لتطوير تطبيق باستخدام واجهات برمجة تطبيقات "خدمات Google Play"، اتّبِع التعليمات الواردة في هذه الصفحة لإعداد مشروعك باستخدام حِزم SDK ذات الصلة، والتي تتوفّر من مستودع Google maven.
لاختبار تطبيقك عند استخدام "خدمات Google Play"، عليك استخدام أحد الخيارَين التاليَين:
- جهاز Android متوافق يعمل بنظام التشغيل Android 6.0 (المستوى 23 من واجهة برمجة التطبيقات) أو إصدار أحدث ومثبَّت عليه تطبيق "متجر Google Play"
- AVD
الإعلان عن البرامج الاعتمادية لـ "خدمات 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.4.0'
}
يتم بشكل دوري طرح إصدارات جديدة من حِزم SDK لـ "خدمات Google Play" تتضمّن إصلاحات للأخطاء وميزات جديدة. ويتم الإعلان عن هذه التحديثات في ملاحظات الإصدار. إذا كان تطبيقك يستخدم برنامجًا اعتماديًا تم تحديثه، غيِّر إلى أحدث إصدار في البرامج الاعتمادية لتطبيقك للاستفادة من هذه الإصلاحات.
التحقّق مما إذا كانت "خدمات Google Play" مثبَّتة
كما هو موضّح في نظرة عامة على "خدمات Google Play" ، يتم تلقائيًا تحديث "خدمات Google Play" على Android 6.0 (المستوى 23 من واجهة برمجة التطبيقات) والإصدارات الأحدث من خلال تطبيق "متجر Google Play". ومع ذلك، لا تتضمّن الأجهزة التي لا يتوفّر عليها متجر Google خدمات Google Play" مثبَّتة. إذا كان تطبيقك يعمل على أجهزة لا تتضمّن "خدمات Google Play"، عليك دائمًا التحقّق مما إذا كانت "خدمات Google Play" مثبَّتة قبل محاولة استخدام واجهات برمجة تطبيقات Google أو تفعيل الميزات التي تتطلبها.
للتحقّق من توفّر "خدمات Google Play" على الجهاز، استخدِم طريقة
isGooglePlayServicesAvailable().
لبدء اتصال بـ "خدمات Google Play" أو لمعرفة كيفية رصد ما إذا كان إصدار "خدمات Google Play" المثبَّت يتيح واجهة برمجة تطبيقات معيّنة، اطّلِع على الدليل حول الوصول إلى Google APIs.
البرامج الاعتمادية لـ "خدمات Google Play"
يسرد الجدول التالي البرامج الاعتمادية لـ "خدمات Google Play" التي يمكنك تضمينها في تطبيق Android. يمكنك فلترة القائمة حسب نوع الجهاز من خلال النقر على أحد الأزرار، ويمكنك البحث عن حالة استخدام أو اسم برنامج اعتمادي معيّن من خلال إدخال نص في المربّع الذي يظهر بعد الأزرار.
| حالة الاستخدام واسم البرنامج الاعتمادي | الأجهزة المعتمدة |
|---|---|
إعلانات Google على الأجهزة الجوّالةcom.google.android.gms:play-services-ads:25.4.0 |
الهاتف، الجهاز اللوحي |
المعرِّف الإعلاني على Android (AAID)com.google.android.gms:play-services-ads-identifier:18.3.0 |
الهاتف، الجهاز اللوحي، Android TV، ChromeOS |
الإصدار الخفيف من "إعلانات Google على الأجهزة الجوّالة"com.google.android.gms:play-services-ads-lite:25.3.0 |
الهاتف، الجهاز اللوحي |
إعلانات البحث المخصّصة (CSA) من "AdSense للبحث" (AFS)com.google.android.gms:play-services-afs-native:19.1.0 |
الهاتف، الجهاز اللوحي، ChromeOS |
حزمة تطوير البرامج (SDK) لخدمات "إحصاءات Google" لنظام التشغيل Androidcom.google.android.gms:play-services-analytics:18.1.1 |
تمّت إزالة هذا العمود. استخدِم "إحصاءات Google لـ Firebase" بدلاً من ذلك. |
فهرسة التطبيقاتcom.google.android.gms:play-services-appindex:16.2.0 |
الهاتف، الجهاز اللوحي، Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
الهاتف، الجهاز اللوحي، Android TV |
معرّف مجموعة تطبيقات Androidcom.google.android.gms:play-services-appset:16.1.0 |
الهاتف، الجهاز اللوحي، Android TV، ChromeOS |
تسجيل الدخول باستخدام حساب Google على Androidcom.google.android.gms:play-services-auth:21.6.0 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS |
SMS Retriever APIcom.google.android.gms:play-services-auth-api-phone:18.3.0 |
الهاتف، الجهاز اللوحي، Android Go |
Block Store API (يتضمّن وحدة تخزين بيانات الاعتماد)com.google.android.gms:play-services-auth-blockstore:16.4.0 |
الهاتف، الجهاز اللوحي، Android Go، ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:20.0.0 |
الهاتف، الجهاز اللوحي، Auto، Android Go، ChromeOS |
فئات الأدواتcom.google.android.gms:play-services-base:18.10.0 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
اختبار النماذج الوهمية لفئات الأدواتcom.google.android.gms:play-services-base-testing:16.2.0 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
المزيد من فئات الأدواتcom.google.android.gms:play-services-basement:18.10.0 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
تحسين الإضاءة المنخفضة في الكاميراcom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta08 |
الهاتف، الجهاز اللوحي |
Google Castcom.google.android.gms:play-services-cast:22.3.1 |
الهاتف، الجهاز اللوحي، Android Go، ChromeOS |
إطار عمل تطبيقات Google Cast (CAF)com.google.android.gms:play-services-cast-framework:22.3.1 |
الهاتف، الجهاز اللوحي، Android Go، ChromeOS |
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.1 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
التفاعلات بين الأجهزة (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 |
الهاتف، الجهاز اللوحي، Android Go |
Key Verifier SDKcom.google.android.gms:contactkeys:16.0.0 |
الهاتف، الجهاز اللوحي |
المصادقة السريعة على الإنترنت (FIDO)com.google.android.gms:play-services-fido:21.3.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.3.0 |
الهاتف، الجهاز اللوحي، Android Go، ChromeOS، Wear OS |
Fraud Protectcom.google.android.gms:play-services-fraudprotect:16.0.1 |
الهاتف، الجهاز اللوحي، Android Go |
الإصدار الثاني من "خدمات ألعاب Google Play" لنظام التشغيل Androidcom.google.android.gms:play-services-games-v2:21.0.0 |
الهاتف، الجهاز اللوحي، Android TV، Android Go، ChromeOS |
الإصدار الثاني من "خدمات ألعاب Google Play" لحزمة SDK الأصلية بلغة C لنظام التشغيل 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:25.0.0 |
تمّت إزالة هذا العمود. استخدِم الإصدار الثاني من "خدمات ألعاب Google Play" بدلاً من ذلك. |
Matter APIcom.google.android.gms:play-services-home:16.0.0 |
الهاتف، الجهاز اللوحي |
تطبيقات Google Play الفوريةcom.google.android.gms:play-services-instantapps:18.2.0 |
تمّت إزالة هذا العمود. مزيد من المعلومات عن تطبيقات Google Play الفورية |
خدمات الموقع الجغرافي لنظام التشغيل Androidcom.google.android.gms:play-services-location:21.4.0 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Androidcom.google.android.gms:play-services-maps:20.0.0 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
Google Maps 3D SDK لنظام التشغيل Androidcom.google.android.gms:play-services-maps3d:0.2.0 |
الهاتف، الجهاز اللوحي |
تحسين تأثيرات الوسائطcom.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta06 |
الهاتف، الجهاز اللوحي |
مسح الرموز الشريطية ضوئيًا باستخدام حزمة تعلّم الآلة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 |
الهاتف، الجهاز اللوحي، 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.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 |
التعرّف على النص باللغة اليابانية من حزمة تعلّم الآلةcom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 |
الهاتف، الجهاز اللوحي، Android Go، ChromeOS |
التعرّف على النص باللغة الكورية من حزمة تعلّم الآلة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.5.1 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS متوافقة مع الأجهزة التي تعمل بنظام التشغيل Android 5.0 (مستوى واجهة برمجة التطبيقات 21) أو إصدار أحدث |
Programmatic Access Libraries (PAL)com.google.android.gms:play-services-pal:23.0.0 |
الهاتف، الجهاز اللوحي، Android TV متوافقة مع الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 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 Passes)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 APIs (تتضمّن التصفّح الآمن والتحقّق من التطبيقات)com.google.android.gms:play-services-safetynet:18.1.0 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS |
Google Tag Managercom.google.android.gms:play-services-tagmanager:18.3.0 |
الهاتف، الجهاز اللوحي، Android TV، Android Go، ChromeOS |
Tasks API على Androidcom.google.android.gms:play-services-tasks:18.4.1 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |
Acceleration Service لنظام التشغيل Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02 |
الهاتف، الجهاز اللوحي، Android Go، ChromeOS |
TensorFlow Lite GPU Delegate API لـ "خدمات Google Play"com.google.android.gms:play-services-tflite-gpu:16.5.0 |
الهاتف، الجهاز اللوحي، Android Go، ChromeOS |
TensorFlow Lite Java API لـ "خدمات Google Play"com.google.android.gms:play-services-tflite-java:16.5.0 |
الهاتف، الجهاز اللوحي، Android Go، ChromeOS |
TensorFlow Lite Support API لـ "خدمات Google Play"com.google.android.gms:play-services-tflite-support:16.5.0 |
الهاتف، الجهاز اللوحي، Android Go، ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.3.0 |
الهاتف، الجهاز اللوحي |
Trusted Time APIcom.google.android.gms:play-services-time:16.0.1 |
الهاتف، الجهاز اللوحي، Auto، Android Go، Wear OS |
Mobile Visioncom.google.android.gms:play-services-vision:20.1.3 |
الهاتف، الجهاز اللوحي، Android Go، ChromeOS |
Google Pay للدفعات على Androidcom.google.android.gms:play-services-wallet:20.0.0 |
الهاتف، الجهاز اللوحي، Auto، Android Go، ChromeOS، Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:20.0.1 |
الهاتف، الجهاز اللوحي، Wear OS |
مكوّنات Gradle الإضافية
تتضمّن "خدمات Google Play" أيضًا العديد من مكوّنات Gradle الإضافية، كما هو موضّح في الجدول التالي. يُرجى العِلم أنّ الأزرار التي تظهر قبل الجدول السابق لا تغيِّر المعلومات التي تظهر في هذا الجدول.
| حالة الاستخدام واسم مكوّن Gradle الإضافي | الأجهزة المعتمدة |
|---|---|
عرض تراخيص البرامج المفتوحة المصدرcom.google.android.gms:oss-licenses-plugin:0.12.0 |
الهاتف، الجهاز اللوحي، ChromeOS |
التحقّق الدقيق من الإصدارcom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
الهاتف، الجهاز اللوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS |