應用程式發布疑難排解與協助；常見問題

iOS Android

本頁提供疑難排解說明和常見問題解答 關於使用應用程式發布發布及測試應用程式的問題。

發行應用程式

如果在上傳過程中可能遇到 以及將應用程式發布給測試人員

缺少聯絡電子郵件地址，因此無法發布應用程式

上傳應用程式時，您可能會遇到以下錯誤：

「我們找不到 <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."
}

如要解決這個問題，請按照下列步驟操作：

1. 確認 IPA 的大小。所有二進位檔的檔案大小上限為 2048 MiB，相差超過 2 GB。

2. 如果 IPA 大小在檔案大小限制內，可重現，請按照 步驟如下：

   1. 檢查您的 Info.plist 檔案，並確認 CFBundleDisplayName 包含任何 <array> 分隔符號。

      注意： 應用程式發布不接受 CFBundleDisplayName 值。 都是陣列。

   2. 移除 <array> 分隔符號，然後重新建構應用程式。上傳文件 成功。

   3. 如果問題仍無法解決，請與 Firebase 支援團隊聯絡。

3. 如果 IPA 大小超過檔案大小上限，請進行必要變更， 縮減檔案大小

4. 如果調降 IPA 檔案大小無法解決問題，請與 Firebase 支援並詢問如何使用 測試。

安裝及測試應用程式

請按照下列提示排解測試人員可能遇到的問題 使用者在安裝及測試應用程式時可能會遇到什麼狀況

測試人員沒有 Google 帳戶

使用者建立 Google 帳戶後，系統會自動為他們設定一個 Gmail 地址。

如果測試人員沒有 Google Workspace 或 Gmail 地址，或是會 例如使用其他電子郵件地址登入，請要求測試人員將 Gmail 連結至非 Gmail 帳戶 電子郵件地址連結到帳戶，然後使用該電子郵件地址登入。

選擇備用電子郵件地址時，應遵守下列原則：

• 請勿使用 Gmail 地址。
• 不要使用已連結至其他 Google 帳戶的電子郵件地址。
• 使用這個電子郵件地址登入時，別忘了使用你的 Google 帳戶密碼 讓我們看看 DNS 解析 進一步探索內部和外部位址

詳情請參閱使用其他電子郵件地址登入 Google 帳戶。

測試人員看不到正確的應用程式或版本

如果測試人員接受電子郵件邀請，但接受的電子郵件地址並非 測試人員可能找不到正確的應用程式 建構應用程式

開發人員傳送邀請至新版本的電子郵件 (電子郵件 A) 可以與測試人員接受 邀請 (電子郵件 B)。這樣就能在幕後建立連結。每次電子郵件 A 時 就是取得存取權的電子郵件 B。

如果測試人員透過其他電子郵件地址接受了電子郵件邀請， 請按照下列步驟解決問題：

1. 從「測試人員和」的「查看所有測試人員」部分刪除測試人員。「應用程式發布」頁面中的「群組」分頁 頁面。系統會移除現有邀請。

2. 再次邀請測試人員測試應用程式。測試人員應會收到 邀請電子郵件。

3. 請確認測試人員接受電子郵件地址相同的邀請。

測試人員沒有收到電子郵件通知

如果發生下列任一情況，測試人員可能不會收到電子郵件通知：

• 電子郵件通知會傳送到垃圾郵件資料夾。

• 已設定電子郵件篩選器。

• 邀請已傳送至一個電子郵件帳戶，但測試人員已接受 另一個電子郵件帳戶。測試人員會收到 收到邀請函的原始電子郵件帳戶。

• 先前已邀請測試人員，但並未接受初始邀請。 如果測試人員在後續版本中加入測試人員，將無法應用程式發布 系統會自動將發布通知傳送給該測試人員 未接受初始邀請。

解決方案 1

1. 請測試人員檢查垃圾郵件資料夾，以及他們先前設定的所有電子郵件篩選器 他們的電子郵件服務。

2. 如果測試人員取消訂閱電子郵件，請要求測試人員執行這項操作 包括：

   1. 找出測試人員先前透過應用程式收到的電子郵件。
   2. 按一下底部的「管理電子郵件設定」，然後點選「允許寄送電子郵件」。 重新訂閱。

解決方案 2

如果該測試人員不在意接收電子郵件通知，而是只想 可以選擇接受應用程式邀請，也可以查看待回覆的應用程式邀請 直接在 Firebase 應用程式發布網頁片段中操作： appdistribution.firebase.google.com。

注意： 如要查看待接受的應用程式邀請， 測試人員用來登入網頁片段的帳戶必須與收件者電子郵件地址相符 開發人員邀請的電子郵件地址。

解決方案 3

1. 從「測試人員和」的「查看所有測試人員」部分刪除測試人員。「應用程式發布」頁面中的「群組」分頁 頁面。這項操作會移除現有的邀請，

2. 再次邀請測試人員測試應用程式。測試人員應會收到 邀請電子郵件。確認測試人員接受含有 這個電子郵件地址。

「不受信任的企業開發人員」執行測試應用程式時發生錯誤

如果您未這麼做，系統會顯示「不受信任的企業開發人員」錯誤訊息 先信任測試裝置上的開發人員憑證，再開啟應用程式。 在「設定」應用程式 >設定檔與裝置管理畫面中，選取 應用程式的開發人員名稱，並加以信任。

「必須使用開發人員模式」執行測試應用程式時發生錯誤

嘗試啟動廣告時，出現「開發人員模式的必要錯誤」錯誤訊息 在 iOS 16 以上版本中臨時佈建的 iOS 應用程式，但未先啟用開發人員 模式。

如要啟用開發人員模式並解決這項錯誤，請按照下列步驟操作：

1. 在 iPhone 上開啟「設定」應用程式，然後輕觸 [隱私權與]安全性：
2. 向下捲動至「安全性」，然後輕觸「開發人員模式」。
3. 輕觸「開發人員模式」滑桿。
4. 輕觸「重新啟動」。
5. 裝置重新啟動後，請解鎖裝置。要開啟開發人員模式嗎？ 對話方塊。
6. 輕觸「開啟」。您現在可以發布應用程式，並開始測試了。

「裝置註冊完成，一切準備就緒！在應用程式可供測試時，我們會透過電子郵件通知你」

要是您正在安裝 Ad Hoc 發行版，則這則訊息會在 開發人員尚未設定在測試裝置上執行的應用程式。 開發人員必須 完成註冊其他裝置一文中的操作說明。

注意： 如果開發人員已發行版本相同的建構版本 只會收到新註冊裝置的使用者 電子郵件通知。

Google 帳戶沒有測試應用程式的存取權

如果您的 Google 帳戶無法存取您先前的測試應用程式 安裝 (或接受了使用者的邀請)，可能是因為您已登入 移至錯誤的 Google 帳戶您有權存取的應用程式 與您初次接受 邀請測試應用程式。請使用 Google 帳戶登入，再試一次 您先前接受邀請的方式。

請注意以下幾點：

• 您用來接受邀請的 Google 帳戶不可 這個帳戶與當初收到邀請的 Google 帳戶相同。
• Google 帳戶可以與任何電子郵件地址建立關聯，而不只是 電子郵件地址。瞭解如何 登入 另一個電子郵件地址

403 錯誤：「請與管理員聯絡，要求對方授予存取權」

如果發生 403 錯誤，表示您使用的帳戶沒有安裝應用程式及測試應用程式的權限。存取權取決於 Google Workspace 帳戶管理員。

如果您認為自己應具備安裝及測試應用程式的權限，請要求 Google Workspace 帳戶管理員變更帳戶設定。管理員應按照「管理非獨立控制服務的存取權」一文的說明操作。

如果您擁有多個帳戶，請嘗試使用其他不會限制安裝及測試應用程式的帳戶登入。

使用應用程式發布的 iOS SDK 啟用應用程式內快訊

您可以運用下列提示排解 使用應用程式發布 iOS SDK 啟用應用程式內新的建構快訊。

測試人員沒有收到應用程式內快訊

如果您已在應用程式中設定應用程式發布 iOS SDK， 測試人員不會收到應用程式內快訊，請確認您的應用程式 擷取新版本：

1. 在應用程式中啟用偵錯模式。若要瞭解操作方式，請參閱 Google Analytics 說明文件。

2. 在模擬器中執行應用程式，並搜尋「[Firebase/AppDistribution]」字串。

3. 請確認測試人員可存取新版本：

   • 如果傳回有效的發布物件， 快訊對話方塊出現於檢視畫面控制器生命週期內的問題 會在畫面顯示前載入。

     注意： 應用程式發布 iOS SDK 未顯示 快訊對話方塊您必須指定對話方塊的方式和位置 。詳情請參閱基本快訊設定。

   • 如果未傳回版本，表示測試人員可能尚未與 新版本。在應用程式的「應用程式發布」資訊主頁中， Firebase 控制台，請確認您的測試已包含測試人員 並且處於已接受狀態。

     如果測試人員還是沒有收到更新內容，請對方按照 下方提示，以確定他們已接受您的 並確認已正確設定測試裝置：

     1. 在測試裝置上登入 Firebase 應用程式發布網站 剪輯片段。請記得選取首次使用的帳戶 已接受邀請測試應用程式。

     2. 請確認新的應用程式版本已出現在網頁剪輯中。

關閉應用程式後，測試人員會收到再次登入的提示

根據預設，測試人員只需登入 Google 帳戶一次， 啟用新的建構快訊及安裝新版本。如果測試人員 關閉應用程式再重新開啟後，系統會提示您重新登入，請按照下列步驟操作： 如何正確調整應用程式發布設定：

• 請檢查確認您已啟用 Firebase App Testers API。如要 資訊，請參閱「啟用 App Distribution Tester API」。

• 在「金鑰限制」下方，確認 Firebase App Testers API 為 並列在允許的 API 清單中

• 如果通常會在登出時清除 UserDefaults，系統可能會清除 測試人員的狀態應用程式發布會儲存旗標，指示系統是否 您的測試人員已登入應用程式。詳情請參閱 GitHub 存放區。

常見問題

在應用程式中新增測試人員是否有限制？

Firebase 應用程式發布有以下測試人員限制：

• 每個 Firebase 專案最多可新增 500 位測試人員

• 為應用程式發布群組新增最多 200 位測試人員

如要新增更多測試人員，請提出免付費要求 提高上限。

測試人員的邀請是否會過期？

在過期前，測試人員有 30 天可以接受邀請，接受邀請。 如果邀請過期的 5 天，系統會在 版本測試人員旁的 Firebase 控制台。您可以更新邀請 ，透過測試工具列的下拉式選單重新傳送。

何時會為 iOS 上傳內容建立新版本？

請參閱註冊其他裝置。

應用程式版本的推出時間有多久？

如果符合下列其中一項條件，應用程式版本就會從「應用程式發布」中移除 會發生下列情況：

• 應用程式版本超過 150 天。
• 應用程式版本數量已超過 1,000 個上限，且應用程式版本低於 1, 000 個 最新的 1,000 個應用程式版本

詳情請參閱應用程式發行支援的版本數量上限為 1,000 個。

在應用程式達到或超過 150 天上限或超過 1,000 個應用程式的情況下 版本上限，該版本就會從「應用程式發布」資訊主頁中移除， 應用程式發布測試人員網頁應用程式。如果測試人員已安裝版本， 持續執行的版本。

如要延長應用程式版本的供應時間，請參考下列其中一種建議：

• 請在應用程式版本到期或超過版本數量上限前下載 IPA，並從「應用程式發布」資訊主頁刪除版本。接著： 重新上傳 IPA，做為新的應用程式發布版本。
• 下載版本並上傳至 Cloud Storage 長期封存的好處

應用程式版本會在 150 天後到期

將應用程式版本上傳至 Firebase 後，該版本會顯示在 應用程式發布資訊主頁 150 天 (自上傳日期起算)。上傳版本後 發布給測試人員，讓他們可透過「應用程式發布」安裝版本 。

在到期日後的 30 天內，代表應用程式版本 到期通知會顯示在「應用程式發布」頁面中。 以及「應用程式發布測試人員」網頁應用程式。

應用程式發布最多支援 1,000 個版本

應用程式發布允許 每個應用程式 1,000 個版本。如果您的應用程式達到 1,000 個版本的上限 應用程式發布會自動刪除最舊的 超出上限的版本。

如要手動管理應用程式版本，請使用 App Distribution REST API 新增至清單 和 delete 大量發布應用程式。

如有任何問題，請與 Firebase 支援團隊聯絡。

什麼是 Firebase 設定檔？

Firebase 設定檔是允許「應用程式發布」功能的組態設定檔：

• 收集裝置的專屬裝置 ID，藉此註冊測試裝置 (UDID)。如果您測試 Ad Hoc 發布管道，Firebase 會將應用程式傳送至 開發人員的電子郵件，內含測試裝置的 UDID，以及測試裝置的 UDID 說明如何將裝置納入應用程式佈建中的操作說明 設定檔，以便在您的裝置上測試該版本。

• 將 Firebase 應用程式發布網頁片段安裝到裝置的住家 。網頁片段可讓您在以下環境中安裝及存取所有測試應用程式 在同一處您受邀測試的新版本如下： 自動新增至網頁剪輯。

如要進一步瞭解如何在 iOS 裝置上安裝組態設定檔，請參閱 Apple 說明文件。

如何存取裝置上安裝的測試應用程式？

測試人員可以透過 Firebase 應用程式發布網站片段，會自動新增至測試 您安裝 Firebase 設定檔後的畫面。如果您測試的 依序放送廣告 安裝設定檔 才能測試應用程式

如果您測試的 企業發布，可以手動安裝設定檔：

1. 如果尚未登入，請登入 Google 並接受邀請。

2. 在「測試應用程式」下方，選取要測試的應用程式。

3. 輕觸應用程式頁面右上方的 。

4. 按照畫面上的操作說明安裝 Firebase 設定檔。

如何刪除測試人員帳戶？

如要刪除應用程式發布測試人員帳戶及相關資料，請按照下列步驟操作： 請依序執行下列步驟：

1. 前往 https://appdistribution.firebase.google.com 然後使用 Google 帳戶登入

2. 按一下右上方的 (「管理帳戶」)

   刪除帳戶。

3. 選用：在 Google 帳戶權限中， 撤銷 Firebase 應用程式發布的存取權。請注意撤銷存取權時， 首次刪除應用程式發布帳戶不會刪除測試人員 帳戶或資料