إعداد التطوير باستخدام إطار عمل تطبيق Cast (CAF) لنظام التشغيل Android

استوديو Android

لإتاحة واجهات برمجة التطبيقات الخاصة بـ "خدمات Google Play" لتطبيقك، اتّبِع الخطوات التالية:

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

   ملاحظة: تحتوي مشاريع "استوديو Android" على ملف build.gradle من المستوى الأعلى وملف build.gradle لكل وحدة. احرص على تعديل الملف الخاص بوحدة تطبيقك. لمزيد من المعلومات حول Gradle، راجِع مقالة إنشاء مشروعك باستخدام Gradle.

2. تأكَّد من تضمين google() في repositories المُدرَجة.

   repositories {
       google()
   }

3. أضِف قاعدة إنشاء جديدة ضمن dependencies لأحدث إصدار من play-services. على سبيل المثال:

   apply plugin: 'com.android.application'
       ...
   
       dependencies {
           implementation 'androidx.appcompat:appcompat:1.3.1'
           implementation 'androidx.mediarouter:mediarouter:1.2.5'
           implementation 'com.google.android.gms:play-services-cast-framework:22.1.0'
       }

   احرص على تعديل رقم الإصدار هذا في كل مرة يتم فيها تعديل "خدمات Google Play".

   ملاحظة: إذا تجاوز عدد مراجع الطرق في تطبيقك الحدّ الأقصى البالغ 65 ألفًا، قد يتعذّر تجميع تطبيقك. يمكنك الحدّ من هذه المشكلة عند تجميع تطبيقك من خلال تحديد واجهات برمجة التطبيقات المحدّدة فقط التي يستخدمها تطبيقك من "خدمات Google Play"، بدلاً من تحديد جميعها. للحصول على معلومات حول كيفية إجراء ذلك، يُرجى الاطّلاع على تجميع واجهات برمجة التطبيقات بشكل انتقائي في الملف التنفيذي.

4. احفظ التغييرات وانقر على مزامنة المشروع مع ملفات Gradle في شريط الأدوات.

بيئة تطوير متكاملة أخرى

لإتاحة واجهات برمجة التطبيقات الخاصة بـ "خدمات Google Play" لتطبيقك، اتّبِع الخطوات التالية:

1. انسخ مشروع المكتبة من <android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/ إلى الموقع الذي تحتفظ فيه بمشاريع تطبيقات Android.
2. في مشروع تطبيقك، أشر إلى مشروع مكتبة "خدمات Google Play". لمزيد من المعلومات حول كيفية إجراء ذلك، يُرجى الاطّلاع على الإشارة إلى "مشروع مكتبة" في سطر الأوامر.

   ملاحظة: يجب الرجوع إلى نسخة من المكتبة التي نسختها إلى مساحة عمل التطوير، وليس إلى المكتبة مباشرةً من دليل حزمة تطوير البرامج (SDK) لنظام Android.

3. بعد إضافة مكتبة "خدمات Google Play" كعنصر تابع لمشروع تطبيقك، افتح ملف البيان الخاص بتطبيقك وأضِف العلامة التالية كعنصر تابع للعنصر <application>:

   <meta-data android:name="com.google.android.gms.version"
       android:value="@integer/google_play_services_version" />

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

إنشاء استثناء Proguard

لمنع ProGuard من إزالة الفئات المطلوبة، أضِف الأسطر التالية في ملف /proguard-project.txt:

-keep public class com.google.android.gms.common.internal.safeparcel.SafeParcelable {
    public static final *** NULL;
}

-keepnames class * implements android.os.Parcelable
-keepclassmembers class * implements android.os.Parcelable {
  public static final *** CREATOR;
}

-keep @interface android.support.annotation.Keep
-keep @android.support.annotation.Keep class *
-keepclasseswithmembers class * {
  @android.support.annotation.Keep <fields>;
}
-keepclasseswithmembers class * {
  @android.support.annotation.Keep <methods>;
}

-keep @interface com.google.android.gms.common.annotation.KeepName
-keepnames @com.google.android.gms.common.annotation.KeepName class *
-keepclassmembernames class * {
  @com.google.android.gms.common.annotation.KeepName *;
}

-keep @interface com.google.android.gms.common.util.DynamiteApi
-keep public @com.google.android.gms.common.util.DynamiteApi class * {
  public <fields>;
  public <methods>;
}

-dontwarn android.security.NetworkSecurityPolicy