本指南說明如何將 Android App Bundle (AAB) 發布給測試人員 使用 Firebase CLICLI 工具可讓您指定測試人員 發布版本,並據此發布版本。
App Distribution 已與 Google Play 的內部應用程式分享服務整合,以便: 處理你上傳並提供針對測試人員最佳化的 APK 裝置設定發布 AAB 可讓您執行下列操作:
執行針對以下項目最佳化的最佳化 APK (由 Google Play 提供) 測試人員裝置。
找出裝置相關問題並進行偵錯。
測試應用程式套件功能,例如 Play Feature Delivery 和 Play Asset Delivery 的套件。
請為測試人員縮減下載大小。
所需權限
如要將 AAB 上傳至 App Distribution,請將 Firebase 應用程式連結至應用程式 位置:Google Play。您必須取得必要的存取層級 才能執行這些動作
如果您沒有必要的 Firebase 存取權,可以詢問 Firebase 專案 擁有者透過 Firebase 控制台 IAM 設定。 如果您對 Firebase 專案的存取方式有疑問,請提供: 尋找或指派擁有者、詳閱 「Firebase 專案的權限和存取權」常見問題。
下表適用於將 Firebase 應用程式連結至應用程式的做法: Google Play,以及上傳 AAB。
Firebase 控制台中的動作 | 必要的 IAM 權限 | 具備必要權限的 IAM 角色 預設 | 其他必要角色 |
---|---|---|---|
將 Firebase 應用程式連結至 Google Play 中的應用程式 | firebase.playLinks.update
|
下列其中一個角色: | 「Google Play」開發人員帳戶的存取權 管理員 |
將 AAB 上傳至「App Distribution」 | firebaseappdistro.releases.update
|
下列其中一個角色: | –– |
事前準備
如果您尚未將 Firebase 新增至 Android,請先完成這項操作。 專案。完成這個工作流程後 Firebase 專案中有 Firebase Android 應用程式。
如果您沒有使用其他 Firebase 產品,則只需建立 並註冊應用程式若您決定使用額外參數 請務必完成 將 Firebase 新增至您的 Android 專案。
如要建立 Google Play 的 Firebase 連結並上傳 AAB,請確認 應用程式符合下列規定:
已在 Google Play 和 Firebase Android 應用程式中註冊應用程式 使用相同的套件名稱
Google Play 中的應用程式已在應用程式中設定 資訊主頁 發行至其中一個 Google Play 測試群組 (內部測試、 封閉測試、公開測試或正式版)。
應用程式在 Google Play 中的審查已完成,並已發布應用程式。 如果「應用程式狀態」欄顯示下列任一項目,表示應用程式已發布 下列狀態:內部測試 (非草稿內部測試)、 封閉測試、公開測試或正式版。
將 Firebase Android 應用程式連結至 Google Play 開發人員帳戶:
透過 Firebase 控制台,前往
、 然後選取「Integrations」(整合) 分頁標籤。 專案設定 按一下「Google Play」資訊卡中的「連結」。
如果已有 Google Play 連結,請按一下「管理」 。按照畫面上的指示啟用 App Distribution 整合並選取要連結至 Google 的 Firebase Android 應用程式 遊玩、
進一步瞭解 連結至 Google Play
步驟 1:建構應用程式
當您準備向測試人員發行應用程式的預先發布版時, 建立 AAB (詳情請參閱 Android Studio 說明文件 )。
步驟 2:將應用程式發布給測試人員
如要將應用程式發布給測試人員,請使用以下程式碼上傳應用程式檔案: Firebase CLI:
- 安裝或更新至最新版的 Firebase CLI (建議您下載 OS 專用的 CLI 獨立二進位檔)。 請務必登入,並測試您是否能存取 Google Cloud 的 Resource Manager 工具 經特別設計,能以程式輔助方式協助您管理專案
- 在「App Distribution」頁面 前往 Firebase 控制台,選取要發行的應用程式,然後按一下「開始使用」。
-
執行
appdistribution:distribute
指令來上傳應用程式並 發布給測試人員使用下列參數設定 發行:應用程式發行:發行選項 --app
必要:應用程式的 Firebase 應用程式 ID。您可以在 登入 Firebase 控制台中的 一般 設定頁面。
--app 1:1234567890:android:0a1b2c3d4e5f67890
--token
驗證持續整合內容時,系統會顯示的更新權杖 更新環境,Firebase CLI 將 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
您可以加入的旗標,用來列印詳細記錄輸出。
--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.aab \ --app 1:1234567890:android:0a1b2c3d4e5f67890 \ --release-notes "Bug fixes and improvements" --testers-file testers.txt
發布版本上傳後,Firebase CLI 會輸出下列連結。 這些連結可協助您管理二進位檔,並確保測試人員和其他 正確的版本:
firebase_console_uri
- 連結至 顯示單一版本的 Firebase 控制台。您可以分享 連結至貴機構的其他開發人員。testing_uri
- 測試人員中的版本連結 體驗 (Android 原生應用程式) 供測試人員查看版本 ,並在裝置上安裝這個應用程式。測試人員需要 才能使用該連結。binary_download_uri
- 直接的已簽署連結 下載並安裝應用程式二進位檔 (APK 或 AAB 檔案) ,直接在 Google Cloud 控制台實際操作。連結將於一小時後失效。
管理測試人員和群組
除了發行版本外 「
appdistribution:testers:add
」和appdistribution: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
。如果您需要大量測試人員,建議使用群組: 您可以使用
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 控制台。邀請可以是 使用測試人員列的下拉式選單重新傳送更新。