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

前提条件

  • 以下を搭載しているデバイス:
    • Android 4.1(API レベル 16、Jelly Bean)以降
    • Google Play 開発者サービス 15.0.0 以降
  • Android Studio の最新バージョン

Android Studio プロジェクトをまだ用意していない場合に Firebase 機能を試すだけであれば、クイックスタート サンプルをダウンロードしてご利用いただけます。クイックスタートを使用する場合は、プロジェクトのモジュール フォルダ(通常は app/)内の build.gradle ファイルからアプリケーション ID を取得してください。このパッケージ名は次のステップで必要になります。

アプリに Firebase を追加する

Android Studio バージョン 2.2 以降を使用し、アプリを Firebase に接続する場合、Firebase Assistant を使用するのが最も簡単な方法です。Assistant を使用すると、既存のプロジェクトを接続したり、必要な Gradle の依存関係を含む新しいプロジェクトを作成したりできます。

Android Studio の以前のバージョンを使用している場合や、複雑なプロジェクト構成がある場合は、Firebase をアプリに手動で追加することもできます。

Firebase Assistant を使用する

Android Studio で Firebase Assistant を開く方法:

  • [ツール] > [Firebase] をクリックし、[Assistant] 画面を開きます。
  • リストにある機能のいずれかをクリックして詳細を表示(例: Analytics)してから、チュートリアル リンクをクリックします(例: Analytics イベントを記録する)。
  • [Firebase へ接続] ボタンをクリックして Firebase に接続し、必要なコードをアプリに追加します。

設定は以上です。状況に応じて次の手順に進んでください。

Firebase を手動で追加する

Firebase をアプリに追加するには、Firebase プロジェクトと、アプリ用の Firebase 構成ファイルが必要です。

Firebase プロジェクトを作成するには:

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

  2. [プロジェクトを追加] をクリックし、[プロジェクト名] でプロジェクト名を選択するか、新しいプロジェクト名を入力します。

    • アプリに関連付けられた既存の Google プロジェクトがある場合は、[プロジェクト名] プルダウン メニューからプロジェクトを選択します。
    • 既存の Google プロジェクトがない場合は、[プロジェクト名] に新しいプロジェクト名を入力します。
  3. (省略可)プロジェクト ID を編集します。

    Firebase プロジェクトには一意の ID が自動的に割り当てられます。一般公開される Firebase サービスでは、この ID は次のように表示されます。

    • デフォルト Realtime Database URL - your-project-id.firebaseio.com
    • デフォルト Cloud Storage バケット名 - your-project-id.appspot.com
    • デフォルト ホスティング サブドメイン - your-project-id.firebaseapp.com
  4. Firebase コンソールで残りの設定手順を実施した後、[プロジェクトを作成](既存の Google プロジェクトを使用する場合は [Firebase を追加])をクリックします。

Firebase プロジェクトのリソースが自動的にプロビジョニングされます。通常、この処理には数分かかります。処理が完了すると、Firebase コンソールで Firebase プロジェクトの概要ページが表示されます。

これでプロジェクトを用意できました。プロジェクトに Android アプリを追加できます。

  1. [Android アプリに Firebase を追加] をクリックし、設定手順に沿って操作します。既存の Google プロジェクトをインポートする場合、このステップは自動的に実行されることがあります。その場合は、構成ファイルをダウンロードするだけでかまいません。

  2. メッセージが表示されたら、アプリのパッケージ名を入力します。必ずアプリで使用しているパッケージ名を入力してください。パッケージ名を設定できるのは、アプリを Firebase プロジェクトに追加するときだけです。

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

    1. [google-services.json をダウンロード] をクリックして、Firebase Android 構成ファイル(google-services.json)を入手します。

      Firebase Android 構成ファイルはいつでも再ダウンロードできます。

    2. 構成ファイルをルートレベルの build.gradle ファイルと同じディレクトリに移動します。

  4. 初期化コードを追加したらアプリを実行して、Firebase を正常にインストールしたという確認を Firebase コンソールに送信します。

SDK を追加する

Firebase ライブラリをプロジェクトに統合する場合は、Android Studio プロジェクトを準備するためのいくつかの基本タスクを実行する必要があります。ただし、アプリに Firebase を追加するときに、すでにこの手順が完了している可能性があります。

まず、ルートレベルの build.gradle ファイルにビルドルールを追加し、google-services プラグインと Google の Maven リポジトリを含めます。

buildscript {
    // ...
    dependencies {
        // ...
        classpath 'com.google.gms:google-services:4.2.0' // google-services plugin
    }
}

allprojects {
    // ...
    repositories {
        google() // Google's Maven repository
        // ...
    }
}

次に、モジュールの Gradle ファイル(通常は app/build.gradle)の末尾に apply plugin 行を追加して、Gradle プラグインを有効にします。

apply plugin: 'com.android.application'

android {
  // ...
}

dependencies {
  // ...
  implementation 'com.google.firebase:firebase-core:16.0.7'

  // Getting a "Could not find" error? Make sure you have
  // added the Google maven respository to your root build.gradle
}

// ADD THIS AT THE BOTTOM
apply plugin: 'com.google.gms.google-services'

また、使用する Firebase SDK の依存関係も追加する必要があります。まず、Firebase 向け Google アナリティクス機能を提供する com.google.firebase:firebase-core から始めることをおすすめします。使用可能なライブラリの一覧をご覧ください。

使用可能なライブラリ

さまざまな Firebase 機能で使用できるライブラリは次のとおりです。

Gradle の依存関係行 サービス
com.google.firebase:firebase-core:16.0.7 アナリティクス
com.google.firebase:firebase-database:16.0.6 Realtime Database
com.google.firebase:firebase-firestore:18.0.1 Cloud Firestore
com.google.firebase:firebase-storage:16.0.5 Storage
com.crashlytics.sdk.android:crashlytics:2.9.9 Crashlytics
com.google.firebase:firebase-auth:16.1.0 Authentication
com.google.firebase:firebase-messaging:17.3.4 Cloud Messaging
com.google.firebase:firebase-config:16.3.0 Remote Config
com.google.firebase:firebase-invites:16.1.0 Invites と Dynamic Links
com.google.firebase:firebase-ads:17.1.3 AdMob
com.google.firebase:firebase-appindexing:17.1.0 App Indexing
com.google.firebase:firebase-perf:16.2.3 Performance Monitoring
com.google.firebase:firebase-functions:16.1.3 Cloud Functions for Firebase Client SDK
com.google.firebase:firebase-ml-vision:19.0.2 ML Kit(Vision)
com.google.firebase:firebase-ml-model-interpreter:17.0.3 ML Kit(カスタムモデル)
com.google.firebase:firebase-ml-natural-language:18.1.1 ML Kit(Natural Language)
com.google.firebase:firebase-ml-natural-language-language-id-model:18.0.2 ML Kit(Natural Language ID モデル)

次のステップ

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

Firebase 機能をアプリに追加します。

  • Analytics を使用してユーザー行動を把握する。
  • Authentication を使用してユーザー認証をセットアップする。
  • Realtime Database でユーザー情報を保存するか、Cloud Storage で blob データを保存する。
  • Cloud Messaging を使用してユーザーに通知を送信する。
  • Crashlytics を使用してアプリがクラッシュする場所と理由を確認する。

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。