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


本指南說明如何使用 fastlane 將 AAB 版本發布給測試人員，這是一個開放原始碼平台，可自動建構及發布 iOS 和 Android 應用程式。它會遵循 Fastfile 中定義的簡單指示。設定 fastlane 和 Fastfile 後，您可以將 App Distribution 與 fastlane 設定整合。

App Distribution 會與 Google Play 的內部應用程式分享服務整合，處理您上傳的 AAB，並提供針對測試人員裝置設定最佳化的 APK。您可以透過發布 AAB 來執行下列操作：

  • 執行經過最佳化的 APK (由 Google Play 提供)，這些 APK 已針對測試人員的裝置進行最佳化。

  • 找出並修正裝置相關問題。

  • 測試應用程式套件功能，例如 Play Feature Delivery 和 Play Asset Delivery。

  • 縮減測試人員的下載檔案大小。

所需權限

如要將 AAB 上傳至 App Distribution，您必須將 Firebase 應用程式連結至 Google Play 中的應用程式。您必須具備必要的存取層級才能執行這些動作。

如果您沒有必要的 Firebase 存取權，可以要求 Firebase 專案擁有者透過 Firebase 控制台的身分與存取權管理設定，指派適用的角色給您。如果您對存取 Firebase 專案有任何疑問，包括尋找或指派擁有者，請參閱 「Firebase 專案的權限和存取權」常見問題。

下表適用於將 Firebase 應用程式連結至 Google Play 中的應用程式，以及上傳 AAB。

在 Firebase 控制台中執行的動作 必要的 IAM 權限 預設包含必要權限的 IAM 角色 其他必要角色
將 Firebase 應用程式連結至 Google Play 中的應用程式 firebase.playLinks.update 下列其中一個角色： 以管理員身分存取 Google Play 開發人員帳戶
將 AAB 上傳至 App Distribution firebaseappdistro.releases.update 下列其中一個角色： ––

事前準備

  1. 如果您尚未將 Firebase 新增至 Android 專案，請新增 Firebase。完成這個工作流程後，您的 Firebase 專案就會包含 Firebase Android 應用程式。

    如果您不使用任何其他 Firebase 產品，只需建立專案並註冊應用程式即可。如果您決定使用其他產品，請務必完成「將 Firebase 新增至 Android 專案」中的所有步驟。

  2. 如要建立 Google Play 與 Firebase 之間的連結來上傳 AAB，請確認應用程式符合下列規定：

    • 註冊 Google Play 中的應用程式和 Firebase Android 應用程式時，你使用的是相同的套件名稱。

    • Google Play 中的應用程式已在應用程式資訊主頁中設定完畢，並發布至其中一個 Google Play 測試群組 (內部測試、封閉測試、公開測試或正式版)。

    • 應用程式的 Google Play 審查程序已經完成，並發布完畢。 如果「應用程式狀態」欄顯示的是下列其中一個狀態，即代表應用程式已經發布：內部測試 (非草稿內部測試)、封閉測試、公開測試或正式版。

  3. 將 Firebase Android 應用程式連結至 Google Play 開發人員帳戶：

    1. 在 Firebase 控制台中，前往「 專案設定」，然後選取「整合」分頁標籤。

    2. 按一下「Google Play」資訊卡中的「連結」。
      如果你已取得 Google Play 連結，請改為點選「管理」。

    3. 按照畫面上的指示啟用 App Distribution 整合功能，並選取要連結至 Google Play 的 Firebase Android 應用程式。

    進一步瞭解如何連結至 Google Play。

步驟 1：設定 fastlane

  1. 安裝及設定 fastlane。

  2. 如要將 App Distribution 新增至 fastlane 設定，請從 Android 專案的根目錄執行下列指令：

    fastlane add_plugin firebase_app_distribution

    如果指令提示您選擇選項，請選取 Option 3: RubyGems.org。

步驟 2：使用 Firebase 進行驗證

您必須先透過下列任一方式驗證 Firebase 專案，才能使用 fastlane 外掛程式。根據預設，如果未使用其他驗證方法，fastlane 外掛程式會從 Firebase CLI 尋找憑證。

步驟 3：設定 Fastfile 並發行應用程式

  1. 在 ./fastlane/Fastfile 車道中，新增 firebase_app_distribution 區塊。請使用下列參數設定發布作業：
    firebase_app_distribution 參數
    app

    必要：應用程式的 Firebase 應用程式 ID。您可以在 Firebase 主控台的「General Settings」(一般設定) 頁面中找到應用程式 ID。

    app: "1:1234567890:android:0a1b2c3d4e5f67890"
    firebase_cli_token

    使用 Firebase CLI 驗證 CI 環境時，系統會列印的重新整理權杖 (詳情請參閱「使用 CLI 與 CI 系統」)。
    service_credentials_file

    Google 服務帳戶 JSON 檔案的路徑。請參閱上述說明，瞭解如何使用服務帳戶憑證進行驗證。
    android_artifact_type

    指定 Android 檔案類型 (APK 或 AAB)。
    android_artifact_path

    取代 apk_path (已淘汰)。要上傳的 APK 或 AAB 檔案的絕對路徑。如果未指定，fastlane 會根據產生檔案的車道來判斷檔案位置。
    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"
    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 控制台查看自動化測試結果。
    debug

    布林值標記。您可以將此值設為 true，以便列印詳細的偵錯輸出內容。

    		 
platform :android do
    desc "My awesome app"
    lane :distribute do
        build_android_app(task: "bundle", ...)
        # build_android_app is a built-in fastlane action.
        release = firebase_app_distribution(
            app: "1:123456789:android:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!",
            android_artifact_type: "AAB"
        )
    end
end

如要讓測試人員使用這個版本，請執行您的車道： 

fastlane <lane>

動作的傳回值是代表上傳版本的雜湊碼。您也可以使用 lane_context[SharedValues::FIREBASE_APP_DISTRO_RELEASE] 取得這個雜湊值。如要進一步瞭解此雜湊中可用的欄位，請參閱 REST API 說明文件。

發布內容上傳後，fastlane 外掛程式會輸出下列連結。這些連結可協助您管理二進位檔，並確保測試人員和其他開發人員擁有正確的版本：

  • 連結至 Firebase 控制台，顯示單一版本。您可以將這個連結分享給貴機構的其他開發人員。
  • 測試人員體驗 (Android 原生應用程式) 中版本的連結，可讓測試人員查看版本說明，並將應用程式安裝到裝置上。測試人員必須具備版本存取權，才能使用連結。
  • 直接下載及安裝應用程式二進位檔 (APK 或 AAB 檔案) 的已簽署連結。連結將於一小時後失效。

發布版本後，您可以在 Firebase 主控台的 App Distribution 資訊主頁中查看該版本，時間長達 150 天。建構作業到期前 30 天，主控台和測試人員的測試裝置上都會顯示到期通知。

先前未受邀測試應用程式的測試人員，會收到電子郵件邀請，以便開始測試。現有測試人員會收到電子郵件通知，指出新版本已可測試。如要瞭解如何安裝測試應用程式，請參閱測試人員設定指南。您可以監控每位測試人員的狀態，判斷他們是否接受邀請，以及是否在 Firebase 控制台下載應用程式。

(選用) 如要在每次在應用程式發布中建立新版本時自動遞增版本號碼，您可以使用 firebase_app_distribution_get_latest_release 動作，以及例如 increment_version_code fastlane 外掛程式。以下程式碼提供如何自動遞增版本號碼的範例：

lane :increment_version do
  latest_release = firebase_app_distribution_get_latest_release(
    app: "<your Firebase app ID>"
  )
  increment_version_code({ version_code: latest_release[:buildVersion].to_i + 1 })
end

如要進一步瞭解 firebase_app_distribution_get_latest_release 動作，請參閱「取得應用程式最新版本的相關資訊」。

步驟 4 (選用)：管理發布版本的測試人員

您可以使用 Fastfile 檔案，或直接執行 Fastlane 動作，在專案或群組中新增及移除測試人員。直接執行動作會覆寫 Fastfile 中設定的值。

將測試人員新增至 Firebase 專案後，您可以將他們加入個別版本。從 Firebase 專案中移除的測試人員將無法再存取專案中的版本，但可能會在一段時間內保留版本存取權。

如果您有大量測試人員，建議您使用群組。

使用Fastfile

# Use lanes to add or remove testers from a project.
lane(:add_testers) do
  firebase_app_distribution_add_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) add testers to this group
  )
end

lane(:remove_testers) do
  firebase_app_distribution_remove_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) remove testers from this group only
  )
end
# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers

執行 Fastlane 動作

fastlane run firebase_app_distribution_create_group display_name:"QA Team" alias:"qa-team"
fastlane run firebase_app_distribution_add_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_remove_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_delete_group alias:"qa-team"

您也可以使用 --file="/path/to/testers.txt 而非 --emails 指定測試人員。

firebase_app_distribution_add_testers 和 firebase_app_distribution_remove_testers 工作也接受下列引數：

  • project_name：您的 Firebase 專案編號。
  • group_alias (選用)：如果指定此值，系統會將測試人員加入 (或移出) 指定群組。
  • service_credentials_file：Google 服務憑證檔案的路徑。
  • firebase_cli_token：Firebase CLI 的驗證權杖。

service_credentials_file 和 firebase_cli_token 是上傳動作使用的相同引數。

步驟 5 (選用)。取得應用程式最新版本的相關資訊

您可以使用 firebase_app_distribution_get_latest_release 動作，擷取應用程式在「應用程式發行」中的最新版本資訊，包括應用程式版本資訊、版本資訊和建立時間。用途包括自動提高版本，以及從先前版本轉移發布說明。

動作的傳回值是代表最新版本的雜湊。您也可以使用 lane_context[SharedValues::FIREBASE_APP_DISTRO_LATEST_RELEASE] 取得這個雜湊值。如要進一步瞭解此雜湊中可用的欄位，請參閱 REST API 說明文件。

參數

firebase_app_distribution_get_latest_release 參數
app

必要：應用程式的 Firebase 應用程式 ID。您可以在 Firebase 主控台的「General Settings」(一般設定) 頁面中找到應用程式 ID。

app: "1:1234567890:android:0a1b2c3d4e5f67890"
firebase_cli_token

使用 Firebase CLI 驗證 CI 環境時，系統會列印的重新整理權杖 (詳情請參閱「使用 CLI 與 CI 系統」)。
service_credentials_file

Google 服務帳戶 JSON 檔案的路徑。請參閱上述說明，瞭解如何使用服務帳戶憑證進行驗證。
debug

布林值標記。您可以將此值設為 true，以便列印詳細的偵錯輸出內容。

後續步驟