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:
- Make sure FVM is properly installed and in your PATH
- Ensure you have a Flutter version configured in your project (
fvm use <version>
) - 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:
- Project
.fvmrc
file - Ancestor directory
.fvmrc
files - Global version (set with
fvm global
) - 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:
- On Windows, make sure your environment variables are in the following order as described here.
- Run
dart pub global deactivate fvm
. - 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.
- Pub Cache for global packages
- Dart SDK (if installed outside of Flutter)
- 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\