應用程式發布疑難排解與協助；常見問題
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
iOS+
Android
本頁面提供疑難排解說明，並解答有關使用 App Distribution 發布及測試應用程式的常見問題。
發布應用程式
請參考下列提示，排解將應用程式發布給測試人員時可能遇到的問題。
因缺少聯絡電子郵件地址而無法發布應用程式
上傳應用程式時，您可能會遇到以下錯誤：
「我們找不到應用程式 <app-id> 的聯絡電子郵件地址。請前往 Firebase 主控台中的 App Distribution 設定頁面。」
在 Firebase 控制台中設定聯絡電子郵件地址 (如有)。如果問題仍未解決，請與 Firebase 支援團隊 聯絡。
佈建應用程式時發生錯誤 (400、409 或 500 錯誤)
如果在佈建期間屢次遇到 400、409 或 500 錯誤，請與 Firebase 支援團隊 聯絡。請將 Firebase 專案編號和應用程式 ID 提供給支援團隊。
無法上傳 APK 檔案
確認 APK 的大小。所有二進位檔的大小上限為 2048 MiB，也就是略高於 2 GB。
如果 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 上傳至 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 應用程式套件 (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 取得存取權。
如果測試人員使用其他電子郵件地址接受電子郵件邀請，請按照下列步驟解決問題：
在 Firebase 控制台的 App Distribution 頁面中，前往「測試人員與群組」
重新邀請測試人員測試應用程式。測試人員應會收到邀請電子郵件。
請確認測試人員使用相同的電子郵件地址接受邀請。
測試人員未收到電子郵件通知
發生下列情況時，測試人員可能不會收到電子郵件通知：
解決方案 1
請測試人員檢查垃圾郵件資料夾，以及在電子郵件服務中設定的任何電子郵件篩選器。
如果測試人員已取消訂閱電子郵件，請要求測試人員執行下列操作：
找出測試人員先前從應用程式收到的電子郵件。
按一下底部的「管理電子郵件設定」
解決方案 2
如果測試人員不想收到電子郵件通知，但希望能夠接受應用程式邀請，可以直接在 App Tester 應用程式中查看待回覆的應用程式邀請 (下載說明 )。
注意： 測試人員使用來登入「應用程式測試人員」應用程式的 Google 帳戶電子郵件地址，必須與開發人員邀請中的收件者電子郵件地址相符，才能查看待處理的應用程式邀請。 解決方案 3
在 Firebase 控制台的 App Distribution 頁面中，從「測試人員與群組」
重新邀請測試人員測試應用程式。測試人員應會收到邀請電子郵件。請確認測試人員使用收到邀請的電子郵件地址接受邀請。
應用程式未顯示已安裝應用程式
如果測試人員下載並安裝版本，但應用程式詳細資料使用者介面未顯示已安裝應用程式，則這是已知問題。在某些情況下，Firebase 應用程式中的軟體包 ID 與 APK 的軟體包 ID 不符。
請確認 APK 的套件 ID 與您用來上傳發布版本的 Firebase 應用程式套件 ID 相符。
Android 警示指出裝置無法安裝不明應用程式
如果執行中的應用程式或瀏覽器尚未獲得在 Google Play 以外安裝應用程式的權限，就會顯示 Android 快訊。如要授予權限：
無法安裝測試 APK
如果測試 APK 無法在測試人員的裝置上安裝，請採取下列做法：
請確認新版本中的憑證與測試人員裝置上安裝的版本相符。只有在憑證相符時，Android 系統才會允許應用程式更新。詳情請參閱「簽署注意事項 」。
確認應用程式支援測試裝置的 OS 版本 (請檢查 minSdkVersion)。
無法登入 Android 應用程式測試工具應用程式
如果 App Tester 應用程式無法讓您登入，並將您重新導向至登入畫面，表示您可能使用的是含有限制設定的 Google Workspace (舊稱 G Suite)。
如要移除限制設定，請按照下列步驟操作：
在 Google Workspace 的 「應用程式」 分頁中，確認 Firebase App Distribution 未 設為「存取權：已封鎖」
在「服務 」
移除設定後，請嘗試再次登入。
安裝 AAB 時發生錯誤：「無法安裝應用程式」
如果要安裝的應用程式與裝置上已安裝的應用程式發生衝突，就可能發生此錯誤。舉例來說，這可能是同一個應用程式的不同變化版本，具有相同的自訂權限 或ContentProvider 名稱 。
您可以要求測試人員在遇到問題後立即收集錯誤報告 ，並檢查報告，進一步瞭解原因。測試人員必須先刪除任何相衝突的應用程式，才能安裝新應用程式。
在新 Android 裝置上測試
如果您是初次測試，請參閱「設定測試人員 」一文。
如果您是現有的 App Distribution 測試人員，並且有新的 Android 裝置可用於測試，請按照下列步驟操作，而非再次完成整個新測試人員流程：
在 Android 裝置上前往 appdistribution.firebase.google.com 。
使用現有的測試人員帳戶登入，然後按一下畫面底部的「下載應用程式測試工具」
使用 App Distribution Android SDK 啟用測試人員功能
請參考下列提示，排解啟用應用程式內新建構警示，或使用 App Distribution Android SDK 提交應用程式內意見回饋的問題。
測試人員無法在應用程式中開始提供意見回饋
如果您已在應用程式中設定 App Distribution Android SDK 以支援應用程式內意見回饋，但測試人員無法提交意見回饋，請按照下列步驟操作：
為應用程式中的 App Distribution Android SDK 啟用詳細記錄功能：
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
篩選「FirebaseAppDistribution」以檢查應用程式記錄中的錯誤訊息。
確認測試人員可以存取已安裝的版本：
如果記錄指出「測試人員無法存取此資源」，表示測試人員可能未受邀使用應用程式，或可能無法存取該版本。
在 Firebase 控制台的 App Distribution 資訊主頁中，找出測試人員裝置上執行的確切版本，並確認測試人員是否列在版本資訊卡的「測試人員」
如果仍未收到意見回饋，請按照下列步驟操作：
在測試裝置上，使用應用程式測試工具或測試人員網頁應用程式登入 Firebase App Distribution 。請務必選取您接受應用程式測試邀請時所用的 Google 帳戶。
使用 App Tester 或測試網頁應用程式再次安裝應用程式，確保測試人員可以存取該版本。
請嘗試提交意見回饋，並再次確認您已使用相同的 Google 帳戶登入。
請確認您已啟用 Firebase App Testers API。詳情請參閱「啟用 App Distribution Tester API 」。
在「金鑰限制」
未收到在應用程式中提交的意見回饋
如果在提交意見回饋時看到「Would have sent feedback, but did not due to development mode」(原本會傳送意見回饋，但因開發人員模式而未傳送)，請執行以下指令，在裝置上停用開發人員模式 ：
adb shell setprop debug.firebase.appdistro.devmode false
檢查 google-services.json 檔案，確認你提交的意見回饋是針對正確的專案和應用程式。
為應用程式中的 App Distribution Android SDK 啟用詳細記錄功能：
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
篩選「FirebaseAppDistribution」以檢查應用程式記錄中的錯誤訊息。
測試人員未收到應用程式內快訊
如果您已在應用程式中設定 App Distribution Android SDK，但測試人員未收到應用程式內快訊，請按照下列步驟操作：
將 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
}
}
確認測試人員可以存取新版本：
在應用程式中啟用偵錯模式。如需瞭解如何操作，請參閱 Google Analytics 說明文件 。
在模擬器中執行應用程式，然後搜尋字串「FirebaseAppDistribution」。
如果記錄指出未找到任何版本，或是測試人員沒有存取權，表示測試人員可能尚未與新版本建立關聯。
在 Firebase 主控台的 App Distribution 資訊主頁中，確認測試人員已納入建構版本發布作業，且處於「已接受」
如果測試人員仍未收到快訊，請要求他們按照下列提示操作，確認他們已接受應用程式測試邀請，並正確設定測試裝置：
在測試裝置上，透過應用程式測試工具或測試人員網頁應用程式登入 Firebase 應用程式發布服務。請記得選取您接受應用程式測試邀請時所使用的 Google 帳戶。
請確認新版應用程式可在 App Tester 或測試人員網頁應用程式中使用。
測試人員在關閉應用程式後會收到登入提示
根據預設，測試人員只需登入 Google 帳戶一次，即可啟用測試功能。如果測試人員在關閉及重新開啟應用程式後，系統會再次提示他們登入，請按照下列提示操作，確保 App Distribution 設定正確無誤：
請確認您已啟用 Firebase App Testers API。詳情請參閱「啟用 App Distribution Tester API 」。
在「金鑰限制」
如果您通常會在登出時清除 SharedPreferences，可能會清除測試人員的狀態。App Distribution 會儲存標記，指出測試人員是否已登入應用程式。詳情請參閱 GitHub 存放區 。
存取應用程式測試代理預先發布版
注意： 如果您選擇存取 App Testing 代理程式預覽版，就會授予 Firebase App Distribution 權限，讓我們可以向您索取這項功能的意見回饋。
如何存取 App Testing 服務代理？
如要存取「應用程式測試」服務代理程式預先發布版，您可以選擇加入，並透過 Firebase 控制台的「版本」頁面橫幅開始使用這項功能
如果您已關閉橫幅，且只有在版本上執行 AI 導向測試，您可以透過「自動化測試人員」分頁啟用應用程式測試代理程式。專案編輯者可以上傳新版本，並針對沒有隨機檢索測試的版本執行 AI 輔助測試。您現在應該可以前往該版本的「自動化測試人員」分頁，選擇加入測試。
如果您仍無法選擇加入這項功能，請與 Firebase 支援團隊 聯絡，並傳送以下訊息：「Requesting access to App Distribution App Testing agent」。
選擇啟用這項功能後，是會為整個團隊啟用，還是只為我個人啟用？
這項功能只會為您的帳戶啟用。
我已選擇啟用，但仍看不到這項功能
請嘗試重新整理瀏覽器。如果在重新整理瀏覽器後，仍無法查看這項功能，請與 Firebase 支援團隊 聯絡，並傳送以下訊息：「請提供 App Distribution 應用程式測試代理程式存取權」。
常見問題
應用程式可新增的測試人員人數有限制嗎？
Firebase App Distribution 有以下測試人員限制：
如要新增更多測試人員，請提出免費的限制增加 要求。
測試人員邀請會過期嗎？
邀請過期前，測試人員有 30 天可以接受邀請，以便測試應用程式。邀請到期前 5 天，Firebase 控制台會在版本測試人員旁邊顯示到期通知。您可以透過測試人員列的下拉式選單，重新傳送邀請函來續約。
應用程式版本可供使用多久？
如果發生下列任一情況，應用程式版本就會從 App Distribution 中移除：
應用程式版本已超過 150 天。
您已超過 1,000 個應用程式版本數量上限，且應用程式版本比最近 1,000 個應用程式版本還舊。
詳情請參閱「App Distribution 最多支援 1,000 個版本
應用程式達到或超過 150 天的到期期限或 1,000 個版本限制後，該版本就會從 App Distribution 資訊主頁和 Firebase App Tester 應用程式中移除。如果測試人員已安裝該版本，應用程式的本機版本會繼續執行。
如要讓應用程式版本可使用更久的時間，請採用下列其中一種建議做法：
在應用程式版本到期或超過發布限制之前，請下載 APK 或 AAB，然後從 App Distribution 資訊主頁刪除該版本。然後將 APK 或 AAB 重新上傳至 App Distribution ，做為新的版本。
下載發布內容並上傳至 Cloud Storage
應用程式發布版本會在 150 天後到期
將應用程式版本上傳至 Firebase 後，該版本會從上傳日期起，在 App Distribution 資訊主頁
當版本距離到期日還有 30 天時，Firebase App Tester 應用程式會在您的版本上顯示應用程式版本到期通知。
App Distribution 最多支援 1,000 個版本App Distribution 的每個應用程式版本數量上限為 1,000 個。應用程式達到 1,000 個應用程式版本數量上限後，App Distribution 會自動刪除超出上限的最舊版本。
如果您想手動管理應用程式版本，請使用 App Distribution REST API 列出 及刪除 應用程式版本。
如有任何問題，請與 Firebase 支援團隊 聯絡。
自動化測試工具功能是否有配額限制？
Firebase App Distribution 使用 Firebase Test Lab 基礎架構，其配額限制和定價相同。測試配額的計算方式是根據每天執行的測試次數。如要進一步瞭解測試配額和計費，請參閱「Test Lab 的使用層級、配額和定價
自動化測試人員功能的配額重試限制為何？
如果超出配額，系統會傳回超出配額的錯誤訊息。配額需要約 24 小時才能重設，因此請在配額釋出前避免重試。不過，如果您收到與自動化測試器基礎架構相關的錯誤，請立即重試，呼叫成功的機率會更高。
執行自動化測試員 Beta 版功能需要哪些權限？
您必須具備 Firebase 專案的「編輯者」存取權，才能使用「自動化測試人員」功能執行測試。
