لتطوير تطبيق باستخدام واجهات برمجة تطبيقات خدمات 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 في تطبيقك، يمكنك إكمال الخطوات التالية:
افتح ملف
build.gradle
داخل دليل وحدة تطبيقك.عليك تضمين التبعية لحزمة تطوير البرامج (SDK) تلك التي يتطلبها تطبيقك لكل حزمة تطوير برامج (SDK). تتضمن هذه الصفحة قسمًا يسرد العناصر الشائعة لخدمات Google Play لتطبيقات Android. قد تحتاج أيضًا إلى إضافة تبعيات Firebase إلى مشروعك.
احفظ التغييرات وزامن مشروعك.
يعرض المقتطف التالي مثالاً على ملف 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. يمكنك تصفية القائمة بحسب نوع الجهاز عن طريق تحديد أحد الأزرار، ويمكنك البحث عن حالة استخدام محددة أو اسم التبعية عن طريق إدخال نص في المربع الذي يظهر بعد الأزرار.
حالة الاستخدام واسم التبعية | الأجهزة المعتمدة |
---|---|
إعلانات 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" لنظام التشغيل Androidcom.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 |
رقم تعريف مجموعة تطبيقات Androidcom.google.android.gms:play-services-appset:16.0.2 |
الهاتف والجهاز اللوحي وAndroid TV ونظام التشغيل Chrome |
تسجيل الدخول بحساب Google لأجهزة Androidcom.google.android.gms:play-services-auth:20.4.1 |
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS |
واجهة برمجة تطبيقات استرداد الرسائل القصيرة SMScom.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 APIcom.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 Castcom.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 TVcom.google.android.gms:play-services-cast-tv:20.0.0 |
Android TV |
ماسح الرمز البرمجي من Googlecom.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 لنظام التشغيل Androidcom.google.android.gms:play-services-fitness:21.1.0 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS وWear OS |
الإصدار الثاني من "خدمات ألعاب Google Play" لنظام التشغيل Androidcom.google.android.gms:play-services-games-v2:17.0.0 |
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS |
الإصدار الثاني من حزمة تطوير البرامج (SDK) لخدمات "ألعاب Google Play" الإصدار 2 لنظام التشغيل Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS |
الإصدار الأول من "خدمات ألعاب Google Play" لنظام التشغيل Androidcom.google.android.gms:play-services-games:23.1.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.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" لنظام التشغيل Androidcom.google.android.gms:play-services-maps:18.1.0 |
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS |
فحص الرمز الشريطي من خلال ML Kitcom.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 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 |
التعرّف على النص في مجموعة أدوات تعلّم الآلة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 |
إدارة العلامات من Googlecom.google.android.gms:play-services-tagmanager:18.0.2 |
الهاتف والجهاز اللوحي وAndroid TV وAndroid Go وChromeOS |
واجهة برمجة تطبيقات "مهام Google" على Androidcom.google.android.gms:play-services-tasks:18.0.2 |
الهاتف والجهاز اللوحي وAndroid TV وAuto وAndroid Go وChromeOS وWear OS |
واجهة برمجة تطبيقات المفوّض في وحدة معالجة الرسومات من TensorFlow Lite لخدمات Google Playcom.google.android.gms:play-services-tflite-gpu:16.1.0 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
واجهة برمجة تطبيقات جافا من TensorFlow Lite لخدمات Google Playcom.google.android.gms:play-services-tflite-java:16.0.1 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
واجهة برمجة تطبيقات دعم TensorFlow Lite لخدمات Google Playcom.google.android.gms:play-services-tflite-support:16.0.1 |
الهاتف والجهاز اللوحي وAndroid Go وChromeOS |
واجهة برمجة تطبيقات شبكة Threadcom.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 للدفع على الأجهزة التي تعمل بنظام التشغيل Androidcom.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 الإضافية، كما هو موضّح في الجدول التالي. تجدر الإشارة إلى أن الأزرار التي تظهر قبل الجدول السابق لا تغيّر المعلومات التي تظهر في هذا الجدول.
اسم الحالة واسم المكوّن الإضافي 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 |