تطوير تطبيق باستخدام خدمات Google Play لواجهات برمجة التطبيقات، اتّبِع التعليمات في هذه الصفحة لإعداد لمشروعك باستخدام حِزم SDK ذات الصلة، والتي تتوفر من مستودع Maven من Google.
لاختبار تطبيقك أثناء استخدام "خدمات Google Play"، يجب استخدام إحدى التالي:
- جهاز Android متوافق يعمل بالإصدار Android 6.0 (واجهة برمجة التطبيقات) المستوى 23) أو أعلى وأن يكون به تطبيق "متجر Google Play" مثبت.
- محاكي Android مع AVD الذي يشغّل واجهات Google APIs يعتمد على Android 6.0 (المستوى 23 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
توضيح الموارد الاعتمادية لخدمات 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.3.0'
}
إصدارات جديدة من حِزم تطوير البرامج (SDK) لخدمات Google Play مع إصلاحات للأخطاء وميزات جديدة يتم إصدارها بشكل دوري. تم الإعلان عن هذه التحديثات في الإصدار الملاحظات. إذا كان تطبيقك يستخدم تبعية تم أو التغيير إلى أحدث إصدار في اعتماديات التطبيق لأخذ والاستفادة من هذه الإصلاحات.
التحقّق مما إذا تم تثبيت "خدمات Google Play"
كما هو موضّح في نظرة عامة حول خدمات Google Play، تتلقّى "خدمات Google Play" تحديثات تلقائية على نظام التشغيل Android 6.0 (مستوى واجهة برمجة التطبيقات 23) والإصدارات الأحدث من خلال تطبيق "متجر Google Play". ولكن بالنسبة إلى أجهزة Android التي لا تستخدم Google Play "خدمات Google Play" غير مثبَّتة في "متجر 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:23.3.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.3.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.0 |
تمّت إزالة هذا العمود. استخدِم إحصاءات Google لبرنامج Firebase بدلاً منه. |
فهرس التطبيقاتcom.google.android.gms:play-services-appindex:16.2.0 |
الهاتف والجهاز اللوحي وAndroid TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.0 |
الهاتف والجهاز اللوحي و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 (بما في ذلك وحدة تخزين بيانات اعتماد المستخدم)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 |
هاتف، جهاز لوحي، Auto، 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:21.5.0 |
هاتف وجهاز لوحي وAndroid Go وChromeOS |
إطار عمل تطبيق Google Cast (CAF)com.google.android.gms:play-services-cast-framework:21.5.0 |
هاتف وجهاز لوحي وAndroid Go وChromeOS |
أجهزة استقبال Android TVcom.google.android.gms:play-services-cast-tv:21.1.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.1.0 |
هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
التفاعلات من جهاز إلى آخر (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta01 |
الهاتف، الجهاز اللوحي، Android Go |
مصادقة Fast IDentity على الإنترنت (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 |
الإصدار الثاني من "خدمات ألعاب Google Play" لنظام التشغيل Androidcom.google.android.gms:play-services-games-v2:20.1.2 |
هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS |
الإصدار الثاني من حزمة تطوير البرامج (SDK) الأصلية لـ "خدمات ألعاب Google Play" لنظام التشغيل 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.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 يتوفّر هذا الخيار على الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث. |
خدمات الموقع الجغرافي لنظام التشغيل Androidcom.google.android.gms:play-services-location:21.3.0 |
هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Androidcom.google.android.gms:play-services-maps:19.0.0 |
هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
مسح الرمز الشريطي لحزمة تعلّم الآلةcom.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 |
التعرّف على الوجوه من خلال حزمة تعلّم الآلة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 |
التعرّف على النص في ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 |
هاتف وجهاز لوحي وAndroid Go وChromeOS |
التعرُّف على النص في مجموعة أدوات تعلُّم الآلة باللغة الصينيةcom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 |
هاتف وجهاز لوحي وAndroid Go وChromeOS |
التعرّف على النص في لغتَي الديفاناغارية من خلال تعلُّم الآلةcom.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 Kit باللغة الكوريةcom.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 متوافق مع الأجهزة التي تعمل بالإصدار 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 for Cards)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 (تشمل مصادقة الجهاز والتصفّح الآمن و 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.0 |
هاتف، جهاز لوحي، 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.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 Networkcom.google.android.gms:play-services-threadnetwork:16.0.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 |
هاتف، جهاز لوحي، Auto، Android Go، ChromeOS، Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:18.2.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 |