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

必要條件

Google Cast SDK for Android 是 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. 針對最新版的 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.0.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