`fvm`

Flutter Version Management: A simple cli to manage Flutter SDK versions.

Features:

Configure Flutter SDK version per project or globally
Ability to install and cache multiple Flutter SDK Versions
Easily switch between Flutter channels & versions

Version Management

This tool allows you to manage multiple channels and releases, and caches these versions locally, so you don't have to wait for a full setup every time you want to switch versions.

Also, it allows you to grab versions by a specific release, i.e. 1.2.0. In case you have projects in different Flutter SDK versions and do not want to upgrade.

Usage

To Install fvm:

brew tap befovy/taps
brew install fvm

Or install fvm through go get

> go get -u -v github.com/befovy/fvm

The command above will install binary executable fvm file to $GOPATH/bin.
Add $GOPATH/bin to your system PATH, or move the binary fvm file to an existing PATH directory.

And then, for information on each command:

> fvm help

FVM_HOME

fvm use environment variable FVM_HOME as a working path.
The installed cache and config file are all stored in this path.

If no FVM_HOME in environment variable, fvm will use the default value returned by os.UserConfigDir() append fvm.
On Mac OS, default FVM_HOME is $HOME/Library/Application Support/fvm

Install a SDK Version

FVM gives you the ability to install many Flutter releases or channels.

> fvm install <version>

Use master to install the Master channel and v1.8.0 to install the release.

Use --repo to install flutter from unoffical repo

> fvm install master --repo https://github.com/flutter/flutter.git

Import Flutter from previous installation

FVM has subcommand import which can import your previous installed flutter into fvm.

> fvm import <name>

If you have installed master channel flutter, just use fvm import master.
Or if you have installed a special derived flutter, just use any name you want to import this flutter. You can use a name from you company, or any other you want. fvm import xianyu

Use a SDK Version

You can use the installed Flutter SDK versions for your computer user account globally. To do that just:

> fvm use <version>

Also, you can use different Flutter SDK versions per project. To do that you have to go into the root of the project and:

> fvm use <version> --locol

Show current SDK info

Get current active Flutter sdk version, link path and actually path

> fvm current

Remove a SDK Version

Using the remove command will uninstall the SDK version locally. This will impact any projects that depend on that version of the SDK.

> fvm remove <version>

List Installed Versions

List all the versions that are installed on your machine.

> fvm list

Running Flutter SDK

Call Global SDK

After add fvm global path to your system environment variable, flutter command is usable every where.

Your will get tip when you run fvm use <version> firstly.

Proxy Commands

Flutter command within fvm proxies all calls to the CLI just changing the SDK to be the local one.

> fvm flutter run

This will run flutter run command using the local project SDK. If no FVM config is found in the project. FMV will recursively try for a version in a parent directory.

If FVM config is still not found, this will run flutter run command using the global Flutter SDK.

Call Local SDK Directly

FVM creates a symbolic link within your project called .fvm/current which links to the installed version of the SDK.

Add $(pwd)/.fvm/current/bin to your PATH, or

> .fvm/current/bin/flutter run

This will run flutter run command using the local project SDK.

As an example calling fvm flutter run is the equivalent of calling flutter run using the local project SDK.

License

This project is licensed under the Apache License 2.0 License - see the LICENSE file for details

befovy / fvm