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

前提条件

  • Android 4.0(Ice Cream Sandwich)以降、および 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 プロジェクトをまだ用意していない場合は、Firebase コンソールで Firebase プロジェクトを作成します。[プロジェクトを追加] をクリックします。モバイルアプリと関連付けられた既存の Google プロジェクトがある場合は、[プロジェクト名] プルダウン メニューから選択します。それ以外の場合は、プロジェクト名を入力して新しいプロジェクトを作成します。
  2. 省略可: プロジェクト ID を編集します。プロジェクトには一意の ID が自動的に付与され、データベース URL や Firebase Hosting サブドメインなどの一般公開される Firebase の機能で使用されます。特定のサブドメインを使用する場合は、この時点でプロジェクト ID を変更できます(後で変更できません)。
  3. 残りの設定手順に沿って操作した後、[プロジェクトを作成](または既存のプロジェクトを使用している場合は [Firebase を追加])をクリックして、プロジェクト用のリソースのプロビジョニングを開始します。通常、この処理には数分かかります。処理が完了すると、プロジェクトの概要が表示されます。

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

  1. [Android アプリに Firebase を追加] をクリックし、設定手順に沿って操作します。既存の Google プロジェクトをインポートする場合、このステップは自動的に実行されることがあります。その場合は、構成ファイルをダウンロードするだけでかまいません。
  2. 求められたら、アプリのパッケージ名を入力します。必ずアプリで使用しているパッケージ名を入力してください。パッケージ名を設定できるのは、アプリを Firebase プロジェクトに追加するときだけです。
  3. 処理中に google-services.json ファイルをダウンロードします。このファイルは、いつでもダウンロードできます。
  4. 初期化コードを追加してアプリを実行すると、Firebase を正常にインストールしたという確認のメッセージが Firebase コンソールに送信されます。
SDK を追加する

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

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

buildscript {
    // ...
    dependencies {
        // ...
        classpath 'com.google.gms:google-services:4.1.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.4'

  // 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.4 アナリティクス
com.google.firebase:firebase-database:16.0.3 Realtime Database
com.google.firebase:firebase-firestore:17.1.1 Cloud Firestore
com.google.firebase:firebase-storage:16.0.3 Storage
com.crashlytics.sdk.android:crashlytics:2.9.5 Crashlytics
com.google.firebase:firebase-auth:16.0.4 Authentication
com.google.firebase:firebase-messaging:17.3.3 Cloud Messaging
com.google.firebase:firebase-config:16.0.1 Remote Config
com.google.firebase:firebase-invites:16.0.4 Invites と Dynamic Links
com.google.firebase:firebase-ads:16.0.1 AdMob
com.google.firebase:firebase-appindexing:16.0.2 App Indexing
com.google.firebase:firebase-perf:16.1.2 Performance Monitoring
com.google.firebase:firebase-functions:16.1.1 Cloud Functions for Firebase Client SDK
com.google.firebase:firebase-ml-vision:17.0.1 ML Kit(Vision)
com.google.firebase:firebase-ml-model-interpreter:16.2.2 ML Kit(カスタムモデル)

次のステップ

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

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

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

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

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