Flutterコマンドを深掘りします!4回目
目次
flutter doctor – 環境診断
開発環境の健康診断!
基本的な使い方
# 環境をチェック
flutter doctor
# 詳細表示
flutter doctor -v
📋 出力の読み方
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.16.0)
[✓] Android toolchain - develop for Android devices
[!] Xcode - develop for iOS and macOS (Xcode 15.0.1)
✗ CocoaPods not installed.
[✓] Chrome - develop for the web
[✓] Android Studio (version 2023.1)
[✓] VS Code (version 1.85.0)
[!] Connected device
! No devices available
! Doctor found issues in 2 categories.
シンボルの意味
| シンボル | 意味 | 対処 |
|---|---|---|
| [✓] | 正常 | 何もしなくてOK ✅ |
| [!] | 警告 | できれば修正 ⚠️ |
| [✗] | エラー | 修正が必要 ❌ |
🔍 各項目の説明
① Flutter
[✓] Flutter (Channel stable, 3.16.0)
• Flutter version 3.16.0
• Dart version 3.2.0
• Framework revision xxxxx
確認内容:
- Flutterのバージョン
- Dartのバージョン
- インストール場所
② Android toolchain
[✓] Android toolchain - develop for Android devices
• Android SDK at /Users/xxx/Library/Android/sdk
• Platform android-34, build-tools 34.0.0
• Java version 17.0.0
確認内容:
- Android SDKの場所
- インストールされているバージョン
- Java のバージョン
③ Xcode
[✓] Xcode - develop for iOS and macOS (Xcode 15.0.1)
• Xcode at /Applications/Xcode.app
• Build 15A507
• CocoaPods version 1.15.0
確認内容:
- Xcodeのバージョン
- CocoaPodsのインストール状況
④ Chrome
[✓] Chrome - develop for the web
• Chrome at /Applications/Google Chrome.app
確認内容:
- Chromeのインストール状況
- Web開発が可能か
⑤ エディタ
[✓] VS Code (version 1.85.0)
• VS Code at /Applications/Visual Studio Code.app
• Flutter extension version 3.78.0
• Dart extension version 3.78.0
確認内容:
- エディタのインストール
- Flutter/Dart拡張機能
⑥ Connected device
[✓] Connected device (2 available)
• iPhone 16 (mobile) • 00008140-xxx • ios
• sdk gphone64 (mobile) • emulator-5554 • android
または
[!] Connected device
! No devices available
確認内容:
- 接続されているデバイス
- 利用可能なエミュレータ
🔧 よくある問題と解決方法
問題1: CocoaPods not installed
[!] Xcode - develop for iOS and macOS
✗ CocoaPods not installed.
解決方法:
sudo gem install cocoapods
問題2: Android licenses not accepted
[!] Android toolchain
✗ Android license status unknown.
解決方法:
flutter doctor --android-licenses
# 全て「y」を入力
問題3: No devices available
[!] Connected device
! No devices available
解決方法:
# エミュレータを起動
flutter emulators --launch Pixel_5_API_33
# または実機を接続
💡 実際の使用例
新しいPCでFlutterをセットアップ
# ① Flutterをインストール
# ② 環境チェック
flutter doctor
# ③ 問題を1つずつ解決
# CocoaPodsをインストール
sudo gem install cocoapods
# Androidライセンスに同意
flutter doctor --android-licenses
# ④ 再度チェック
flutter doctor
# すべて [✓] になるまで繰り返す
ビルドエラーが出たとき
# ① 環境をチェック
flutter doctor -v
# ② 問題がないか確認
# [!] や [✗] がないか
# ③ 問題があれば解決
# ④ 再ビルド
flutter clean
flutter pub get
flutter build apk --release
