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

必要條件

Android 版 Google Cast SDK 是 Google Play 服務 SDK 的一部分,不需要另外下載。

注意:Google Play 服務可讓您使用多種 API,以便建立廣告、收集資料、驗證使用者、整合地圖等。詳情請參閱「Google Play 服務總覽」。請務必確保使用者的裝置已安裝正確的 Google Play 服務 APK,因為更新可能無法立即觸及所有使用者。

將 Google Play 服務新增至專案

請在下方選取您的開發環境,並按照提供的步驟將 Google Play 服務新增至您的專案。

Android Studio

如何為應用程式提供 Google Play 服務 API:

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

    注意:Android Studio 專案包含一個頂層 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:21.4.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