🔄

FVM 3.0.0を使ってみた（Flutter Version Management）

村松龍之介

2023/12/22に公開

こんにちは、Flutterでのアプリ開発をメインとしている「Altive株式会社」の村松龍之介（@riscait）です！

2年前に「FVMでFlutter SDKのバージョンをプロジェクト毎に管理する」という記事を書きました。（もうそんな経ったの…⁉️）

それからずっとFVMを使っていますが、v3.0.0-beta (Pre-release)がリリースされているので使ってみました！

FVMとは

ご存知の方も多いとは思いますが、FVMは、Flutter SDKのバージョン管理ツールです。

複数のFlutter SDKをインストールし、プロジェクトごとにバージョンを容易に切り替えることができます。

何らかの理由で最新ではないバージョンや、逆に安定版ではないBetaバージョンを使用したい場合にも便利です。

FVM 3.0 で変わること

リリースノートで確認でき、気になる項目をざっくりリストアップしました。

追加機能

VS Codeとの統合が強化され、Flutter SDKバージョンを自動的に設定し、ターミナルパスを更新する機能が追加。
これにより、flutterコマンドを直接使用できるようになります
Git Flutterリポジトリのミラーリングにより、新しいSDKバージョンのクローンが速くなります
.gitignoreの自動追加: .fvm ディレクトリがチェックされて自動で追記されます
Flutter SDKのキャッシュ検証: キャッシュされたFlutter SDKがアップグレードされたかを検証し、修正アクションのオプションを提供されます
Flutter SDKの互換性チェック: 現在のプロジェクトとの互換性を確認する機能が追加

改善点

エラーメッセージ、ログ、ヘルプ情報の改善
fvm flutterコマンドの出力がカラー化
fvm doctorコマンドの改善。
fvm releasesおよびfvm list出力の改善
fvm globalコマンドのエラーチェックの改善

変更点

fvm releases コマンドはデフォルトで安定版のみ表示されるように。全てのリリースを見るには --all フラグを使用。
flavor コマンドが削除され、 fvm use {flavor} に変更
destroy コマンドが削除され、 fvm remove --all に変更
設定ファイルを fvm_config.json から .fvmrc に変更
これにより、 .fvm を .gitignore に追加可能に。FVMが自動的に移行します。
fvm use {version} --env {flavor} をflavorのエイリアスとして使用可能に
Flutterリポジトリコミットハッシュを使用する際、ハッシュは10桁必要に。FVMが検証し、正しいハッシュが提供されます
fvm install はデフォルトでセットアップを行わなくなりました。 --setup フラグでセットアップも同時に行われるようになります
fvm use はデフォルトでセットアップを行います。 --skip-setup フラグでスキップ可能
環境変数 FVM_HOME が FVM_CACHE_PATH に、 FVM_GIT_CACHE は FVM_FLUTTER_URL に変更されました

FVM 3 のインストール

Homebrew, Chocolatey, GitHub Releasesなどからインストールできます。

# Homebrewの場合
brew tap leoafarias/fvm
brew install fvm
fvm --version

fvm doctor

fvm doctor コマンドを実行し、環境が正しく設定されているか確認します。

fvm doctorの出力結果（長いので折りたたみ）

弊社の yourrank と言うアプリのプロジェクトで実行した結果です。

FVM Doctor:                                                                                                                                    
-----------------------------------------------------------------------------------------------------------------------------------------------
Project:
┌─────────────────────────────┬─────────────────────────────────────────────┐
│ Project                     │ yourrank                                    │
├─────────────────────────────┼─────────────────────────────────────────────┤
│ Directory                   │ /Users/riscait/Repositories/altive/yourrank │
├─────────────────────────────┼─────────────────────────────────────────────┤
│ Active Flavor               │ None                                        │
├─────────────────────────────┼─────────────────────────────────────────────┤
│ Is Flutter Project          │ No                                          │
├─────────────────────────────┼─────────────────────────────────────────────┤
│ Dart Tool Generator Version │ Not available                               │
├─────────────────────────────┼─────────────────────────────────────────────┤
│ Dart tool version           │ Not available                               │
├─────────────────────────────┼─────────────────────────────────────────────┤
│ .gitignore Present          │ Yes                                         │
├─────────────────────────────┼─────────────────────────────────────────────┤
│ Config Present              │ Yes                                         │
├─────────────────────────────┼─────────────────────────────────────────────┤
│ Pinned Version              │ 3.19.1                                      │
├─────────────────────────────┼─────────────────────────────────────────────┤
│ Config path                 │ .fvmrc                                      │
├─────────────────────────────┼─────────────────────────────────────────────┤
│ Local cache dir             │ .fvm/versions                               │
├─────────────────────────────┼─────────────────────────────────────────────┤
│ Version symlink             │ .fvm/versions/3.19.1                        │
└─────────────────────────────┴─────────────────────────────────────────────┘


IDEs:
┌─────────────────────────┬─────────────────────────────────────────────────────┐
│ IDEs                    │ Value                                               │
├─────────────────────────┼─────────────────────────────────────────────────────┤
│ VSCode                  │                                                     │
├─────────────────────────┼─────────────────────────────────────────────────────┤
│ dart.flutterSdkPath     │ .fvm/flutter_sdk                                    │
├─────────────────────────┼─────────────────────────────────────────────────────┤
│ Matches pinned version: │ false                                               │
├─────────────────────────┼─────────────────────────────────────────────────────┤
│ Android Studio          │                                                     │
├─────────────────────────┼─────────────────────────────────────────────────────┤
│ Android Studio          │ No local.properties file found in android directory │
└─────────────────────────┴─────────────────────────────────────────────────────┘

Environment:
┌───────────────────────┬────────────────────────────────────────────────┐
│ Environment Variables │ Value                                          │
├───────────────────────┼────────────────────────────────────────────────┤
│ Flutter PATH          │ /Users/riscait/fvm/versions/3.19.1/bin/flutter │
├───────────────────────┼────────────────────────────────────────────────┤
│ Dart PATH             │ /Users/riscait/fvm/versions/3.19.1/bin/dart    │
├───────────────────────┼────────────────────────────────────────────────┤
│ FVM_CACHE_PATH        │ N/A                                            │
├───────────────────────┼────────────────────────────────────────────────┤
│ FVM_GIT_CACHE         │ N/A                                            │
├───────────────────────┼────────────────────────────────────────────────┤
│ FVM_GIT_CACHE_PATH    │ N/A                                            │
├───────────────────────┼────────────────────────────────────────────────┤
│ FVM_FLUTTER_URL       │ N/A                                            │
├───────────────────────┼────────────────────────────────────────────────┤
│ Flutter PATH          │ /Users/riscait/fvm/versions/3.19.1/bin/flutter │
├───────────────────────┼────────────────────────────────────────────────┤
│ Dart PATH             │ /Users/riscait/fvm/versions/3.19.1/bin/dart    │
└───────────────────────┴────────────────────────────────────────────────┘
┌──────────────┬──────────────────────────────────────────────────────────────────┐
│ Platform     │ Value                                                            │
├──────────────┼──────────────────────────────────────────────────────────────────┤
│ OS           │ macos Version 14.1.2 (Build 23B92)                               │
├──────────────┼──────────────────────────────────────────────────────────────────┤
│ Dart Locale  │ en-JP                                                            │
├──────────────┼──────────────────────────────────────────────────────────────────┤
│ Dart runtime │ 3.3.0 (stable) (Tue Sep 26 14:25:13 2023 +0000) on "macos_arm64" │
└──────────────┴──────────────────────────────────────────────────────────────────┘

fvm doctor を実行すると、 fvm_config.json が削除され、 .fvmrc が自動作成されました。

// ↓ 削除：fvm_config.json
{
  "flutterSdkVersion": "3.19.1",
  "flavors": {}
}

// ↓ 生成：.fvmrc
{
  "flutter": "3.19.1"
}

`fvm use` でFlutter SDKのバージョンを指定する

fvm use 3.19.1

v2では、モノレポや、 flutter create 前など、実行したい場所がFlutterプロジェクトではない場合は、
--forceをつける必要がありましたが、v3ではつけなくても、プロンプトで尋ねてくれるようになりました。

This does not seem to be a Flutter project directory
✔ Would you like to continue?

--force は、引き続き使用できるので、プロンプトを省略したい場合は指定しましょう。

`.gitignore` が自動で修正される

ここで、 .gitignore に .fvm/ を追加するか尋ねられました。

You should add the fvm version directory ".fvm/" to .gitignore?
✔ Would you like to do that now? · yes                                                                                                         
✓ Added .fvm/ to .gitignore

# FVM Version Cache
.fvm

以前は .fvm/flutter_sdk を指定していたと思いますが、v3では .fvm でOKです。

`settings.json` の `dart.flutterSdkPath` が自動で修正される

This does not seem to be a Flutter project directory
✔ Would you like to continue? · yes                                                                                                            
✗ Could not resolve dependencies. (0.7s)

Expected to find project root in current working directory.

The error could indicate incompatible dependencies to the SDK.
✔ Would you like to continue pinning this version anyway? · yes                                                                                
✓ Project now uses Flutter SDK : SDK Version : 3.19.1
┌────────────────────────────────────────────────────────────────────┐
│ ✓ Running on VsCode, please restart the terminal to apply changes. │
└────────────────────────────────────────────────────────────────────┘
You can then use "flutter" command within the VsCode terminal.

  // Before
  "dart.flutterSdkPath": ".fvm/flutter_sdk"
  // After
  "dart.flutterSdkPath": ".fvm/versions/3.19.1"

ちなみに .fvm ディレクトリは下記のような構成になっていました👀

-.fvm
  - versions
    - 3.19.1
  - release
  - version

これで無事に Flutter SDKバージョンを指定することができました！
出力された通り、VS CodeのTerminalを再起動すると、 flutter コマンドで指定したSDKバージョンが使用できるようになります🙌

`fvm install` でプロジェクトで指定されているFlutter SDKをインストールする

fvm use を実行していないチームメンバーや、新しく入ったプロジェクトでは、従来通り fvm install を実行して指定のSDKをインストールしましょう👌

fvm install --setup

--setup を付けると、Flutter SDKのビルドも行ってくれます。

FVMでFlutter SDKを指定して `flutter create` する方法

Flutter SDKバージョンを指定した上での新しいFlutterプロジェクトの作成方法は、v2と同じです。

以下のように、プロジェクト用のディレクトリを作成し、 fvm use {version} --force でFlutter SDKを指定してから、 flutter create コマンドを実行します。

mkdir fvm_sample_app
cd fvm_sample_app/
fvm use 3.19.1 --force
fvm flutter create .

ディレクトリをVS Codeで開いて、VS CodeのTerminalで実行すれば fvm をつけなくても flutter clean を使えそうです。

`fvm global` でどこでも `flutter` コマンドを使う

v3にも、v2と同じく fvm global コマンドがあります。

Flutter公式サイトからSDKをダウンロードしていない場合、 .fvmrc のないプロジェクトやそれ以外のディレクトリでは flutter コマンドが使えません。

fvm global {version} コマンドを実行することで、任意のディレクトリで flutter コマンドを使用できるようになります。

PATHを通す必要があります。

.zshrc

# FVM global
export PATH="$PATH:$HOME/fvm/default/bin"

global設定を解除したい場合は、 fvm global --unlink が使用できます。
3.0.8で追加されました👍

Melosとの相性は問題なさそう

弊社では、モノレポ管理ツールの Melos を使用しています。

Melosへの影響を調べました。

FVM v2では、設定ファイル melos.yaml で、以下のようにFVMのFlutter SDKパスを指定していました。

name: yourrank
repository: https://github.com/altive/yourrank
sdkPath: .fvm/flutter_sdk

ところが FVM v3では、SDKの配置場所が .fvm/flutter_sdk ではなくなったので、 sdkPath の指定を変更する必要がありますね。

試しに、 sdkPath を削除（未指定）にして、 Melos経由でFlutter SDKのバージョンを確認してみました。

% melos exec -- "flutter --version"
$ melos exec
  └> flutter --version
     └> RUNNING (in 2 packages)

-----------------------------------------------------------------------------------------------------------------------------------------------
[yourrank_api_client]: Waiting for another flutter command to release the startup lock...

[yourrank]: Flutter 3.19.1 • channel stable • https://github.com/flutter/flutter.git
[yourrank]: Framework • revision 78666c8dc5 (2 days ago) • 2023-12-19 16:14:14 -0800
[yourrank]: Engine • revision 3f3e560236
[yourrank]: Tools • Dart 3.3.0 • DevTools 2.28.4
[yourrank_api_client]: Flutter 3.19.1 • channel stable • https://github.com/flutter/flutter.git
[yourrank_api_client]: Framework • revision 78666c8dc5 (2 days ago) • 2023-12-19 16:14:14 -0800
[yourrank_api_client]: Engine • revision 3f3e560236
[yourrank_api_client]: Tools • Dart 3.3.0 • DevTools 2.28.4
-----------------------------------------------------------------------------------------------------------------------------------------------

問題なく、 FVMで指定したFlutter SDKのバージョンが使用されています🙌

Melosとの併用も問題なさそうです👌

v2とv3の共存

以下に注意することで、v2とv3を共存させることは可能です。

.fvmrc をコミットする
fvm_config.json を削除しない
fvm_config.json は .gitignore されないようにする

# FVM Version Cache
.fvm
!.fvm/fvm_config.json

settings.json をGit管理にしない。または、 dart.flutterSdkPath だけはローカルの差分として保持する
melos.yaml で sdkPath: .fvm/flutter_sdk を指定しない

最後の settings.json と melos.yaml がちょっと面倒ですね…🤔

settings.json お勧め設定

VS Codeの settings.json に以下を追記することで、検索時に .fvm ディレクトリ以下を除外することができます。
これがないと検索時にノイズが多くなるので追加することをお勧めします。

  "search.exclude": {
    "**/*.freezed.dart": true,
    "**/*.g.dart": true,
    "**/.dart_tool": true,
    "**/.fvm": true // <- 追記
  },

おわりに

FVM 3.0.0はまだベータ版ですが、v2からの改善点が多く、使いやすくなっていると感じました。
安定版のリリースが待ち遠しいです！

Xでは、主にアプリ開発について呟いております。
フォローしていただければ嬉しいです☺️ → 村松龍之介（@riscait）

宣伝

弊社社員の小林さんも、Flutter Advent Calendar 2023 の17日目の記事を投稿しています🎄

Altive株式会社では、Flutterアプリの開発・運営を承っております。
お気軽にお問い合わせください🫡
https://altive.co.jp/contact

Riverpod の実践入門本を公開中です📘

GitHubで編集を提案

AltiveエンジニアリングブログPublication

Altive株式会社のソフトウェアエンジニアメンバーによる、開発技術記事やチーム開発に関するアイデア等を投稿します。

Discussion

mono

VSCodeとVS Codeの揺れがあったので、正式略記のはずの後者に揃えるプルリクを送ろうとしつつも、fvmのログでVsCode(s小文字)の揺れがあって厄介と思って手が止まりました🐶
(文字列検索で取りこぼし無いように全て揃えた方が良いと思いつつ、fvmに合わせてスペース無しにするか、あるいはfvmの方を正すプルリクもするのが良いのか🤔)