如果您想使用 App Distribution 分發臨時 iOS 構建,您必須按照本指南註冊您的測試人員的設備。臨時構建是未使用企業配置文件簽名的構建。如果設備的唯一設備標識符 (UDID) 包含在構建的配置文件中,則設備只能安裝臨時構建。
當測試人員接受測試您的應用程序的邀請時,App Distribution 會請求允許與您(開發人員)共享測試人員的設備標識符。在下載臨時構建之前,App Distribution 會要求測試人員註冊他們的設備。如果測試人員註冊了他們的設備,App Distribution 會從設備中收集 UDID 並通過電子郵件將 UDID 通知您。
當您收到一封包含 UDID 的電子郵件時,請使用 UDID 更新您的配置文件並將新版本分發給您的測試人員。您可以使用Firebase 控制台或 Firebase CLI手動導出 UDID,也可以使用fastlane以編程方式導出 UDID。
手動導出 UDID
- 將設備添加到您的 Apple 開發人員門戶。
- 選項 1:將設備 UDID 導入為 CSV 文件。
在 App Distribution 儀表板的Testers & Groups選項卡中,選擇All testers ,然後單擊Export Apple UDIDs下載 CSV 文件。接下來,使用“註冊多個設備”選項將文件導入您的Apple 開發者帳戶。要了解更多信息,請參閱將您的應用程序分發到已註冊的設備。
請注意,您的 Apple 開發者帳戶每年可能只允許導入有限數量的設備。
- 選項 2:通過電子郵件收集並輸入 UDID。
在 Apple 開發者門戶的“添加設備”頁面上,註冊您收到的電子郵件中指定的新 UDID。
- 選項 1:將設備 UDID 導入為 CSV 文件。
- 將已註冊的設備添加到您的配置文件中。
- 下載配置文件並使用它來重建您的應用程序。如果您重建只是為了更新已註冊的設備,請不要更新內部版本號或版本。
- 從Firebase 控制台或CLI重新分發您的應用程序。如果您不更改版本、內部版本號或應用代碼,App Distribution 不會創建新版本,也不會通知測試人員。如果您已經分發了具有相同內部版本號和版本的內部版本,則只有新註冊設備的用戶會收到通知電子郵件。
使用 fastlane 以編程方式導出 UDID
從 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
使用Register Multiple Devices選項將 UDID 導入您的Apple 開發者帳戶。要了解更多信息,請參閱Apple 的文檔。請注意,您的 Apple 開發者帳戶每年可能只允許導入有限數量的設備。
將已註冊的設備添加到您的配置文件中。
下載配置文件並使用它來重建您的應用程序。如果您只是為了更新已註冊的設備而重建,請不要更新內部版本號或版本。
重新分發您的應用程序。如果您不更改版本、內部版本號或應用代碼,App Distribution 不會創建新版本,也不會通知測試人員。如果您已經分發了具有相同內部版本號和版本的內部版本,則只有新註冊設備的用戶會收到通知電子郵件。
接收警報
獲取默認警報
默認情況下,Firebase 可以通過電子郵件發送新 iOS 設備註冊的 App Distribution 警報。
要通過此默認機制接收 App Distribution 提醒,您必須擁有firebase.projects.update
權限。默認情況下,以下角色包含此必需權限: Firebase Admin或項目所有者或編輯者。
默認情況下,每個項目成員(具有接收警報所需的權限)都會在註冊新的 iOS 設備時收到一封電子郵件。
為您自己的帳戶打開/關閉警報
對於您自己的帳戶,您可以在不影響其他項目成員的情況下打開/關閉 App Distribution 警報。請注意,您仍然需要所需的權限才能接收警報。
要打開或關閉 App Distribution 提醒,請按照以下步驟操作:
- 在 Firebase 控制台的右上角,轉到 Firebase alerts 。
- 然後,轉到 設置並設置應用程序分發警報的帳戶首選項。
設置對第三方服務的高級警報
您還可以使用 Cloud Functions for Firebase 將 App Distribution 提醒發送到您團隊的首選通知渠道。例如,您可以編寫一個函數來捕獲新 iOS 設備註冊的警報事件,並將警報信息發佈到第三方服務,如 Discord、Slack 或 Jira。
要完全自動化入職新 iOS 測試人員,您可以編寫一個函數,將新 iOS 設備的 UDID 添加到應用程序的配置文件中,重建應用程序,並使用更新後的配置文件重新分發應用程序。
要使用 Cloud Functions for Firebase 設置高級警報功能,請執行以下步驟:
為 Firebase 設置 Cloud Functions ,其中包括以下任務:
- 為 Node.js 或 Python 設置開發環境。
- 安裝並登錄 Firebase CLI。
- 使用 Firebase CLI 初始化 Cloud Functions for Firebase。
編寫並部署一個函數,用於從 App Distribution 捕獲警報事件並處理事件負載(例如,在 Discord 上的消息中發布警報信息)。
要了解您可以捕獲的所有警報事件,請轉到App Distribution 警報的參考文檔。
下一步
要了解如何增加內部測試基礎,請參閱創建邀請鏈接。