註冊其他 iOS 裝置

如果您想使用 App Distribution 發布臨時 iOS 版本,必須按照本指南註冊測試人員的裝置。臨時版本是指未使用 Enterprise 設定檔簽署的版本。只有在裝置專屬 ID (UDID) 包含在建構設定檔中時,裝置才能安裝臨時性版本。

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

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

手動匯出 UDID

  1. 將裝置新增至 Apple 開發人員入口網站。
    • 選項 1: 將裝置 UDID 匯入 CSV 檔案。

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

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

    • 選項 2: 透過電子郵件收集及輸入 UDID。

      在 Apple Developer 入口網站的「Add Devices」頁面中,註冊您收到的電子郵件中指定的新裝置專屬 ID。

  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. 使用「註冊多部裝置」選項,將 UDID 匯入 Apple 開發人員帳戶。詳情請參閱 Apple 說明文件。請注意,Apple 開發人員帳戶每年只能匯入有限數量的裝置。

  3. 將註冊的裝置新增至佈建設定檔

  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 測試人員的 onboarding 作業,您可以編寫函式,將新 iOS 裝置的 UDID 新增至應用程式的 Provisioning Profile,然後重新建構應用程式,並使用更新版 Provisioning Profile 重新發布應用程式。

如要使用 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 快訊的參考文件。

後續步驟