註冊其他 iOS 裝置

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

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

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

手動匯出 UDID

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

      在 App Distribution 資訊主頁的「測試人員和群組」分頁中，選取「所有測試人員」，然後按一下「匯出 Apple UDID」，即可下載 CSV 檔案。接著，使用「Register Multiple Devices」(註冊多部裝置) 選項，將檔案匯入 Apple 開發人員帳戶。詳情請參閱「將應用程式發布至已註冊的裝置」。

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

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

      在 Apple 開發人員入口網站的「新增裝置」頁面中，註冊您收到的電子郵件中指定的新 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 可以透過電子郵件傳送新 iOS 裝置註冊的App Distribution快訊。

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

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

為帳戶開啟或關閉快訊

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

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

  1. 前往 Firebase 控制台右上角的「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快訊的參考文件。

後續步驟