إعداد "خدمات Google Play"

لتطوير تطبيق باستخدام واجهات برمجة التطبيقات في "خدمات Google Play"، اتّبِع التعليمات الواردة في هذه الصفحة لإعداد مشروعك باستخدام حِزم SDK ذات الصلة، والتي تتوفّر من مستودع Google maven.

لاختبار تطبيقك عند استخدام "خدمات Google Play"، يجب استخدام أحد الإجراءَين التاليَين:

  • جهاز Android متوافق يعمل بالإصدار 6.0 (المستوى 23 من واجهة برمجة التطبيقات) أو إصدار أحدث ومُثبَّت عليه تطبيق "متجر Google Play"
  • محاكي Android المزوّد بملف AVD الذي يشغّل منصّة Google APIs استنادًا إلى الإصدار 6.0 من نظام التشغيل Android (المستوى 23 من واجهة برمجة التطبيقات) أو إصدار أحدث

الإفصاح عن التبعيات لخدمة "خدمات Google Play"

لتطوير ميزات تعتمد على واجهات برمجة تطبيقات "خدمات Google Play" في تطبيقك، عليك إكمال الخطوات التالية:

  1. افتح ملف build.gradle داخل دليل وحدة تطبيقك.

  2. يجب تضمين الملحقات لكل حزمة SDK يتطلّبها تطبيقك. تتضمّن هذه الصفحة قسمًا يسرد التبعيات المشترَكة لخدمات Google Play لتطبيقات Android. ننصحك أيضًا بإضافة متطلّبات Firebase إلى مشروعك.

  3. احفظ التغييرات وزامِن مشروعك.

يعرض المقتطف التالي مثالاً على ملف build.gradle يستخدم مكتبة location:

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.3.0'
}

يتم طرح إصدارات جديدة من حِزم SDK لـ "خدمات Google Play" بشكل دوري تتضمّن إصلاحات للأخطاء وميزات جديدة. ويتم الإعلان عن هذه التعديلات في ملاحظات الإصدار. إذا كان تطبيقك يستخدم ملفًا تابعًا تم تعديله، يمكنك التبديل إلى أحدث إصدار من الملفات التابعة لتطبيقك للاستفادة من هذه الإصلاحات.

التحقّق مما إذا كانت "خدمات Google Play" مثبَّتة

كما هو موضّح في نظرة عامة على "خدمات Google Play"،تلقّى "خدمات Google Play" تحديثات تلقائية على الإصدار 6.0 من Android (المستوى 23 من واجهة برمجة التطبيقات) والإصدارات الأحدث من خلال تطبيق "متجر Google Play". ومع ذلك، لا يتم تثبيت "خدمات Google Play" على أجهزة Android التي لا تتضمّن "متجر Google Play". إذا كان تطبيقك يعمل على الأجهزة بدون "خدمات Google Play"، ننصحك بالتحقّق ممّا إذا كانت "خدمات Google Play" مثبّتة على الجهاز قبل محاولة استخدام واجهات برمجة تطبيقات Google، أو تفعيل الميزات في تطبيقك التي تتطلّب "خدمات Google Play" لكي تعمل.

للتحقّق من توفّر "خدمات Google Play" على الجهاز، استخدِم الخطوات التالية: isGooglePlayServicesAvailable().

لبدء الاتصال بـ "خدمات Google Play" أو معرفة كيفية رصد ما إذا كان إصدار "خدمات Google Play" المثبَّت يتيح استخدام واجهة برمجة تطبيقات معيّنة، اطّلِع على الدليل حول الوصول إلى Google APIs.

متطلّبات "خدمات Google Play"

يسرد الجدول التالي التبعيات لخدمات Google Play التي يمكنك إدراجها في تطبيق Android. يمكنك فلترة القائمة حسب نوع الجهاز من خلال اختيار أحد الأزرار، ويمكنك البحث عن حالة استخدام معيّنة أو اسم تبعية معيّن عن طريق إدخال نص في المربّع الذي يظهر بعد الأزرار.

الجدول 1: متطلّبات "خدمات Google Play" المطلوب تضمينها في التطبيقات المتوافقة مع Android
حالة الاستخدام واسم التبعية الأجهزة المتوافقة
إعلانات Google للأجهزة الجوّالة
com.google.android.gms:play-services-ads:23.6.0
الهاتف والجهاز اللوحي
المعرِّف الإعلاني على Android‏ (AAID)
com.google.android.gms:play-services-ads-identifier:18.1.0
الهاتف والجهاز اللوحي وAndroid TV وChromeOS
إصدار خفيف من "إعلانات Google" للأجهزة الجوّالة
com.google.android.gms:play-services-ads-lite:23.6.0
الهاتف والجهاز اللوحي
إعلانات البحث المخصّصة في "AdSense للبحث"
com.google.android.gms:play-services-afs-native:19.1.0
الهاتف والجهاز اللوحي وChromeOS
حزمة تطوير البرامج (SDK) لخدمات "إحصاءات Google" لنظام التشغيل Android
com.google.android.gms:play-services-analytics:18.1.1
تمّ إيقاف هذا العمود نهائيًا. استخدِم إحصاءات Google لبرنامج Firebase بدلاً من ذلك.
فهرس التطبيقات
com.google.android.gms:play-services-appindex:16.2.0
الهاتف والجهاز اللوحي وAndroid TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.1
الهاتف والجهاز اللوحي وAndroid TV
معرّف مجموعة تطبيقات Android
com.google.android.gms:play-services-appset:16.1.0
الهاتف والجهاز اللوحي وAndroid TV وChromeOS
تسجيل الدخول بحساب Google لأجهزة Android
com.google.android.gms:play-services-auth:21.2.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.1.0
الهاتف والجهاز اللوحي وAndroid Go
حظر Store API (يشمل تخزين بيانات اعتماد المستخدم)
com.google.android.gms:play-services-auth-blockstore:16.4.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.1.0
الهاتف والجهاز اللوحي والسيارة وAndroid Go وChromeOS
فئات الخدمات
com.google.android.gms:play-services-base:18.5.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
اختبار العناصر المزيّفة لفئات الأدوات
com.google.android.gms:play-services-base-testing:16.1.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
المزيد من فئات الأدوات
com.google.android.gms:play-services-basement:18.5.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
Google Cast
com.google.android.gms:play-services-cast:22.0.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
إطار عمل تطبيقات Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:22.0.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
Google Code Scanner
com.google.android.gms:play-services-code-scanner:16.1.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
حِزمة Chromium للشبكة (Cronet)
com.google.android.gms:play-services-cronet:18.1.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
التفاعلات بين الأجهزة (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta02
الهاتف والجهاز اللوحي وAndroid Go
المصادقة باستخدام بروتوكول Fast IDentity Online ‏ (FIDO)
com.google.android.gms:play-services-fido:21.1.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS

تتوفّر على الأجهزة التي تعمل بنظام التشغيل Android 7.0 (المستوى 24 من واجهة برمجة التطبيقات) أو إصدار أحدث.
Google Fit API لنظام التشغيل Android وRecording API على الأجهزة الجوّالة (لبيانات اللياقة البدنية للمستخدم)
com.google.android.gms:play-services-fitness:21.2.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS وWear OS
الإصدار 2 من "خدمات ألعاب Google Play" لأجهزة Android
com.google.android.gms:play-services-games-v2:20.1.2
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
حزمة تطوير البرامج (SDK) لإصدار 2 من "خدمات ألعاب Google Play" المتوافقة مع C لنظام التشغيل Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
الإصدار 1 من "خدمات ألعاب Google Play" لأجهزة Android
com.google.android.gms:play-services-games:23.2.0
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
Matter API
com.google.android.gms:play-services-home:16.0.0
الهاتف والجهاز اللوحي
تطبيقات Google Play الفورية
com.google.android.gms:play-services-instantapps:18.1.0
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS

التوافق مع الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) أو إصدار أحدث
خدمات الموقع الجغرافي لنظام التشغيل Android
com.google.android.gms:play-services-location:21.3.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
حزمة تطوير البرامج (SDK) لـ "خرائط Google" لنظام التشغيل Android
com.google.android.gms:play-services-maps:19.0.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
مسح الرموز الشريطية ضوئيًا باستخدام حزمة ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
الماسح الضوئي للمستندات في "حزمة تعلُّم الآلة"
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على الوجوه باستخدام حزمة ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
تصنيف الصور باستخدام حزمة ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
تصنيف الصور المخصّص في حزمة ML Kit
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
تحديد اللغة باستخدام ML Kit
com.google.android.gms:play-services-mlkit-language-id:17.0.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
الرد السريع في حزمة ML Kit
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
تقسيم المواضيع في حزمة ML Kit
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على النصوص باستخدام حزمة ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على النصوص باللغة الصينية باستخدام حزمة ML Kit
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على النصوص باللغة الديفاناغارية باستخدام حزمة ML Kit
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
استخدام ML Kit للتعرّف على النص باللغة اليابانية
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على النصوص باللغة الكورية باستخدام ML Kit
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
رصد الأجهزة المجاورة والاتصال بها
com.google.android.gms:play-services-nearby:19.3.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go
عرض تراخيص البرامج المفتوحة المصدر
com.google.android.gms:play-services-oss-licenses:17.1.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS
التوافق مع الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) أو إصدار أحدث
مكتبات الوصول الآلي (PAL)
com.google.android.gms:play-services-pal:21.0.0
الهاتف والجهاز اللوحي وAndroid TV
الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث
التحقّق من جودة قفل الشاشة
com.google.android.gms:play-services-password-complexity:18.1.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS وWear OS

التوافق مع الأجهزة التي تعمل بنظام التشغيل Android 4.4 (المستوى 19 لواجهة برمجة التطبيقات) إلى Android 9 (المستوى 28 لواجهة برمجة التطبيقات)
محفظة Google (المعروفة سابقًا باسم "Google Pay للبطاقات")
com.google.android.gms:play-services-pay:16.5.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS

التوافق مع الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 20 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث
استخدام reCAPTCHA Enterprise لقياس أداء التطبيقات
com.google.android.gms:play-services-recaptcha:17.1.0
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
واجهات برمجة تطبيقات SafetyNet (تشمل التصديق على الجهاز والتصفح الآمن وGoogle reCAPTCHA وإثبات ملكية التطبيق)
com.google.android.gms:play-services-safetynet:18.1.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS
إدارة العلامات من Google
com.google.android.gms:play-services-tagmanager:18.1.1
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
واجهة برمجة التطبيقات Tasks API على Android
com.google.android.gms:play-services-tasks:18.2.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
خدمة Acceleration Service لنظام التشغيل Android
com.google.android.gms:play-services-tflite-acceleration-service:16.3.0-beta01
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
TensorFlow Lite GPU Delegate API لخدمة "خدمات Google Play"
com.google.android.gms:play-services-tflite-gpu:16.3.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
TensorFlow Lite Java API لخدمة Google Play
com.google.android.gms:play-services-tflite-java:16.3.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
TensorFlow Lite Support API لخدمة "خدمات Google Play"
com.google.android.gms:play-services-tflite-support:16.3.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.2.1
الهاتف والجهاز اللوحي
الرؤية على الأجهزة الجوّالة
com.google.android.gms:play-services-vision:20.1.3
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
Google Pay للدفعات على Android
com.google.android.gms:play-services-wallet:19.4.0
الهاتف والجهاز اللوحي والسيارة وAndroid Go وChromeOS وWear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:19.0.0
الهاتف والجهاز اللوحي ونظام التشغيل Wear OS

مكوّنات Gradle الإضافية

تتضمّن "خدمات Google Play" أيضًا العديد من مكوّنات Gradle الإضافية، كما هو موضّح في الجدول التالي. يُرجى العلم أنّ الأزرار التي تظهر قبل الجدول السابق لا تغيّر المعلومات التي تظهر في هذا الجدول.

الجدول 2: قائمة المكوّنات الإضافية لنظام Gradle المضمّنة في "خدمات Google Play"
حالة الاستخدام واسم المكوّن الإضافي Gradle الأجهزة المتوافقة
عرض تراخيص البرامج المفتوحة المصدر
com.google.android.gms:oss-licenses-plugin:0.10.6
الهاتف والجهاز اللوحي وChromeOS
التحقّق الصارم من الإصدار
com.google.android.gms:strict-version-matcher-plugin:1.2.4
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS