Flutter アプリのログ監視セットアップガイド（Mac → Android）

Win/Mac混在開発がつらくなったので備忘録。

もともとWinでFlutterアプリ、Macでバックエンドを作ってた。Winでさくらサーバを再現するためにDocker使ってたけど、Winのパス構成が面倒でMacでやるようになった。Android開発自体はWinで問題ないんだけど、フロントとバックのログを同時に監視するとなるとPC跨ぎがつらい。Macならパス周りも楽だし、1台で完結させたほうがいいのでは？ってことでFlutter環境もMacに入れた。

Claudeに聞きながらセットアップした内容をまとめた。

前提条件

macOS（Apple Silicon / Intel）
Homebrew インストール済み

インストール手順

Android Studio インストール

brew install --cask android-studio

または公式サイトからダウンロード

Android SDK セットアップ

Android Studio を起動して初期セットアップを完了させる。

SDK Tools の追加インストール（Android Studio → Settings → Languages & Frameworks → Android SDK → SDK Tools）:

✅ Android SDK Command-line Tools (latest)
✅ Android SDK Platform-Tools
✅ Android Emulator

Flutter SDK インストール

brew install --cask flutter

ライセンス承認

flutter doctor --android-licenses

すべて y で承認。

環境確認

flutter doctor

以下が ✅ になっていればOK:

Flutter
Android toolchain

エミュレータ作成

Android Studio → Device Manager → Create Device

推奨設定:

Device: Medium Phone
System Image: API 34 以上
名前: 任意（例: Medium_Phone_API_36）

PATH 設定（推奨）

~/.zshrc に追加:

export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$PATH:$ANDROID_HOME/platform-tools"
export PATH="$PATH:$ANDROID_HOME/emulator"

反映:

source ~/.zshrc

設定後は短縮コマンドが使える:

adb logcat
emulator -list-avds

ログ監視の使い方

エミュレータ起動

# エミュレータ一覧確認
emulator -list-avds

# 起動
emulator -avd <エミュレータ名>

または Flutter 経由:

flutter emulators --launch <エミュレータ名>

デバイス認識確認

# 軽量（adb直接）
adb devices

# Flutter経由（詳細情報あり）
flutter devices

ログ監視

# Flutter ログ（推奨）
# ※ Flutterアプリが起動していないと何も出力されない
flutter logs

# ADB 全ログ
adb logcat

# WebView コンソールログのみ
adb logcat | grep -iE "console|chromium|webview"

# WebView ログ（他を抑制）
adb logcat *:S chromium:V

# Flutter タグのみ
adb logcat -s flutter

トラブルシューティング

adb がデバイスを認識しない

adb kill-server && adb start-server

flutter devices に何も出ない

エミュレータが起動しているか確認
adb devices で認識されているか確認
認識されていなければ adb を再起動

よく使うコマンド一覧

用途	コマンド
環境確認	`flutter doctor`
デバイス一覧	`flutter devices`
デバイス認識確認（軽量）	`adb devices`
エミュレータ一覧	`flutter emulators` または `emulator -list-avds`
エミュレータ起動	`flutter emulators --launch <名前>`
ログ監視（Flutter）	`flutter logs`
ログ監視（全体）	`adb logcat`
WebView ログ	`adb logcat *:S chromium:V`
adb 再起動	`adb kill-server && adb start-server`

環境状況サンプル

項目	状態	パス/バージョン
Flutter SDK	✅	3.38.x (stable)
Dart	✅	3.10.x
Android toolchain	✅	Android SDK 36.x
Android Studio	✅	`/Applications/Android Studio.app`
Android SDK	✅	`~/Library/Android/sdk/`
cmdline-tools	✅	`~/Library/Android/sdk/cmdline-tools/latest/`
ADB	✅	`~/Library/Android/sdk/platform-tools/adb`
エミュレータ	✅	`Medium_Phone_API_36`
Xcode	❌	iOS開発には必要（Android開発には不要）