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

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

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

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

الإفصاح عن التبعيات لخدمة "خدمات Google Play"

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

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

2. يجب تضمين الملحقات لكل حزمة SDK يتطلّبها تطبيقك. تتضمّن هذه الصفحة قسمًا يسرد التبعيات المشترَكة لخدمات Google Play لتطبيقات Android. ننصحك أيضًا بإضافة متطلّبات Firebase إلى مشروعك.

3. احفظ التغييرات وزامِن مشروعك.

يعرض المقتطف التالي مثالاً على ملف build.gradle يستخدم مكتبة location:

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" تحديثات تلقائية على الإصدار 6.0 من Android (المستوى 23 من واجهة برمجة التطبيقات) والإصدارات الأحدث من خلال تطبيق "متجر Google Play". ومع ذلك، لا يتم تثبيت "خدمات Google Play" على أجهزة Android التي لا تتضمّن "متجر Google Play". إذا كان تطبيقك يعمل على الأجهزة بدون "خدمات Google Play"، ننصحك بالتحقّق ممّا إذا كانت "خدمات Google Play" مثبّتة على الجهاز قبل محاولة استخدام واجهات برمجة تطبيقات Google، أو تفعيل الميزات في تطبيقك التي تتطلّب "خدمات Google Play" لكي تعمل.

للتحقّق من توفّر "خدمات Google Play" على الجهاز، استخدِم الخطوات التالية: isGooglePlayServicesAvailable().

لبدء الاتصال بـ "خدمات Google Play" أو معرفة كيفية رصد ما إذا كان إصدار "خدمات Google Play" المثبَّت يتيح استخدام واجهة برمجة تطبيقات معيّنة، اطّلِع على الدليل حول الوصول إلى Google APIs.

متطلّبات "خدمات Google Play"

يسرد الجدول التالي التبعيات لخدمات Google Play التي يمكنك إدراجها في تطبيق Android. يمكنك فلترة القائمة حسب نوع الجهاز من خلال اختيار أحد الأزرار، ويمكنك البحث عن حالة استخدام معيّنة أو اسم تبعية معيّن عن طريق إدخال نص في المربّع الذي يظهر بعد الأزرار.

الهواتف والأجهزة اللوحية Android TV Auto Android Go ChromeOS Wear OS

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

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