本頁面提供疑難排解說明,並針對使用 App Distribution 發布及測試應用程式的常見問題提供解答。
發布應用程式
請按照下列提示排解,將應用程式發布給測試人員時可能遇到的問題。
缺少聯絡電子郵件地址,因此無法發布應用程式
上傳應用程式時,您可能會遇到以下錯誤:
「我們找不到 <app-id>
應用程式的聯絡電子郵件地址。請前往 Firebase 控制台中的 App Distribution 進行設定。」
在 Firebase 控制台設定聯絡電子郵件地址 (如果有的話)。如果問題持續發生,請與 Firebase 支援團隊聯絡。
佈建應用程式時發生錯誤 (400、409 或 500 錯誤)
如果在佈建期間反覆遇到 400、409 或 500 錯誤,請與 Firebase 支援團隊聯絡。將您的 Firebase 專案編號和應用程式 ID 提供給支援人員。
無法上傳 IPA
以下是瀏覽器網路回應範例:
{
"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 帳戶
使用者建立 Google 帳戶後,系統會自動為他們設定一個 Gmail 地址。
如果測試人員沒有 Google Workspace 或 Gmail 地址,或是想使用其他電子郵件地址登入,請要求測試人員將非 Gmail 電子郵件地址連結至帳戶,然後使用該電子郵件登入。
選擇備用電子郵件地址時,測試人員必須遵循下列規範:
- 請勿使用 Gmail 地址。
- 不要使用已連結至其他 Google 帳戶的電子郵件地址。
- 使用這個電子郵件地址登入時,請使用您的 Google 帳戶密碼。
詳情請參閱使用其他電子郵件地址登入 Google 帳戶。
測試人員看不到正確的應用程式或版本
如果測試人員使用與邀請中所列不同的電子郵件地址接受電子郵件邀請,可能就無法查看正確的應用程式或版本。
開發人員傳送邀請並新增至新版本的電子郵件 (電子郵件 A),可能與測試人員用來接受邀請的電子郵件 (電子郵件 B) 不同。這樣就能在幕後建立連結。每當電子郵件 A 新增至新建構時,實際上是電子郵件 B 取得存取權。
如果測試人員使用其他電子郵件地址接受電子郵件邀請,請按照下列步驟解決問題:
前往 Firebase 控制台「App Distribution」頁面,然後在「Testers &Groups」分頁中,刪除「View all 測試人員」部分的「查看所有測試人員」部分。系統會移除現有邀請。
重新邀請測試人員測試應用程式。測試人員應會收到邀請電子郵件。
請確認測試人員接受電子郵件地址相同的邀請。
測試人員沒有收到電子郵件通知
發生下列情況時,測試人員可能不會收到電子郵件通知:
解決方案 1
請測試人員檢查垃圾郵件資料夾,以及在電子郵件服務中設定的任何電子郵件篩選器。
如果測試人員取消訂閱電子郵件,請要求測試人員執行下列操作:
- 找出測試人員先前透過應用程式收到的電子郵件。
- 按一下底部的「管理電子郵件設定」,然後點選「允許電子郵件」重新訂閱。
解決方案 2
如果測試人員不想收到電子郵件通知,只想接受應用程式邀請,可以直接在 Firebase App Distribution 網頁剪報中查看待處理的應用程式邀請:appdistribution.firebase.google.com。
解決方案 3
前往 Firebase 控制台,在「App Distribution」頁面的「測試人員和群組」分頁中,從「查看所有測試人員」部分刪除測試人員。這項操作會移除現有的邀請。
重新邀請測試人員測試應用程式。測試人員應會收到邀請電子郵件。確認測試人員接受邀請時,使用的電子郵件地址與收到邀請的電子郵件地址相同。
嘗試執行測試應用程式時,出現「不受信任的企業開發人員」錯誤
如果您在開啟應用程式前,未信任測試裝置上的開發人員憑證,就會出現「Untrusted Enterprise Developer」錯誤。請在「設定」應用程式 >「Profiles & Device Management」畫面中,選取應用程式的開發人員名稱並信任該開發人員。
嘗試執行測試應用程式時,出現「需要開發人員模式」錯誤
如果您在 iOS 16 以上版本中嘗試啟動臨時佈建的 iOS 應用程式,但未先啟用開發人員模式,系統就會顯示「開發人員模式必要」錯誤。
如要啟用開發人員模式並解決這項錯誤,請按照下列步驟操作:
- 在 iPhone 上開啟「設定」應用程式,然後輕觸「隱私權和安全性」。
- 向下捲動至「安全性」,然後輕觸「開發人員模式」。
- 輕觸「開發人員模式」滑桿。
- 輕觸「重新啟動」。
- 裝置重新啟動後,請解鎖裝置。要啟用開發人員模式嗎?對話方塊會隨即顯示。
- 輕觸「開啟」。您現在可以啟動應用程式並開始測試。
「裝置已註冊,一切準備就緒!應用程式可供測試時,系統會傳送電子郵件給你」
如果要安裝 Ad Hoc 發布管道,當開發人員尚未將應用程式設為在測試裝置上執行時,系統就會顯示這則訊息。如要讓開發人員提供應用程式,他們必須完成「註冊其他裝置」中的操作說明。
Google 帳戶沒有測試應用程式的存取權
如果您的 Google 帳戶無法存取先前安裝 (或接受邀請) 的測試應用程式,表示您可能登入錯誤的 Google 帳戶。您可以存取的應用程式會與您首次接受應用程式測試邀請時使用的 Google 帳戶相關聯。請使用先前接受邀請時使用的 Google 帳戶登入,再試一次。
使用 App Distribution iOS SDK 啟用應用程式內警示
請參考下列提示,排解使用 App Distribution iOS SDK 啟用應用程式內新版本快訊時發生的問題。
測試人員未收到應用程式內快訊
如果您已在應用程式中設定 App Distribution iOS SDK,但測試人員未收到應用程式內快訊,請確認應用程式是否正在擷取新版本:
在應用程式中啟用偵錯模式。如需瞭解如何操作,請參閱 Google Analytics 說明文件。
在模擬器中執行應用程式,並搜尋「[Firebase/AppDistribution]」字串。
確認測試人員可以存取新版本:
如果系統傳回有效的釋放物件,則表示 View Controller 生命週期中可能發生問題,因為在 View 顯示前,系統會先載入警示對話方塊。
如果未傳回任何版本,可能是測試人員尚未與新版本建立關聯。在 Firebase 主控台的 App Distribution 資訊主頁中,確認測試人員已納入建構版本發布作業,且處於「已接受」狀態。
如果測試人員仍未收到更新,請要求他們按照下列提示操作,確保他們已接受應用程式測試邀請,並正確設定測試裝置:
在測試裝置上登入 Firebase 應用程式發布功能網頁剪輯片段。請記得選取您接受應用程式測試邀請時所使用的 Google 帳戶。
確認網頁剪輯片段中提供的新應用程式版本。
測試人員在關閉應用程式後會收到登入提示
根據預設,測試人員只需登入 Google 帳戶一次,就能啟用新的建構快訊並安裝新版本。如果測試人員在關閉及重新開啟應用程式後,系統會再次提示他們登入,請按照下列提示操作,確保 App Distribution 設定正確無誤:
請檢查確認您已啟用 Firebase App Testers API。詳情請參閱「啟用 App Distribution Tester API」。
在「金鑰限制」下方,確認 Firebase App Testers API 已納入允許的 API 清單。
如果您通常會在登出時清除 UserDefaults,可能會清除測試人員的狀態。App Distribution 會儲存標記,指出測試人員是否已登入應用程式。詳情請參閱 GitHub 存放區。
常見問題
在應用程式中新增測試人員是否有限制?
Firebase App Distribution 的測試人員數量上限如下:
如要新增更多測試人員,請提出免費的限制增加要求。
測試人員的邀請是否會過期?
測試人員有 30 天的時間可以接受邀請,在到期前接受測試應用程式。
邀請到期前 5 天,Firebase 控制台會在版本測試人員旁邊顯示到期通知。您可以透過測試人員資料列的下拉式選單重新傳送邀請,藉此更新邀請。
何時會為 iOS 上傳內容建立新版本?
請參閱註冊其他裝置。
應用程式版本可供使用多久?
如果發生下列任一情況,系統就會從 App Distribution 移除應用程式版本:
- 應用程式版本超過 150 天。
- 應用程式版本數量已超過 1,000 個上限,且有新版本超過最近 1,000 個版本。
詳情請參閱「App Distribution 最多支援 1,000 個版本」。
如果應用程式達到或超過 150 天的到期上限或應用程式 1,000 個發布上限,該版本就會從 App Distribution 資訊主頁和 App Distribution 測試人員網頁應用程式中移除。如果測試人員已安裝該版本,本機版本的應用程式仍會繼續執行。
如要延長應用程式版本的供應時間,請參考下列其中一種建議:
- 在應用程式版本到期或超過版本限制之前,請下載 IPA 並從 App Distribution 資訊主頁刪除該版本。然後將 IPA 做為新的建構項目重新上傳至 App Distribution。
- 下載發布內容並上傳至 Cloud Storage,以便長期封存。
應用程式發布版本會在 150 天後到期
將應用程式版本上傳至 Firebase 後,該版本會在 App Distribution 資訊主頁中顯示 150 天,時間從上傳日期開始計算。上傳版本後,您可以將版本發布給測試人員,讓他們在測試裝置上透過 App Distribution 測試人員網頁應用程式安裝版本。
當發布版本距離到期日 30 天時,應用程式發布到期日通知會顯示在 Firebase 控制台的 App Distribution 頁面和 App Distribution 測試人員網頁應用程式中。
App Distribution 最多支援 1,000 個版本
App Distribution 允許每個應用程式最多只能有 1,000 個版本。如果應用程式達到 1,000 個版本的上限,App Distribution 就會自動刪除超過限制的最舊版本。
如果您想手動管理應用程式版本,請使用 App Distribution REST API 列出及刪除應用程式版本。
如有任何問題,請與 Firebase 支援團隊聯絡。
什麼是 Firebase 設定檔?
Firebase 設定檔是可讓 App Distribution 執行下列操作的設定檔:
收集裝置的專屬裝置 ID (UDID) 來註冊測試裝置。如果您測試 Ad Hoc 發布版本,Firebase 會向應用程式開發人員傳送一封內含測試裝置 UDID 的電子郵件,以及在應用程式的佈建設定檔中加入裝置的操作說明,以便在您的裝置上測試該版本。
在裝置的主畫面上安裝 Firebase App Distribution 網頁剪輯片段。您可以透過網頁剪輯片段,在同一個位置安裝及存取所有測試應用程式。您受邀測試的新版本會自動新增至網頁剪輯。
如需在 iOS 裝置上安裝設定設定檔的相關說明,請參閱 Apple 說明文件。
如何存取裝置上安裝的測試應用程式?
如果您是測試人員,可以透過 Firebase App Distribution 網頁片段存取所有測試應用程式,這個片段會在您安裝 Firebase 設定檔時自動新增至測試裝置的主畫面。如果要測試廣告導覽發布,就必須先安裝設定檔,才能測試應用程式。
如果您要測試 Enterprise 發布版本,可以手動安裝設定檔:
如果尚未登入 Google,請先登入並接受邀請。
在「測試應用程式」下方,選取要測試的應用程式。
輕觸應用程式頁面右上方的 mobile_screen_share。
按照顯示的操作說明安裝 Firebase 設定檔。
如何刪除測試人員帳戶?
如要刪除 App Distribution 測試人員帳戶及相關聯的資料,請依序按照下列步驟操作:
前往 https://appdistribution.firebase.google.com,然後使用 Google 帳戶登入。
按一下右上方的 settings (「管理帳戶」)
刪除帳戶。
選用:在您的 Google 帳戶權限中,撤銷 Firebase App Distribution 的存取權。請注意,在撤銷存取權前,必須先刪除 App Distribution 帳戶,系統「不會」刪除您的測試人員帳戶或資料。