Documentation
Getting Started
FAQ

FAQ

Upgrade Flutter Channel

As described in our Principles, FVM does not override standard Flutter behavior. Therefore, to upgrade a channel, you will have to use the standard flutter upgrade. You can find more about it in the Running Flutter section.

flutter and dart commands not found

If fvm flutter or fvm dart commands are not working:

  1. Make sure FVM is properly installed and in your PATH
  2. Ensure you have a Flutter version configured in your project (fvm use <version>)
  3. Check that the .fvm directory exists in your project

How does FVM find the Flutter version to use?

FVM searches for the Flutter SDK in this order:

  1. Project .fvmrc file
  2. Ancestor directory .fvmrc files
  3. Global version (set with fvm global)
  4. System PATH Flutter installation

Cannot install the latest version of FVM

When running dart pub global activate fvm, pub will grab the latest FVM version that is compatible with the installed dart-sdk. Upgrade to the latest version of Dart, and run the command again. Go to get dart (opens in a new tab) for more information.

How to uninstall FVM

Install script (macOS/Linux):

./install.sh --uninstall

Homebrew:

brew uninstall fvm
brew untap leoafarias/fvm

Pub:

dart pub global deactivate fvm

Chocolatey (Windows):

choco uninstall fvm

Remove cached Flutter versions (optional):

fvm destroy

Commands run twice on Windows

This happens due to a pub issue dart-lang:2934 (opens in a new tab). To avoid this issue from happening, make sure your PATH is in the following order. Please read the following.

Invalid kernel binary or invalid SDK hash when running FVM

There are a few reasons this can happen. However, it means that the FVM snapshot is not compatible with the Dart version that is installed.

Please do the following:

  1. On Windows, make sure your environment variables are in the following order as described here.
  2. Run dart pub global deactivate fvm.
  3. Run dart pub global activate fvm.

Command 'pub' not found

If you get Command 'pub' not found, then make sure to append export PATH="$PATH:/usr/lib/dart/bin" to your ~/.bashrc (gets reinitiated each time you open a bash shell) or ~/.profile (only read at login) file.

Environment variables order for Windows in PATH

Flutter comes with Dart embedded. Because of that, you can find some conflicts when running standalone Dart and Flutter together. Here is a suggestion of what we found to be the correct order of dependencies to avoid issues.

  1. Pub Cache for global packages
  2. Dart SDK (if installed outside of Flutter)
  3. Flutter SDK

It should look like this:

C:\Users\<user>\AppData\Roaming\Pub\Cache\bin
C:\src\flutter\bin\cache\dart-sdk\bin
C:\src\flutter\bin

Git not found after install on Windows

Some users may be greeted by this error after installing FVM in a project.

Error: Unable to find git in your PATH.

This happens because of a security update from Git where Git now checks for ownership of the folder, trying to ensure that the folder you are using Git in has the same user as the owner as your current user account. To fix this, we need to mark our repos as safe using the following command:

git config --global --add safe.directory '*'

Restart your terminals and VS Code after running this command. This should fix the issue.

If you don’t want to mark all the repos as safe, then you can mark only the Flutter repo as safe by passing the Flutter path instead of *:

git config --global --add safe.directory C:\Users\someUser\flutter\.git\
ConfigurationBasic Commands