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

iOS Android

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

發行應用程式

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

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

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

「我們找不到 <app-id> 應用程式的聯絡電子郵件地址。請造訪 也可以在 Firebase 控制台設定「應用程式發布」。

在 Firebase 控制台設定聯絡電子郵件 (如果有的話)。如果問題 問題仍未解決，請與 Firebase 支援團隊聯絡。

佈建應用程式時發生錯誤 (400、409 或 500 錯誤)

如果您在佈建時反覆遇到 400、409 或 500 錯誤， 與 Firebase 支援團隊聯絡。賦能 並提供 Firebase 專案編號和應用程式 ID。

無法上傳 APK 檔案

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

2. 如果 APK 大小在檔案大小限制內，並且可重現，請與 Firebase 支援：

無法上傳含有 Fastlane 的 APK。APK 未簽署。

確認 APK 是以下列方法簽署：

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

發布 Android App Bundle (AAB)

收到社交錯誤 登入/第三方 API 供應商

當您將 AAB 上傳至「應用程式發布」後，Google Play 會自動重新簽署 產生的 APK。系統提示時 如要繼續使用，您必須向 API 供應商註冊應用程式 使用 API簽署後，應用程式的測試憑證即可 您可以在 Firebase 控制台中查看

我上傳的 AAB 是否也會出現在 Google Play 中？

您上傳至「應用程式發布」的 AAB 版本不會顯示在 Google Play 中 開發人員帳戶 (包括 App Bundle Explorer 和內部應用程式分享)。

取消連結會有什麼影響 要從 Google Play 匯入 Firebase 嗎？

如果取消 Firebase Android 應用程式和 Google Play 的連結，會發生下列情況：

• 您將無法將新的應用程式套件上傳至「應用程式發布」，也無法匯出 開發人員可透過 Google Play 的「應用程式發布」功能，將應用程式發布至 Google Play。

• 現有版本會繼續在 Firebase 應用程式發布資訊主頁和測試人員。

• 系統會保留先前在 Firebase 和 Google Play 之間匯出的所有資料 可在兩種產品中存取

我可以重新將應用程式連結至 Google 嗎？ 播放？

如何透過「應用程式發布」發布 Android App Bundle (AAB)。 自動將上傳的 AAB 連結至 Firebase 專案和 Google Play 開發人員帳戶，請確認符合下列規定：

• 您的 Google Play 開發人員帳戶中有下列其中一項 存取層級： 擁有者或管理員

• 針對 Firebase 專案，需具備下列其中一個角色： 擁有者或 Firebase 管理員：

• 您的應用程式已向 Firebase 和您的 Google Play 開發人員註冊 讓他們使用服務帳戶也就是說，您同時擁有 Firebase Android 應用程式和 Google Play 應用程式。

• 已在 Google Play 和 Firebase Android 應用程式中註冊應用程式 使用相同的套件名稱

• Google Play 中的應用程式已在應用程式中設定 資訊主頁 發行至其中一個 Google Play 測試群組 (內部測試、 封閉測試、公開測試或正式版)。

• 應用程式的 Google Play 審核程序已經完成，並發布完畢。您的 如果「應用程式狀態」欄顯示下列其中一項內容，就表示應用程式已發布 狀態：內部測試 (非草稿內部測試)、封閉測試、 公開測試或正式版。

如果您上傳的應用程式先前不符合上述 但現在連結，您可以重試將 Firebase Android 應用程式連結至 Google Play

安裝及測試應用程式

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

測試人員沒有 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

測試人員不想收到電子郵件通知，但想接受邀請時 應用程式邀請，則可直接在「應用程式」中查看待接受的應用程式邀請 測試人員應用程式 (下載操作說明)。

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

解決方案 3

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

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

應用程式未指出已安裝應用程式

如果測試人員下載並安裝版本，但應用程式詳細資料使用者介面 目前未顯示應用程式，這表示目前已知的問題。在某些情況下 Firebase 應用程式中的軟體包 ID 與 APK 的軟體包 ID 不符。

確認 APK 的軟體包 ID 與 Firebase 的軟體包 ID 相符 。

Android 快訊顯示我的裝置無法安裝不明應用程式

如果正在執行的應用程式或瀏覽器，系統會顯示 Android 快訊 權限以安裝 Google Play 以外來源的應用程式。如要授予權限：

• Android 8 以上版本：在「設定」應用程式中輕觸 允許這個來源的儲存格。

• Android 7 以下版本：在「設定」應用程式中輕觸「安全性」。 然後選取「不明來源」。當畫面上出現提示時，請輕觸 確定 >信任。

無法安裝測試 APK

如果測試 APK 無法安裝在測試人員的裝置上：

• 確認新版本中的憑證與 測試人員裝置上安裝的版本。Android 系統僅允許使用 如果憑證相符，應用程式就會更新。詳情請參閱簽署注意事項。
• 確認測試人員裝置的 OS 版本受到應用程式支援 (請查看 minSdkVersion)。

無法登入 Android App Tester 應用程式

如果 App Tester 應用程式禁止您登入，並且將您重新導向回 登入畫面，你可能正在使用 Google Workspace (舊稱 G Suite) 包括限制設定

如何移除限制設定：

1. 前往應用程式的「應用程式」分頁 Google Workspace，請確認 Firebase 應用程式發布「未」設為 存取權：已封鎖。

2. 在「Services」(服務) 分頁中： 確認 Cloud Platform 未受限制。

3. 移除設定後，請再次嘗試登入。

安裝 AAB 時發生錯誤：「無法安裝應用程式」

如果同時安裝的應用程式已經與某個應用程式發生衝突，就會發生這個錯誤 安裝在裝置上。舉例來說，該變數可以是 相同應用程式 自訂權限 或 ContentProvider 名稱。

您可以請測試人員收集 錯誤報告 便可立即解決問題，並且查看報告以尋找 有關錯誤原因的資訊。測試人員必須在 使用者就可以安裝新的應用程式

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

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

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

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

在新的 Android 裝置上測試

如果您是首次測試人員，請參閱「完成設定做為測試人員」一文。

如果您目前是應用程式發布測試人員，卻收到新的 Android 裝置 不要重複執行整個新的測試人員流程 步驟：

1. 在 Android 裝置上前往 appdistribution.firebase.google.com。

2. 使用現有的測試人員帳戶登入，然後按一下「下載應用程式」 畫面底部的「測試人員」按鈕，用於安裝 Android App Tester 應用程式。

透過應用程式發布 Android SDK 啟用測試人員功能

如要排解無法在應用程式中啟用新功能的問題，請按照下列提示操作 使用應用程式發布 Android SDK 建立快訊，或提交應用程式內意見回饋。

測試人員無法在應用程式中啟動意見回饋功能

如果您已經在應用程式中設定應用程式發布 Android SDK， 應用程式內意見回饋，但測試人員無法提交意見回饋，請遵循這些 步驟：

1. 在應用程式中啟用應用程式發布 Android SDK 的詳細記錄功能：

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

2. 篩選「FirebaseAppDistribution」，檢查應用程式記錄中的錯誤訊息。

3. 確認測試人員可以存取已安裝的版本：

   1. 如果記錄指出「測試人員沒有存取檔案的權限 資源」測試人員可能尚未受邀加入該應用程式，或者 可能無法取得此版本的存取權。

   2. 在 Firebase 控制台的「應用程式發布」資訊主頁中找到 測試裝置執行的確切版本，並確保 測試人員會列在版本資訊卡的「測試人員」分頁中，找到 已接受狀態

   如果仍未收到意見回饋，請按照下列步驟操作：

   1. 在測試裝置上，使用「應用程式」登入「Firebase 應用程式發布」功能 測試人員或測試人員網頁應用程式。請務必選取 Google 帳戶 首次使用的名稱。

   2. 使用 App Tester 或測試版網頁應用程式再次安裝應用程式， 確認測試人員有權存取此版本。

   3. 請嘗試提交意見回饋，請再次使用 來自同一個 Google 帳戶。

4. 請確認您已啟用 Firebase App Testers API。如需更多資訊 請參閱「啟用 App Distribution Tester API」。

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

未收到在應用程式中提交的意見回饋

1. 如果您在提交意見回饋時看到這則訊息：「歡迎提供意見， 但不適用於開發模式」停用開發人員模式 ，請執行以下指令：

   adb shell setprop debug.firebase.appdistro.devmode false
   

2. 請檢查 google-services.json 檔案，確定您提交的是有效的 並提供有關正確專案和應用程式的意見回饋

3. 在應用程式中啟用應用程式發布 Android SDK 的詳細記錄功能：

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

4. 篩選以下項目，檢查應用程式記錄中是否有錯誤訊息 「FirebaseAppDistribution」。

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

如果您已在應用程式中設定應用程式發布 Android SDK， 測試人員不會收到應用程式內快訊，請按照下列步驟操作：

1. 將 OnFailureListener 附加至工作，檢查是否有錯誤訊息 Firebase App Distribution API 回傳。

   Java

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> {
                     if (e instanceof FirebaseAppDistributionException) {
                        // Log exception here
                     }});
   

   Kotlin

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e ->
                     if (e is FirebaseAppDistributionException) {
                        // Log exception here
                     }
     }
   

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

   1. 在應用程式中啟用偵錯模式。詳情請參閱 Google Analytics 說明文件。

   2. 在模擬器中執行應用程式，並搜尋字串 「FirebaseAppDistribution」。

      如果記錄指出找不到任何版本，或是測試人員確實 沒有存取權，測試人員可能尚未與新的 版本。

   3. 在應用程式的「應用程式發布」資訊主頁中， Firebase 控制台，請確認您的測試已包含測試人員 並且處於已接受狀態。

      如果測試人員仍未收到快訊，請他們按照提示操作 並確認對方已接受邀請來測試應用程式 確認已正確設定測試裝置：

      1. 在測試裝置上，透過「應用程式」登入 Firebase 應用程式發布 測試人員或透過測試人員網頁應用程式。請記得選取 您接受測試，用於測試 應用程式。

      2. 確認新的應用程式版本是否已在 App Tester 中提供，或 進行測試。

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

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

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

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

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

常見問題

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

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

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

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

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

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

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

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

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

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

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

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

如要延長應用程式版本的發布時間，請使用下列其中一種做法 最佳化建議：

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

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

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

在到期日後的 30 天內，代表應用程式版本 到期通知會顯示在 Firebase App Tester 應用程式中。

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

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

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

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

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

如果您是測試人員，建議您下載 Firebase App Tester：這款應用程式可讓您集中存取所有測試版本。

自動化測試人員功能是否有配額限制？

Firebase 應用程式發布採用 Firebase Test Lab 基礎架構和配額 限制和價格皆相同測試配額是以 和每日測試如要進一步瞭解測試配額和帳單，請參閱用量 級別、配額和定價等詳細資訊

自動化測試人員功能的配額重試限制是多少？

超出配額時，您會收到超出配額的錯誤。配額約需 24 分鐘 小時，因此請避免在配額釋出前重試。不過， 您收到有關自動化測試人員基礎架構的錯誤，呼叫次數更多 可能就會立即重試。

我需要哪些權限才能執行自動化測試人員 Beta 版功能？

你必須擁有 Firebase 專案的編輯者權限，才能執行 使用自動化測試人員功能進行測試。

如何刪除測試人員帳戶？

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

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

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

   刪除帳戶。

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