Firebase Emulator ワークフロー(v2.0)
Firebase Emulator Suite のローカル開発環境管理ワークフロー。
スキル
| スキル | 用途 | 使いどころ |
|---|---|---|
| emulator-control | 起動・停止・状態確認 | 「エミュレーター起動」「停止」「状態」 |
推奨ワークフロー
開発開始 → emulator-control(起動)
↓
iOS / Backend 開発
↓
開発終了 → emulator-control(停止)
環境変数
| 変数 | 説明 | デフォルト |
|---|---|---|
FIREBASE_PROJECT_ID |
プロジェクトID | 自動検出 |
EMULATOR_PORT_FIRESTORE |
Firestore ポート | 8090 |
EMULATOR_PORT_AUTH |
Auth ポート | 9099 |
EMULATOR_PORT_STORAGE |
Storage ポート | 9199 |
EMULATOR_PORT_UI |
UI ポート | 4000 |
ディレクトリ検出
以下の順序で Firebase 設定を検出:
- 環境変数
FIREBASE_DIR - カレントディレクトリの
firebase.json firebase/サブディレクトリ
Emulator UI
起動後、ブラウザで確認:
http://localhost:4000
アプリからの接続
iOS (Swift)
let settings = Firestore.firestore().settings
settings.host = "localhost:8090"
settings.isSSLEnabled = false
Firestore.firestore().settings = settings
Go Backend
os.Setenv("FIRESTORE_EMULATOR_HOST", "localhost:8090")
os.Setenv("FIREBASE_AUTH_EMULATOR_HOST", "localhost:9099")
よくある問題
ポートが既に使用中
Port 8090 is already in use
対処: 既存のプロセスを終了
lsof -ti :8090 | xargs kill -9
firebase.json が見つからない
Error: No Firebase project directory found
対処: firebase init でプロジェクトを初期化