使用 Firebase CLI 將 Android 應用程式發布給測試人員


本指南說明如何使用 Firebase CLI 將 Android App Bundle (AAB) 發布給測試人員。您可以使用 CLI 工具指定版本的測試人員和發布說明，然後依此發布版本。

App Distribution 會整合 Google Play 的內部應用程式分享服務，處理您上傳的 AAB，並提供針對測試人員裝置設定最佳化的 APK。您可以透過發布 AAB 來執行下列操作：

  • 執行經過最佳化的 APK (由 Google Play 提供)，這些 APK 已針對測試人員的裝置進行最佳化。

  • 找出並修正裝置相關問題。

  • 測試應用程式套件功能，例如 Play Feature Delivery 和 Play Asset Delivery。

  • 縮減測試人員的下載檔案大小。

所需權限

如要將 AAB 上傳至 App Distribution，您必須將 Firebase 應用程式連結至 Google Play 中的應用程式。您必須具備必要的存取層級才能執行這些動作。

如果您沒有必要的 Firebase 存取權，可以要求 Firebase 專案擁有者透過 Firebase 控制台的身分與存取權管理設定，指派適用的角色給您。如果您對存取 Firebase 專案有任何疑問，包括尋找或指派擁有者，請參閱 「Firebase 專案的權限和存取權」常見問題。

下表適用於將 Firebase 應用程式連結至 Google Play 中的應用程式，以及上傳 AAB。

在 Firebase 控制台中執行的動作 必要的 IAM 權限 預設包含必要權限的 IAM 角色 其他必要角色
將 Firebase 應用程式連結至 Google Play 中的應用程式 firebase.playLinks.update 下列其中一個角色： 以管理員身分存取 Google Play 開發人員帳戶
將 AAB 上傳至 App Distribution firebaseappdistro.releases.update 下列其中一個角色： ––

事前準備

  1. 如果您尚未將 Firebase 新增至 Android 專案，請先新增。完成這個工作流程後，您的 Firebase 專案中就會出現 Firebase Android 應用程式。

    如果您不使用任何其他 Firebase 產品，只需建立專案並註冊應用程式即可。如果您決定使用其他產品，請務必完成將 Firebase 新增至 Android 專案中的所有步驟。

  2. 如要建立 Google Play 與 Firebase 之間的連結來上傳 AAB，請確認應用程式符合下列規定：

    • 註冊 Google Play 中的應用程式和 Firebase Android 應用程式時，你使用的是相同的套件名稱。

    • Google Play 中的應用程式已在應用程式資訊主頁中設定完畢，並發布至其中一個 Google Play 測試群組 (內部測試、封閉測試、公開測試或正式版)。

    • 應用程式的 Google Play 審查程序已經完成，並發布完畢。 如果「應用程式狀態」欄顯示的是下列其中一個狀態，即代表應用程式已經發布：內部測試 (非草稿內部測試)、封閉測試、公開測試或正式版。

  3. 將 Firebase Android 應用程式連結至 Google Play 開發人員帳戶：

    1. 在 Firebase 控制台中，前往「專案設定」，然後選取「整合」分頁標籤。

    2. 按一下「Google Play」資訊卡中的「連結」。
      如果你已取得 Google Play 連結，請改為點選「管理」。

    3. 按照畫面上的指示啟用 App Distribution 整合功能，並選取要連結至 Google Play 的 Firebase Android 應用程式。

    進一步瞭解如何連結至 Google Play。

步驟 1：建構應用程式

當您準備好將應用程式的預先發布版發布給測試人員時，請建構 AAB (請參閱 Android Studio 說明文件瞭解操作方式)。

步驟 2：將應用程式發送給測試人員

如要將應用程式發布給測試人員，請使用 Firebase CLI 上傳應用程式檔案：

  1. 安裝或更新至最新版 Firebase CLI (建議您下載適用於您作業系統的 CLI 專屬獨立二進位檔)。請務必登入，並測試是否能存取專案。
  2. 在 Firebase 控制台的 App Distribution 頁面中，選取要發布的應用程式，然後按一下「開始使用」。

  3. 執行 appdistribution:distribute 指令，上傳應用程式並發布給測試人員。請使用下列參數設定發布作業：

    appdistribution:distribute options
    --app

    必要：應用程式的 Firebase 應用程式 ID。您可以在 Firebase 主控台的「General Settings」頁面中找到應用程式 ID。

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    使用 Firebase CLI 驗證 CI 環境時，系統會列印的重新整理權杖 (詳情請參閱「使用 CLI 搭配 CI 系統 」)。

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    這個版本的版本資訊。

    您可以直接指定發布說明：

    --release-notes "Text of release notes"

    或者，指定純文字檔案的路徑：

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    您要邀請的測試人員電子郵件地址。

    您可以透過逗號分隔的電子郵件地址清單指定測試人員：

    --testers "ali@example.com, bri@example.com, cal@example.com"

    或者，您也可以指定含有以半形逗號分隔的電子郵件地址清單的純文字檔案路徑：

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    您要邀請的測試人員群組 (請參閱「管理測試人員」)。群組會使用群組別名指定，您可以在 Firebase 控制台中查詢。

    您可以透過逗號分隔清單的形式指定群組：

    --groups "qa-team, trusted-testers"

    或者，您也可以指定純文字檔案的路徑，其中包含以半形逗號分隔的群組名稱清單：

    --groups-file "/path/to/groups.txt"
    --debug

    可用於列印詳細記錄輸出的標記。
    --test-devices
    --test-devices-file

    以下發布類型屬於 自動測試人員 Beta 版功能。

    您要將建構項目發布至的測試裝置 (請參閱「自動化測試」)。

    您可以透過逗號分隔的電子郵件地址清單指定測試人員：

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

    或者，您也可以指定純文字檔案的路徑，其中包含以半形分號分隔的測試裝置清單：

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    在自動化測試期間用於自動登入的使用者名稱。
    --test-password
    --test-password-file

    在自動化測試期間用於自動登入的密碼。

    或者，您也可以指定含有密碼的純文字檔案路徑：

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    自動登入時要使用的使用者名稱欄位資源名稱，用於自動化測試。
    --test-password-resource

    自動登入時用於自動化測試的密碼欄位資源名稱。
    --test-non-blocking

    以非同步方式執行自動化測試。請前往 Firebase 控制台查看自動化測試結果。

    例如：

    firebase appdistribution:distribute test.aab  \
    --app 1:1234567890:android:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

    Firebase CLI 會在發布內容上傳後輸出下列連結。 這些連結可協助您管理二進位檔，並確保測試人員和其他開發人員擁有正確的版本：

    • firebase_console_uri - 連結至顯示單一版本的 Firebase 主控台。您可以將這個連結分享給貴機構中的其他開發人員。
    • testing_uri - 測試人員體驗 (Android 原生應用程式) 中版本的連結，可讓測試人員查看版本附註，並在裝置上安裝應用程式。測試人員必須有權存取版本，才能使用連結。
    • binary_download_uri：直接下載及安裝應用程式二進位檔 (APK 或 AAB 檔案) 的已簽署連結。連結將於一小時後失效。

    管理測試人員和群組

    除了發布版本，您也可以使用 appdistribution:testers:add 和 appdistribution:testers:remove 邀請新的測試人員，或從 Firebase 專案中移除現有測試人員。

    將測試人員新增至 Firebase 專案後，您可以將他們加入個別版本。移除測試人員後，他們就無法再存取專案中的發布版本。請注意，最近移除的測試人員仍可在一段時間內存取您的版本。

    例如：

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com

    測試人員的電子郵件地址之間必須以空格分隔。您也可以使用 --file /path/to/testers.txt 指定測試人員。

    如果您有大量測試人員，建議您使用群組：您可以使用 appdistribution:group:create 和 appdistribution:group:delete 在 Firebase 專案中建立或刪除群組。

    使用 --group-alias 為 appdistribution:testers:add 和 appdistribution:testers:remove 指令指定群組。

    例如：

    firebase appdistribution:group:create "QA team" qa-team

firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:group:delete qa-team

發布版本後，您可以在 Firebase 主控台的 App Distribution 資訊主頁中查看該版本，時間長達 150 天 (五個月)。當建構作業到期日剩下 30 天時，主控台和測試人員的測試裝置建構作業清單都會顯示到期通知。

未受邀測試應用程式的測試人員會收到電子郵件邀請，而現有測試人員則會收到新版本已可測試的電子郵件通知 (請參閱測試人員設定指南，瞭解如何安裝測試應用程式)。您可以在 Firebase 控制台中，監控每位測試人員的狀態，包括他們是否接受邀請，以及是否下載應用程式。

邀請過期前，測試人員有 30 天可以接受邀請，以便測試應用程式。邀請即將在 5 天後到期時，Firebase 控制台會在版本測試人員旁邊顯示到期通知。您可以使用測試人員資料列的下拉式選單，重新傳送邀請，藉此續訂邀請。

後續步驟