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


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

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

  • 執行針對測試人員裝置最佳化的 APK (由 Google Play 提供)。

  • 找出並修正特定裝置的問題。

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

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

所需權限

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

如果沒有必要的 Firebase 存取權，可以要求 Firebase 專案擁有者透過 Firebase 控制台 IAM 設定，指派適用的角色給你。如對存取 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. 執行 appdistribution:distribute 指令，上傳應用程式並提供給測試人員。使用下列參數設定發布作業：

    appdistribution:distribute 選項
    --app

    必要：應用程式的 Firebase 應用程式 ID。您可以在 Firebase 控制台的「一般設定」頁面中找到應用程式 ID。

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

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

    --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 - A link to the Firebase console displaying a single release. 您可以將這個連結分享給貴機構的其他開發人員。
    • 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控制台會在版本中的測試人員旁顯示到期通知。如要續發邀請，請使用測試人員列的下拉式選單重新傳送邀請。

後續步驟