使用 Android 適用的 Cast 應用程式架構 (CAF) 進行開發的設定

Android Studio

如要讓應用程式使用 Google Play 服務 API，請按照下列步驟操作：

1. 開啟應用程式模組目錄中的 build.gradle 檔案。

   注意：Android Studio 專案包含頂層 build.gradle 檔案，以及每個模組的 build.gradle 檔案。請務必編輯應用程式模組的檔案。如要進一步瞭解 Gradle，請參閱「 使用 Gradle 建構專案」。

2. 確認 google() 已納入 repositories 清單。

   repositories {
       google()
   }

3. 針對最新版的 play-services，在 dependencies 下方新增建構規則。例如：

   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 服務時更新這個版本號碼。

   注意：如果應用程式中的方法參照數量超過 65K 上限，應用程式可能無法編譯。您可以在編譯應用程式時，只指定應用程式使用的特定 Google Play 服務 API，而非所有 API，藉此減輕這項問題。如要瞭解如何執行此操作，請參閱「選擇性地將 API 編譯至可執行檔」。

4. 儲存變更內容，然後在工具列中按一下「Sync Project with Gradle Files」。

其他 IDE

如要讓應用程式使用 Google Play 服務 API，請按照下列步驟操作：

1. 將 <android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/ 中的程式庫專案複製到您維護 Android 應用程式專案的位置。
2. 在應用程式專案中參照 Google Play 服務程式庫專案。如要進一步瞭解如何執行這項操作，請參閱「 在指令列中參照程式庫專案」。

   注意：您應參照複製到開發工作區的程式庫副本，請勿直接從 Android SDK 目錄參照程式庫。

3. 將 Google Play 服務程式庫新增為應用程式專案的依附元件後，請開啟應用程式的資訊清單檔案，並將下列標記新增為 <application> 元素的子項：

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

設定專案以參照程式庫專案後，您就可以開始使用 Google Play 服務 API 開發功能。

建立 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