よく使うflutterコマンド

Flutter

よく使うコマンドとオプションに説明をメモしています。

flutter –version

Flutterのバージョン表示

C:\Users\xxx>flutter --version
Flutter 3.10.5 • channel stable • https://github.com/flutter/flutter.git
Framework • revision 796c8ef792 (5 weeks ago) • 2023-06-13 15:51:02 -0700
Engine • revision 45f6e00911
Tools • Dart 3.0.5 • DevTools 2.23.1

flutter doctor

Flutter環境診断、-vオプションで詳細表示

C:\Users\xxx>flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.10.5, on Microsoft Windows [Version 10.0.22621.1992], locale ja-JP)
[✓] Windows Version (Installed version of Windows is version 10 or higher)
[✓] Android toolchain - develop for Android devices (Android SDK version 33.0.2)
[✓] Chrome - develop for the web
[!] Visual Studio - develop for Windows (Visual Studio Build Tools 2022 17.1.3)
    ✗ Visual Studio is missing necessary components. Please re-run the Visual Studio installer for the "Desktop
      development with C++" workload, and include these components:
        MSVC v142 - VS 2019 C++ x64/x86 build tools
         - If there are multiple build tool versions available, install the latest
        C++ CMake tools for Windows
        Windows 10 SDK
[✓] Android Studio (version 2022.2)
[✓] VS Code (version 1.77.0)
[✓] Connected device (3 available)
[✓] Network resources

! Doctor found issues in 1 category.
  • 上記の例ではVisual Studioで警告が出ていたものの、私はFlutterでWindowsのデスクトップアプリ開発をしないためそのまま放置しています

flutter channel

現在使用しているFlutterSDKのチャンネルを表示／設定

  • master
    • 開発中のマスターリポジトリ
    • あまり使用しない
  • dev
    • masterに対して自動テスト等をパスして一定の品質が保たれているもの
    • アルファ版に相当する
  • beta
    • ベータ版機能が有効になったもの
  • stable
    • 安定板、通常はこちらを使用

channelの後にチャンネル名を指定するとFlutterSDKを切り替えられる

C:\Users\xxx>flutter channel beta

切り替えた後にいったんflutter upgradeしたほうがいいかも

flutter upgrade

利用中のFlutterSDKチャンネルについて、新バージョンにアップグレード

C:\Users\xxx>flutter upgrade

チャンネルが安定版だとしてもアップグレードすると「今まで動いていたのに動かなくなった」という事象も起きるので慎重に実行しましょう。

flutter downgrade

利用中のFlutterSDKチャンネルについて、指定バージョンにダウングレード

C:\Users\xxx>flutter downgrade 3.0.1

flutter clean

ビルド時に生成される/build、/.dart_toolディレクトリ等を削除する

C:\Users\xxx\app>flutter clearn

flutter pub get

pubspec.yamlで指定されたパッケージのライブラリ取得／更新

C:\Users\xxx\app>flutter pub get

flutter pub upgrade

パッケージのアップグレード

C:\Users\xxx\app>flutter pub upgrade

特定のパッケージだけ指定したい場合は以下のように実行

C:\Users\xxx\app>flutter pub upgrade package_name

メジャーバージョンにアップグレードしたい場合は以下のように実行

C:\Users\xxx\app>flutter pub upgrade --major-versions

flutter pub outdated

パッケージの最新バージョンを確認

C:\Users\xxx\app>flutter pub outdated
Showing outdated packages.
[*] indicates versions that are not the latest available.

Package Name            Current   Upgradable  Resolvable  Latest

direct dependencies:
archive                 *3.3.6    3.3.7       3.3.7       3.3.7
build_runner            *2.4.0    2.4.6       2.4.6       2.4.6
:
yaml                    *3.1.1    3.1.2       3.1.2       3.1.2

dev_dependencies:
flutter_launcher_icons  *0.11.0   *0.11.0     0.13.1      0.13.1
:
test                    *1.24.1   *1.24.1     *1.24.1     1.24.4

20 upgradable dependencies are locked (in pubspec.lock) to older versions.
To update these dependencies, use `flutter pub upgrade`.

10  dependencies are constrained to versions that are older than a resolvable version.
To update these dependencies, edit pubspec.yaml, or run `flutter pub upgrade --major-versions`.

flutter build

以下はターゲットをappbundleに指定しproductionフレーバーでリリースビルドを行う例

C:\Users\xxx\app>flutter build appbundle --release --flavor production

PCに接続されている端末にインストールするなら、apkでビルド→アンインストール→インストールで可能

C:\Users\xxx\app>flutter build apk --release --flavor production
C:\Users\xxx\app>adb.exe uninstall application_id
C:\Users\xxx\app>adb.exe install C:\Users\xxx\app\build\app\outputs\flutter-apk\xxx.apk
  • 端末が1台のみ接続されている前提
  • application_idはアプリのID、/android/app/build.gradleのapplicationId

flutter test

ユニットテスト実行