لتطوير تطبيق باستخدام واجهات برمجة التطبيقات لخدمات 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" في تطبيقك، عليك إكمال الخطوات التالية:
افتح ملف
build.gradleداخل دليل وحدة تطبيقك.يجب تضمين الملحقات لكل حزمة SDK يتطلّبها تطبيقك. تتضمّن هذه الصفحة قسمًا يسرد التبعيات المشترَكة لخدمات Google Play لتطبيقات Android. يمكنك أيضًا إضافة متطلّبات Firebase إلى مشروعك.
احفظ التغييرات وزامِن مشروعك.
يعرض المقتطف التالي مثالاً على ملف 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. يمكنك فلترة القائمة حسب نوع الجهاز من خلال اختيار أحد الأزرار، ويمكنك البحث عن حالة استخدام معيّنة أو اسم تبعية معيّن عن طريق إدخال نص في المربّع الذي يظهر بعد الأزرار.
| حالة الاستخدام واسم التبعية | الأجهزة المتوافقة |
|---|---|
إعلانات Google للأجهزة الجوّالةcom.google.android.gms:play-services-ads:23.5.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.5.0 |
الهاتف والجهاز اللوحي |
إعلانات البحث المخصّصة في "AdSense للبحث"com.google.android.gms:play-services-afs-native:19.1.0 |
الهاتف والجهاز اللوحي وChromeOS |
حزمة تطوير البرامج (SDK) لخدمات "إحصاءات Google" لنظام التشغيل Androidcom.google.android.gms:play-services-analytics:18.1.1 |
تمّ إيقاف هذا العمود نهائيًا. استخدِم إحصاءات Google لبرنامج Firebase بدلاً من ذلك. |
فهرس التطبيقاتcom.google.android.gms:play-services-appindex:16.2.0 |
الهاتف والجهاز اللوحي وAndroid TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
الهاتف والجهاز اللوحي وAndroid TV |
معرّف مجموعة تطبيقات Androidcom.google.android.gms:play-services-appset:16.1.0 |
الهاتف والجهاز اللوحي وAndroid TV وChromeOS |
تسجيل الدخول بحساب Google لأجهزة Androidcom.google.android.gms:play-services-auth:21.2.0 |
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS |
SMS Retriever APIcom.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 APIcom.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.4.0 |
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS |
Google Castcom.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 Scannercom.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" لأجهزة Androidcom.google.android.gms:play-services-games-v2:20.1.2 |
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS |
حزمة تطوير البرامج (SDK) لإصدار 2 من "خدمات ألعاب Google Play" المتوافقة مع C لنظام التشغيل Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS |
الإصدار 1 من "خدمات ألعاب Google Play" لأجهزة Androidcom.google.android.gms:play-services-games:23.2.0 |
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS |
Matter APIcom.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 من واجهة برمجة التطبيقات) أو إصدار أحدث |
خدمات الموقع الجغرافي لنظام التشغيل Androidcom.google.android.gms:play-services-location:21.3.0 |
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS |
حزمة تطوير البرامج (SDK) لـ "خرائط Google" لنظام التشغيل Androidcom.google.android.gms:play-services-maps:19.0.0 |
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS |
مسح الرموز الشريطية باستخدام حزمة ML Kitcom.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 Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
تصنيف الصور باستخدام حزمة ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
تصنيف الصور المخصّص في حزمة ML Kitcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
تحديد اللغة باستخدام ML Kitcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
الرد السريع في حزمة ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
تقسيم المواضيع في حزمة ML Kitcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
التعرّف على النصوص باستخدام حزمة ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
التعرّف على النصوص باللغة الصينية باستخدام حزمة ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
التعرّف على النصوص باللغة الديفاناغارية باستخدام حزمة ML Kitcom.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 Kitcom.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 |
إدارة العلامات من Googlecom.google.android.gms:play-services-tagmanager:18.1.1 |
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS |
واجهة برمجة التطبيقات Tasks API على Androidcom.google.android.gms:play-services-tasks:18.2.0 |
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS |
خدمة Acceleration Service لنظام التشغيل Androidcom.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 Playcom.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 APIcom.google.android.gms:play-services-threadnetwork:16.2.1 |
الهاتف والجهاز اللوحي |
الرؤية على الأجهزة الجوّالةcom.google.android.gms:play-services-vision:20.1.3 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
Google Pay للدفعات على Androidcom.google.android.gms:play-services-wallet:19.4.0 |
الهاتف والجهاز اللوحي والسيارة وAndroid Go وChromeOS وWear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:19.0.0 |
الهاتف والجهاز اللوحي ونظام التشغيل Wear OS |
مكوّنات Gradle الإضافية
تتضمّن "خدمات Google Play" أيضًا العديد من مكوّنات Gradle الإضافية، كما هو موضّح في الجدول التالي. يُرجى العلم أنّ الأزرار التي تظهر قبل الجدول السابق لا تغيّر المعلومات التي تظهر في هذا الجدول.
| حالة الاستخدام واسم المكوّن الإضافي 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 |