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

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

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

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

توضيح تبعيات "خدمات Google Play"

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

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

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

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

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

apply plugin: 'com.android.application'

...

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

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

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

كما هو موضّح في نظرة عامة على خدمات Google Play، تتلقّى "خدمات Google Play" تحديثات تلقائية على نظام التشغيل Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) والإصدارات الأحدث من خلال تطبيق "متجر Google Play"، إلا أنّ خدمات Google Play غير مُثبَّتة على أجهزة Android التي لا تشتمل على "متجر Google Play". إذا كان تطبيقك يعمل على أجهزة لا تتضمن خدمات Google Play، ننصحك بالتحقق ممّا إذا كان قد تم تثبيت خدمات Google Play على الجهاز قبل محاولة استخدام واجهات Google APIs، أو التأكّد ممّا إذا كان تطبيقك يتطلّب عمل خدمات 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:22.6.0
هاتف، جهاز لوحي
المعرّف الإعلاني على Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.0.1
الهاتف والجهاز اللوحي وAndroid TV وChromeOS
إصدار خفيف من "إعلانات Google للأجهزة الجوّالة"
com.google.android.gms:play-services-ads-lite:22.6.0
هاتف، جهاز لوحي
إعلانات البحث المخصّص (CSA) التي تخصّ "AdSense للبحث"
com.google.android.gms:play-services-afs-native:19.0.3
هاتف، جهاز لوحي، ChromeOS
حزمة تطوير البرامج (SDK) لخدمات "إحصاءات Google" لنظام التشغيل Android
com.google.android.gms:play-services-analytics:18.0.4
تمّت إزالة هذا العمود. استخدِم إحصاءات Google لبرنامج Firebase بدلاً من ذلك.
فهرس التطبيقات
com.google.android.gms:play-services-appindex:16.1.0
الهاتف والجهاز اللوحي وAndroid TV
معرّف مجموعة تطبيقات Android
com.google.android.gms:play-services-appset:16.0.2
الهاتف والجهاز اللوحي وAndroid TV وChromeOS
تسجيل الدخول بحساب Google على أجهزة Android
com.google.android.gms:play-services-auth:21.0.0
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS
واجهة برمجة تطبيقات SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.0.2
الهاتف والجهاز اللوحي وAndroid Go
Block Store API (تتضمّن مساحة تخزين بيانات اعتماد المستخدم)
com.google.android.gms:play-services-auth-blockstore:16.2.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.0.1
الهاتف، الجهاز اللوحي، Auto، Android Go، ChromeOS
فئات المرافق
com.google.android.gms:play-services-base:18.3.0
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
اختبار المواد المزيّفة لفئات الخدمات
com.google.android.gms:play-services-base-testing:16.0.0
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
المزيد من فئات الخدمات
com.google.android.gms:play-services-basement:18.3.0
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.4.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
إطار عمل تطبيق Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:21.4.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
أجهزة استقبال Android TV
com.google.android.gms:play-services-cast-tv:21.0.1
Android TV
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.0.1
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
التفاعلات من جهاز إلى آخر (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
الهاتف والجهاز اللوحي وAndroid Go
مصادقة الهوية السريعة على الإنترنت (FIDO)
com.google.android.gms:play-services-fido:20.1.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS

تتوفّر هذه الميزة على الأجهزة التي تعمل بالإصدار 7.0 من نظام التشغيل Android (المستوى 24 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
Google Fit API لنظام التشغيل Android
com.google.android.gms:play-services-fitness:21.1.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS وWear OS
الإصدار 2 من "خدمات ألعاب Google Play" لنظام التشغيل Android
com.google.android.gms:play-services-games-v2:19.0.0
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
الإصدار 2 من حزمة تطوير البرامج (SDK) Native C في "خدمات ألعاب Google Play" لنظام التشغيل 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.1.0
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
mater API
com.google.android.gms:play-services-home:16.0.0
هاتف، جهاز لوحي
تطبيقات Google Play الفورية
com.google.android.gms:play-services-instantapps:18.0.1
الهواتف والأجهزة اللوحية وAndroid TV وAndroid Go وChromeOS

تتوفّر هذه الميزة على الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
خدمات الموقع الجغرافي لنظام التشغيل Android
com.google.android.gms:play-services-location:21.2.0
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
com.google.android.gms:play-services-maps:18.2.0
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
مسح الرمز الشريطي لمجموعة أدوات تعلُّم الآلة
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
الماسح الضوئي للمستندات في حزمة تعلُّم الآلة
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على الوجوه في أدوات تعلّم الآلة
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
تصنيف صور تعلُّم الآلة
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
تصنيف صور مخصَّص ضمن أدوات تعلُّم الآلة
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على اللغة في أدوات تعلّم الآلة
com.google.android.gms:play-services-mlkit-language-id:17.0.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
الرد السريع على أدوات تعلُّم الآلة
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
تصنيف مواضيع "أدوات تعلُّم الآلة"
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على النص في أدوات تعلُّم الآلة
com.google.android.gms:play-services-mlkit-text-recognition:19.0.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على النص في أدوات تعلّم الآلة باللغة الصينية
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على النص في أدوات تعلّم الآلة لخدمة Devanagari
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على النص في أدوات تعلّم الآلة باللغة اليابانية
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
التعرّف على النص في أدوات تعلّم الآلة باللغة الكورية
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
اكتشاف الأجهزة المجاورة والاتصال بها
com.google.android.gms:play-services-nearby:19.1.0
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go
عرض تراخيص البرامج المفتوحة المصدر
com.google.android.gms:play-services-oss-licenses:17.0.1
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS
يتوفّر ذلك على الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
التحقّق من جودة "قفل الشاشة"
com.google.android.gms:play-services-password-complexity:18.0.1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS وWear OS

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

تتوفّر هذه الميزة على الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 20 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
reCAPTCHA Enterprise لأدوات التطبيق
com.google.android.gms:play-services-recaptcha:17.0.1
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
واجهات برمجة تطبيقات SafetyNet (بما في ذلك مصادقة الجهاز والتصفّح الآمن و reCAPTCHA والتحقق من التطبيقات)
com.google.android.gms:play-services-safetynet:18.0.1
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS
إدارة العلامات من Google
com.google.android.gms:play-services-tagmanager:18.0.4
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
Tasks API على نظام التشغيل Android
com.google.android.gms:play-services-tasks:18.1.0
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
خدمة التسريع لنظام التشغيل Android
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
TensorFlow Lite GPU Delegate API لخدمات Google Play
com.google.android.gms:play-services-tflite-gpu:16.2.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
TensorFlow Lite Java API لخدمات Google Play
com.google.android.gms:play-services-tflite-java:16.2.0-beta02
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
TensorFlow Lite Support API لخدمات Google Play
com.google.android.gms:play-services-tflite-support:16.1.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.0.0
هاتف، جهاز لوحي
رؤية الأجهزة الجوّالة
com.google.android.gms:play-services-vision:20.1.3
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
Google Pay for Payments على أجهزة Android
com.google.android.gms:play-services-wallet:19.3.0
هاتف، جهاز لوحي، Auto، Android Go، ChromeOS، Wear OS
واجهة برمجة التطبيقات لطبقة البيانات القابلة للارتداء
com.google.android.gms:play-services-wearable:18.1.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