Android 和 Firebase 的故障排除和常見問題解答

本頁面針對您在使用 Firebase 時可能遇到的特定於 Android 的問題提供提示和故障排除。

有其他挑戰或沒有看到您的問題概述如下？請務必查看主要的 Firebase 常見問題解答，了解更多泛 Firebase 或產品特定的常見問題解答。

您還可以查看Firebase Android SDK GitHub 存儲庫以獲取報告的問題和故障排除的最新列表。我們鼓勵您也在那裡提交您自己的 Firebase Android SDK 相關問題！

將 Android 應用添加到 Firebase 項目時是否需要提供 SHA-1？

Firebase 身份驗證（使用Google 登錄或電話號碼登錄時）和Firebase 動態鏈接需要SHA-1 信息。如果您不使用這些功能，則不必提供 SHA-1。

如何解決此錯誤：“另一個項目中已存在此包名稱和 SHA-1 的 OAuth2 客戶端”？

如果我們檢測到另一個 Firebase 或 Google Cloud 項目包含具有您指定的包名稱和 SHA-1 的 OAuth 2.0 客戶端 ID，則會發生此錯誤。了解如何解決此錯誤。

當我將 Firebase 添加到我的 Android 項目時，我收到“找不到”錯誤。

此錯誤通常意味著您的應用缺少對 Google 的 Maven 存儲庫的一個或多個引用。在您的項目級build.gradle文件中，確保在您的buildscript和allprojects部分中包含 Google 的 Maven 存儲庫 ( google() )。

當我將 Firebase SDK 添加到我的 Android 項目時，我收到關於調用自定義支持和啟用脫糖的錯誤。

2021 年 5 月（Firebase BoM v28.0.0），Firebase 禁用了所有 Android 庫的脫糖功能（請參閱發行說明）。

此更改意味著使用 Android Gradle 插件 (AGP) v4.2 或更早版本的 Gradle 構建需要啟用 Java 8 支持。否則，在添加 Firebase SDK 時，這些 Android 項目會出現以下構建失敗：

D8: Invoke-customs are only supported starting with Android O (--min-api 26)
Caused by: com.android.builder.dexing.DexArchiveBuilderException: Error while dexing.
The dependency contains Java 8 bytecode. Please enable desugaring by adding the following to build.gradle
android {
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}
See https://developer.android.com/studio/write/java8-support.html for details.
Alternatively, increase the minSdkVersion to 26 or above.

要修復此構建失敗，您可以遵循以下兩個選項之一：

將錯誤消息中列出的compileOptions添加到您的應用程序級build.gradle文件中。
將您的 Android 項目的minSdkVersion增加到 26 或更高。