環境構築手順 (Environment Setup Guide)

新しい PC で開発環境を構築する際の手順．メンバーの参加時や環境の再構築時に使用する．

前提条件 (Prerequisites)

OS: Windows 10 以降
インターネット接続
GitHub アカウント（リポジトリへのアクセス権があること）
Python 3.7 以上と bash（Claude Code のフック実行に使用）
- フックは bash .claude/hooks/run_python.sh 経由で起動し，python3 → python → py の順に起動できるものを使う（いずれか 1 つで起動できればよい）
- bash は Git for Windows 付属のものを使う
- ※ Python が見つからないと，リポジトリ外アクセス制限フックが Claude Code の Read・Write・Edit・Glob・Grep・Bash をすべてブロックする

トラブルシューティング (Troubleshooting)

`flutter doctor` で Android SDK が見つからない場合

Android SDK のパスを手動で設定する．

flutter config --android-sdk <Android SDKのパス>

Scoop 経由でインストールした場合，Android SDK は通常以下にある．

%LOCALAPPDATA%\Android\Sdk

ADB で端末が認識されない場合

USB ケーブルが「データ転送対応」であることを確認する（充電専用ケーブルでは認識されない）
スマートフォンの USB 接続モードが「ファイル転送（MTP）」になっていることを確認する
端末のメーカー固有の USB ドライバが必要な場合がある（AQUOS の場合は SHARP 公式サイトからダウンロード）
adb コマンドが見つからない場合は，ADB パスの環境変数設定（上記「環境変数の設定」セクション）を確認する

Gradle ビルドで `JAVA_HOME is not set` エラーが出る場合

JAVA_HOME の環境変数設定（上記「環境変数の設定」セクション）を確認する．Scoop 経由で Android Studio をインストールした場合，JDK は以下にある．

%USERPROFILE%\scoop\apps\android-studio\current\jbr

Gradle ビルドで Java と Gradle の非互換エラーが出る場合

flutter build apk で「Java/Gradle incompatibility」（例: Java 25 と Gradle 8.14 は非互換）と表示される場合，Android Studio 同梱の JDK が新しすぎる．JDK 21 を別途導入し，Flutter が使う JDK として指定する．

scoop bucket add java
scoop install java/temurin21-jdk
flutter config --jdk-dir="$env:USERPROFILE\scoop\apps\temurin21-jdk\current"

※ temurin21-jdk の導入でユーザー環境変数 JAVA_HOME も JDK 21 に設定される．Android Studio は同梱の JDK を使うため影響しない．

`Failed to find target with hash string 'android-37'` エラーが出る場合

Android SDK Platform 37 は platforms/android-37.0 という名前でインストールされるが，Android Gradle Plugin は platforms/android-37 を探すため見つからない（flutter/flutter #192478）．SDK の platforms に android-37 から android-37.0 へのジャンクションを作成する（管理者権限は不要）．

$p = "<Android SDKのパス>\platforms"
New-Item -ItemType Junction -Path "$p\android-37" -Target "$p\android-37.0"

※ SDK Platform 37 が未導入の場合は，先に SDK Manager（または sdkmanager "platforms;android-37.0"）で導入する．

環境構築手順 (Environment Setup Guide)

前提条件 (Prerequisites)

手順 (Steps)

Scoop のインストール (Install Scoop)

リポジトリの取得 (Clone Repository)

セットアップスクリプトの実行 (Run Setup Script)

Android Studio の初期設定 (Android Studio Initial Setup)

Flutter の設定 (Configure Flutter)

環境の確認 (Verify Environment)

GitHub CLI の認証 (Authenticate GitHub CLI)

VS Code のセットアップ (VS Code Setup)

実機デバッグの準備 (USB Debugging Setup)