將應用程式套件版本發布給測試人員 - 程式碼研究室

1. 總覽

在這個程式碼研究室中，您將瞭解如何使用 Firebase 應用程式發布及其 Gradle 外掛程式，將 Android App Bundle 版本發布給測試人員。應用程式發布作業提供單一中樞，方便您管理應用程式的預先發布版，以及您邀請加入各個版本的測試人員。

課程內容

• 如何將 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 開發人員帳戶的應用程式。

   注意：如要連結 Firebase 應用程式與 Google Play 開發人員帳戶，必須使用相同的套件名稱。我們將在下一節進行操作。

   ，瞭解如何調查及移除這項存取權。 最後按一下「註冊應用程式」。
3. 完成其餘步驟，將應用程式的 Firebase 設定檔 (google-services.json) 新增至應用程式。請注意，針對 Android 平台，應用程式發布沒有可加入應用程式的 Firebase SDK。
4. 按一下 [Continue to console] (前往主控台)。

連結至 Google Play

1. 前往 Firebase 控制台中的「專案設定」。
   
   
2. 在「整合」分頁中，按一下「Google Play」資訊卡上的「連結」。
3. 按照畫面上的指示啟用應用程式發布整合功能，然後選取新建立的 Firebase 應用程式以連結至 Google Play。

完成上述步驟後，只要應用程式套件名稱一致。

3. 將應用程式發布新增至專案

新增 App Distribution Gradle 外掛程式

現在，您將使用 Android Studio 將應用程式發布及其 Gradle 外掛程式新增至應用程式。

1. 在專案層級的 Gradle 檔案 (android/build.gradle.kts) 中，將應用程式發布 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) 中，將應用程式發布外掛程式新增至 plugins 區塊。

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

4. 如果使用公司 Proxy 或防火牆，請新增下列 Java 系統資源，透過「應用程式發布」功能將發行範圍上傳至 Firebase：

   -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
   

驗證 Firebase 專案

您必須先驗證 Firebase 專案，才能使用 Gradle 外掛程式。在本程式碼研究室中，您將使用 Firebase CLI 登入 Google 帳戶。

在 Android 專案的根目錄中執行下列指令：

~/your-android-project$ firebase login

詳情請參閱參考說明文件。

4. 在 Android Studio 中設定套件屬性

在這個步驟中，您需要先將自己新增為日後發布版本的測試人員。發布版本後，Firebase 會傳送電子郵件通知給測試人員，邀請他們測試新版本。

在您的 app/build.gradle.kts 中新增 firebaseAppDistribution 區段，並加入下列參數：

• appID：應用程式的 Firebase 應用程式 ID。如要查看該專案，請前往「專案設定」的「一般」分頁。
• artifactType：應用程式的檔案類型 (AAB)。
• testers：您的測試人員電子郵件地址。在這個程式碼研究室中，請新增自己的電子郵件地址，以便在發布版本後進行測試。

例如：

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "[e-mail], [e-mail], [e-mail]"
                }
            }
        }

        // ...
    }

您也可以覆寫 build.gradle.kts 中設定的值，方法是以 -PappDistribution-property-name=property-value 的格式傳遞指令列引數。

5. 建構及發布版本

1. 執行 bundleVariant Gradle 工作，建構應用程式套件檔案：

   $ ./gradlew :base:bundleRelease
   

2. 在應用程式的建構目錄中找出套件 (預設位置為 app/build/outputs/bundle/release)。
3. 如要發布版本，請使用專案的 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 商店應用程式中啟用內部應用程式分享功能。

1. 在測試裝置上登入測試人員電子郵件帳戶，然後開啟 Firebase 傳送的邀請。
   
   
2. 使用 Google 帳戶登入，接受測試已發行版本的測試邀請。您也可以選擇下載 Firebase App Tester，防止系統將已下載的版本加入裝置的 Downloads 資料夾。也會顯示版本的其他資訊，例如下載進度和發布版本。
   
   
3. 輕觸版本上的「下載」，即可透過 Play 商店安裝。
4. 系統提示時，請完成其餘步驟，以便啟用內部應用程式分享功能 (操作說明會顯示在測試裝置上，只需完成一次即可)。

下載完成後，版本會自動以捷徑的形式顯示在裝置主畫面上。

7. 恭喜！

您剛剛透過 Firebase 應用程式發布功能上傳應用程式套件，並將版本發布給測試人員。

後續步驟

• 請參閱應用程式發布說明文件，進一步瞭解如何管理版本的測試人員。
• 如要瞭解其他可用來部署應用程式的工具，請參閱「建構及測試 Android App Bundle」。