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

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

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

「我們找不到應用程式『<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."
}

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

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

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

   1. 檢查 Info.plist 檔案，確認 CFBundleDisplayName 是否包含任何 <array> 分隔符。

   2. 移除 <array> 分隔符並重建應用程式，上傳作業應可順利完成。

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

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

4. 如果縮減 IPA 檔案大小仍無法解決問題，請與 Firebase 支援團隊聯絡，詢問如何使用 Testflight。

測試人員沒有 Google 帳戶

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

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

選擇備用電子郵件地址時，測試人員必須遵守下列規範：

• 請勿使用 Gmail 地址。
• 請勿使用已連結至其他 Google 帳戶的電子郵件地址。
• 使用這個電子郵件地址登入時，請使用 Google 帳戶密碼。

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

測試人員無法查看正確的應用程式或版本

如果測試人員接受電子郵件邀請時使用的電子郵件地址，與您傳送邀請時使用的地址不同，測試人員可能無法查看正確的應用程式或版本。

開發人員用來傳送邀請並新增至新版本的電子郵件地址 (電子郵件 A)，可能與測試人員用來接受邀請的電子郵件地址 (電子郵件 B) 不同。這項操作會在幕後建立連結。每當電子郵件 A 新增至新版本時，實際取得存取權的是電子郵件 B。

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

1. 在 App Distribution 控台的「測試人員與群組」分頁中，前往「查看所有測試人員」部分，然後刪除測試人員。Firebase系統會移除現有邀請。

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

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

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

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

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

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

• 邀請已傳送至某個電子郵件帳戶，但測試人員使用其他電子郵件帳戶接受邀請。測試人員會透過當初收到邀請的電子郵件帳戶，接收新版本發布通知電子郵件。

• 測試人員先前已受邀，但未接受初始邀請。 如果測試人員加入後續版本，App Distribution 不會自動傳送版本通知給該測試人員，因為測試人員未接受初始邀請。

解決方案 1

1. 請測試人員檢查垃圾郵件資料夾，以及電子郵件服務中設定的任何電子郵件篩選器。

2. 如果測試人員取消訂閱電子郵件，請要求他們執行下列操作：

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

解決方案 2

如果測試人員不在意是否收到電子郵件通知，只想接受應用程式邀請，可以直接在 Firebase App Distribution網頁剪輯片段：appdistribution.firebase.google.com 中查看待處理的應用程式邀請。

解決方案 3

1. 在 App Distribution 頁面的 Firebase 控制台中，前往「測試人員與群組」分頁，然後在「查看所有測試人員」部分刪除測試人員。這項操作會移除現有邀請。

2. 重新邀請測試人員測試應用程式。測試人員應會收到邀請電子郵件。請確認測試人員使用收到邀請的電子郵件地址接受邀請。

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

如果開啟應用程式前，您未在測試裝置上信任開發人員憑證，就會出現「Untrusted Enterprise Developer」(不受信任的企業開發人員) 錯誤訊息。請依序前往「設定」應用程式 >「設定檔與裝置管理」畫面，選取應用程式的開發人員名稱並信任該名稱。

嘗試執行測試應用程式時出現「需要開發人員模式」錯誤

如果您在 iOS 16 以上版本中，嘗試啟動臨時佈建的 iOS 應用程式，但未先啟用開發人員模式，系統就會顯示「需要開發人員模式」錯誤訊息。

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

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

「裝置已註冊，一切準備就緒！應用程式可供測試時，系統會傳送電子郵件給你。

如果安裝的是 Ad Hoc 發布版本，表示開發人員尚未設定應用程式，因此無法在測試裝置上執行，才會顯示這則訊息。如要讓您使用應用程式，開發人員必須按照「註冊其他裝置」一文中的操作說明完成註冊。

Google 帳戶無法存取測試應用程式

如果您的 Google 帳戶無法存取先前安裝 (或接受邀請) 的測試應用程式，可能是因為您登入的 Google 帳戶有誤。您有權存取的應用程式會與您首次接受應用程式測試邀請時使用的 Google 帳戶建立關聯。請使用先前接受邀請的 Google 帳戶登入，然後再試一次。

403 錯誤：「請與管理員聯絡，要求對方授予您相關權限」

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

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

如果你有多個帳戶，請嘗試登入其他帳戶，確認該帳戶是否未受限制，可以安裝及測試應用程式。

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

如果您已在應用程式中設定 App Distribution iOS SDK，但測試人員未收到應用程式內快訊，請確認應用程式是否正在擷取新版本：

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

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

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

   • 如果系統傳回有效的發布物件，可能是檢視畫面控制器生命週期發生問題，導致系統在檢視畫面顯示前載入快訊對話方塊。

   • 如果沒有傳回任何版本，表示測試人員可能尚未與新版本建立關聯。在控制台的 App Distribution資訊主頁Firebase中，確認測試人員已納入版本發布範圍，且狀態為「已接受」。

     如果測試人員仍未收到更新，請他們按照下列提示操作，確認已接受測試應用程式的邀請，並正確設定測試裝置：

     1. 在測試裝置上登入 Firebase 應用程式發布網頁剪輯片段。請務必選取您當初接受應用程式測試邀請時使用的 Google 帳戶。

     2. 確認網頁剪報中提供新版應用程式。

測試人員關閉應用程式後，系統會提示再次登入

根據預設，測試人員只要登入 Google 帳戶一次，即可啟用新版本快訊並安裝新版本。如果測試人員關閉並重新開啟應用程式後，系統會提示他們再次登入，請按照下列提示操作，確保 App Distribution 設定正確無誤：

• 確認您已啟用 Firebase App Testers API。詳情請參閱「啟用 App Distribution Tester API」。

• 在「金鑰限制」下方，確認 Firebase App Testers API 已列入允許的 API 清單。

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

為應用程式新增測試人員時，是否有任何限制？

Firebase App Distribution 的測試人員人數上限如下：

• 在 Firebase 專案中新增最多 500 位測試人員

• 每個App Distribution群組最多可新增 200 名測試人員

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

測試人員邀請會過期嗎？

測試人員必須在邀請過期前接受邀請，否則無法測試應用程式。 如果邀請即將在 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 個。應用程式達到版本數量上限後，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 設定檔時，系統會自動將網頁剪輯片段新增至測試裝置的主畫面。如果您要測試 Ad Hoc 發布版本，請先安裝設定檔，再測試應用程式。

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

1. 如果尚未登入 Google 並接受邀請，請先完成這項動作。

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

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

4. 按照畫面上的指示安裝 Firebase 設定檔。

如何刪除測試人員帳戶？

如要刪除App Distribution測試人員帳戶和相關聯的資料，請依序按照下列步驟操作：

1. 前往 https://appdistribution.firebase.google.com 並登入 Google 帳戶。

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

   刪除帳戶。

3. 選用：在「Google 帳戶權限」中，撤銷 Firebase App Distribution 的存取權。請注意，如果沒有先刪除 App Distribution 帳戶就撤銷存取權，不會刪除測試人員帳戶或資料。