Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Android プロジェクトに Firebase を追加する

前提条件

  • Android Studio の最新バージョンをインストールするか、更新してください。

  • プロジェクトが次の要件を満たしていることを確認します。

    • API レベル 16(Jelly Bean)以降が対象です。
    • Android 4.1 以降を使用します。
    • Jetpack(AndroidX)を使用します。また、次のバージョン要件を満たしている必要があります。
      • com.android.tools.build:gradle v3.2.1 以降
      • compileSdkVersion 28 以降
  • 実機を設定するか、エミュレータを使用してアプリを実行します。
    Google Play 開発者サービスに依存している Firebase SDK を使用する場合、デバイスまたはエミュレータに Google Play 開発者サービスがインストールされている必要があります。

  • Google アカウントを使用して Firebase にログインします。

Android プロジェクトがまだない方で Firebase プロダクトを試す場合は、クイックスタート サンプルをダウンロードしてください。


Android アプリは以下のいずれかの方法で Firebase に接続できます。

  • オプション 1: (推奨)Firebase コンソールの設定ワークフローを使用します。
  • オプション 2: Android Studio Firebase Assistant を使用します(追加構成が必要な場合があります)。



オプション 1: Firebase コンソールを使用して Firebase を追加する

Firebase をアプリに追加するには、Firebase コンソールと開いている Android プロジェクトの両方でタスクを行う必要があります(コンソールから Firebase 構成ファイルをダウンロードし、Android プロジェクトに移動するなど)。

ステップ 1: Firebase プロジェクトを作成する

Android アプリに Firebase を追加する前に、Android アプリに接続するための Firebase プロジェクトを作成します。Firebase プロジェクトの詳細については、Firebase プロジェクトについて理解するをご覧ください。

ステップ 2: アプリを Firebase に登録する

Android アプリで Firebase を使用するには、アプリを Firebase プロジェクトに登録する必要があります。アプリの登録は、プロジェクトへのアプリの「追加」と呼ばれることがよくあります。

  1. Firebase コンソールに移動します。

  2. プロジェクトの概要ページの中央で、Android アイコン()または [アプリを追加] をクリックして、設定ワークフローを起動します。

  3. [Android パッケージ名] フィールドにアプリのパッケージ名を入力します。

  4. (省略可)その他のアプリ情報(アプリのニックネームデバッグ用の署名証明書 SHA-1)を入力します。

  5. [アプリを登録] をクリックします。

ステップ 3: Firebase 構成ファイルを追加する

  1. Firebase Android 構成ファイルをアプリに追加します。

    1. google-services.json のダウンロード ボタン をクリックして、Firebase Android 構成ファイル(google-services.json)を取得します。

    2. 構成ファイルをアプリのモジュール(アプリレベル)ディレクトリに移動します。

  2. アプリで Firebase プロダクトを有効にするには、Gradle ファイルに google-services プラグインを追加します。

    1. ルートレベル(プロジェクト レベル)の Gradle ファイル(build.gradle)に、Google サービスの Gradle プラグインを含めるためのルールを追加します。Google の Maven リポジトリがあることも確認してください。

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.10'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. モジュール(アプリレベル)の Gradle ファイル(通常は app/build.gradle)で、Google サービスの Gradle プラグインを適用します。

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

ステップ 4: アプリに Firebase SDK を追加する

  1. Firebase Android BoM を使用して、アプリで使用する Firebase プロダクトの依存関係を宣言します。これらをモジュール(アプリレベル)の Gradle ファイル(通常は app/build.gradle)で宣言します。

    アナリティクスが有効な場合

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.4.1')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.4.1')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    Firebase Android BoM を使用すると、アプリは常に互換性のあるバージョンの Firebase Android ライブラリを使用します。

    アナリティクスが無効な場合

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.4.1')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.4.1')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    Firebase Android BoM を使用すると、アプリは常に互換性のあるバージョンの Firebase Android ライブラリを使用します。

  2. アプリを同期して、すべての依存関係に必要なバージョンがあることを確認します。

これで、推奨の次の手順に進めます。

設定の際に問題が発生した場合は、Android のトラブルシューティングとよくある質問をご覧ください。



オプション 2: Firebase Assistant を使用して Firebase を追加する

Firebase Assistant は、Firebase プロジェクトにアプリを登録し、Android プロジェクトに必要な Firebase ファイル、プラグイン、依存関係を追加します。これらはすべて Android Studio から行えます。

  1. Android Studio で Android プロジェクトを開き、Android Studio と Firebase Assistant の最新版を使用していることを確認します。

    • Windows / Linux: [Help] > [Check for updates]
    • macOS: [Android Studio] > [Check for updates]
  2. Firebase Assistant を開きます([Tools] > [Firebase])。

  3. [Assistant] ペインで、アプリに追加する Firebase プロダクトを選択します。セクションを展開し、チュートリアルのリンク([Analytics] > [Log an Analytics event] など)をクリックします。

    1. [Connect to Firebase] をクリックして Android プロジェクトを Firebase に接続します。

    2. ボタンをクリックして、必要な Firebase プロダクトを追加します(アプリにアナリティクスを追加するなど)。

  4. アプリを同期して、すべての依存関係に必要なバージョンがあることを確認します。

  5. [Assistant] ペインで、選択した Firebase プロダクトの残りの設定手順を行います。

  6. Firebase Assistant で、他にも多くの Firebase プロダクトを追加できます。

これで、推奨の次の手順に進めます。

設定の際に問題が発生した場合は、Android のトラブルシューティングとよくある質問をご覧ください。



使用可能なライブラリ

このセクションでは、Android とその Gradle 依存関係でサポートされている Firebase プロダクトを一覧表示しています。Firebase Android ライブラリの詳細については、以下をご覧ください。

Firebase Android BoM を使用する場合、build.gradle で Firebase ライブラリの依存関係を宣言する際に、個々のライブラリ バージョンを指定しません。

Java

サービスまたはプロダクト Gradle 依存関係 最新
バージョン
アナリティクスの追加
Firebase Android BoM
(部品構成表)
com.google.firebase:firebase-bom

最新バージョンの Firebase BoM には、各 Firebase Android ライブラリの最新バージョンが含まれます。特定の BoM バージョンにマッピングされているライブラリ バージョンを確認するには、その BoM バージョンのリリースノートをご覧ください。

28.4.1
AdMob com.google.android.gms:play-services-ads 20.3.0
アナリティクス com.google.firebase:firebase-analytics 19.0.1
App Check カスタム プロバイダ com.google.firebase:firebase-appcheck 16.0.0-beta02
App Check デバッグ プロバイダ com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
App Check SafetyNet プロバイダ com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
App Distribution プラグイン com.google.firebase:firebase-appdistribution-gradle 2.2.0
App Indexing com.google.firebase:firebase-appindexing 20.0.0
Authentication com.google.firebase:firebase-auth 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore 23.0.3
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 20.0.1
Cloud Messaging com.google.firebase:firebase-messaging 22.0.0
Cloud Storage com.google.firebase:firebase-storage 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.2.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.1
Crashlytics プラグイン com.google.firebase:firebase-crashlytics-gradle 2.7.1
動的機能モジュールのサポート com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Dynamic Links com.google.firebase:firebase-dynamic-links 20.1.1
In-App Messaging com.google.firebase:firebase-inappmessaging 20.1.0
(必須)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display 20.1.0
(必須)
Firebase インストール com.google.firebase:firebase-installations 17.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 24.0.0
Performance Monitoring com.google.firebase:firebase-perf 20.0.2
Performance Monitoring プラグイン com.google.firebase:perf-plugin 1.4.0
Realtime Database com.google.firebase:firebase-database 20.0.2
Remote Config com.google.firebase:firebase-config 21.0.1
Google Play 開発者サービス プラグイン com.google.gms:google-services 4.3.10
非推奨ライブラリ
Firebase ML カスタムモデル API com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: 画像ラベル付けモデル com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: オブジェクトの検出とトラッキング モデル com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: 顔検出モデル com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: バーコード スキャンモデル com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: Natural Language API com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML: 言語識別モデル com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: 翻訳モデル com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: スマート リプライモデル com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8

Kotlin+KTX

サービスまたはプロダクト Gradle 依存関係 最新
バージョン
アナリティクスの追加
Firebase Android BoM
(部品構成表)
com.google.firebase:firebase-bom

最新バージョンの Firebase BoM には、各 Firebase Android ライブラリの最新バージョンが含まれます。特定の BoM バージョンにマッピングされているライブラリ バージョンを確認するには、その BoM バージョンのリリースノートをご覧ください。

28.4.1
AdMob com.google.android.gms:play-services-ads 20.3.0
アナリティクス com.google.firebase:firebase-analytics-ktx 19.0.1
App Check カスタム プロバイダ com.google.firebase:firebase-appcheck 16.0.0-beta02
App Check デバッグ プロバイダ com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
App Check SafetyNet プロバイダ com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
App Distribution プラグイン com.google.firebase:firebase-appdistribution-gradle 2.2.0
App Indexing com.google.firebase:firebase-appindexing 20.0.0
Authentication com.google.firebase:firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 23.0.3
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.0.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 22.0.0
Cloud Storage com.google.firebase:firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.1
Crashlytics プラグイン com.google.firebase:firebase-crashlytics-gradle 2.7.1
動的機能モジュールのサポート com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 20.1.1
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 20.1.0
(必須)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display-ktx 20.1.0
(必須)
Firebase インストール com.google.firebase:firebase-installations-ktx 17.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.0
Performance Monitoring com.google.firebase:firebase-perf-ktx 20.0.2
Performance Monitoring プラグイン com.google.firebase:perf-plugin 1.4.0
Realtime Database com.google.firebase:firebase-database-ktx 20.0.2
Remote Config com.google.firebase:firebase-config-ktx 21.0.1
Google Play 開発者サービス プラグイン com.google.gms:google-services 4.3.10
非推奨ライブラリ
Firebase ML カスタムモデル API com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: 画像ラベル付けモデル com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: オブジェクトの検出とトラッキング モデル com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: 顔検出モデル com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: バーコード スキャンモデル com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: Natural Language API com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML: 言語識別モデル com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: 翻訳モデル com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: スマート リプライモデル com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8



次のステップ

Firebase サービスをアプリに追加します。

以下で Firebase の詳細を確認します。