Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/befovy/fvm
Flutter Version Manager. Flutter 多版本管理工具。 本地缓存安装多个 Flutter 版本，随时快速切换
https://github.com/befovy/fvm
flutter flutter-sdk-versions fvm golang version-manager
Last synced: 5 days ago
JSON representation
Flutter Version Manager. Flutter 多版本管理工具。 本地缓存安装多个 Flutter 版本，随时快速切换
- Host: GitHub
- URL: https://github.com/befovy/fvm
- Owner: befovy
- License: apache-2.0
- Created: 2019-12-06T05:51:12.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2021-05-15T12:41:31.000Z (over 3 years ago)
- Last Synced: 2024-05-19T12:12:49.761Z (6 months ago)
- Topics: flutter, flutter-sdk-versions, fvm, golang, version-manager
- Language: Go
- Homepage:
- Size: 88.9 KB
- Stars: 260
- Watchers: 7
- Forks: 19
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-flutter - fvm - Flutter Version Management: A simple cli to manage Flutter SDK versions. (Tools / Effect)
README
# `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:
```bash
brew tap befovy/taps
brew install fvm
```
Or install fvm through `go get`
```bash
> 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:
```bash
> 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**.
```bash
> fvm install
```
Use `master` to install the Master channel and `v1.8.0` to install the release.
Use `--repo` to install flutter from unoffical repo
```bash
> 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.
```bash
> fvm import
```
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:
```bash
> fvm use
```
Also, you can use different Flutter SDK versions per project. To do that you have to go into the root of the project and:
```bash
> fvm use --locol
```
### Show current SDK info
Get current active Flutter sdk version, link path and actually path
```bash
> 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.
```bash
> fvm remove
```
### List Installed Versions
List all the versions that are installed on your machine.
```bash
> 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 ` firstly.
#### Proxy Commands
Flutter command within `fvm` proxies all calls to the CLI just changing the SDK to be the local one.
```bash
> 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
```bash
> .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](LICENSE) file for details