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

我收到錯誤訊息，指出 ktx 程式庫無法解析或找不到。

這個錯誤可能是因為您使用 Firebase BoM，並指定 KTX 模組做為產品程式庫依附元件。

2025 年 7 月，我們停止發布新版 KTX 模組，並從 Firebase Android BoM (v34.0.0) 移除 KTX 程式庫。

如果您使用先前發布的 KTX 模組中的 KTX API，建議您將應用程式遷移至使用主要模組中的 KTX API。詳情請參閱這項計畫的常見問題。

將 Android 應用程式新增至 Firebase 專案時，是否需要提供 SHA-1？

Firebase Authentication (使用 Google 登入或電話號碼登入時) 和 Firebase Dynamic Links 需要 SHA-1 資訊。如果您不使用這些功能，就不必提供 SHA-1。

如何解決「另一個專案中已有使用這個套件名稱和 SHA-1 的 OAuth2 用戶端」錯誤？

如果系統偵測到另一個 Firebase 或 Google Cloud 專案包含 OAuth 2.0 用戶端 ID，且該 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 區段中加入該語法。

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

這可能是因為您未提供支援電子郵件地址，或缺少安全雜湊演算法 (SHA) 金鑰。如要修正這項錯誤，請確認所有條件皆符合：

• 您已在 Firebase 控制台的專案一般設定中新增支援電子郵件地址。
• 您已在 Firebase 控制台中，將發布/正式版 KeyStore 的 SHA-1 憑證指紋新增至 Firebase Android 應用程式 (前往 settings專案設定，向下捲動至「您的應用程式」，然後選取 Android 應用程式)。
• 您已將 Google Play 控制台中的 SHA-1 憑證指紋新增至 Firebase 控制台中的 Firebase Android 應用程式 (前往 settings專案設定，向下捲動至「您的應用程式」，然後選取 Android 應用程式)。

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

Firebase 包含下列 Gradle 外掛程式：

如要將 Firebase 外掛程式新增至仍使用 buildscript 語法的 Android 專案，請按照下列步驟操作：

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'
       ...
   }
   

應用程式應包含哪些開放原始碼聲明？

Firebase Android SDK 包含輔助程式 Activity，用於顯示授權資訊。