Flutter3 环境搭建

Windows

弃用 Windows 7/8 进行开发

在此版本中，我们将推荐的用于开发的 Windows 版本提升到 Windows 10。虽然我们不会阻止在旧版本（Windows 7、Windows 8、Windows 8.1）上进行开发，但 Microsoft 不再支持这些版本，我们提供 对这些版本的有限测试。 虽然我们将继续为旧版本提供“尽力而为”的支持，但我们鼓励您升级。

注意：我们继续为在 Windows 7 和 Windows 8 上运行的 Flutter 应用程序提供支持； 此更改仅影响推荐的开发环境。

安装Flutter SDK

1. 下载SDK

2. 解压到安装目录 例如D:\flutter

3. 添加环境变量

   1. 打开系统设置->关于->高级系统设置->环境变量->系统变量
   2. 找到Path->编辑->新建->复制Flutter/bin目录 如上D:\flutter\bin
   3. 保存

4. 终端运行flutter doctor

---

配置代理

1. 打开系统设置->关于->高级系统设置->环境变量->用户变量
2. 新增
   • 变量名FLUTTER_STORAGE_BASE_URL
   • 变量值https://storage.flutter-io.cn
   • 变量名PUB_HOSTED_URL
   • 变量值https://pub.flutter-io.cn
3. 保存

---

安装FVM（可选）

1. 终端运行dart pub global activate fvm安装FVM

   安装后如果终端提示

   Warning: Pub installs executables into C:\Users\Administrator\AppData\Local\Pub\Cache\bin, which is not on your path. 按提示把C:\Users\Administrator\AppData\Local\Pub\Cache\bin路径添加到环境变量中

2. 配置环境变量

   打开系统设置->关于->高级系统设置->环境变量->系统变量->编辑

   1. 删除flutter/bin目录 如上D:\flutter\bin
   2. 添加fvm/bin目录C:\Users\Administrator\fvm\default\bin
   3. 保存

3. 安装版本测试

   // terminal
   fvm install 3.0.1
   fvm global 3.0.1
   flutter doctor
   

MacOS

安装Flutter SDK

1. 下载SDK

2. 解压到安装目录 例如~/Documents/flutter

3. 添加环境变量

   // terminal
   open ~/.zshrc
   
   // .zshrc 编辑后记得保存
   export PATH=~/Documents/flutter/bin:$PATH // 添加Flutter/bin目录 如上
   
   // terminal
   source ~/.zshrc
   flutter doctor
   

---

配置代理

// terminal
open ~/.zshrc

// .zshrc 编辑后记得保存
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

// terminal
source ~/.zshrc
flutter doctor

---

安装FVM（可选）

1. 终端运行dart pub global activate fvm安装FVM

   安装后如果终端提示

   Warning: Pub installs executables into $HOME/.pub-cache/bin, which is not on your path. 按提示把`export PATH="$PATH":"$HOME/.pub-cache/bin"`路径添加到环境变量中

2. 配置环境变量

   // terminal 
   open ~/.zshrc
   
   // .zshrc
   // 用fvm/bin目录替换flutter/bin目录 例如
   export PATH=/Users/[你电脑的用户名]/fvm/default/bin:$PATH
   
   // terminal
   source ~/.zshrc
   

3. 安装版本测试

   // terminal
   fvm install 3.0.1
   fvm global 3.0.1
   flutter doctor
   

---

平台开发环境配置

Web

1. 安装Edge或者Chrome浏览器

2. 运行flutter doctor

Android

1. 下载并安装Android Studio
2. 安装 Android SDK Command-line Tools

3. // terminal
   flutter doctor --android-licenses
   flutter doctor
   

Windows (desktop)

1. 下载Visual Studio 安装包并运行

2. 选中使用C++的桌面开发

3. 安装后重新运行flutter doctor

已知可能会出现的问题

Exception: Bad UTF-8 encoding (U+FFFD; REPLACEMENT CHARACTER) found while decoding string:

• 下载vswhere.exe

• 替换文件C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe