لتطوير تطبيق باستخدام واجهات برمجة التطبيقات لخدمات 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.3.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:23.1.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.1.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.2.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.0 |
هاتف، جهاز لوحي، 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.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 |
التعرّف على النص في لغتَي الديفاناغارية من خلال تعلّم الآلة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 |
التعرّف على النص في ML Kit باللغة الكوريةcom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0 |
هاتف وجهاز لوحي و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 Pass)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 |