使用 Firebase CLI 將 iOS 應用程式分發給測試人員

您可以使用 Firebase CLI 將構建分發給測試人員。 CLI 工具允許您為構建指定測試人員和發行說明,並相應地分發構建。

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

  1. 安裝或更新到最新版本的Firebase CLI (我們建議下載特定於您操作系統的 CLI 的獨立二進製文件)。確保登錄並測試您是否可以訪問您的項目。
  2. 在 Firebase 控制台的“應用程序分發”頁面中,選擇要分發的應用程序,然後點擊“開始”
  3. 運行appdistribution:distribute命令上傳您的應用程序並將其分發給測試人員。使用以下參數來配置分發:

    appdistribution:分發選項
    --app

    必需:您應用的 Firebase 應用 ID。您可以在 Firebase 控制台的“常規設置”頁面上找到應用程序 ID。

    --app 1:1234567890:ios: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.ipa  \
        --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    Firebase CLI 在版本上傳後輸出以下鏈接。這些鏈接可幫助您管理二進製文件並確保測試人員和其他開發人員擁有正確的版本:

    • firebase_console_uri - 顯示單個版本的 Firebase 控制台的鏈接。您可以與組織中的其他開發人員共享此鏈接。
    • testing_uri - 測試人員體驗中版本的鏈接(iOS Web 剪輯),可讓測試人員查看版本說明並將應用程序安裝到其設備上。測試人員需要訪問該版本才能使用該鏈接。
    • binary_download_uri - 直接下載並安裝應用程序二進製文件(IPA 文件)的簽名鏈接。該鏈接在一小時後過期。

    管理測試人員和組

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

    如果您有大量測試人員,則應考慮使用組:您可以使用appdistribution:group:createappdistribution:group:delete在 Firebase 項目中創建或刪除組。

    使用--group-aliasappdistribution:testers:addappdistribution: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 控制台的應用程序分發儀表板中可用 150 天(五個月)。當構建版本距到期日還有 30 天時,控制台和測試人員在其測試設備上的構建版本列表中都會顯示到期通知。

尚未受邀測試應用程序的測試人員會收到開始測試的電子郵件邀請,現有測試人員會收到新版本已準備好測試的電子郵件通知。要了解如何安裝測試應用程序,請參閱設置為測試人員。您可以在 Firebase 控制台中監控每個測試人員的狀態 - 他們是否接受邀請以及他們是否下載了應用程序。

測試人員有 30 天的時間接受邀請來測試該應用程序,然後該應用程序就會過期。當邀請在 5 天后到期時,Firebase 控制台中發布的測試人員旁邊會顯示到期通知。可以通過使用測試者行上的下拉菜單重新發送邀請來更新邀請。

下一步