إعداد "خدمات Google Play"

لتطوير تطبيق باستخدام واجهات برمجة تطبيقات "خدمات Google Play"، اتّبِع التعليمات الواردة في هذه الصفحة لإعداد مشروعك باستخدام حِزم SDK ذات الصلة، والتي تتوفّر من مستودع Google maven.

لاختبار تطبيقك عند استخدام "خدمات Google Play"، عليك استخدام أحد الخيارَين التاليَين:

جهاز Android متوافق يعمل بنظام التشغيل Android 6.0 (المستوى 23 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث ومثبَّت عليه تطبيق "متجر Google Play"
AVD

الإعلان عن البرامج الاعتمادية لخدمات Google Play

لتطوير ميزات تعتمد على واجهات برمجة تطبيقات "خدمات Google Play" في تطبيقك، أكمل الخطوات التالية:

افتح ملف build.gradle داخل دليل وحدة تطبيقك.

ملاحظة: تحتوي مشاريع "استوديو Android" على ملف build.gradle ذي مستوى أعلى وملف build.gradle لكل وحدة. احرص على تعديل الملف الخاص بوحدة تطبيقك. مزيد من المعلومات حول إنشاء مشروعك باستخدام 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. يمكنك فلترة القائمة حسب نوع الجهاز من خلال النقر على أحد الأزرار، ويمكنك البحث عن حالة استخدام معيّنة أو اسم برنامج اعتمادي معيّن من خلال إدخال نص في المربّع الذي يظهر بعد الأزرار.

**الجدول 1.** البرامج الاعتمادية لخدمات Google Play التي يجب تضمينها في تطبيقات Android
حالة الاستخدام واسم البرنامج الاعتمادي	الأجهزة المعتمدة
‫إعلانات Google على الأجهزة الجوّالة `com.google.android.gms:play-services-ads:25.1.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" على Android `com.google.android.gms:play-services-analytics:18.1.1`	تمّ إيقاف هذه الخدمة نهائيًا. استخدِم إحصاءات Google لـ Firebase بدلاً من ذلك.
فهرسة التطبيقات `com.google.android.gms:play-services-appindex:16.2.0`	هاتف، جهاز لوحي، Android TV
AppSearch `com.google.android.gms:play-services-appsearch:16.0.1`	هاتف، جهاز لوحي، Android TV
رقم تعريف مجموعة تطبيقات Android `com.google.android.gms:play-services-appset:16.1.0`	هاتف، جهاز لوحي، Android TV، ChromeOS
تسجيل الدخول باستخدام حساب Google على Android `com.google.android.gms:play-services-auth:21.5.1`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS
‫SMS Retriever API `com.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 API `com.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 Cast `com.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 Scanner `com.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 SDK `com.google.android.gms:contactkeys:16.0.0`	هاتف، جهاز لوحي
المصادقة على الهوية السريعة على الإنترنت (FIDO) `com.google.android.gms:play-services-fido:21.2.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
الإصدار الثاني من "خدمات ألعاب Google Play" لنظام التشغيل Android `com.google.android.gms:play-services-games-v2:21.0.0`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
الإصدار الثاني من "خدمات ألعاب Google Play" لحزمة تطوير البرامج (SDK) الأصلية بلغة C لنظام التشغيل Android `com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
الإصدار الأول من "خدمات ألعاب Google Play" لنظام التشغيل Android `com.google.android.gms:play-services-games:24.0.0`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
‫Matter API `com.google.android.gms:play-services-home:16.0.0`	هاتف، جهاز لوحي
تطبيقات Google Play الفورية `com.google.android.gms:play-services-instantapps:18.2.0`	تمّ إيقاف هذه الخدمة نهائيًا. مزيد من المعلومات في تطبيقات Google Play الفورية
خدمات الموقع الجغرافي لنظام التشغيل Android `com.google.android.gms:play-services-location:21.3.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
‫حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android `com.google.android.gms:play-services-maps:20.0.0`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
‫Google Maps 3D SDK لنظام التشغيل Android `com.google.android.gms:play-services-maps3d:0.2.0`	هاتف، جهاز لوحي
تحسين تأثيرات الوسائط `com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta03`	هاتف، جهاز لوحي
مسح الرموز الشريطية ضوئيًا باستخدام حزمة تعلّم الآلة `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.0`	هاتف، جهاز لوحي، 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 Manager `com.google.android.gms:play-services-tagmanager:18.3.0`	هاتف، جهاز لوحي، Android TV، Android Go، ChromeOS
‫Tasks API على Android `com.google.android.gms:play-services-tasks:18.4.1`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS
‫Acceleration Service لنظام التشغيل Android `com.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01`	هاتف، جهاز لوحي، Android Go، ChromeOS
‫TensorFlow Lite GPU Delegate API لخدمات Google Play `com.google.android.gms:play-services-tflite-gpu:16.4.0`	هاتف، جهاز لوحي، Android Go، ChromeOS
‫TensorFlow Lite Java API لخدمات Google Play `com.google.android.gms:play-services-tflite-java:16.4.0`	هاتف، جهاز لوحي، Android Go، ChromeOS
‫TensorFlow Lite Support API لخدمات Google Play `com.google.android.gms:play-services-tflite-support:16.4.0`	هاتف، جهاز لوحي، Android Go، ChromeOS
‫Thread Network API `com.google.android.gms:play-services-threadnetwork:16.3.0`	هاتف، جهاز لوحي
‫Trusted Time API `com.google.android.gms:play-services-time:16.0.1`	هاتف، جهاز لوحي، Auto، Android Go، Wear OS
‫Mobile Vision `com.google.android.gms:play-services-vision:20.1.3`	هاتف، جهاز لوحي، Android Go، ChromeOS
‫Google Pay للدفعات على Android `com.google.android.gms:play-services-wallet:19.5.0`	هاتف، جهاز لوحي، Auto، Android Go، ChromeOS، Wear OS
‫Wearable Data Layer API `com.google.android.gms:play-services-wearable:19.0.0`	هاتف، جهاز لوحي، Wear OS

مكوّنات Gradle الإضافية

تتضمّن "خدمات Google Play" أيضًا العديد من مكوّنات Gradle الإضافية، كما هو موضّح في الجدول التالي. يُرجى العِلم أنّ الأزرار التي تظهر قبل الجدول السابق لا تغيِّر المعلومات التي تظهر في هذا الجدول.

**الجدول 2.** قائمة بمكوّنات Gradle الإضافية المضمّنة في "خدمات Google Play" services
حالة الاستخدام واسم مكوّن Gradle الإضافي	الأجهزة المعتمدة
عرض تراخيص البرامج المفتوحة المصدر `com.google.android.gms:oss-licenses-plugin:0.11.0`	هاتف، جهاز لوحي، ChromeOS
التحقّق الدقيق من الإصدار `com.google.android.gms:strict-version-matcher-plugin:1.2.4`	هاتف، جهاز لوحي، Android TV، Auto، Android Go، ChromeOS، Wear OS