將應用程式包版本分發給測試人員 - Codelab

1. 概述

圖片10.png

在此 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。

    圖片8.png
  3. (可選)出現提示時,啟用 Google Analytics。
  4. 完成其餘步驟,然後按一下「建立專案」

將您的應用程式套件新增至專案中

  1. 在 Firebase 控制台中,點擊新增應用程式

    圖片5.png
  2. 註冊您的應用程式時,請確保使用與上傳到您的 Google Play 開發者帳戶的應用程式相同的套件名稱最後,點擊註冊應用程式
  3. 完成其餘步驟,將套用的 Firebase 設定檔 ( google-services.json ) 新增至您的應用程式。請注意,對於 Android,App Distribution 沒有可新增至您的應用程式中的 Firebase SDK。
  4. 按一下繼續控制台
  1. 在 Firebase 控制台中,前往您的專案設定

    圖片2.png
  2. 整合標籤中,按一下Google Play卡上的連結
  3. 按照螢幕上的指示啟用應用程式分發集成,然後選擇新建立的 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 中設定您的套件屬性

在此步驟中,您將把自己加入為稍後將分發的建置的測試人員。分發建置後,測試人員會收到來自 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 包裝器建立目標bundleReleaseappDistributionUploadRelease 。包含 Firebase 令牌(您在第 3 步:將應用程式分發新增至您的應用程式中收到的令牌)。
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

測試人員現在將收到下載和測試建置的電子郵件邀請。作為開發人員,您現在可以在應用程式分發儀表板的「發布」標籤中監視建置。

6. 下載並測試您的版本

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

  1. 在您的測試裝置上,登入您的測試人員電子郵件帳戶並開啟來自 Firebase 的邀請。

    圖6.png
  2. 使用您的 Google 帳戶登入並接受測試分散式版本的邀請。作為一個選項,您也可以下載Firebase App Tester ,它可以防止將下載的版本新增到您裝置的Downloads資料夾中。它還顯示有關版本的其他信息,例如下載進度和版本。

    圖片9.png
  3. 點擊版本上的「下載」以從 Play 商店安裝它。
  4. 出現提示時,完成其餘步驟以啟用內部應用程式共用(說明將顯示在您的測試裝置上,只需完成一次)。

下載完成後,您的版本將自動以捷徑顯示在裝置的主畫面中。

7. 恭喜!

您剛剛使用 Firebase App Distribution 上傳應用程式套件並將版本分發給測試人員。

下一步