本页针对在使用 Firebase 时可能会遇到的特定于 Android 的问题提供提示和问题排查方法。
还有其他难题，或是您的问题未在下面列出？请务必查看主要的 Firebase 常见问题解答页面，了解更多涉及所有 Firebase 产品或涉及特定产品的常见问题。
您还可以查看 Firebase Android SDK GitHub 代码库，获取已报告问题和问题排查的最新列表。同时，我们也鼓励您提交与 Firebase Android SDK 相关的问题。
将 Android 应用添加到 Firebase 项目时，我需要提供 SHA-1 吗？
Firebase Authentication（使用 Google 登录或电话号码登录时）和 Firebase Dynamic Links 需要 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 或更高。
当我发布应用后，Google 登录显示错误“12500:”。如何解决此问题？
发生这种情况的原因可能有两种：您尚未提供支持电子邮件地址或缺少 SHA 密钥。如需修复此错误，请确保满足以下所有条件：
- 您在 Firebase 控制台中为项目的常规设置添加了支持电子邮件地址。
- 您在 Firebase 控制台中将发布/生产密钥库中的 SHA-1 证书指纹添加到了 Firebase Android 应用中（转到
settings 项目设置 ，向下滚动到“您的应用”，然后选择您的 Android 应用）。 - 您在 Firebase 控制台中将 Google Play 管理中心内的 SHA-1 证书指纹添加到了 Firebase Android 应用中（转到
settings 项目设置 ，向下滚动到“您的应用”，然后选择您的 Android 应用）。