iOS
Android
本頁面提供透過應用程式發布發布及測試應用程式的常見問題和疑難排解說明,以及常見問題解答。
發行應用程式
請按照下列提示排解,將應用程式發布給測試人員時可能遇到的問題。
缺少聯絡電子郵件地址,因此無法發布應用程式
上傳應用程式時,您可能會遇到以下錯誤:
「我們找不到 <app-id>
應用程式的聯絡電子郵件地址。請前往 Firebase 控制台的「應用程式發布」頁面進行設定。」
在 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 上傳至「應用程式發布」時,Google Play 會使用測試應用程式簽署金鑰憑證,自動重新簽署產生的 APK。系統提示時,您必須向 API 供應商註冊應用程式,才能繼續使用第三方服務。簽署後,您就可以在 Firebase 控制台中查看應用程式的測試憑證。
我上傳的 AAB 是否也會出現在 Google Play 中?
您上傳至「應用程式發布」的 AAB 版本不會顯示在 Google Play 開發人員帳戶中 (包括 App Bundle Explorer 和內部應用程式分享)。
如果取消 Firebase 與 Google Play 的連結,會發生什麼情況?
如果取消 Firebase Android 應用程式和 Google Play 的連結,會發生下列情況:
您將無法將新的應用程式套件上傳至「應用程式發布」,並透過與 Google Play 的「應用程式發布」整合功能匯出至 Google Play。
您的測試人員將繼續在 Firebase 應用程式發布資訊主頁中取得現有版本。
你還是可以在 Firebase 和 Google Play 中存取先前匯出的所有資料。
我可以重新將應用程式連結至 Google Play 嗎?
如要透過應用程式發布功能發布 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 實際上會取得存取權。
如果測試人員透過其他電子郵件地址接受了電子郵件邀請,請按照下列步驟解決問題:
在 Firebase 控制台的「App Distribution」(應用程式發布) 頁面中,前往「Testers & Groups」(測試人員和群組) 分頁的「View all 測試人員」 部分刪除測試人員。系統會移除現有邀請。
重新邀請測試人員測試應用程式。測試人員應該會收到邀請電子郵件。
請確認測試人員接受電子郵件地址相同的邀請。
測試人員沒有收到電子郵件通知
如果發生下列任一情況,測試人員可能不會收到電子郵件通知:
解決方案 1
請測試人員檢查垃圾郵件資料夾,以及他們在電子郵件服務中設定的所有電子郵件篩選器。
如果測試人員取消訂閱電子郵件,請要求測試人員執行下列操作:
找出測試人員先前透過應用程式收到的電子郵件。
按一下底部的「管理電子郵件設定」 ,然後點選「允許電子郵件」 重新訂閱。
解決方案 2
如果測試人員不想收到電子郵件通知,但想接受應用程式邀請,可以直接在 App Tester 應用程式中查看待處理的應用程式邀請 (下載操作說明 )。
注意: 如要查看待處理的應用程式邀請,測試人員用來登入 App Tester 應用程式的 Google 帳戶電子郵件地址,必須與開發人員寄送邀請的收件者電子郵件地址相符。
解決方案 3
前往 Firebase 控制台的「應用程式發布」頁面,在「測試人員和群組」 分頁的「查看所有測試人員」 分頁中刪除測試人員。這項操作會移除現有的邀請,
重新邀請測試人員測試應用程式。測試人員應該會收到邀請電子郵件。確認測試人員接受邀請時,使用的電子郵件地址與收到邀請的電子郵件地址相同。
應用程式未指出已安裝應用程式
如果測試人員下載並安裝版本,但應用程式詳細資料使用者介面未顯示應用程式已安裝,表示這是已知問題。在某些情況下,Firebase 應用程式中的軟體包 ID 與 APK 的軟體包 ID 不符。
確認 APK 的軟體包 ID 與您用來上傳發行版本的 Firebase 應用程式軟體包 ID 相符。
Android 快訊顯示我的裝置無法安裝不明應用程式
如果您的執行中應用程式或瀏覽器尚未獲得在 Google Play 以外的地方安裝應用程式的權限,系統會顯示 Android 快訊。如要授予權限:
無法安裝測試 APK
如果測試 APK 無法安裝在測試人員的裝置上:
確認新版本中的憑證與測試人員裝置上安裝的憑證相符。Android 系統僅允許在憑證相符時更新應用程式。詳情請參閱簽署注意事項 。
確認應用程式支援測試人員裝置的 OS 版本 (請查看 minSdkVersion
)。
無法登入 Android App Tester 應用程式
如果 App Tester 應用程式禁止您登入,並且將您重新導向回登入畫面,那麼您使用的可能是包含限制設定的 Google Workspace (舊稱 G Suite)。
如何移除限制設定:
在 Google Workspace 的「Apps」(應用程式) 分頁標籤 中,確認 Firebase 應用程式發布「未」 設為「Access: Block」 。
在「Services」(服務) 分頁標籤 中,確認「Cloud Platform」 未受限制。
移除設定後,請再次嘗試登入。
安裝 AAB 時發生錯誤:「無法安裝應用程式」
如果安裝的應用程式與裝置上安裝的應用程式發生衝突,就可能發生這項錯誤。舉例來說,這可能是相同應用程式的不同變化版本,但具有相同的自訂權限 或 ContentProvider 名稱 。
遇到問題後,您可以要求測試人員立即收集錯誤報告 ,並且查看報告,進一步瞭解原因。測試人員必須先刪除所有衝突的應用程式,才能安裝新的應用程式。
透過應用程式發布 Android SDK 啟用測試人員功能
如果問題包括啟用應用程式內新的建構快訊,或使用應用程式發布 Android SDK 提交應用程式內意見回饋,請按照下列提示排解問題。
測試人員無法在應用程式中啟動意見回饋功能
如果您已在應用程式中設定應用程式發布 Android SDK 來支援應用程式內意見回饋,且測試人員無法提交意見回饋,請按照下列步驟操作:
在應用程式中啟用應用程式發布 Android SDK 的詳細記錄功能:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
篩選「FirebaseAppDistribution」,檢查應用程式記錄中的錯誤訊息。
確認測試人員可以存取已安裝的版本:
如果記錄顯示「測試人員無法存取這項資源,」測試人員可能未受邀存取應用程式,或是無權存取版本。
在 Firebase 控制台的「應用程式發布」資訊主頁中,找出測試人員裝置上執行的確切版本,確認測試人員列在版本資訊卡的「Testers」 分頁中,並且處於「已接受」狀態。
如果仍未收到意見回饋,請按照下列步驟操作:
在測試裝置上,使用 App Tester 或測試人員網頁應用程式登入 Firebase 應用程式發布功能。接受測試應用程式時,請務必選取您第一次使用的 Google 帳戶。
請使用 App Tester 或測試網頁應用程式再次安裝應用程式,確認測試人員有權存取該版本。
嘗試提交意見回饋,並確認登入的是相同的 Google 帳戶。
請確認您已啟用 Firebase App Testers API。詳情請參閱「啟用 App Distribution Tester API 」。
在「金鑰限制」 下方,確認 Firebase App Testers API 已加入允許的 API 清單內。
未收到在應用程式中提交的意見回饋
如果您在提交意見回饋時看到這則訊息:「雖然有提供意見,但因為開發模式並未造成問題」,請執行下列指令,停用裝置上的開發人員模式 :
adb shell setprop debug.firebase.appdistro.devmode false
請檢查 google-services.json
檔案,確認您要為正確的專案和應用程式提交意見回饋。
在應用程式中啟用應用程式發布 Android SDK 的詳細記錄功能:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
篩選「FirebaseAppDistribution」,檢查應用程式記錄中的錯誤訊息。
測試人員沒有收到應用程式內快訊
如果您已在應用程式中設定應用程式發布 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」(應用程式發布) 資訊主頁中,確認測試人員已納入建構發行版本,且處於「接受」 狀態。
如果測試人員仍未收到快訊,請要求他們按照下列提示,確認他們已接受測試應用程式的邀請,並正確設定測試裝置:
在測試裝置上,透過 App Tester 或測試人員網頁應用程式,登入 Firebase 應用程式發布。請記得選取接受測試應用程式邀請時最初使用的 Google 帳戶。
確認新的應用程式版本是否已在 App Tester 或測試人員網頁應用程式中提供。
關閉應用程式後,測試人員會收到再次登入的提示
根據預設,測試人員只需登入 Google 帳戶一次,就能啟用測試功能。如果在關閉並重新開啟應用程式後,系統要求測試人員再次登入,請按照下列提示操作,確認應用程式發布設定已正確設定:
請檢查確認您已啟用 Firebase App Testers API。詳情請參閱「啟用 App Distribution Tester API 」。
在「金鑰限制」 下方,確認 Firebase App Testers API 已加入允許的 API 清單內。
如果您通常在登出時清除 SharedPreferences,可能會清除測試人員的狀態。應用程式發布會儲存標記,指出測試人員是否已登入應用程式。詳情請參閱 GitHub 存放區 。
常見問題
在應用程式中新增測試人員是否有限制?
Firebase 應用程式發布有以下測試人員限制:
如要新增更多測試人員,請要求提高上限 。
測試人員的邀請是否會過期?
測試人員有 30 天的時間可以接受邀請,在到期前接受測試應用程式。
邀請到期後的 5 天,每當有版本測試的測試人員旁邊,Firebase 控制台就會顯示到期通知。您可以透過測試人員資料列的下拉式選單重新傳送邀請,藉此更新邀請。
應用程式版本的推出時間有多久?
如果發生下列任一情況,應用程式版本就會從應用程式發布中移除:
應用程式版本超過 150 天。
應用程式版本數量已超過 1,000 個上限,且有新版本超過最近 1,000 個版本。
詳情請參閱應用程式發行支援的版本數量上限為 1,000 個 。
當應用程式達到或超過 150 天的到期上限或 1,000 個版本上限,就會從「應用程式發布」資訊主頁和 Firebase App Tester 應用程式中移除。如果測試人員已安裝該版本,則應用程式的本機版本會繼續執行。
如要延長應用程式版本的發布時間,請使用下列建議:
在應用程式版本到期或超過版本限制前,下載 APK 或 AAB,然後從「應用程式發布」資訊主頁刪除該版本。接著,重新上傳 APK 或 AAB,做為新的應用程式發布版本。
下載此版本並上傳至 Cloud Storage ,以進行長期封存。
應用程式版本會在 150 天後到期
將應用程式版本上傳至 Firebase 後,自上傳日期起,該版本會在應用程式發布資訊主頁 中顯示 150 天。上傳版本後,您可以將版本發布給測試人員,他們可以將版本從 Firebase App Tester 應用程式安裝到測試裝置上。
當版本從到期日算起 30 天時,Firebase App Tester 應用程式版本會顯示應用程式版本到期通知。
應用程式發布最多支援 1,000 個版本
應用程式發布的每個應用程式版本數量上限為 1,000 個。當應用程式達到 1,000 個上限時,應用程式發布就會自動刪除超過限制的最舊版本。
如果想要手動管理應用程式版本,請使用 App Distribution REST API 大量列出 及刪除 應用程式版本。
如有任何問題,請與 Firebase 支援團隊 聯絡。
自動化測試人員功能是否有配額限制?
Firebase 應用程式發布使用 Firebase Test Lab 基礎架構,且配額限制和價格相同。測試配額的計算依據為每日執行的測試次數。如要進一步瞭解測試配額和帳單,請參閱 Test Lab 的用量等級、配額和定價 。
自動化測試人員功能的配額重試限制是多少?
超出配額時,您會收到超出配額的錯誤。重設配額約需 24 小時的時間,因此請避免在配額釋出前重試。但如果您收到有關自動化測試人員基礎架構的錯誤,只要立即重試,呼叫可能會成功。
我需要哪些權限才能執行自動化測試人員 Beta 版功能?
您需要有 Firebase 專案的編輯者權限,才能透過「自動化測試人員」功能執行測試。