您可以使用 Firebase CLI 將建構版本發布給測試人員。透過 CLI 工具,您可以指定建構版本的測試人員和版本說明,並據此發布建構版本。
如要將應用程式發行給測試人員,請使用 Firebase CLI 上傳 IPA 檔案:
- 安裝或更新至最新版本的 Firebase CLI (建議下載適用於您作業系統的 CLI 獨立二進位檔)。 請務必登入,並測試是否可以存取專案。
-
執行
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要用來執行應用程式測試代理測試的測試裝置。
您可以指定測試裝置,方法是以半形分號分隔裝置規格清單:
--test-devices: "model=shiba,version=34,locale=en,orientation=portrait"
或者,您也可以指定純文字檔的路徑,其中包含以半形分號分隔的測試裝置清單:
--test-devices-file: "/path/to/test-devices.txt"
--test-username在 App Testing 代理程式測試期間,用於自動登入的使用者名稱。
--test-password
--test-password-file在應用程式測試代理程式測試期間,系統會使用這個密碼自動登入。
或者,您也可以指定含有密碼的純文字檔路徑:
--test-password-file: "/path/to/test-password.txt"
--test-username-resource使用者名稱欄位的資源名稱,用於 App Testing 代理程式測試期間的自動登入。
--test-password-resource在 應用程式測試代理程式測試期間,用於自動登入的密碼欄位資源名稱。
--test-non-blocking如果執行 App Testing 代理程式測試時設定此值,指令會啟動測試,然後立即傳回結果,不必等待測試完成。如要查看測試結果,請前往 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- 連結至顯示單一版本的Firebase控制台。您可以與機構中的其他開發人員分享這個連結。testing_uri- 測試人員體驗中的版本連結 (iOS 網頁剪輯片段) 測試人員可透過這個連結查看版本說明,並在裝置上安裝應用程式。測試人員必須有權存取版本,才能使用連結。binary_download_uri- 簽署的連結,可直接下載及安裝應用程式二進位檔 (IPA 檔案)。連結將於一小時後失效。
管理測試人員和群組
除了發布版本,您也可以使用
appdistribution:testers:add和appdistribution:testers:remove邀請新測試人員,或從 Firebase 專案中移除現有測試人員。將測試人員新增至 Firebase 專案後,即可將他們新增至個別版本。移除測試人員後,他們就無法再存取專案中的版本。請注意,最近移除的測試人員在一段時間內仍可存取您的版本。
例如:
firebase appdistribution:testers:add anothertester@email.com moretesters@email.comfirebase 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-teamfirebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.comfirebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.comfirebase appdistribution:group:delete qa-team
發布版本後,該版本會在Firebase控制台的App Distribution資訊主頁中保留 150 天 (五個月)。版本即將到期前 30 天,控制台和測試人員的測試裝置都會顯示到期通知。
尚未受邀測試應用程式的測試人員會收到電子郵件邀請,現有測試人員則會收到電子郵件通知,告知他們有新版本可供測試。如要瞭解如何安裝測試版應用程式,請參閱「成為測試人員」一文。您可以在 Firebase 控制台中監控每位測試人員的狀態,包括是否接受邀請及是否下載應用程式。
測試人員有 30 天的時間可以接受應用程式測試邀請,邀請過期後將失效。 如果邀請即將在 5 天後過期,Firebase控制台會在版本中測試人員旁邊顯示過期通知。如要續發邀請,請使用測試人員列的下拉式選單重新傳送邀請。
後續步驟
如要手動或以程式輔助方式註冊更多裝置,請參閱「註冊其他 iOS 裝置」。