Mac端Flutter环境配置

一、Flutter Version Management

fvm是一个用于管理多个Flutter版本的工具，帮助我们查看、切换、安装、删除Flutter版本，使每个项目工程都可以使用不同版本的Flutter，实现版本隔离、快速切换和节省空间。

1、安装Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2、配置ruby环境

2.1、安装 on-my-zsh 
sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

2.2、安装 rbenv
brew install rbenv ruby-build

3、更新gem和source源

sudo gem update --system
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
gem sources -l

4、安装fvm

brew tap leoafarias/fvm
brew install fvm

5、卸载fvm

brew uninstall fvm
brew untap leoafarias/fvm

6、查看fvm安装情况

Snip20250717_1.png
7、fvm常用命令

1、查看版本
fvm --version

2、查看所有远程Flutter版本
fvm releases

3、安装指定版本
fvm install 2.5.0

4、删除指定版本
fvm remove 2.5.0

5、查看本地已经下载的所有Flutter版本
fvm list

6、指定工程要使用的版本，会产生一个.fvm的隐藏文件在项目中，但不会影响项目的git管理
fvm use 2.5.0

7、设置fvm配置，若需要更改默认的缓存文件位置
fvm config --cache-path <CACHE_PATH>

8、代理dart的命令
fvm dart

9、显示有关环境和项目配置的信息
fvm doctor

10、设置全局版本
fvm global 2.5.0

11、代理Flutter命令，在当前项目下运行Flutter相关的命令
fvm flutter --version
fvm flutter doctor
fvm flutter clean
fvm flutter pub get
fvm flutter run

二、`Flutter`环境配置

1、准备工作
1、确定macOS系统，最好更新到最新版本
2、安装最新版本的Xcode （从AppStore搜索Xcode选择下载）
3、安装CocoaPods 运行到OS平台需要用到CocoaPods管理组件
4、安装Android Studio （以后我们就用这个IDE进行Flutter开发）
5、安装Google Chrome （Web平台开发需要用到的调试平台）
6、下载Flutter SDK 需要的版本 Flutter SDK 官方下载地址
2、环境配置
1、使用终端vim ~/.bash_profile或者在Finder直接打开bash_profile配置环境变量。

#flutter环境变量
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
export PATH=~/flutter/bin:$PATH
export FVM_DIR="$HOME/.fvm"

#android sdk目录
export ANDROID_HOME="~/Library/Android/sdk" 

#android tools目录
export PATH=${PATH}:${ANDROID_HOME}/emulator

#android tools目录
export PATH=${PATH}:${ANDROID_HOME}/tools

#android 平台工具目录
export PATH=${PATH}:${ANDROID_HOME}/platform-tools

若根目录没有.bash_profile文件就 touch .bash_profile。当环境变量配置完成后，需要进行保存source ~/.bash_profile。

3、在vim ~/.zshrc配置Flutter、dart环境变量

# fvm
export FVM_HOME="$HOME/fvm"

# flutter sdk
export PATH=${PATH}:~/fvm/default/bin:$PATH
# dart sdk
export PATH=${PATH}:~/fvm/default/bin/cache/dart-sdk/bin

# flutter 别名
alias flutter="fvm flutter"
alias dart="fvm dart"