使用 Firebase CLI 將 Android 應用分發給測試人員

本指南介紹瞭如何使用 Firebase CLI 將 Android App Bundle (AAB) 分發給測試人員。 CLI 工具允許您為構建指定測試人員和發行說明,然後相應地分發構建。

要遵循本指南,您需要滿足以下先決條件:訪問 Firebase 項目(所有者Firebase 管理員)、訪問 Google Play 開發者帳戶(所有者或管理員)以及在 Google Play 中處於已發布狀態的應用。

關於分發 Android App Bundle

App Distribution 與 Google Play 的內部應用共享服務集成,以處理您上傳的 AAB 並提供針對測試人員的設備配置進行了優化的 APK。分發 AAB 時,您可以:

  • 運行針對測試人員的設備進行了優化的優化 APK(由 Google Play 提供)。
  • 發現和調試特定於設備的問題。
  • 測試應用程序包功能,例如Play 功能交付Play 資產交付
  • 減少測試人員的下載量。

在你開始之前

  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 控制台中,轉到您的 Project settings ,然後選擇Integrations選項卡。

    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 頁面中,選擇您要分發的應用,然後點擊Get started
  3. 運行appdistribution:distribute命令以上傳您的應用並將其分發給測試人員。使用以下參數配置分佈:

    appdistribution:分發選項
    --app

    必需:您的應用的 Firebase 應用 ID。您可以在 Firebase 控制台的“常規設置”頁面上找到應用 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

    您可以包含一個標誌來打印詳細的日誌輸出。

    例如:

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

    除了分發版本之外,您還可以使用appdistribution:testers:addappdistribution: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指定測試人員。

分發構建後,它會在 Firebase 控制台的 App Distribution 儀表板中可用 150 天(五個月)。當構建距離到期 30 天時,控制台和測試人員在其測試設備上的構建列表中都會顯示到期通知。

未受邀測試應用程序的測試人員會收到電子郵件開始邀請,現有測試人員會收到電子郵件通知,告知新版本已準備好進行測試(請閱讀測試人員設置指南以獲取有關如何安裝測試應用程序的說明)。您可以在 Firebase 控制台中監控每個測試人員的狀態——他們是否接受了邀請以及是否下載了應用程序。

測試人員有 30 天的時間在應用程序過期前接受測試邀請。當邀請距過期還有 5 天時,過期通知會出現在 Firebase 控制台中某個版本的測試人員旁邊。可以通過使用測試人員行上的下拉菜單重新發送邀請來更新邀請。