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

本指南說明如何將 APK 發布給測試人員 就能建構應用程式CLI 工具可讓您指定測試人員 發布版本,並據此發布版本。

事前準備

如果您尚未將 Firebase 新增至 Android,請先完成這項操作。 專案

如果您沒有使用其他 Firebase 產品,只要建立 並註冊應用程式不過,如果您決定使用額外的 在日後推出產品時,請務必完成本頁列出的所有步驟 。

步驟 1:建構應用程式

當您準備向測試人員發行應用程式的預先發布版時, 建立 APK。您必須透過偵錯來簽署 APK 金鑰或應用程式簽署金鑰。

步驟 2:將應用程式發布給測試人員

如要將應用程式發布給測試人員,請使用以下程式碼上傳應用程式檔案: Firebase CLI:

  1. 安裝或更新至最新版的 Firebase CLI (建議您下載 OS 專用的 CLI 獨立二進位檔)。 請務必登入,並測試您是否能存取 Google Cloud 的 Resource Manager 工具 經特別設計,能以程式輔助方式協助您管理專案
  2. 「應用程式發布」頁面 選取您要發行的應用程式,然後按一下「開始使用」
  3. 執行 appdistribution:distribute 指令來上傳應用程式並 發布給測試人員使用下列參數設定 發行:

    應用程式發行:發行選項
    --app

    必要:應用程式的 Firebase 應用程式 ID。你可以在這裡找到應用程式 請前往 Firebase 控制台 一般 設定頁面

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    驗證持續整合內容時,系統會顯示的更新權杖 讀取及更新環境 將 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.apk  \
        --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:createappdistribution: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 控制台的應用程式發布資訊主頁,為期 150 天 (五個月)。 如果版本到期 30 天,兩個版本都會顯示到期通知 測試裝置上的控制台和測試人員的版本清單。

測試人員會收到電子郵件邀請,但尚未受邀測試應用程式 新的版本,現有測試人員會收到新版本的電子郵件通知 可供測試 (閱讀 測試人員設定指南 瞭解如何安裝測試 應用程式)。您可以監控每位測試人員的狀態,確認他們是否接受 邀請以及是否在 Firebase 控制台中下載應用程式。

在過期前,測試人員有 30 天可以接受邀請,接受邀請。 如果邀請過期的 5 天,系統會在 版本測試人員旁的 Firebase 控制台。邀請可以是 使用測試人員列的下拉式選單重新傳送更新。

後續步驟