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

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

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

「我們找不到應用程式『<app-id>』的聯絡電子郵件地址。請前往 Firebase 控制台中的 App Distribution 設定一組密碼。」

在 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

使用社群網路登入/第三方 API 供應商時發生錯誤

將 AAB 上傳至 App Distribution 時，Google Play 會使用測試應用程式簽署金鑰憑證，自動重新簽署產生的 APK。系統提示時，您必須向 API 供應商註冊應用程式，才能繼續使用他們的第三方服務。簽署後，您可以在 Firebase 控制台中查看應用程式的測試憑證。

我上傳的 AAB 是否也會顯示在 Google Play 中？

上傳至 App Distribution 的 AAB 建構版本不會顯示在 Google Play 開發人員帳戶中 (包括應用程式套件探索工具和內部應用程式分享)。

如果取消 Firebase 與 Google Play 的連結，會發生什麼情況？

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

• 您將無法再將新的應用程式套件上傳至 App Distribution，也不能透過 App Distribution 與 Google Play 的整合功能，將應用程式套件匯出至 Google Play。

• 現有建構版本仍會顯示在 Firebase App Distribution 資訊主頁中，並提供給測試人員。

• 你還是可以在 Firebase 和 Google Play 中存取先前匯出的所有資料。

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

如要透過 App Distribution 發布 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 地址。
• 請勿使用已連結至其他 Google 帳戶的電子郵件地址。
• 使用這個電子郵件地址登入時，請使用 Google 帳戶密碼。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

解決方案 1

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

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

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

解決方案 2

如果測試人員不想收到電子郵件通知，但希望能夠接受應用程式邀請，可以直接在 App Tester 應用程式中查看待處理的應用程式邀請 (下載說明)。

解決方案 3

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

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

應用程式未指出已安裝

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

確認 APK 的套件 ID 與您用來上傳發布版本的 Firebase 應用程式套件 ID 相符。

Android 警示訊息指出裝置無法安裝不明應用程式

如果執行中的應用程式或瀏覽器尚未取得在 Google Play 以外安裝應用程式的權限，系統就會顯示 Android 警示。如要授予權限：

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

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

無法安裝測試 APK

如果測試人員的裝置無法安裝測試 APK，請按照下列步驟操作：

• 確認新版本中的憑證與測試人員裝置上安裝的版本相符。只有在憑證相符時，Android 系統才會允許更新應用程式。詳情請參閱「簽署注意事項」。
• 確認測試人員裝置的 OS 版本支援應用程式 (請查看 minSdkVersion)。

無法登入 Android 應用程式測試人員應用程式

如果 App Tester 應用程式禁止您登入，並將您重新導向至登入畫面，可能是因為您使用的 Google Workspace (舊稱 G Suite) 包含限制設定。

如要移除限制設定，請按照下列步驟操作：

1. 在 Google Workspace 的「應用程式」分頁中，確認 Firebase App Distribution未設為「存取權：已封鎖」。

2. 在「服務」分頁中，確認「Cloud Platform」不受限制。

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

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

如果安裝中的應用程式與裝置上已安裝的應用程式發生衝突，就可能發生此錯誤。舉例來說，可能是具有相同自訂權限或ContentProvider 名稱的相同應用程式不同變體。

您可以要求測試人員在發生問題後立即收集錯誤報告，並檢查報告，瞭解問題原因的詳細資訊。測試人員必須先刪除任何衝突的應用程式，才能安裝新應用程式。

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

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

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

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

在新 Android 裝置上測試

如果是第一次參與測試，請參閱「設定測試人員身分」。

如果您是現有的 App Distribution 測試人員，並取得新的 Android 裝置進行測試，請按照下列步驟操作，不必再次完成整個新測試人員流程：

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

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

測試人員無法在應用程式中提供意見回饋

如果您已在應用程式中設定 App Distribution Android SDK，支援應用程式內意見回饋功能，但測試人員無法提交意見回饋，請按照下列步驟操作：

1. 在應用程式中為 App Distribution Android SDK 啟用詳細記錄功能：

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

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

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

   1. 如果記錄顯示「測試人員無法存取這項資源」，可能是測試人員未受邀加入應用程式，或是無法存取該版本。

   2. 在 Firebase 管理中心的 App Distribution 資訊主頁中，找出測試人員裝置上執行的確切版本，並確認測試人員列於版本資訊卡的「測試人員」分頁中，且狀態為「已接受」。

   如果還是沒有收到意見回饋，請按照下列步驟操作：

   1. 在測試裝置上，使用應用程式測試人員或測試人員網頁應用程式登入 Firebase App Distribution。請務必選取您接受應用程式測試邀請時使用的 Google 帳戶。

   2. 使用應用程式測試人員或測試網頁應用程式再次安裝應用程式，確保測試人員可以存取發布版本。

   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. 在應用程式中為 App Distribution Android SDK 啟用詳細記錄功能：

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

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

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

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

1. 將 OnFailureListener 附加至 Firebase App Distribution API 傳回的 Task，即可檢查錯誤訊息。

   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. 在控制台的 App Distribution資訊主頁Firebase中，確認測試人員已納入版本發布範圍，且狀態為「已接受」。

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

      1. 在測試裝置上，透過 App Tester 或測試人員網頁應用程式登入 Firebase 應用程式發布。請務必選取您接受應用程式測試邀請時使用的 Google 帳戶。

      2. 確認新版應用程式是否已在 App Tester 或測試人員網頁應用程式中發布。

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

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

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

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

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

如何存取應用程式測試代理程式？

如要存取應用程式測試代理程式預覽畫面，請在Firebase控制台的「版本」頁面中，透過橫幅選擇加入並開始使用這項功能。

如果已關閉橫幅，且版本只執行 AI 導向測試，您可以從「自動測試人員」分頁選擇加入 App Testing 代理程式。專案編輯者可以上傳新版本，並對沒有隨機檢索測試的版本執行 AI 輔助測試。現在，您應該可以前往該版本的「自動測試人員」分頁，選擇加入。

如果仍無法啟用這項功能，請傳送「Requesting access to App Distribution App Testing agent」訊息，與 Firebase 支援團隊聯絡。

選擇啟用後，這項功能會套用至整個團隊，還是只套用至我的帳戶？

這只會為你的帳戶啟用這項功能。

我已啟用這項功能，但還是看不到

請嘗試重新整理瀏覽器。如果重新整理瀏覽器後仍無法查看這項功能，請向 Firebase 支援團隊傳送訊息：「Requesting access to App Distribution App Testing agent」(要求存取 App Distribution 應用程式測試代理程式)。

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

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

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

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

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

測試人員邀請會過期嗎？

測試人員必須在邀請過期前接受邀請，否則無法測試應用程式。 如果邀請即將在 5 天後到期，Firebase 控制台會在版本頁面上的測試人員旁顯示到期通知。如要續發邀請，請透過測試者列的下拉式選單重新傳送邀請。

應用程式版本可保留多久？

如果發生下列任一情況，應用程式版本就會從 App Distribution 移除：

• 應用程式版本發布至今已超過 150 天。
• 您超過 1,000 個應用程式版本的上限，且應用程式版本比最近 1,000 個應用程式版本舊。

詳情請參閱「App Distribution 最多支援 1,000 個版本」。

如果應用程式達到或超過 150 天的期限，或超過 1,000 個版本的限制，該版本就會從 App Distribution 資訊主頁和 Firebase 應用程式測試人員應用程式中移除。如果測試人員已安裝該版本，應用程式的本機版本仍會繼續執行。

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

• 在應用程式版本過期或超過發布限制前，請下載 APK 或 AAB，然後從 App Distribution 資訊主頁刪除該版本。然後，將 APK 或 AAB 重新上傳至 App Distribution，做為新版本。
• 下載發行內容，然後上傳至 Cloud Storage，以便長期封存。

應用程式版本會在 150 天後失效

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

如果版本將在 30 天後到期，Firebase App Tester 應用程式中的版本就會顯示應用程式版本到期通知。

App Distribution最多支援 1,000 個版本

App Distribution的每個應用程式版本數量上限為 1,000 個。應用程式達到版本數量上限後，App Distribution便會自動刪除超出上限的最舊版本。

如要手動管理應用程式版本，請使用 App Distribution REST API 大量列出和刪除應用程式版本。

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

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

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

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

Firebase App Distribution 使用 Firebase Test Lab 基礎架構，配額限制和價格也相同。測試配額是以每日執行的測試次數計算。如要進一步瞭解測試配額和帳單，請參閱「Test Lab 的用量層級、配額和定價」。

自動測試人員功能的配額重試次數上限為何？

如果超出配額，您會收到配額超出錯誤。配額約需 24 小時才會重設，因此請避免在配額釋出前重試。不過，如果收到與自動測試人員基礎架構相關的錯誤，立即重試呼叫可能會成功。

如要執行自動測試人員 Beta 版功能，需要哪些權限？

您必須具備 Firebase 專案的編輯者存取權，才能使用「自動化測試人員」功能執行測試。

如何刪除測試人員帳戶？

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

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

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

   刪除帳戶。

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