Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

本指南介紹瞭如何使用 Firebase CLI 向測試人員分發 APK。 CLI 工具允許您為構建指定測試人員和發行說明,然後相應地分發構建。

在你開始之前

如果你還沒有,添加火力地堡到您的Android項目

如果您沒有使用任何其他 Firebase 產品,您只需創建一個項目並註冊您的應用程序。但是,如果您決定將來使用其他產品,請務必完成上面鏈接頁面上的所有步驟。

步驟 1. 構建您的應用程序

當您準備好向測試人員分發應用的預發布版本時,請使用正常流程構建您的 APK。您必須使用調試密鑰或應用簽名密鑰對 APK 進行簽名。

第 2 步:將您的應用分發給測試人員

要將您的應用分發給測試人員,請使用 Firebase CLI 上傳您的應用文件:

  1. 安裝或更新到最新版本火力地堡CLI (我們建議您下載的CLI特定的獨立二進制到您的操作系統)。請務必登錄和測試,你可以訪問你的項目。
  2. 應用發布頁面的火力地堡控制台,選擇您要分發的應用程序,然後點擊開始使用
  3. 運行appdistribution:distribute命令上傳應用程序,並將其發布給測試人員。使用以下參數配置分發:

    appdistribution:分發選項
    --app

    要求:你的應用程序的火力地堡的App ID。你可以找到在火力地堡控制台應用程序ID,則在常規設置頁面

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

    令牌刷新是當你進行身份驗證與火力地堡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

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

    例如:

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

    除了分發的版本中,你也可以使用appdistribution:testers:addappdistribution:testers:remove邀請新的測試人員,或從火力地堡項目中刪除現有的測試。將測試人員添加到您的 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 控制台的應用分發儀表板中可用 150 天(五個月)。當構建距過期 30 天時,控制台和測試人員在其測試設備上的構建列表中都會顯示過期通知。

誰沒有被邀請來測試應用程序測試人員收到電子郵件邀請上手,而且現有的測試人員收到電子郵件通知,一個新的版本是準備測試(讀取測試儀設立指導如何安裝測試程序的說明)。您可以在 Firebase 控制台中監控每個測試人員的狀態——他們是否接受了邀請以及他們是否下載了應用程序。

測試人員有 30 天的時間接受邀請以在應用程序到期之前對其進行測試。當邀請距到期還有 5 天時,Firebase 控制台中會在發布的測試人員旁邊顯示到期通知。可以通過使用測試人員行上的下拉菜單重新發送邀請來續訂邀請。