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

您可以使用 Firebase CLI 將建構作業發布給測試人員。CLI 工具可讓您指定測試人員和版本資訊，並據此發布版本。

事前準備

  1. 如果您尚未將 Firebase 新增至 Apple 專案，請先新增。

    如果您不使用其他 Firebase 產品，只需建立專案並註冊應用程式。不過，如果您日後決定使用其他產品，請務必完成上述連結頁面中的所有步驟。

  2. 開啟 Firebase 控制台的「App Distribution」頁面。系統提示時，選取 Firebase 專案，使用產品切換工具選取應用程式，然後按一下「Get started」(開始使用)。

步驟 1：將應用程式提供給測試人員

如要將應用程式發布給測試人員，請使用 Firebase CLI 上傳 IPA 檔案：

  1. 安裝或更新至最新版本的 Firebase CLI (建議下載適用於您 OS 的 CLI 獨立二進位檔)。請務必登入並測試是否能存取專案。

  2. 執行 appdistribution:distribute 指令，上傳應用程式並發布給測試人員。請使用下列參數設定分布：

    appdistribution:distribute 選項
    --app

    必要：應用程式的 Firebase 應用程式 ID。您可以在 Firebase 控制台的「General Settings」(一般設定) 頁面找到應用程式 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

    要執行應用程式測試代理測試的測試裝置。

    您可以指定測試裝置，並以分號分隔裝置規格清單：

    --test-devices: "model=shiba,version=34,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 控制台。如未設定這個旗標，指令會封鎖，直到測試完成為止，並在任何測試失敗時，以失敗代碼結束。
    --results-bucket

    儲存測試結果的自訂 Google Cloud Storage (GCS) bucket。如果留空，則會使用預設 bucket。bucket 必須由已啟用計費功能的專案擁有，且指定 bucket 會產生所用儲存空間的費用。

    例如：

    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 網頁剪輯) 中的版本連結，可讓測試人員查看版本資訊，並將應用程式安裝到裝置上。測試人員必須有權存取版本，才能使用連結。
    • binary_download_uri - 簽署連結，可直接下載並安裝應用程式二進位檔 (IPA 檔案)。連結會在 1 小時後失效。

    管理測試人員和群組

    除了發布版本外，您也可以使用 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 控制台會顯示到期通知，就在版本測試人員旁邊。如要更新邀請，請使用測試人員列的下拉式選單重新傳送。

後續步驟