使用 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:21.5.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