必要條件
- 使用 Android SDK Manager 安裝最新版的 Android SDK。
- 透過 Android SDK Manager 安裝最新版的 appcompat 和 mediarouter AndroidX 程式庫。
- 透過 Android SDK Manager 安裝最新的 Google Play 服務中的 Cast SDK。
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,請按照下列步驟操作:
- 開啟應用程式模組目錄中的
build.gradle
檔案。注意:Android Studio 專案包含頂層
build.gradle
檔案,以及每個模組的build.gradle
檔案。請務必編輯應用程式模組的檔案。如要進一步瞭解 Gradle,請參閱「 使用 Gradle 建構專案」。 - 確認
google()
已納入repositories
清單。repositories {
- 針對最新版的
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 編譯至可執行檔」。
- 儲存變更內容,然後按一下工具列中的「Sync Project with Gradle Files」。
其他 IDE
如要讓應用程式使用 Google Play 服務 API,請按照下列步驟操作:
- 將
<android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/
中的程式庫專案複製到您維護 Android 應用程式專案的位置。 - 在應用程式專案中參照 Google Play 服務程式庫專案。如要進一步瞭解如何執行這項操作,請參閱「
在指令列中參照程式庫專案」。
注意:您應參照複製到開發工作區的程式庫副本,請勿直接從 Android SDK 目錄參照程式庫。
- 將 Google Play 服務程式庫新增為應用程式專案的依附元件後,請開啟應用程式的資訊清單檔案,並將下列標記新增為
<application>
元素的子項:<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />
設定專案以參照程式庫專案後,您就可以開始使用 Google Play 服務 API 開發功能。
建立 Proguard 例外狀況
為避免 ProGuard 移除必要的類別,請在
檔案中加入下列行:
-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