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

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

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

  • جهاز Android متوافق يعمل بالإصدار Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) أو إصدار أحدث ومثبَّت عليه تطبيق "متجر Google Play".
  • محاكي Android مع متوسّط مدة تشغيل يشغّل النظام الأساسي لـ 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.0.1'
}

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

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

كما هو موضّح في نظرة عامة على خدمات Google Play، تتلقّى "خدمات Google Play" تحديثات تلقائية على نظام التشغيل Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) والإصدارات الأحدث من خلال تطبيق "متجر Google Play". أمّا بالنسبة إلى أجهزة Android التي لا تتضمّن "متجر Google Play"، فلم يتم تثبيت "خدمات Google Play" عليها. إذا كان تطبيقك يعمل على أجهزة لا تحتوي على خدمات Google Play، ننصحك بالتحقّق ممّا إذا كان قد تم تثبيت خدمات Google Play على الجهاز قبل محاولة استخدام واجهات Google API، أو التحقّق من إمكانية تفعيل ميزات في تطبيقك تتطلّب عمل "خدمات 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.4.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.4.0
هاتف، جهاز لوحي
إعلانات البحث المخصّص (CSA) في "AdSense للبحث" (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.3
متوقّف نهائيًا. استخدِم إحصاءات 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:20.7.0
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS
واجهة برمجة التطبيقات للرسائل القصيرة (SMS ريتريفر)
com.google.android.gms:play-services-auth-api-phone:18.0.1
الهاتف والجهاز اللوحي و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.2.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.2.0
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.3.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
إطار عمل تطبيق Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:21.3.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
أجهزة استقبال Android TV
com.google.android.gms:play-services-cast-tv:21.0.0
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

متوافق مع الأجهزة التي تعمل بنظام التشغيل Android 7.0 (المستوى 24 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث.
Google Fit API لنظام التشغيل Android
com.google.android.gms:play-services-fitness:21.1.0
الهاتف، الجهاز اللوحي، Android Go، ChromeOS، Wear OS
الإصدار الثاني من "خدمات ألعاب Google Play" لنظام التشغيل Android
com.google.android.gms:play-services-games-v2:19.0.0
الهاتف، الجهاز اللوحي، Android TV، Android Go، ChromeOS
الإصدار الثاني من "خدمات ألعاب Google Play" التي تتضمّن حزمة تطوير برامج (SDK) مدمجة مع المحتوى لنظام التشغيل 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
Matter 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.0.1
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android
com.google.android.gms:play-services-maps:18.1.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-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-beta4
الهاتف والجهاز اللوحي و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-text-recognition:19.0.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
ميزة التعرّف على النص في "حزمة تعلّم الآلة" للغة الصينية
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
ميزة التعرّف على النص في "حزمة تعلّم الآلة" للغة الديفاناغارية
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:18.7.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

يتوافق مع الأجهزة التي تعمل بنظام التشغيل Android 4.4 (مستوى واجهة برمجة التطبيقات 19) وAndroid 9 (المستوى 28 من واجهة برمجة التطبيقات).
Google Pay for Passes
com.google.android.gms:play-services-pay:16.1.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.3
الهاتف، الجهاز اللوحي، Android TV، Android Go، ChromeOS
Tasks API على Android
com.google.android.gms:play-services-tasks:18.0.2
الهاتف، الجهاز اللوحي، 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 Implement 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.1.0
الهاتف والجهاز اللوحي و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.2.1
الهاتف، الجهاز اللوحي، 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