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