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

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

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

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

توضيح الموارد الاعتمادية لخدمات 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.3.0'
}

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

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

كما هو موضّح في نظرة عامة حول خدمات Google Play، تتلقّى "خدمات Google Play" تحديثات تلقائية على نظام التشغيل Android 6.0 (مستوى واجهة برمجة التطبيقات 23) والإصدارات الأحدث من خلال تطبيق "متجر Google Play". ولكن بالنسبة إلى أجهزة Android التي لا تستخدم Google Play "خدمات Google Play" غير مثبَّتة في "متجر 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:23.3.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.3.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.0
تمّت إزالة هذا العمود. استخدِم إحصاءات Google لبرنامج Firebase بدلاً منه.
فهرس التطبيقات
com.google.android.gms:play-services-appindex:16.2.0
الهاتف والجهاز اللوحي وAndroid TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.0
الهاتف والجهاز اللوحي و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 (بما في ذلك وحدة تخزين بيانات اعتماد المستخدم)
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
هاتف، جهاز لوحي، Auto، 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.4.0
هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.5.0
هاتف وجهاز لوحي وAndroid Go وChromeOS
إطار عمل تطبيق Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:21.5.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-beta01
الهاتف، الجهاز اللوحي، Android Go
مصادقة Fast IDentity على الإنترنت (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
الإصدار الثاني من "خدمات ألعاب Google Play" لنظام التشغيل Android
com.google.android.gms:play-services-games-v2:20.1.2
هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
الإصدار الثاني من حزمة تطوير البرامج (SDK) الأصلية لـ "خدمات ألعاب Google Play" لنظام التشغيل Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
الإصدار الأول من "خدمات ألعاب 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

يتوفّر هذا الخيار على الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
خدمات الموقع الجغرافي لنظام التشغيل Android
com.google.android.gms:play-services-location:21.3.0
هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
com.google.android.gms:play-services-maps:19.0.0
هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
مسح الرمز الشريطي لحزمة تعلّم الآلة
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
التعرّف على الوجوه من خلال حزمة تعلّم الآلة
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
التعرّف على النص في ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرُّف على النص في مجموعة أدوات تعلُّم الآلة باللغة الصينية
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
هاتف وجهاز لوحي وAndroid Go وChromeOS
التعرّف على النص في لغتَي الديفاناغارية من خلال تعلُّم الآلة
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
متوافق مع الأجهزة التي تعمل بالإصدار 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 for Cards)
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 (تشمل مصادقة الجهاز والتصفّح الآمن و 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.0
هاتف، جهاز لوحي، 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.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
com.google.android.gms:play-services-threadnetwork:16.0.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
هاتف، جهاز لوحي، Auto، Android Go، ChromeOS، Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:18.2.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