Windows11のFlutterでFirebaseを使えるようにする
🔥 Windows 11 × Flutter × Firebase
VS CodeでFirebaseを使うための設定ガイド
Node.js → Firebase CLI → FlutterFire CLI → Firebase接続
🎯 1. 完成イメージ
Windows 11のVS CodeでFlutterアプリを開発し、 Firebaseを利用できる環境を構築します。
| 項目 | 役割 | 確認 |
|---|---|---|
| Flutter | スマートフォンアプリを開発 | ✓ |
| VS Code | プログラムを作成 | ✓ |
| Node.js | Firebase CLIを動かすための環境 | ✓ |
| Firebase CLI | Firebaseをコマンドから操作 | ✓ |
| FlutterFire CLI | FlutterとFirebaseを接続 | ★重要 |
| firebase_core | FlutterからFirebaseを利用 | ★重要 |
Firebase CLIをインストールしただけでは、 FlutterアプリとFirebaseの接続は完了しません。
FlutterではFlutterFire CLIを使用します。
📋 2. 全体の手順
| 順番 | 作業内容 |
|---|---|
| ① | Node.jsをインストール |
| ② | Firebase CLIをインストール |
| ③ | Firebase CLIを確認 |
| ④ | Firebaseへログイン |
| ⑤ | FlutterFire CLIをインストール |
| ⑥ | FlutterFire CLIを確認 |
| ⑦ | Firebaseプロジェクトを作成 |
| ⑧ | FlutterプロジェクトをFirebaseへ接続 |
| ⑨ | firebase_coreを追加 |
| ⑩ | main.dartを設定 |
| ⑪ | Flutterアプリを実行 |
① Node.jsをインストール
Node.jsをまだインストールしていない場合は、 node-v24.19.0-x64.msiを実行します。
基本的にはデフォルト設定のままでインストールできます。
インストール確認
VS Codeを起動して、
ターミナル → 新しいターミナル
を選択します。
例えば、次のように表示されます。
次にnpmを確認します。
Node.jsとnpmのバージョンが表示されれば成功です。
② Firebase CLIをインストール
用意した firebase-tools-instant-win.exe を実行します。
Firebaseプロジェクトをコマンドラインから操作するためのツールです。
確認
バージョン番号が表示されればOKです。
③ Firebaseへログイン
Firebaseで使用するGoogleアカウントでログインします。
ブラウザが起動するので、 Firebase Consoleで使用するGoogleアカウントを選択します。
ログイン確認
Firebaseプロジェクトの一覧が表示されれば成功です。
Googleアカウントを複数持っている場合は、 Firebase Consoleと同じアカウントでログインしてください。
④ FlutterFire CLIをインストール
FlutterとFirebaseを接続するために、 FlutterFire CLIをインストールします。
FlutterプロジェクトとFirebaseプロジェクトを接続し、 Firebase設定ファイルを自動生成するツールです。
⑤ FlutterFire CLIを確認
バージョン番号が表示されれば成功です。
「flutterfireが認識されません」と表示された場合
Windowsの環境変数PATHに以下を追加します。
PATHの設定
- Windows検索を開く
- 「環境変数」と入力
- 「環境変数を編集」を開く
- 「環境変数」をクリック
- 「Path」を選択
- 「編集」をクリック
- 「新規」をクリック
%LOCALAPPDATA%\Pub\Cache\binを追加- OKをクリック
PATHを変更した場合は、 VS Codeを一度終了して再起動してください。
再起動後に確認します。
⑥ Firebaseプロジェクトを作成
ブラウザでFirebase Consoleを開きます。
「プロジェクトを追加」をクリックします。
例:
FirebaseプロジェクトIDは、作成後に変更できません。 アプリ名などを考えて作成してください。
⑦ Flutterプロジェクトを作成
VS CodeのターミナルでFlutterプロジェクトを作成します。
プロジェクトへ移動します。
VS Codeで開きます。
VS CodeでFlutterプロジェクトが開けば成功です。
⑧ FlutterとFirebaseを接続
VS Codeのターミナルで、 pubspec.yamlがある場所を確認します。
その場所で以下を実行します。
画面で選択
- Googleアカウント
- Firebaseプロジェクト
- 使用するプラットフォーム
WindowsでAndroidアプリを開発する場合は、 まずAndroidを選択します。
Webアプリも作る場合はWebも選択できます。
lib/firebase_options.dart
が作成されます。
⑨ firebase_coreを追加
FlutterアプリからFirebaseを利用するため、 Firebase Coreを追加します。
その後、Firebase設定を確認・更新します。
⑩ main.dartを設定
VS Codeで以下のファイルを開きます。
Firebaseを初期化するコードを入れます。
Firebase.initializeApp()
でFirebaseをFlutterアプリに初期化します。
⑪ Flutterアプリを実行
まず接続されているデバイスを確認します。
AndroidエミュレーターまたはUSB接続したスマートフォンが表示されることを確認します。
その後、実行します。
アプリ画面に「Firebase接続OK」と表示されれば、 基本的なFirebase接続は完了です。
🔍 最終チェックリスト
⚠️ よくあるエラー
| 症状 | 原因 | 対処 |
|---|---|---|
| firebaseが認識されない | PATHの問題 | Firebase CLIのPATHを確認 |
| flutterfireが認識されない | Dart Pub CacheのPATH不足 | %LOCALAPPDATA%\Pub\Cache\binをPATHへ追加 |
| Firebaseプロジェクトが表示されない | Googleアカウントが違う | firebase loginを確認 |
| firebase_options.dartがない | FlutterFire設定未実行 | flutterfire configureを実行 |
| Firebase.initializeAppエラー | Firebase Coreや設定ファイルの問題 | firebase_coreとfirebase_options.dartを確認 |
🚨 Windows 11で特に注意
Firebase CLIをインストールしただけでは、 FlutterとFirebaseの接続は完了しません。
以下が必要です。
pubspec.yamlがある場所で実行してください。
Windows 11ではXcodeを使用できないため、 iOSアプリの最終ビルドにはMacが必要です。
WindowsではまずAndroidを対象に開発するのがおすすめです。
Firebase接続に必要な設定ファイルです。 Firebase設定を変更した場合は、
を再実行してください。
🧩 Firebase機能を追加する場合
Firebase Authentication
Cloud Firestore
Firebase Storage
Firebase Cloud Messaging
📁 最終的なプロジェクト構成
| ファイル | 役割 |
|---|---|
| pubspec.yaml | Flutterパッケージ管理 |
| firebase_options.dart | Firebase接続設定 |
| main.dart | Firebase初期化 |
| .firebaserc | Firebaseプロジェクトとの関連付け |
⭐ 最初に覚えるコマンド
| コマンド | 目的 |
|---|---|
node --version |
Node.js確認 |
npm --version |
npm確認 |
firebase --version |
Firebase CLI確認 |
firebase login |
Firebaseログイン |
firebase projects:list |
Firebaseプロジェクト確認 |
dart pub global activate flutterfire_cli |
FlutterFire CLIインストール |
flutterfire --version |
FlutterFire確認 |
flutterfire configure |
FlutterとFirebaseを接続 |
flutter pub add firebase_core |
Firebase Core追加 |
flutter run |
アプリ実行 |
🏁 最短セットアップ
すでにNode.js、Firebase CLI、Flutter、VS Codeがインストール済みなら、 次の順番で実行してください。
Windows 11 + VS Code + Flutter + Firebaseの基本開発環境が完成です。
コメント