Flutter アプリに Firebase を追加する

前提条件

お好みのエディタまたは IDE をインストールします。
以下のコンポーネントを含む、ご利用のオペレーティングシステムに対応した Flutter をインストールします。
- Flutter SDK
- サポートライブラリ
- プラットフォーム固有のソフトウェアと SDK
Google アカウントを使用して Firebase にログインします。

Flutter アプリがまだない場合は、スタートガイド: テストドライブを参照して、お好みのエディタまたは IDE で新しい Flutter アプリを作成してください。

ステップ 1: 必要なコマンドラインツールをインストールする

まだインストールしていない場合は、Firebase CLI をインストールします。
Google アカウントで Firebase にログインするには、次のコマンドを実行します。
```
firebase login
```
任意のディレクトリで次のコマンドを実行して、FlutterFire CLI をインストールします。
```
dart pub global activate flutterfire_cli
```

ステップ 2: Firebase を使用するようにアプリを構成する

FlutterFire CLI を使用して、Flutter アプリを Firebase に接続するように構成します。

Flutter プロジェクトディレクトリで、次のコマンドを実行して、アプリの構成ワークフローを開始します。

flutterfire configure

この flutterfire configure ワークフローの内容

flutterfire configure ワークフローは、次のことを行います。

Flutter アプリでサポートされているプラットフォーム（iOS、Android、ウェブ）を選択するよう求められます。選択したプラットフォームごとに、FlutterFire CLI によって Firebase プロジェクトに Firebase アプリが新規作成されます。

既存の Firebase プロジェクトを使用するか、Firebase プロジェクトを新規作成するかを選択します。既存の Firebase プロジェクトにアプリがすでに登録されている場合、FlutterFire CLI は、現在の Flutter プロジェクト構成に基づいて、アプリのマッチングを試みます。

注: Firebase プロジェクトの設定と管理に関するヒントをいくつか紹介します。

Firebase プロジェクトにアプリを追加する際のベストプラクティス（複数のバリアントの扱い方など）をご確認ください。

プロジェクトで Google Analytics を有効にします。これにより、Crashlytics や Remote Config などの多くの Firebase プロダクトを使用して最適なエクスペリエンスを実現できます。

Firebase 構成ファイル（firebase_options.dart）を作成し、lib/ ディレクトリに追加します。

注: この Firebase 構成ファイルには、選択した各プラットフォームの、機密ではない一意の識別子が格納されています。
構成ファイルの詳細については、Firebase プロジェクトについて理解するをご覧ください。

（Android の Crashlytics または Performance Monitoring の場合）必要な、プロダクト固有の Gradle プラグインを Flutter アプリに追加します。

注: FlutterFire CLI で適切な Gradle プラグインを追加するには、プロダクトの Flutter プラグインを Flutter アプリにインポートしておく必要があります。

flutterfire configure の初回実行後、以下の場合には必ず、コマンドを再実行する必要があります。

Flutter アプリで新しいプラットフォームをサポートする場合。
Flutter アプリで新しい Firebase サービスまたはプロダクトの使用を開始する場合。特に Google、Crashlytics、Performance Monitoring、Realtime Database でログインの使用を開始する場合。

コマンドを再実行すると、Flutter アプリの Firebase 構成が最新の状態になり、（Android の場合）必要な Gradle プラグインがアプリに自動的に追加されます。

ステップ 3: アプリで Firebase を初期化する

Flutter プロジェクトディレクトリで、次のコマンドを実行してコアプラグインをインストールします。
```
flutter pub add firebase_core
```
Flutter プロジェクトディレクトリで次のコマンドを実行して、Flutter アプリの Firebase 構成を最新にします。
```
flutterfire configure
```
lib/main.dart ファイルで、Firebase Core プラグインと、以前に生成した構成ファイルをインポートします。
```
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
```
また、lib/main.dart ファイルで、構成ファイルによってエクスポートされた DefaultFirebaseOptions オブジェクトを使用して Firebase を初期化します。
```
WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);
runApp(const MyApp());
```
Flutter アプリケーションを再ビルドします。
```
flutter run
```

デモプロジェクトを使用する場合は、Firebase エミュレータを起動し、lib/main.dart ファイルで demoProjectId（demo- で始まる）を使用して Firebase を初期化します。

  await Firebase.initializeApp(
    demoProjectId: "demo-project-id",
  );

ステップ 4: Firebase プラグインを追加する

Flutter アプリでは、Firebase プロダクトごとに 1 つずつ、さまざまな Firebase Flutter プラグインを使用できます（Cloud Firestore、Authentication、Analytics など）。

Flutter はマルチプラットフォームフレームワークであるため、各 Firebase プラグインは、Apple、Android、ウェブのプラットフォームに適用できます。つまり、Flutter アプリに Firebase プラグインを追加すると、Apple バージョン、Android バージョン、ウェブバージョンのアプリで使用されます。

Firebase Flutter プラグインを追加する方法は次のとおりです。

Flutter プロジェクトディレクトリで、次のコマンドを実行します。
```
flutter pub add PLUGIN_NAME
```
Flutter プロジェクトディレクトリで、次のコマンドを実行します。
```
flutterfire configure
```
このコマンドを実行すると、Flutter アプリの Firebase 構成が最新の状態になり、Android の Crashlytics と Performance Monitoring で必要な Gradle プラグインがアプリに追加されます。
完了したら、Flutter プロジェクトを再ビルドします。
```
flutter run
```

これで設定は完了です。Flutter アプリは、Firebase を使用するように登録され、構成されました。

使用できるプラグイン

プロダクト	プラグイン名	その他の Apple （macOS など）	Windows
Firebase AI Logic ¹	`firebase_ai`	ベータ版
Analytics	`firebase_analytics`	ベータ版
App Check	`firebase_app_check`	ベータ版
Authentication	`firebase_auth`	ベータ版	ベータ版
Cloud Firestore	`cloud_firestore`	ベータ版	ベータ版
Cloud Functions	`cloud_functions`	ベータ版
Cloud Messaging	`firebase_messaging`	ベータ版
Cloud Storage	`firebase_storage`	ベータ版	ベータ版
Crashlytics	`firebase_crashlytics`	ベータ版
Data Connect	`firebase_data_connect`
Dynamic Links	`firebase_dynamic_links`
In-App Messaging	`firebase_in_app_messaging`
Firebaseインストール	`firebase_app_installations`	ベータ版
ML モデルダウンローダー	`firebase_ml_model_downloader`	ベータ版
Performance Monitoring	`firebase_performance`
Realtime Database	`firebase_database`	ベータ版
Remote Config	`firebase_remote_config`	ベータ版

^{1 Firebase AI Logic は、以前はプラグイン firebase_vertexai で「Vertex AI in Firebase」と呼ばれていました。}

Analyticsを使ってサンプルアプリを試す

すべてのパッケージと同様に、firebase_analytics プラグインにはサンプルプログラムが含まれています。

Firebase を使用するように構成した Flutter アプリを開きます（このページの手順を参照）。
アプリの lib ディレクトリにアクセスして、既存の main.dart ファイルを削除します。
Google Analyticsのサンプルプログラムリポジトリから、次の 2 つのファイルをコピーしてアプリの lib ディレクトリに貼り付けます。
- main.dart
- tabs_page.dart
Flutter アプリを実行します。
Firebase コンソールでアプリの Firebase プロジェクトに移動し、左側のナビゲーションで [分析] をクリックします。
1. [Dashboard] をクリックします。Analyticsが正常に動作している場合、ダッシュボードの [過去 30 分間のユーザー] パネルにアクティブなユーザーが表示されます（この処理にはしばらく時間がかかる場合があります）。
2. [DebugView] をクリックします。この機能を有効にすると、サンプルプログラムによって生成されたすべてのイベントが表示されます。

Analyticsの設定の詳細については、iOS+、Android、ウェブの各スタートガイドをご覧ください。

次のステップ

Firebase Flutter Codelab を実際に体験します。
アプリをリリースする準備をする。
- Google Cloud コンソールでプロジェクトの予算アラートを設定する。
- Firebase コンソールの [使用量と請求額] ダッシュボードをモニタリングして、複数の Firebase サービスを通じたプロジェクトの全体的な使用状況を確認する。
- Firebase リリースチェックリストを確認する。