註冊其他 iOS 裝置

如要使用 App Distribution 發布臨時 iOS 版本，請務必按照本指南註冊測試人員的裝置。臨時版本是指未以企業設定檔簽署的版本。只有在裝置的專屬裝置 ID (UDID) 包含在建構作業的佈建設定檔中時，裝置才能安裝臨時建構作業。

測試人員接受測試應用程式的邀請時，App Distribution 會要求權限，以便與您 (開發人員) 分享測試人員的裝置 ID。下載臨時版本前，App Distribution 會要求測試人員註冊裝置。如果測試人員註冊裝置，App Distribution 會從裝置收集 UDID，並透過電子郵件通知您。

收到含有 UDID 的電子郵件後，請使用 UDID 更新佈建設定檔，並將新版本發布給測試人員。您可以透過 Firebase 控制台或 Firebase CLI 手動匯出 UDID，也可以使用 fastlane 以程式輔助方式匯出 UDID。

手動匯出 UDID

  1. 將裝置新增至 Apple 開發人員入口網站。
    • 方法 1： 以 CSV 檔案格式匯入裝置 UDID。

      在 App Distribution 資訊主頁的「Testers & Groups」分頁中，選取「All testers」，然後按一下「Export Apple UDIDs」，下載 CSV 檔案。接著，使用「Register Multiple Devices」選項，將檔案匯入 Apple 開發人員帳戶。詳情請參閱「將應用程式發布至已註冊的裝置」。

      請注意，Apple 開發人員帳戶每年可能只允許匯入有限數量的裝置。

    • 方法 2： 透過電子郵件收集並輸入 UDID。

      在 Apple 開發人員入口網站的「Add Devices」頁面中，註冊您收到的電子郵件中指定的新 UDID。

  2. 將已註冊的裝置新增至佈建設定檔。
  3. 下載佈建設定檔，並用來重新建構應用程式。如果重新建構只是為了更新已註冊的裝置，請勿更新版本號碼或版本。
  4. 透過 Firebase 控制台或 CLI 重新發布應用程式。如果您未變更版本、版本號碼或應用程式程式碼，App Distribution 就不會建立新版本，也不會通知測試人員。如果您已發布版本號碼和版本相同的版本，則只有新註冊裝置的使用者會收到通知電子郵件。

使用 fastlane 以程式輔助方式匯出 UDID

  1. 從 fastlane 將所有測試人員裝置 UDID 匯出為 CSV 檔案。例如，建立並執行新的 download_udids 泳道：

    lane :download_udids do
    firebase_app_distribution_get_udids(
        app: "<your Firebase app ID>",
        output_file: "<path to output file>",
    )
end

  2. 使用「Register Multiple Devices」選項，將 UDID 匯入 Apple 開發人員帳戶。詳情請參閱 Apple 說明文件。請注意，Apple 開發人員帳戶每年可能只允許匯入有限數量的裝置。

  3. 將已註冊的裝置新增至佈建設定檔 {: .external}。

  4. 下載佈建設定檔，並用來重新建構應用程式。如果重新建構的目的只是更新註冊裝置，請勿更新版本號碼或版本。

  5. 重新發布應用程式。如果您未變更版本、版本號碼或應用程式程式碼，App Distribution 就不會建立新版本，也不會通知測試人員。如果您已發布版本號碼和版本相同的版本，則只有新註冊裝置的使用者會收到通知電子郵件。

接收快訊

接收預設快訊

根據預設，Firebase 可以透過電子郵件傳送 App Distribution 警示，通知有新的 iOS 裝置註冊。

如要使用這項預設機制接收App Distribution快訊，您必須具備firebase.projects.update權限。根據預設，下列角色具備這項必要權限：Firebase 管理員或專案擁有者或編輯者。

根據預設，每當有新的 iOS 裝置註冊時，具備接收快訊必要權限的專案成員都會收到電子郵件。

開啟或關閉帳戶快訊

您可以為自己的帳戶啟用/停用 App Distribution 快訊，不會影響其他專案成員。請注意，您仍須具備必要權限才能接收警告。

如要開啟或關閉App Distribution警示，請按照下列步驟操作：

  1. 前往 Firebase 控制台右上角的「 Firebase alerts」(Firebase 快訊)。
  2. 接著前往「設定」，選擇帳戶的 App Distribution 快訊偏好設定。

設定第三方服務的進階警告

您也可以使用 Cloud Functions for Firebase 將 App Distribution 警告傳送至團隊偏好的通知管道。舉例來說，您可以編寫函式，擷取新 iOS 裝置註冊的快訊事件，並將快訊資訊發布至第三方服務，例如 Discord、Slack 或 Jira。

如要完全自動化新 iOS 測試人員的新進人員訓練，您可以編寫函式，將新 iOS 裝置的 UDID 新增至應用程式的佈建設定檔、重新建構應用程式，並使用更新後的佈建設定檔重新發布應用程式。

如要使用 Cloud Functions for Firebase 設定進階警告功能，請按照下列步驟操作：

  1. 設定 Cloud Functions for Firebase，包括下列工作：

    1. 設定 Node.js 或 Python 的開發環境。
    2. 安裝並登入 Firebase CLI。
    3. 使用 Firebase CLI 初始化 Cloud Functions for Firebase。

  2. 編寫及部署函式，擷取 App Distribution 的警告事件，並處理事件酬載 (例如在 Discord 訊息中張貼警告資訊)。

如要瞭解可擷取的所有快訊事件，請參閱 App Distribution 快訊的參考文件。

後續步驟