لتطوير تطبيق باستخدام واجهات برمجة تطبيقات "خدمات 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.3.0'
}
يتم بشكل دوري طرح إصدارات جديدة من حِزم SDK لـ "خدمات Google Play" تتضمّن إصلاحات للأخطاء وميزات جديدة. ويتم الإعلان عن هذه التحديثات في ملاحظات الإصدار. إذا كان تطبيقك يستخدم برنامجًا اعتماديًا تم تحديثه، غيِّر إلى أحدث إصدار في البرامج الاعتمادية لتطبيقك للاستفادة من هذه الإصلاحات.
التحقّق مما إذا كانت "خدمات Google Play" مثبَّتة
كما هو موضّح في نظرة عامة على "خدمات Google Play" ، يتم تلقائيًا تحديث "خدمات Google Play" على Android 6.0 (المستوى 23 من واجهة برمجة التطبيقات) والإصدارات الأحدث من خلال تطبيق "متجر Google Play". ومع ذلك، لا تتضمّن الأجهزة التي لا يتوفّر عليها "متجر Google Play" "خدمات Google Play". إذا كان تطبيقك يعمل على أجهزة لا تتضمّن "خدمات Google Play"، عليك دائمًا التحقّق مما إذا كانت "خدمات Google Play" مثبَّتة قبل محاولة استخدام واجهات برمجة تطبيقات Google أو تفعيل الميزات التي تتطلبها.
للتحقّق من توفّر "خدمات Google Play" على الجهاز، استخدِم طريقة
isGooglePlayServicesAvailable().
لبدء اتصال بـ "خدمات Google Play" أو لمعرفة كيفية رصد ما إذا كان إصدار "خدمات Google Play" المثبَّت يتيح استخدام واجهة برمجة تطبيقات معيّنة، اطّلِع على دليل الوصول إلى واجهات برمجة تطبيقات Google.
البرامج الاعتمادية لـ "خدمات Google Play"
يسرد الجدول التالي البرامج الاعتمادية لـ "خدمات Google Play" التي يمكنك تضمينها في تطبيق Android. يمكنك فلترة القائمة حسب نوع الجهاز من خلال النقر على أحد الأزرار، ويمكنك البحث عن حالة استخدام أو اسم برنامج اعتمادي معيّن من خلال إدخال نص في المربّع الذي يظهر بعد الأزرار.
| حالة الاستخدام واسم البرنامج الاعتمادي | الأجهزة المعتمدة |
|---|---|
إعلانات Google على الأجهزة الجوّالةcom.google.android.gms:play-services-ads:25.2.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:24.8.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.5.1 |
هاتف، جهاز لوحي، 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-beta07 |
هاتف، جهاز لوحي |
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.0 |
هاتف، جهاز لوحي، 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:24.0.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.2.0 |
تمّت إزالة هذا العمود. مزيد من المعلومات عن تطبيقات Google Play الفورية |
خدمات الموقع الجغرافي لنظام التشغيل 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: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-beta04 |
هاتف، جهاز لوحي |
مسح الرموز الشريطية ضوئيًا باستخدام حزمة تعلّم الآلة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 |