Documentation
Guides
Global Configuration

Overview

You can have the default Flutter version on your machine and still preserve dynamic switching. This allows you to make no changes to how you currently use Flutter, but benefit from faster switching and version caching.

⚠️

It is recommended that you install FVM as a standalone executable instead of through pub.dev to avoid dependency conflicts.

If you are configuring a global version, FVM will check if the global version is set in your environment path. If it is not, it will provide you with the path that needs to be configured.

Link global version

To accomplish this, FVM provides you with a helper command to configure a global version.

fvm global {version}

FVM creates a default link inside the configured cache:

  • macOS/Linux default: $HOME/fvm/default
  • Windows default: C:\Users\<user>\fvm\default
  • Custom cache: <FVM_CACHE_PATH>/default

Add the link's bin directory before other Flutter installations on PATH. If you use Android Studio or IntelliJ, also follow the IDE configuration guide; FVM does not change the IDE's SDK setting.

Now you will be able to do the following.

Example

After you run the command, FVM will check if the global version is configured in your environment path. If it is not, it will provide you with the path that needs to be configured.

⚠️

Android Studio and IntelliJ can resolve the default link to a specific cached version. After changing the global version, verify the version shown in the IDE and reselect the FVM path if necessary.