لتطوير تطبيق باستخدام واجهات برمجة التطبيقات لخدمات 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 في تطبيقك، أكمل الخطوات التالية:
افتح ملف
build.gradle
داخل دليل وحدة تطبيقك.لكل حزمة SDK يتطلبها تطبيقك، يجب تضمين الاعتمادية لهذه الحزمة. تتضمن هذه الصفحة قسمًا يسرد تبعيات "خدمات Google Play" الشائعة لتطبيقات Android. ويمكنك أيضًا إضافة تبعيات Firebase إلى مشروعك.
احفظ التغييرات وزامِن مشروعك.
يعرض المقتطف التالي مثالاً على ملف 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 الخاص بك. ويمكنك فلترة القائمة حسب نوع الجهاز عن طريق اختيار أحد الأزرار، ويمكنك البحث عن حالة استخدام أو اسم تبعية معين عن طريق إدخال نص في المربع الذي يظهر بعد الأزرار.
حالة الاستخدام واسم التبعية | الأجهزة المتوافقة |
---|---|
إعلانات 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" لنظام التشغيل Androidcom.google.android.gms:play-services-analytics:18.0.4 |
تمّت إزالة هذا العمود. استخدِم إحصاءات Google لبرنامج Firebase بدلاً من ذلك. |
فهرس التطبيقاتcom.google.android.gms:play-services-appindex:16.1.0 |
الهاتف والجهاز اللوحي وAndroid TV |
معرّف مجموعة تطبيقات Androidcom.google.android.gms:play-services-appset:16.0.2 |
الهاتف والجهاز اللوحي وAndroid TV وChromeOS |
تسجيل الدخول بحساب Google على أجهزة Androidcom.google.android.gms:play-services-auth:21.0.0 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS |
واجهة برمجة تطبيقات SMS Retriever APIcom.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 APIcom.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 Castcom.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 TVcom.google.android.gms:play-services-cast-tv:21.0.1 |
Android TV |
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.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 لنظام التشغيل Androidcom.google.android.gms:play-services-fitness:21.1.0 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS وWear OS |
الإصدار 2 من "خدمات ألعاب Google Play" لنظام التشغيل Androidcom.google.android.gms:play-services-games-v2:19.0.0 |
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS |
الإصدار 2 من حزمة تطوير البرامج (SDK) Native C في "خدمات ألعاب Google Play" لنظام التشغيل 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.1.0 |
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS |
mater APIcom.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 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث. |
خدمات الموقع الجغرافي لنظام التشغيل Androidcom.google.android.gms:play-services-location:21.2.0 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Androidcom.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 |
التعرّف على النص في أدوات تعلّم الآلة لخدمة Devanagaricom.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 |
إدارة العلامات من Googlecom.google.android.gms:play-services-tagmanager:18.0.4 |
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS |
Tasks API على نظام التشغيل Androidcom.google.android.gms:play-services-tasks:18.1.0 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
خدمة التسريع لنظام التشغيل Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
TensorFlow Lite GPU Delegate API لخدمات Google Playcom.google.android.gms:play-services-tflite-gpu:16.2.0 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
TensorFlow Lite Java API لخدمات Google Playcom.google.android.gms:play-services-tflite-java:16.2.0-beta02 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
TensorFlow Lite Support API لخدمات Google Playcom.google.android.gms:play-services-tflite-support:16.1.0 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
Thread Network APIcom.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 على أجهزة Androidcom.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 الإضافية، كما هو موضّح في الجدول التالي. لاحظ أن الأزرار التي تظهر قبل الجدول السابق لا تغير المعلومات التي تظهر في هذا الجدول.
حالة الاستخدام واسم المكوّن الإضافي لنظام 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 |