MENU
現役エンジニアが教えない、挫折と苦悩のアプリ開発
  1. ホーム
  2. Flutter解説
  3. Flutterコマンド

Flutterコマンド

Flutter解説

Flutter開発で使う主要コマンドを、紹介します！

目次

📱 1. プロジェクト管理コマンド

① プロジェクト作成

# 新規プロジェクト作成
flutter create my_app

# 特定のプラットフォームのみ
flutter create --platforms=android,ios my_app

# organizationを指定（アプリIDに影響）
flutter create --org com.sample my_app
# → com.sample.my_app というアプリIDになる


② プロジェクト情報確認

# Flutterのバージョン確認
flutter --version

# プロジェクトの状態確認
flutter doctor

# 詳細表示
flutter doctor -v
```

**flutter doctor の出力例：**
```
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.16.0)
[✓] Android toolchain
[✓] Xcode
[✓] Chrome
[✓] Android Studio
[✓] VS Code
[!] Connected device (1 available)

📦 2. パッケージ管理コマンド

①パッケージのインストール

# pubspec.yamlに基づいてパッケージ取得
flutter pub get

# パッケージ追加（自動でpubspec.yamlに追記）
flutter pub add http
flutter pub add shared_preferences
flutter pub add image_picker

# 開発用パッケージ追加
flutter pub add --dev flutter_test

②パッケージの削除

# すべてのパッケージを最新に更新
flutter pub upgrade

# 特定のパッケージのみ更新
flutter pub upgrade http

# メジャーバージョンも含めて更新
flutter pub upgrade --major-versions

🏃 3. 実行・デバッグコマンド

①アプリの実行

# デバッグモードで実行（開発中）
flutter run

# リリースモードで実行（動作確認）
flutter run --release

# プロファイルモードで実行（パフォーマンス測定）
flutter run --profile

# 特定のデバイスで実行
flutter run -d chrome        # Webブラウザ
flutter run -d iPhone        # iOSシミュレータ
flutter run -d emulator-5554 # Androidエミュレータ

② ホットリロード・ホットリスタート

アプリ実行中に：

# ホットリロード（rキーを押す）
r

# ホットリスタート（Rキーを押す）
R

# デバッグ情報表示（dキーを押す）
d

# 終了（qキーを押す）
q

違い：

ホットリロード（r）: コード変更を即座に反映（状態を保持）
ホットリスタート（R）: アプリを再起動（状態をリセット）

🔨 4. ビルドコマンド（重要！）

Android向けビルド

# APKファイル作成（テスト用）
flutter build apk --release

# デバッグ用APK
flutter build apk --debug

# App Bundle作成（Google Play用）
flutter build appbundle --release

# 特定のアーキテクチャのみ
flutter build apk --target-platform android-arm64

iOS向けビルド

# iOSアプリビルド
flutter build ios --release

# 設定のみ更新（ビルドしない）
flutter build ios --config-only --release

# シミュレータ用ビルド
flutter build ios --simulator

その他のプラットフォーム

# Webアプリビルド
flutter build web

# macOSアプリビルド
flutter build macos

# Windowsアプリビルド
flutter build windows

# Linuxアプリビルド
flutter build linux

🧹 5. クリーンアップコマンド

# ビルドキャッシュをクリア
flutter clean

# パッケージキャッシュもクリア
flutter clean && flutter pub get

# Dartのビルドキャッシュをクリア
dart pub cache repair

いつ使う？

ビルドエラーが出たとき
挙動がおかしいとき
パッケージを追加/削除したとき

🔍 6. 分析・テストコマンド

① コード分析

# コードの問題をチェック
flutter analyze

# より詳細な分析
flutter analyze --fatal-infos

② テスト実行

# すべてのテストを実行
flutter test

# 特定のテストファイルのみ
flutter test test/widget_test.dart

# カバレッジレポート生成
flutter test --coverage

③ パフォーマンス測定

# パフォーマンスプロファイル
flutter run --profile

# メモリ使用量チェック
flutter run --enable-observatory

# アプリサイズ分析
flutter build apk --analyze-size

📊 7. 実務での典型的な流れ

開発開始時

# ① プロジェクトに移動
cd ~/flutter_projects/concert_manager_app

# ② パッケージ取得
flutter pub get

# ③ デバイス確認
flutter devices

# ④ 実行
flutter run

パッケージ追加時

# ① パッケージ追加
flutter pub add image_picker

# ② クリーン
flutter clean

# ③ 再取得
flutter pub get

# ④ 実行して確認
flutter run

ビルドエラー時

# ① クリーン
flutter clean

# ② パッケージ再取得
flutter pub get

# ③ 分析
flutter analyze

# ④ 再ビルド
flutter build apk --release

リリース時

# ① バージョン確認
cat pubspec.yaml | grep version

# ② クリーン
flutter clean

# ③ パッケージ取得
flutter pub get

# ④ Androidビルド
flutter build appbundle --release

# ⑤ iOSビルド（設定のみ）
flutter build ios --config-only --release

# ⑥ Xcodeでアーカイブ
open ios/Runner.xcworkspace

🎯 8. よく使うオプション

–release vs –debug vs –profile

# デバッグモード（開発中）
flutter build apk --debug
# - ホットリロード可能
# - デバッグ情報あり
# - 動作が遅い
# - ファイルサイズ大きい

# リリースモード（配布用）
flutter build apk --release
# - 最適化済み
# - 動作が速い
# - ファイルサイズ小さい
# - デバッグ不可

# プロファイルモード（性能測定）
flutter build apk --profile
# - 最適化済み
# - パフォーマンス測定可能
# - デバッグ情報あり

–verbose（詳細表示）

# 詳細なログを表示
flutter build apk --release --verbose

# エラーの詳細を確認したいとき便利
flutter run -v

💡 9. トラブルシューティングコマンド

よくある問題と解決方法

① ビルドエラー
# 完全クリーンアップ
flutter clean
rm -rf build/
rm -rf ios/Pods/
rm -rf ios/Podfile.lock
flutter pub get
cd ios && pod install && cd ..
② パッケージエラー
# キャッシュクリア
flutter pub cache repair
flutter clean
flutter pub get
③ Gradleエラー（Android）
# Gradleキャッシュクリア
cd android
./gradlew clean
cd ..
flutter clean
flutter build apk --release
④ Cocoaポッドエラー（iOS）
# Podを再インストール
cd ios
rm -rf Pods/
rm Podfile.lock
pod install
cd ..
flutter clean
flutter build ios --config-only --release

📚 10. 便利なエイリアス設定

~/.zshrc または ~/.bashrc に追加：

# Flutter エイリアス
alias frun='flutter run'
alias fbuild='flutter build'
alias fclean='flutter clean && flutter pub get'
alias ftest='flutter test'
alias fdoctor='flutter doctor -v'
alias fdevices='flutter devices'

# よく使う組み合わせ
alias frebuild='flutter clean && flutter pub get && flutter run'
alias frelease='flutter build appbundle --release'

使用例：

# 通常
flutter clean && flutter pub get && flutter run

# エイリアス使用
frebuild

🎯 まとめ：コマンド早見表

用途コマンド
プロジェクト作成flutter create
パッケージ追加flutter pub add
パッケージ取得flutter pub get
実行flutter run
ビルド（Android）flutter build appbundle –release
ビルド（iOS）flutter build ios –config-only –release
クリーンflutter clean
分析flutter analyze
テストflutter test
デバイス確認flutter devices

💪 実践：明日から使えるコマンド集

毎日の開発

flutter run          # 開発開始
# アプリ実行中に「r」でホットリロード
flutter analyze      # コードチェック

パッケージ追加

flutter pub add パッケージ名
flutter clean
flutter pub get
flutter run

パッケージ追加

# pubspec.yamlでバージョンアップ
flutter clean
flutter pub get
flutter build appbundle --release
flutter build ios --config-only --release
Flutter解説
目次