此頁面提供疑難解答幫助以及有關使用 App Distribution 分發和測試應用程序的常見問題解答。
分發應用程序
使用以下提示解決您在向測試人員分發應用程序時可能遇到的問題。
上傳應用程序時,您可能會遇到此錯誤:
“我們找不到應用<app-id>
的聯繫電子郵件。請訪問 Firebase 控制台中的 App Distribution 進行設置。”
如果可用,請在 Firebase 控制台中設置聯繫人電子郵件。如果問題仍然存在,請聯繫Firebase 支持。
如果您在配置過程中反复遇到錯誤 400、409 或 500,請聯繫Firebase 支持。向支持人員提供您的 Firebase 項目編號和應用程序標識符。
以下是瀏覽器網絡響應的示例:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
要解決此問題,請按照下列步驟操作:
驗證 IPA 的大小。所有二進製文件的最大文件大小限制為 2048 MiB,略高於 2 GB。
如果 IPA 大小在文件大小限制內並且可重現,請執行以下步驟:
檢查您的
Info.plist
文件並確認CFBundleDisplayName
是否包含任何<array>
分隔符。刪除
<array>
分隔符並重建您的應用程序。上傳應該會成功。如果您仍然遇到問題,請聯繫Firebase 支持。
如果 IPA 大小超過文件大小限制,請進行任何必要的更改以減小文件大小。
如果減小 IPA 文件大小不能解決問題,請聯繫Firebase 支持並詢問有關使用Testflight 的問題。
安裝和測試應用程序
使用以下提示解決測試人員在安裝和測試您的應用程序時可能遇到的問題。
當用戶創建 Google 帳戶時,他們會自動收到一個 Gmail 地址。
如果測試人員沒有 Google Workspace 或 Gmail 地址,或者如果他們更願意使用其他電子郵件地址登錄,請要求測試人員將非 Gmail 電子郵件地址鏈接到該帳戶並使用該電子郵件地址登錄。
選擇備用電子郵件時,測試人員必須遵循以下準則:
- 不要使用 Gmail 地址。
- 不要使用已經關聯到其他 Google 帳戶的電子郵件地址。
- 使用此電子郵件地址登錄時,請記住使用您的 Google 帳戶密碼。
有關詳細信息,請參閱使用其他電子郵件地址登錄您的 Google 帳戶。
如果測試人員接受電子郵件邀請時使用的電子郵件地址與發送邀請的地址不同,則測試人員可能無法看到正確的應用程序或構建。
開發人員發送邀請並添加到新構建的電子郵件(電子郵件 A)可以不同於測試人員用來接受邀請的電子郵件(電子郵件 B)。這會在幕後創建一個鏈接。每當將電子郵件 A 添加到新構建中時,實際上是電子郵件 B 獲得了訪問權限。
如果測試人員接受了具有不同電子郵件地址的電子郵件邀請,請按照以下步驟解決問題:
從 Firebase 控制台的 App Distribution 頁面的Testers & Groups選項卡的View all testers部分刪除測試員。現有邀請將被刪除。
重新邀請測試人員測試您的應用。測試人員應該會收到一封邀請電子郵件。
確保測試人員接受具有相同電子郵件地址的邀請。
如果發生以下情況之一,測試人員可能收不到電子郵件通知:
電子郵件通知被發送到垃圾郵件文件夾。
電子郵件過濾器已設置。
邀請被發送到一個電子郵件帳戶,但測試人員接受了另一個電子郵件帳戶。測試人員收到最初發送邀請的電子郵件帳戶的新發布電子郵件。
測試人員之前收到過邀請,但沒有接受初始邀請。如果測試人員被添加到後續版本,App Distribution 不會自動向該測試人員發送發布通知,因為測試人員未接受初始邀請。
解決方案 1
讓測試人員檢查他們的垃圾郵件文件夾和他們在電子郵件服務中設置的任何電子郵件過濾器。
如果測試人員取消訂閱電子郵件,請要求測試人員執行以下操作:
- 查找測試人員之前從應用程序收到的電子郵件。
- 單擊底部的管理電子郵件設置,然後單擊允許電子郵件重新訂閱。
方案二
從 Firebase 控制台的 App Distribution 頁面的Testers & Groups選項卡的View all testers部分刪除測試員。此操作刪除現有邀請。
重新邀請測試人員測試您的應用。測試人員應該會收到一封邀請電子郵件。確保測試人員接受邀請時使用的電子郵件地址與收到邀請的電子郵件地址相同。
如果您在打開應用程序之前不信任測試設備上的開發人員證書,則會出現不受信任的企業開發人員錯誤。在設置應用 >配置文件和設備管理屏幕中,選擇應用的開發者名稱並信任它。
當您嘗試在 iOS 16 或更高版本上啟動臨時配置的 iOS 應用程序而不先啟用開發人員模式時,會出現“需要開發人員模式”錯誤。
要啟用開發人員模式並解決此錯誤,請執行以下步驟:
- 在您的 iPhone 上,打開“設置”應用,然後點擊“隱私與安全” 。
- 向下滾動到 Security 並點擊Developer Mode 。
- 點擊開發者模式滑塊。
- 點擊重啟。
- 設備重啟後,解鎖設備。打開開發者模式?對話框出現。
- 點擊打開。您現在可以啟動您的應用程序並開始測試。
如果您正在安裝 Ad Hoc 發行版,當開發人員尚未配置他們的應用程序以在您的測試設備上運行時,會出現此消息。要向您提供該應用程序,開發人員必須完成註冊其他設備中的說明。
如果您的 Google 帳戶無權訪問您之前安裝(或接受邀請)的測試應用程序,則很可能是您登錄了錯誤的 Google 帳戶。您有權訪問的應用程序與您首次接受測試該應用程序的邀請時使用的 Google 帳戶相關聯。使用您之前用於接受邀請的 Google 帳戶登錄,重試。
當您遇到 403 錯誤時,這意味著您使用的帳戶沒有安裝和測試應用程序的權限。訪問權限由您在 Google Workspace 中的帳號所在域的管理員決定。
如果您認為自己應該有權安裝和測試應用,請讓您的 Google Workspace 帳號管理員更改您的帳號設置。您的管理員應按照管理對不受單獨控制的服務的訪問中的說明進行操作。
如果您有多個帳戶,請嘗試使用不受安裝和測試應用程序限制的其他帳戶登錄。
使用 App Distribution iOS SDK 啟用應用內提醒
使用以下提示解決涉及使用 App Distribution iOS SDK 啟用應用內新構建警報的問題。
如果您已經在您的應用中設置 App Distribution iOS SDK,並且您的測試人員未收到應用內提醒,請檢查以確保您的應用正在獲取新版本:
在您的應用中啟用調試模式。要了解如何操作,請參閱Google Analytics 文檔。
在模擬器中運行您的應用並蒐索字符串“[Firebase/AppDistribution]”。
檢查測試人員是否有權訪問新版本:
如果返回有效的發布對象,則可能是視圖控制器生命週期中存在問題,即在視圖出現之前加載警報對話框。
如果沒有返回版本,則您的測試人員可能尚未與新版本相關聯。在 Firebase 控制台的 App Distribution 儀表板中,確保您的測試人員包含在您的構建分發中並且處於已接受狀態。
如果您的測試人員仍未收到更新,請讓他們按照以下提示進行操作,以確保他們接受了測試您應用的邀請並正確設置了他們的測試設備:
在測試設備上,登錄 Firebase App Distribution 網絡剪輯。請記住選擇您接受測試應用程序邀請時首次使用的 Google 帳戶。
確保新的應用程序版本在網絡剪輯中可用。
默認情況下,您的測試人員只需登錄他們的 Google 帳戶一次即可啟用新構建警報並安裝新構建。如果您的測試人員在關閉並重新打開您的應用程序後被提示再次登錄,請按照以下提示操作以確保您的 App Distribution 配置設置正確:
檢查以確保您已啟用 Firebase App Testers API。有關詳細信息,請參閱啟用 App Distribution Tester API 。
在Key restrictions下,確保 Firebase App Testers API 包含在允許的 API 列表中。
如果您通常在註銷時清除 UserDefaults,您可能正在清除測試人員的狀態。 App Distribution 存儲一個標誌,指示您的測試人員是否已經登錄到該應用程序。有關更多信息,請參閱GitHub 存儲庫。
經常問的問題
Firebase App Distribution 具有以下測試人員限制:
最多可向一個 Firebase 項目添加 500 名測試人員
最多可向 App Distribution 組添加 200 名測試人員
要添加更多測試人員,請請求免費增加限制。
測試人員有 30 天的時間接受邀請,在邀請到期前測試該應用。當邀請還有 5 天到期時,Firebase 控制台中發布的測試人員旁邊會顯示到期通知。可以通過測試人員行上的下拉菜單重新發送邀請來更新邀請。
請參閱註冊其他設備。
如果出現以下情況之一,應用程序版本將從應用程序分發中刪除:
- 應用程序版本早於 150 天。
- 您超過了 1,000 個應用程序版本限制,並且該應用程序版本早於最近的 1,000 個應用程序版本。
有關詳細信息,請參閱App Distribution 最多支持 1,000 個版本。
在應用程序達到或超過 150 天到期限製或 1,000 個應用程序發布限制後,該版本將從應用程序分發儀表板和應用程序分發測試器 Web 應用程序中刪除。如果您的測試人員已安裝該版本,則該應用程序的本地版本將繼續運行。
要使應用版本的可用時間更長,請使用以下建議之一:
- 在應用發佈到期或超過發布限制之前,下載 IPA 並從 App Distribution 儀表板中刪除發布。然後,將 IPA 作為新版本重新上傳到 App Distribution。
- 下載版本並將其上傳到Cloud Storage以進行長期存檔。
應用程序版本在 150 天后過期
當您將應用程序的版本上傳到 Firebase 時,該版本會在App Distribution 儀表板中顯示 150 天,從上傳日期算起。上傳版本後,您可以將其分發給測試人員,測試人員從他們的測試設備上的 App Distribution 測試人員 Web 應用安裝版本。
當版本距離到期日期還有 30 天時,應用程序版本到期通知會出現在 Firebase 控制台的應用程序分發頁面和應用程序分發測試器 Web 應用程序中的版本上。
App Distribution 最多支持 1,000 個版本
App Distribution 允許每個應用最多發布 1,000 個版本。當您的應用程序達到 1,000 個應用程序版本限制時,App Distribution 會自動刪除超出限制的最舊版本。
如果您想手動管理應用版本,請使用 App Distribution REST API 批量列出和刪除應用版本。
如有疑問,請聯繫Firebase 支持。
Firebase 配置文件是一個配置文件,它允許 App Distribution 執行以下操作:
通過收集設備的唯一設備 ID (UDID) 來註冊測試設備。如果您正在測試 Ad Hoc 分發,Firebase 會向應用程序開發人員發送一封電子郵件,其中包含測試設備的 UDID,以及有關如何將設備包含在應用程序配置文件中的說明,以便可以在您的設備上測試構建。
將 Firebase App Distribution 網絡剪輯安裝到您設備的主屏幕。 Web Clip 允許您在一個地方安裝和訪問所有測試應用程序。您受邀測試的新版本會自動添加到網絡剪輯中。
有關在 iOS 設備上安裝配置描述文件的幫助,請參閱Apple 文檔。
如果您是測試人員,則可以使用Firebase App Distribution web clip訪問您的所有測試應用程序,它會在您安裝 Firebase 配置文件時自動添加到測試設備的主屏幕。如果您正在測試 Ad Hoc 發行版,則必須先安裝配置文件,然後才能測試該應用程序。
如果您正在測試企業發行版,則可以手動安裝配置文件:
如果您還沒有,請登錄 Google 並接受邀請。
在Test apps下,選擇要測試的應用程序。
在應用程序頁面的右上角,點按mobile_screen_share 。
按照顯示的說明安裝 Firebase 配置文件。
要刪除您的 App Distribution 測試員帳戶及其關聯數據,請按順序執行以下步驟:
訪問https://appdistribution.firebase.google.com並使用您的 Google 帳戶登錄。
在右上角,單擊
(管理帳戶)刪除帳戶。
可選:在您的Google 帳戶權限中,撤銷 Firebase App Distribution 的訪問權限。請注意,在未先刪除您的 App Distribution 帳戶的情況下撤銷訪問權限不會刪除您的測試員帳戶或數據。