疑難排解(&A)；Android 和 Firebase 常見問題

本頁面提供使用 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 專案包含 OAuth 2.0 用戶端 ID，且使用您指定的套件名稱和 SHA-1，就會發生這個錯誤。瞭解如何解決這個錯誤。

將 Firebase 新增至 Android 專案時，收到「找不到」錯誤。

這個錯誤通常表示您的應用程式缺少一或多個 Google Maven 存放區參照。請務必在 Gradle 設定檔中加入 Google 的 Maven 存放區 (google())。

• 如果專案使用 plugins 語法，請將其加入 settings.gradle.kts 或 settings.gradle 檔案的 plugins 區段。
• 如果您的專案使用 buildscript 語法，請在專案層級 build.gradle.kts 或 build.gradle 檔案的 buildscript 和 allprojects 區段中加入該語法。

將 Firebase SDK 新增至 Android 專案時，我收到有關「叫用自訂支援」和啟用「去糖化」的錯誤。

2021 年 5 月 (Firebase BoM 28.0.0 版)，Firebase 已為所有 Android 程式庫停用 desugaring 功能 (請參閱版本資訊)。

這項變更表示使用 Android Gradle 外掛程式 (AGP) 4.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.kts 或 build.gradle 檔案。
• 將 Android 專案的 minSdkVersion 提高至 26 以上。

應用程式發布後，Google 登入顯示「12500」錯誤訊息，該如何修正？

發生這種情況的原因可能有兩個：您未提供支援電子郵件，或是缺少 SHA 金鑰。為修正這項錯誤，請確認所有這些條件都符合：

• 您已在 Firebase 控制台的專案一般設定中新增支援電子郵件。
• 您已在 Firebase 主控台將 從發布/實際運作金鑰庫取得的 SHA-1 憑證指紋新增至 Firebase Android 應用程式 (請前往 專案設定，然後向下捲動至「您的應用程式」，然後選取您的 Android 應用程式)。
• 您已將 從 Google Play 控制台新增的 SHA-1 憑證指紋，新增至 Firebase 控制台中的 Firebase Android 應用程式 (請前往 「Project settings」，然後向下捲動至「Your apps」，然後選取您的 Android 應用程式)。

如何使用 buildscript 語法將 Firebase 外掛程式新增至 Android 專案？

提示： 建議從 buildscript 遷移至 plugin 語法，這樣 Android Studio 就能執行程式碼完成作業，並提供其他實用的建議。

Firebase 提供下列 Gradle 外掛程式：

外掛程式名稱	Maven 座標	最新版本	外掛程式 ID
Google Play 服務外掛程式	com.google.gms:google-services	4.4.2	com.google.gms.google-services
App Distribution 外掛程式	com.google.firebase:firebase-appdistribution-gradle	5.1.1	com.google.firebase.appdistribution
Crashlytics 外掛程式	com.google.firebase:firebase-crashlytics-gradle	3.0.3	com.google.firebase.crashlytics
Performance Monitoring 外掛程式	com.google.firebase:perf-plugin	1.4.2	com.google.firebase.firebase-perf

以下說明如何在仍使用 buildscript 語法的 Android 專案中新增 Firebase 外掛程式：

1. 在根層級 (專案層級) Gradle 檔案 (<project>/build.gradle.kts 或 <project>/build.gradle) 中，使用 Maven 座標將外掛程式新增為依附元件：

   Kotlin

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath ("PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION")
       }
   }
   
   allprojects {
     ...
   
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   }
   

   Groovy

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath 'PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION'
       }
   }
   
   allprojects {
     ...
   
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   }
   

2. 在模組 (應用程式層級) Gradle 檔案 (通常是 <project>/<app-module>/build.gradle.kts 或 <project>/<app-module>/build.gradle) 中，使用外掛程式 ID 新增外掛程式：

   Kotlin

   plugins {
       id("com.android.application")
   
       // Add the ID of the plugin
       id("FIREBASE_PLUGIN_ID")
       ...
   }
   

   Groovy

   plugins {
       id 'com.android.application'
   
       // Add the ID of the plugin
       id 'FIREBASE_PLUGIN_ID'
       ...
   }