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

您可以使用 Firebase CLI 將建構版本發布給測試人員。您可以使用 CLI 工具指定測試人員和版本說明,並據此發布版本。

如要將應用程式發行給測試人員,請使用 Firebase CLI 上傳 IPA 檔案:

  1. 安裝或更新至最新版 Firebase CLI (建議下載適用於您作業系統的 CLI 獨立二進位檔)。請務必登入並測試是否可以存取專案。
  2. 執行 appdistribution:distribute 指令,上傳應用程式並提供給測試人員。使用下列參數設定發布作業:

    appdistribution:distribute 選項
    --app

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

    --app 1:1234567890:ios: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.ipa  \
        --app 1:1234567890:ios: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 - 測試人員體驗中的版本連結 (iOS 網頁剪輯片段) 測試人員可透過這個連結查看版本說明,並在裝置上安裝應用程式。測試人員必須有權存取版本,才能使用連結。
    • 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 控制台的 App Distribution 資訊主頁中查看版本,效期為 150 天 (五個月)。如果建構版本即將在 30 天後過期,管理中心和測試人員測試裝置上的建構版本清單都會顯示過期通知。

尚未受邀測試應用程式的測試人員會收到電子郵件邀請,瞭解如何開始測試;現有測試人員則會收到電子郵件通知,得知有新版本可供測試。如要瞭解如何安裝測試版應用程式,請參閱「成為測試人員」。您可以在 Firebase 控制台中,監控每位測試人員的狀態,包括是否接受邀請及是否下載應用程式。

測試人員必須在邀請過期前接受邀請,否則無法測試應用程式。 如果邀請即將在 5 天後到期,Firebase控制台會在版本中的測試人員旁顯示到期通知。如要續發邀請,請使用測試人員列的下拉式選單重新傳送邀請。

後續步驟