Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。

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

前提条件

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

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

    • API レベル 16(Jelly Bean)以降が対象です。
    • Gradle 4.1 以降を使用します。
    • Jetpack(AndroidX)を使用します。また、次のバージョン要件を満たしている必要があります。
      • com.android.tools.build:gradle v3.2.1 以降
      • compileSdkVersion 28 以降
  • 物理デバイスを設定するか、エミュレータを使用してアプリを実行します。
    エミュレータでは 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 サービス プラグインを含めるためのルールを追加します。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.4'  // 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:25.12.0')
    
      // 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:25.12.0')
    
      // 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:25.12.0')
    
      // 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'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
    

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:25.12.0')
    
      // 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'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
    

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

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

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



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

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

  1. Android Studio で Android プロジェクトを開き、Firebase Assistant にアクセスします。

    1. [File] > [Check for updates] に移動して、Android Studio と Firebase Assistant の最新版を使用していることを確認します。

    2. [Tools] > [Firebase] に移動し、[Assistant] ペインを開きます。

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

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

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

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

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

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

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



使用可能なライブラリ

このセクションでは、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 バージョンのリリースノートをご覧ください。

25.12.0
AdMob com.google.android.gms:play-services-ads 19.4.0
アナリティクス com.google.firebase:firebase-analytics 17.6.0
App Indexing com.google.firebase:firebase-appindexing 19.1.0
Authentication com.google.firebase:firebase-auth 19.4.0
Cloud Firestore com.google.firebase:firebase-firestore 21.7.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 19.1.0
Cloud Messaging com.google.firebase:firebase-messaging 20.3.0
Cloud Storage com.google.firebase:firebase-storage 19.2.0
Crashlytics com.google.firebase:firebase-crashlytics 17.2.2
Dynamic Links com.google.firebase:firebase-dynamic-links 19.1.1
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML カスタムモデル API com.google.firebase:firebase-ml-model-interpreter 22.0.4
アプリ内メッセージング com.google.firebase:firebase-inappmessaging 19.1.1
(必須)
アプリ内メッセージング表示 com.google.firebase:firebase-inappmessaging-display 19.1.1
(必須)
Performance Monitoring com.google.firebase:firebase-perf 19.0.9
Realtime Database com.google.firebase:firebase-database 19.5.0
Remote Config com.google.firebase:firebase-config 19.2.0
Google Play 開発者サービス プラグイン com.google.gms:google-services 4.3.4
非推奨ライブラリ
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 バージョンのリリースノートをご覧ください。

25.12.0
AdMob com.google.android.gms:play-services-ads 19.4.0
アナリティクス com.google.firebase:firebase-analytics-ktx 17.6.0
App Indexing com.google.firebase:firebase-appindexing 19.1.0
Authentication com.google.firebase:firebase-auth-ktx 19.4.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 21.7.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 19.1.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 20.3.0
Cloud Storage com.google.firebase:firebase-storage-ktx 19.2.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 17.2.2
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 19.1.1
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML カスタムモデル API com.google.firebase:firebase-ml-model-interpreter 22.0.4
アプリ内メッセージング com.google.firebase:firebase-inappmessaging-ktx 19.1.1
(必須)
アプリ内メッセージング表示 com.google.firebase:firebase-inappmessaging-display-ktx 19.1.1
(必須)
Performance Monitoring com.google.firebase:firebase-perf-ktx 19.0.9
Realtime Database com.google.firebase:firebase-database-ktx 19.5.0
Remote Config com.google.firebase:firebase-config-ktx 19.2.0
Google Play 開発者サービス プラグイン com.google.gms:google-services 4.3.4
非推奨ライブラリ
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 の詳細を確認します。