Flutterアプリ開発環境構築ガイド（Windows）

# Flutterアプリ開発環境構築ガイド（Windows） 本ドキュメントは、Windows 上で Flutter の開発環境を素早く構築し、本プロジェクト `app_health` を正常に実行するための手順です。 ## 1. 前提環境 - OS: Windows 10/11（64bit） - Flutter: stable チャンネル推奨 - Dart: Flutter SDK に同梱 - Git: 依存取得・バージョン管理用 - Android Studio: Android SDK / エミュレータ / デバッグ用 - （任意）VS Code: 軽量な開発体験 --- ## 2. 必須ツールのインストール ### 2.1 Git のインストール Git が必要な理由： - プロジェクトの取得（`git clone`）や更新（`git pull`）に使用します。 - チーム開発での変更履歴管理、ブランチ運用、差分確認に必須です。 - 問題発生時に過去コミットへ戻して調査しやすくなります。 1. Git をダウンロードしてインストール - https://git-scm.com/download/win 2. インストール後、PowerShell で確認 ```powershell git --version ``` ### 2.2 Flutter SDK のインストール 1. Flutter 公式（Windows）を開く - https://docs.flutter.dev/get-started/install/windows/mobile 2. stable 版 SDK をダウンロードし、空白を含まないパスへ解凍（例） ```text D:\dev\flutter ``` 3. Flutter の `bin` をシステム環境変数 `Path` に追加 ```text D:\dev\flutter\bin ``` 4. PowerShell を再起動し、動作確認 ```powershell flutter --version ``` ### 2.3 Android Studio のインストール 1. Android Studio をダウンロードしてインストール - https://developer.android.com/studio 2. 初回起動時に推奨コンポーネントを導入 - Android SDK - Android SDK Platform - Android SDK Build-Tools - Android Emulator 3. Android Studio で以下を確認 - `More Actions` → `SDK Manager`（SDK が導入済みか確認） - `More Actions` → `Virtual Device Manager`（Android エミュレータを1台以上作成） ### 2.4 Android ライセンスの同意 PowerShell で実行： ```powershell flutter doctor --android-licenses ``` 表示に従って `y` を入力し、すべて同意します。 --- ## 3. VS Code のインストール（任意） 1. VS Code をインストール - https://code.visualstudio.com/ 2. 拡張機能を導入 - Flutter - Dart --- ## 4. Flutter 環境チェック 以下を実行： ```powershell flutter doctor -v ``` 目標状態： - Flutter が正常 - Android toolchain が正常 - Android Studio が正常 - 接続済みデバイス、または利用可能なエミュレータがある `✗` がある場合は、表示された指示を先に解消してください。 --- ## 5. 本プロジェクトの依存関係を初期化 プロジェクトルートで実行： ```powershell cd d:\localapp\app_health flutter pub get ``` この端末で初回実行の場合は、あわせて以下を推奨： ```powershell flutter clean flutter pub get ``` --- ## 6. エミュレータ起動とアプリ実行 ### 6.1 利用可能なエミュレータ一覧 ```powershell flutter emulators ``` ### 6.2 エミュレータを起動 ```powershell flutter emulators --launch <エミュレータID> ``` 例： ```powershell flutter emulators --launch Medium_Phone ``` ### 6.3 接続デバイス確認 ```powershell flutter devices ``` ### 6.4 アプリ実行 ```powershell flutter run ``` プラットフォーム指定の例： ```powershell flutter run -d windows flutter run -d chrome ``` --- ## 7. よく使う開発コマンド ```powershell flutter pub get # 依存関係を取得 flutter clean # ビルドキャッシュを削除 flutter analyze # 静的解析 flutter test # テスト実行 flutter run -v # 詳細ログ付きで実行 ``` 実行中ショートカット： - `r`: Hot Reload - `R`: Hot Restart - `q`: 終了 --- ## 8. よくあるトラブル ### 8.1 `flutter doctor` で Android toolchain が異常 - Android Studio で SDK の導入状態を確認 - 次を再実行： ```powershell flutter doctor --android-licenses flutter doctor -v ``` ### 8.2 `No devices available` / `No supported devices connected` - エミュレータの完全起動を待つ（通常 1〜3 分） - 次を実行： ```powershell flutter devices ``` ### 8.3 依存取得に失敗する - ネットワーク接続を確認 - 次を実行： ```powershell flutter clean flutter pub get ``` ### 8.4 Gradle ビルドに失敗する - まず次を実行： ```powershell flutter doctor -v ``` - ログを確認し、JDK / Android SDK の不足やバージョン不整合を修正 --- ## 9. チーム開発向け推奨事項 - Flutter は stable チャンネルに統一 ```powershell flutter channel stable flutter upgrade ``` - コード提出前に最低限実行 ```powershell flutter analyze flutter test ``` - 依存バージョンを固定し、開発者間の差異を抑える --- ## 10. クイックチェックリスト - [ ] `flutter --version` が正常に表示される - [ ] `flutter doctor -v` に致命的なエラーがない - [ ] `flutter pub get` が成功する - [ ] `flutter devices` でデバイス/エミュレータが見える - [ ] `flutter run` で本プロジェクトを起動できる 上記を満たせば、Flutter アプリ開発を開始できます。