لتطوير تطبيق باستخدام واجهات برمجة تطبيقات خدمات 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 في تطبيقك، يُرجى إكمال الخطوات التالية:
افتح ملف
build.gradle
داخل دليل الوحدة في تطبيقك.بالنسبة إلى كل حزمة 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 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 الخاص بك. يمكنك فلترة القائمة حسب نوع الجهاز عن طريق اختيار أحد الأزرار، ويمكنك البحث عن حالة استخدام معيّنة أو اسم تبعية عن طريق إدخال نص في المربّع الذي يظهر بعد الأزرار.
حالة الاستخدام واسم التبعية | الأجهزة المتوافقة |
---|---|
إعلانات 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" لنظام التشغيل Androidcom.google.android.gms:play-services-analytics:18.0.3 |
متوقّف نهائيًا. استخدِم إحصاءات 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: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 APIcom.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 Castcom.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 TVcom.google.android.gms:play-services-cast-tv:21.0.0 |
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 متوافق مع الأجهزة التي تعمل بنظام التشغيل 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:19.0.0 |
الهاتف، الجهاز اللوحي، Android TV، Android Go، ChromeOS |
الإصدار الثاني من "خدمات ألعاب Google Play" التي تتضمّن حزمة تطوير برامج (SDK) مدمجة مع المحتوى لنظام التشغيل 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 |
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 |
مسح الرمز الشريطي لحزمة تعلّم الآلة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 Passescom.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.3 |
الهاتف، الجهاز اللوحي، Android TV، Android Go، ChromeOS |
Tasks API على Androidcom.google.android.gms:play-services-tasks:18.0.2 |
الهاتف، الجهاز اللوحي، 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 Implement 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.1.0 |
الهاتف والجهاز اللوحي و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.2.1 |
الهاتف، الجهاز اللوحي، 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 |