將 app bundle 版本分發給測試人員 - Codelab

一、概述

在此 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項目

1. 登錄到Firebase 。
2. 在 Firebase 控制台中，點擊添加項目，然後將您的項目命名為“AppBundlesCodelab”。記住您的 Firebase 項目的項目 ID。如果您不編輯項目 ID，Firebase 會自動為您的項目分配一個唯一 ID。
   
   
3. （可選）出現提示時，啟用 Google Analytics。
4. 完成剩餘的步驟，然後單擊創建項目。

將您的應用程序包添加到項目中

1. 在 Firebase 控制台中，單擊添加應用程序。
   
   
2. 註冊您的應用程序時，請確保使用與上傳到您的 Google Play 開發者帳戶的應用程序相同的程序包名稱。最後，點擊Register app 。
3. 完成其餘步驟，將您應用的 Firebase 配置文件 ( google-services.json ) 添加到您的應用中。請注意，對於 Android，App Distribution 沒有可添加到您的應用程序的 Firebase SDK。
4. 單擊繼續控制台。

鏈接到 Google Play

1. 在 Firebase 控制台中，轉到您的項目設置。
   
   
2. 在集成選項卡中，單擊Google Play卡片上的鏈接。
3. 按照屏幕上的說明啟用 App Distribution 集成，然後選擇您新創建的 Firebase 應用程序以鏈接到 Google Play。

現在您已經完成了這些步驟，只要應用程序包名稱匹配，您的 Firebase 應用程序就會鏈接到您的 Google Play 開發者帳戶中的應用程序。

3. 將 App Distribution 添加到您的項目中

添加 App Distribution Gradle 插件

現在，您將使用 Android Studio 將 App Distribution 及其 Gradle 插件添加到您的應用中。

1. 在您的項目級 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
   }
   

2. 在您的項目級設置 Gradle 文件 ( android/settings.gradle.kts ) 中，將 Google 的 Maven 存儲庫添加到pluginManagement塊。

    pluginManagement {
        // Check that you have Google's Maven repository (if not, add it).
        repositories {
            google()
            mavenCentral()
        }
    }
   

3. 在您的應用級 Gradle 文件 ( android/app/build.gradle.kts ) 中，將 App Distribution 插件添加到plugins塊。

   plugins {
        //...
   
        // Add the App Distribution plugin
        id("com.google.firebase.appdistribution")
   }
   

4. 如果您在公司代理或防火牆後面，請添加以下 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 中配置你的 bundle 屬性

在此步驟中，您將自己添加為稍後將分發的構建的測試員。分發構建後，測試人員會收到來自 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. 構建和分發版本

1. 運行bundle Variant Gradle 任務來構建您的應用程序包文件：

   $ ./gradlew :base:bundleRelease
   

2. 在應用程序的構建目錄中找到包（默認位置是app/build/outputs/bundle/release ）。
3. 要分發版本，請使用項目的 Gradle 包裝器構建目標bundleRelease和appDistributionUploadRelease 。包括 Firebase 令牌（您在第 3 步中收到的令牌：將 App Distribution 添加到您的應用程序）。

   export FIREBASE_TOKEN=your_firebase_token
   
   ./gradlew --stop // Only needed for environment variable changes
   
   ./gradlew bundleRelease appDistributionUploadRelease
   

測試人員現在將收到下載和測試構建的電子郵件邀請。作為開發人員，您現在可以在 App Distribution 儀表板的Releases選項卡中監控構建。

6. 下載並測試您的版本

在本節中，您將被設置為測試人員，以便下載您分發的版本。作為測試人員，您需要驗證您的測試設備並在 Google Play 商店應用中啟用內部應用共享。

1. 在您的測試設備上，登錄到您的測試人員電子郵件帳戶並打開來自 Firebase 的邀請。
   
   
2. 使用您的 Google 帳戶登錄並接受測試分佈式版本的邀請。作為一個選項，您還可以下載Firebase App Tester ，它可以防止下載的版本被添加到您設備的Downloads文件夾中。它還會顯示有關發布的其他信息，例如下載進度和發布版本。
   
   
3. 點擊版本上的下載以從 Play 商店安裝它。
4. 出現提示時，完成剩餘步驟以啟用內部應用程序共享（說明顯示在您的測試設備上，只需完成一次）。

下載完成後，您的版本將自動顯示為設備主屏幕中的快捷方式。

7. 恭喜！

您剛剛使用 Firebase App Distribution 上傳了一個應用程序包並向測試人員分發了一個版本。

下一步

• 前往App Distribution 文檔，了解有關如何管理您的版本的測試人員的更多信息。
• 有關可用於部署應用的其他工具的信息，請參閱構建和測試您的 Android App Bundle 。