此頁面提供故障排除幫助以及有關使用 App Distribution 分發和測試應用程序的常見問題解答。
分發應用程序
使用以下提示來解決您在向測試人員分發應用程序時可能遇到的問題。
上傳應用時,您可能會遇到此錯誤:
“我們找不到應用<app-id>
的聯繫電子郵件。請訪問 Firebase 控制台中的應用分發進行設置。”
在 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 不會自動向該測試人員發送發布通知,因為測試人員沒有接受初始邀請。
解決方案 1
要求測試人員檢查他們的垃圾郵件文件夾以及他們在電子郵件服務中設置的任何電子郵件過濾器。
如果測試人員取消訂閱電子郵件,請讓測試人員執行以下操作:
- 查找測試人員之前從應用程序收到的電子郵件。
- 單擊底部的管理電子郵件設置,然後單擊允許電子郵件重新訂閱。
解決方案 2
從 Firebase 控制台的“應用分發”頁面的“測試人員和組”選項卡中刪除測試人員。此操作會刪除現有邀請。
重新邀請測試人員測試您的應用。測試人員應該會收到一封邀請電子郵件。確保測試人員使用與發送邀請相同的電子郵件地址接受邀請。
如果您在打開應用程序之前不信任測試設備上的開發人員證書,則會出現Untrusted Enterprise Developer錯誤。在設置應用 >配置文件和設備管理屏幕中,選擇應用的開發者名稱並信任它。
如果您正在安裝 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]”。
檢查測試人員是否可以訪問新版本:
如果返回了有效的發布對象,則可能是在 View Controller 生命週期中存在問題,即在 View 出現之前加載了警報對話框。
如果未返回任何版本,則您的測試人員可能尚未與新版本關聯。在 Firebase 控制台的 App Distribution 儀表板中,確保您的測試人員包含在您的構建分發中並且處於Accepted狀態。
如果您的測試人員仍未收到更新,請讓他們按照以下提示操作,以確保他們接受了測試您的應用的邀請並正確設置了測試設備:
在測試設備上,登錄 Firebase 應用分發網絡剪輯。請記住選擇您在接受測試應用邀請時首次使用的 Google 帳戶。
確保新的應用程序版本在網絡剪輯中可用。
默認情況下,您的測試人員只需登錄其 Google 帳戶一次即可啟用新版本警報並安裝新版本。如果在關閉並重新打開您的應用程序後提示您的測試人員再次登錄,請按照以下提示確保您的應用程序分發配置設置正確:
檢查以確保您已啟用 Firebase App Testers API。有關更多信息,請參閱啟用 App Distribution Tester API 。
在Key limits 下,確保 Firebase App Testers API 包含在允許的 API 列表中。
如果您通常在退出時清除 UserDefaults,則您可能正在清除測試人員的狀態。 App Distribution 存儲一個標誌,指示您的測試人員是否已經登錄到應用程序。有關更多信息,請參閱GitHub 存儲庫。
經常問的問題
Firebase App Distribution 具有以下測試人員限制:
最多向 Firebase 項目添加 500 名測試人員
將最多 200 名測試人員添加到應用分發組
要添加更多測試人員,請請求免費增加限制。
測試人員有 30 天的時間在應用程序過期前接受測試邀請。當邀請距過期還有 5 天時,過期通知會出現在 Firebase 控制台中某個版本的測試人員旁邊。可以通過測試人員行的下拉菜單重新發送邀請來更新邀請。
如果發生以下情況之一,將從 App Distribution 中刪除 App 版本:
- 應用程序版本超過 150 天。
- 您超過了 1,000 個應用程序版本限制,並且該應用程序版本早於 1,000 個最近的應用程序版本。
有關更多信息,請參閱App Distribution 最多支持 1,000 個版本。
在應用程序達到或超過 150 天到期限製或 1,000 個應用程序發布限制後,將從應用程序分發儀表板和應用程序分發測試程序 Web 應用程序中刪除該版本。如果您的測試人員已安裝該版本,則應用程序的本地版本將繼續運行。
要使應用程序版本的可用時間更長,請使用以下建議之一:
- 在應用發布過期或超過發布限制之前,下載 IPA 並從應用分發儀表板中刪除該發布。然後,將 IPA 作為新版本重新上傳到 App Distribution。
- 下載版本並將其上傳到Cloud Storage以進行長期存檔。
應用程序版本在 150 天后過期
當您將應用的版本上傳到 Firebase 時,該版本會在應用分發信息中心中顯示 150 天,從上傳日期開始。上傳版本後,您可以將其分發給測試人員,他們從 App Distribution 測試人員 Web 應用程序在其測試設備上安裝該版本。
當版本距到期日期 30 天時,應用版本到期通知會顯示在 Firebase 控制台的應用分發頁面和應用分發測試程序 Web 應用中的版本上。
App Distribution 最多支持 1,000 個版本
應用分發最多允許每個應用發布 1,000 個版本。當您的應用達到 1,000 個應用發布限制時,App Distribution 會自動刪除超過限制的最舊版本。
如果您想手動管理應用版本,請使用應用分發 REST API 批量列出和刪除應用版本。
如果您有任何疑問,請聯繫Firebase 支持。
Firebase 配置文件是一個配置文件,它允許應用分發:
通過收集設備的唯一設備 ID (UDID) 來註冊測試設備。如果您正在測試 Ad Hoc 發行版,Firebase 會向應用開發者發送一封電子郵件,其中包含測試設備的 UDID,以及如何將設備包含在應用的配置文件中的說明,以便可以在您的設備上測試構建。
將 Firebase 應用分發網絡剪輯安裝到您設備的主屏幕。 Web 剪輯允許您在一處安裝和訪問所有測試應用程序。您受邀測試的新版本會自動添加到網絡剪輯中。
有關在 iOS 設備上安裝配置文件的幫助,請參閱Apple 的文檔。
如果您是測試人員,則可以使用Firebase 應用分發網絡剪輯訪問您的所有測試應用,當您安裝 Firebase 配置文件時,該網絡剪輯會自動添加到您的測試設備的主屏幕。如果您正在測試 Ad Hoc 發行版,則必須先安裝配置文件,然後才能測試應用程序。
如果您正在測試 Enterprise 發行版,您可以手動安裝配置文件:
如果您尚未登錄,請登錄 Google 並接受邀請。
在測試應用下,選擇您要測試的應用。
在應用頁面的右上角,點擊mobile_screen_share 。
按照顯示的說明安裝 Firebase 配置文件。
要刪除您的 App Distribution 測試人員帳戶及其關聯數據,請按順序執行以下步驟:
訪問https://appdistribution.firebase.google.com並使用您的 Google 帳戶登錄。
在右上角,點擊
(管理帳戶)刪除帳戶。
可選:在您的Google 帳戶權限中,撤消 Firebase App Distribution 的訪問權限。請注意,在不首先刪除您的 App Distribution 帳戶的情況下撤消訪問權限不會刪除您的測試人員帳戶或數據。