Android と Firebase のトラブルシューティングとよくある質問

ktx ライブラリを解決できなかった、または見つからなかったというエラーが表示されます。

このエラーは、Firebase BoM を使用して、KTX モジュールをプロダクト ライブラリの依存関係として指定している場合に発生する可能性があります。

2025 年 7 月に KTX モジュールの新バージョンのリリースを停止し、KTX ライブラリを Firebase Android BoM（v34.0.0）から削除しました。

以前にリリースされた KTX モジュールの KTX API を使用している場合は、代わりにメイン モジュールの KTX API を使用するようにアプリを移行することをおすすめします。詳しくは、このイニシアチブに関するよくある質問をご覧ください。

Android アプリを Firebase プロジェクトに追加するときに SHA-1 を提供する必要はありますか？

SHA-1 情報は、Firebase Authentication（Google ログインまたは電話番号ログインを使用する場合）と Firebase Dynamic Links で必要になります。こうした機能を使用しない場合、SHA-1 は不要です。

「このパッケージ名と SHA-1 の組み合わせを持つ OAuth2 クライアントは、別のプロジェクトにすでに存在します」というエラーが出た場合、どのように対処したらよいですか？

このエラーは、指定したパッケージ名と SHA-1 を持つ OAuth 2.0 クライアント ID が別の Firebase または Google Cloud プロジェクトに含まれている場合に発生します。このエラーの解決方法をご覧ください。

Android プロジェクトに Firebase を追加すると、見つからなかったことを示すエラーが表示されます。

このエラーは通常、アプリで Google の Maven リポジトリへの参照が 1 つ以上存在していないことを意味します。Gradle 構成ファイルに Google の Maven リポジトリ（google()）が組み込まれていることを確認してください。

• プロジェクトで plugins 構文を使用している場合は、settings.gradle.kts ファイルまたは settings.gradle ファイルの plugins セクションに含めます。
• プロジェクトで buildscript 構文を使用している場合は、プロジェクト レベルの build.gradle.kts ファイルまたは build.gradle ファイルの buildscript セクションと allprojects セクションの両方に含めます。

アプリをリリースした後、Google ログインでエラー「12500:」が表示されます。どうすればよいですか？

このエラーには 2 つの理由が考えられます。サポート メールアドレスを提供していなかった、または SHA 鍵がなかったことです。このエラーを修正するには、以下の条件をすべて満たすようにしてください。

• Firebase コンソールのプロジェクトの [全般設定] でサポートのメールアドレスを追加している。
• Firebase コンソールで、リリース / 本番環境用のキーストアの SHA-1 証明書のフィンガープリントを Firebase Android アプリに追加している（settings [プロジェクトの設定] に移動し、下にスクロールして [マイアプリ] を表示し、Android アプリを選択）。
• Firebase コンソールで、Google Play Console の SHA-1 証明書のフィンガープリントを Firebase Android アプリに追加している（settings [プロジェクトの設定] に移動し、下にスクロールして [マイアプリ] を表示し、Android アプリを選択）。

buildscript 構文を使用して Firebase プラグインを Android プロジェクトに追加するにはどうすればよいですか？

Firebase には、次の Gradle プラグインがあります。

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