1. 概述
在此 Codelab 中,您將了解如何使用 Firebase App Distribution 及其 Gradle 插件向測試人員分發 Android App Bundle 版本。 App Distribution 為您提供了一個中央樞紐,用於管理應用程序的預發布版本以及您邀請的每個版本的測試人員。
你將學到什麼
- 如何將您的 Firebase 應用關聯到 Google Play
- 如何將應用程序打包並構建為應用程序包
- 如何創建版本並與現場測試人員共享
- 作為測試人員如何下載和測試新版本
你需要什麼
- 最新的Android Studio版本
- 您從 Android Studio 生成的簽名包文件
- 您是所有者或管理員的 Google Play 開發者帳戶
- 您在 Google Play 中的應用程序已在 Google Play 應用程序儀表板上設置,並且具有以下狀態:
- 該應用程序被分發到 Google Play 軌道之一(內部測試、封閉測試、開放測試或生產)。
- 該應用在 Google Play 中的審核已完成並已發布。如果應用程序狀態列顯示以下狀態之一,則您的應用程序已發布:內部測試(不是草稿內部測試)、封閉測試、開放測試或生產。
- 您可以用作測試人員的電子郵件地址,用於接收來自 Firebase 的新構建邀請
2. 創建 Firebase 項目
- 登錄Firebase 。
- 在 Firebase 控制台中,點擊添加項目,然後將您的項目命名為“AppBundlesCodelab”。請記住您的 Firebase 項目的項目 ID。如果您不編輯項目 ID,Firebase 會自動為您的項目分配一個唯一 ID。
- (可選)出現提示時,啟用 Google Analytics。
- 完成其餘步驟,然後單擊“創建項目” 。
將您的應用程序包添加到項目中
- 在 Firebase 控制台中,點擊添加應用。
- 註冊您的應用時,請確保使用與上傳到您的 Google Play 開發者帳戶的應用相同的包名稱。最後,單擊註冊應用程序。
- 完成其餘步驟,將應用的 Firebase 配置文件 (
google-services.json
) 添加到您的應用。請注意,對於 Android,App Distribution 沒有可添加到您的應用中的 Firebase SDK。 - 單擊繼續控制台。
鏈接到 Google Play
- 在 Firebase 控制台中,轉到您的項目設置。
- 在集成選項卡中,單擊Google Play卡上的鏈接。
- 按照屏幕上的說明啟用應用程序分發集成,然後選擇新創建的 Firebase 應用程序以鏈接到 Google Play。
現在您已完成這些步驟,只要應用程序包名稱匹配,您的 Firebase 應用程序就會鏈接到 Google Play 開發者帳戶中的應用程序。
3. 將 App Distribution 添加到您的項目中
添加 App Distribution Gradle 插件
現在,您將使用 Android Studio 將 App Distribution 及其 Gradle 插件添加到您的應用程序中。
- 在項目級 Gradle 文件 (
android/build.gradle.kts
) 中,將 App Distribution Gradle 插件添加到plugins
塊中。plugins { //... // Add the App Distribution Gradle plugin id("com.google.firebase.appdistribution") version "4.0.0" apply false }
- 在項目級設置 Gradle 文件 (
android/settings.gradle.kts
) 中,將 Google 的 Maven 存儲庫添加到pluginManagement
塊中。pluginManagement { // Check that you have Google's Maven repository (if not, add it). repositories { google() mavenCentral() } }
- 在應用程序級 Gradle 文件 (
android/app/build.gradle.kts
) 中,將 App Distribution 插件添加到plugins
塊中。plugins { //... // Add the App Distribution plugin id("com.google.firebase.appdistribution") }
- 如果您位於公司代理或防火牆後面,請添加以下 Java 系統屬性,使 App Distribution 能夠將您的發行版上傳到 Firebase:
-Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
驗證您的 Firebase 項目
在使用 Gradle 插件之前,您需要對 Firebase 項目進行身份驗證。在此 Codelab 中,您將使用Firebase CLI登錄您的 Google 帳戶。
在 Android 項目的根目錄運行以下命令:
~/your-android-project$ firebase login
參考文檔包含更多詳細信息。
4. 在 Android Studio 中配置您的包屬性
在此步驟中,您將把自己添加為稍後將分發的構建的測試人員。分發構建後,測試人員會收到來自 Firebase 的電子郵件通知,邀請他們測試新構建。
在您的app/build.gradle.kts
中,添加firebaseAppDistribution
部分並包含以下參數:
-
appID
:您應用的 Firebase 應用 ID。您可以在項目設置的“常規”選項卡中找到它。 -
artifactType
:您的應用程序的文件類型 (AAB
)。 -
testers
:您的測試人員的電子郵件地址。對於此 Codelab,請添加您自己的電子郵件,以便您可以在分發構建後對其進行測試。
例如:
android {
// ...
buildTypes {
getByName("release") {
firebaseAppDistribution {
appId = "yourAppId"
artifactType = "AAB"
testers = "ali@example.com, bri@example.com, cal@example.com"
}
}
}
// ...
}
作為一個選項,您還可以通過以-PappDistribution- property-name = property-value
的形式傳遞命令行參數來覆蓋build.gradle.kts
中設置的值。
5. 構建並分發版本
- 運行
bundle Variant
Gradle任務來構建您的應用程序包文件:$ ./gradlew :base:bundleRelease
- 在應用程序的構建目錄中找到該包(默認位置是
app/build/outputs/bundle/release
)。 - 要分發版本,請使用項目的 Gradle 包裝器構建目標
bundleRelease
和appDistributionUploadRelease
。包含 Firebase 令牌(您在第 3 步:將應用程序分發添加到您的應用中收到的令牌)。export FIREBASE_TOKEN=your_firebase_token ./gradlew --stop // Only needed for environment variable changes ./gradlew bundleRelease appDistributionUploadRelease
測試人員現在將收到下載和測試構建的電子郵件邀請。作為開發人員,您現在可以在應用程序分發儀表板的“發布”選項卡中監視構建。
6. 下載並測試您的版本
在本部分中,您將被設置為測試人員,以便下載您分發的版本。作為測試人員,您需要驗證您的測試設備並在 Google Play 商店應用中啟用內部應用共享。
- 在您的測試設備上,登錄您的測試人員電子郵件帳戶並打開來自 Firebase 的邀請。
- 使用您的 Google 帳戶登錄並接受測試分佈式版本的邀請。作為一個選項,您還可以下載Firebase App Tester ,它可以防止將下載的版本添加到您設備的
Downloads
文件夾中。它還顯示有關版本的其他信息,例如下載進度和版本。 - 點擊版本上的“下載”以從 Play 商店安裝它。
- 出現提示時,完成其餘步驟以啟用內部應用程序共享(說明將顯示在您的測試設備上,只需完成一次)。
下載完成後,您的版本將自動作為快捷方式顯示在設備的主屏幕中。
7. 恭喜!
您剛剛使用 Firebase App Distribution 上傳應用程序包並將版本分發給測試人員。
下一步
- 請參閱應用程序分發文檔,了解有關如何管理您的版本的測試人員的更多信息。
- 有關可用於部署應用程序的其他工具的信息,請參閱構建和測試您的 Android App Bundle 。