2024年10月版 Windows11にFVM+Flutterの開発環境を構築する

Last updated at 2024-11-14Posted at 2024-10-23

はじめに

Windows11にFlutterの開発環境を構築する手順の備忘録です。

Visual Studio 2022 Community 版をインストールします。インストーラーでは「C++によるデスクトップ開発」を選択してインストールします。

git for windowsからインストーラーをダウンロードしてインストールします。バージョンは 2.46 以上であることを確認してください（2.46以上でないと、後述の safe.directory の設定が簡単にできません）。

インストールオプションは特にデフォルトから変更しません。

Chocolateyがインストールされていない場合は、公式サイトの「Install Chocoletey for Individual Use」に従って、Chocolateyをインストールします。管理者Terminalでインストールする必要があります。

Flutter SDKのバージョン管理マネージャ、FVMをインストールします。管理者Terminalを開いて、公式サイトどおり、以下を実行します。

choco install fvm

パッケージが見つからない、または壊れているという趣旨のエラーが出てインストールに失敗した場合は、以下のように --pre オプションを付けて実行してください。

choco install --pre fvm

管理者Terminalで、fvmコマンドを使ってFlutter SDKをインストールします。

fvm install 3.24.4

FVMがFlutter SDKをインストールするディレクトリをgitに信頼させる必要があります。

git for windows をインストールした際に付属でインストールされたターミナル（Git Bash または Git CMD)を起動して、以下のコマンドを実行します。xxxxxx の部分はご自身のユーザーディレクトリ名で読み替えてください。

git config set --global --append safe.directory 'C:\Users\xxxxxx\fvm\*'

設定したら一度ターミナルを終了させます。

Flutter SDKが正しくインストールされたか確認します。Terminalを開いて以下を実行します。

fvm flutter doctor

上記で表示される Flutter SDK のバージョンが期待どおりえ、かつAndroid関係以外のエラーが出ていなければ、セットアップは問題なく完了です。

ここまでの設定では、flutterコマンドの実行はfvm flutterのようにfvmコマンドを経由する必要があります。

flutterコマンドのみ入力して実行できるようにしたい場合は、Windows の環境設定で、%USERPROFILE%\fvm\default\bin にパスを通します。

パスを通しておくと、flutter コマンド単体で入力した場合でも、fvm global や fvm use の指定を反映したバージョンの flutter が起動します。

一般権限の Terminal を開いて適当な作業ディレクトリに移動し、以下のコマンドを入力します。

fvm flutter create --platforms=windows test_project
cd test_project
fvm flutter run -d windows

以上で Windows 用のFlutterのサンプルアプリがビルドされ、起動します。

ここまで確認できたら、開発環境構築はおわりです。

以下の手順を行うと、Android版アプリも開発できるようになります。

前述の「gitの設定を調整」が正しく行われていればエラーが発生しないはずです。

しかし、上記の設定をしても、fvm flutterコマンドがエラーで動かない場合は、FVMのインストール先ディレクトリが標準と異なっているのかもしれません。

fvm api context

を実行すると表示される JSON の下の方に fvmDir という項目があるので、それでFVMのルートディレクトリを確認してください。そして、FVMのルートディレクトリの後に '*' を付けたものを safe.directory に指定して、以下のコマンドを実行してください。

git config set --global --append safe.directory '<FVMのルートディレクトリ>\*'```