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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

تعريف التبعيات لخدمات Google Play

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

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

  2. عليك تضمين التبعية لحزمة تطوير البرامج (SDK) تلك التي يتطلبها تطبيقك لكل حزمة تطوير برامج (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 4.4 (مستوى واجهة برمجة التطبيقات 19) والإصدارات الأحدث من خلال تطبيق "متجر Google Play"، ولكن أجهزة Android التي لا تتضمن "متجر Google Play" لم يتم تثبيت خدمات 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:21.5.0
هاتف، جهاز لوحي
معرّف إعلانات Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.0.1
الهاتف والجهاز اللوحي وAndroid TV ونظام التشغيل Chrome
إصدار خفيف من "إعلانات Google" للأجهزة الجوّالة
com.google.android.gms:play-services-ads-lite:21.5.0
هاتف، جهاز لوحي
إعلانات البحث المخصّص (CSA) من AdSense للبحث (CSA)
com.google.android.gms:play-services-afs-native:19.0.3
الهاتف والجهاز اللوحي ونظام التشغيل Chrome
حزمة تطوير البرامج (SDK) لخدمات "إحصاءات Google" لنظام التشغيل Android
com.google.android.gms:play-services-analytics:18.0.2
متوقف. استخدم Google Analytics for 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 ونظام التشغيل Chrome
تسجيل الدخول بحساب Google لأجهزة Android
com.google.android.gms:play-services-auth:20.4.1
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS
واجهة برمجة تطبيقات استرداد الرسائل القصيرة SMS
com.google.android.gms:play-services-auth-api-phone:18.0.1
هاتف، جهاز لوحي، Android Go
حظر واجهة برمجة تطبيقات المتجر (بما في ذلك وحدة تخزين بيانات اعتماد المستخدم)
com.google.android.gms:play-services-auth-blockstore:16.1.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.0.1
الهاتف والجهاز اللوحي وAuto وAndroid Go ونظام التشغيل Chrome
فئات الخدمات
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.1.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
Google Cast
com.google.android.gms:play-services-cast:21.2.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
إطار عمل Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:21.2.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
أجهزة استقبال Android TV
com.google.android.gms:play-services-cast-tv:20.0.0
Android TV
ماسح الرمز البرمجي من Google
com.google.android.gms:play-services-code-scanner:16.0.0-beta3
الهاتف والجهاز اللوحي و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:19.0.1
الهاتف والجهاز اللوحي و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:17.0.0
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
الإصدار الثاني من حزمة تطوير البرامج (SDK) لخدمات "ألعاب Google Play" الإصدار 2 لنظام التشغيل 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.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
فحص الرمز الشريطي من خلال ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.1.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
التعرّف على لغة 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
التعرّف على النص في مجموعة أدوات تعلّم الآلة
com.google.android.gms:play-services-mlkit-text-recognition:18.0.2
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
اكتشاف الأجهزة المجاورة والاتصال بها
com.google.android.gms:play-services-nearby:18.4.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go
عرض تراخيص مفتوحة المصدر
com.google.android.gms:play-services-oss-licenses:17.0.0
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go ونظام التشغيل Chrome
يتوفّر ذلك على الأجهزة التي تعمل بنظام التشغيل 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 للبطاقات
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.2
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS
واجهة برمجة تطبيقات "مهام Google" على Android
com.google.android.gms:play-services-tasks:18.0.2
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS
واجهة برمجة تطبيقات المفوّض في وحدة معالجة الرسومات من TensorFlow Lite لخدمات Google Play
com.google.android.gms:play-services-tflite-gpu:16.1.0
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
واجهة برمجة تطبيقات جافا من TensorFlow Lite لخدمات Google Play
com.google.android.gms:play-services-tflite-java:16.0.1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
واجهة برمجة تطبيقات دعم TensorFlow Lite لخدمات Google Play
com.google.android.gms:play-services-tflite-support:16.0.1
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
واجهة برمجة تطبيقات شبكة Thread
com.google.android.gms:play-services-threadnetwork:16.0.0-beta02
هاتف، جهاز لوحي
الرؤية على الأجهزة الجوّالة
com.google.android.gms:play-services-vision:20.1.3
الهاتف والجهاز اللوحي وAndroid Go وChromeOS
Google Pay للدفع على الأجهزة التي تعمل بنظام التشغيل Android
com.google.android.gms:play-services-wallet:19.1.0
الهاتف والجهاز اللوحي وAuto وAndroid Go وChromeOS وWear OS
واجهة برمجة تطبيقات طبقة البيانات القابلة للارتداء
com.google.android.gms:play-services-wearable:18.0.0
هاتف، جهاز لوحي، Wear OS

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

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

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