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