前言

手机 APP 的开发最容易劝退的就是搭环境的这一步，其实我一直想搞手机 APP 的开发，但是每次想到搭环境这么麻烦就望而生畏，所以一直拖到现在才开始搞。

其实搞着搞着发现捋顺了环境搭建的思路其实也并没有那么难，官方的文档写得还是挺好的，这篇文章只是对官方文档的一个补充或者叫注脚吧。

首先明确环境要求：

• 开发 Flutter Android 应用 Windows 和 MacOS 都是可以的
• 开发 Flutter IOS 应用只能使用 MacOS，因为 IOS 应用的构建需要 Xcode，而 Xcode 只能在 MacOS 上运行

Windows 开发 Android 应用环境搭建

Step1 软件安装

• Git for Windows 2.27 或更高的版本来管理源代码。
• Android Studio 2023.1 (Hedgehog) 调试和编译 Android 的 Java 或 Kotlin 代码。 Flutter 需要完整版本的 Android Studio，方便我们管理 Android SDK、手机模拟器等。如果前面的地址无法打开也可以尝试一下去这里下载 Android Studio。

如果使用 Android Studio 开发那就不需要安装其它软件了，再装两个插件（File -> Settings -> Plugins）即可，插件名称分别是 Dart 和 Flutter。

如果使用 VS Code 开发，那就安装一下 VS Code，然后再安装两个插件，插件名称分别是 Dart 和 Flutter，另外还可以安装 Flutter Widget Snippets 方便开发 Widget。

也可以使用 IntelliJ IDEA 进行开发，不过个人比较习惯使用 VS Code 开发。

Step2 Flutter 镜像配置

国内进行 Flutter 安装和开发之前最好是配置一下国内的镜像源，可以让后面的安装和下载更加丝滑。

配置环境变量：

• PUB_HOSTED_URL：https://pub.flutter-io.cn
• FLUTTER_STORAGE_BASE_URL：https://storage.flutter-io.cn

flutter pub get 会在任何设置了 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 的终端中去获取 flutter-io.cn 上的 package。

Step3 安装 Flutter SDK

这个官方文档讲得很清晰，采用 VS Code 安装和下载 Flutter SDK 包安装两种方式都讲了，直接跟着官方文档一步一步配置即可。

Step4 安装 Android toolchain

Android toolchain（工具链）需要用到 Android Studio。

需要安装的组件有下面这些（配置位置 File -> Settings -> Languages & Frameworks -> Android SDK）：

• Android SDK Platform（SDK Platforms 页签，然后选择对应的 Android版本，例如 Android 14.0，API Level 34，点击“Show Package Details”，可以看到 Android SDK Platform 34 等）
• Android SDK Command-line Tools（SDK Tools 页签，找到 Android SDK Command-line Tools，点击“Show Package Details”，可以看到 Android SDK Command-line Tools Version 13.0、12.0 等）
• Android SDK Build-Tools（SDK Tools 页签，找到 Android SDK Build-Tools xx.x.x，点击“Show Package Details”，可以看到 Version 34.0.0、33.0.0 等）
• Android SDK Platform-Tools（SDK Tools 页签，找到 Android SDK Platform-Tools，可以看到例如 Version 35.0.0 这样的版本号）
• Android Emulator（SDK Tools 页签，找到 Android Emulator，可以看到例如 Version 33.1.24 这样的版本号）

Step5 安装 Android 设备

安装 Android 设备主要是为了进行 APP 的调试和运行，设备有两种，一种是虚拟设备，也就是模拟器，另一种是真机调试。

安装教程还是直接查看官方文档即可，讲得很详细了。

Step6 Java环境配置

在运行 Android 项目的时候如果 Java 版本试用得不合适很可能会导致项目编译错误，无法运行。

项目需要用的 Java 版本与 Android 的构建工具 Gradle 的版本有关。如果环境的 Java 版本过低就需要升级 Java 版本。

一个比较简单的配置办法是打开 Android Studio -> File -> Project Structure -> Platform Settings -> SDKs，点“+”可以 Download JDK。

下载好之后可以在 File -> Project Structure -> Project Settings -> Project -> SDK 配置某个项目的 JDK。

另外，环境变量 JAVA_HOME 也可以配置为新下载的 JDK 的存放位置。

重启 Android Studio 或者 重启电脑之后生效。

Step7 检查开发配置

flutter doctor -v

然后就是有问题解决问题了，基本上按照错误描述就可以解决大多数问题，解决完问题项目大概率就可以运行了。

MacOS 开发 IOS 应用环境搭建

Step1 设置 shell

官方文档推荐使用 zsh 作为默认 shell 来进行 Flutter 的环境配置，如果确认自己的环境就是 zsh，那么可以跳过这一步。

否则请跟随下面步骤切换。

查看当前 shell 环境：

echo $SHELL
# 或
dscl . -read ~/ UserShell

切换：

# M 系列芯片
chsh -s `which zsh`

# intel 芯片
chsh -s /usr/local/bin/zsh

重启终端。

Step2 软件安装

安装 Xcode。

安装 brew。

安装 CocoaPods：

brew install cocoapods

pod setup

如果使用 VS Code 开发，那就安装一下 VS Code，然后再安装两个插件，插件名称分别是 Dart 和 Flutter，另外还可以安装 Flutter Widget Snippets 方便开发 Widget。

Step3 Flutter 镜像配置

国内进行 Flutter 安装和开发之前最好是配置一下国内的镜像源，可以让后面的安装和下载更加丝滑。

flutter pub get 会在任何设置了 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 的终端中去获取 flutter-io.cn 上的 package。

vim ~/.zprofile

cat <<EOT >> ~/.zprofile
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
export PATH="$PWD/flutter/bin:$PATH"
EOT

Step4 安装 Flutter SDK

这个官方文档讲得很清晰，采用 VS Code 安装和下载 Flutter SDK 包安装两种方式都讲了，直接跟着官方文档一步一步配置即可。

Step5 安装 IOS 设备

安装 IOS 设备主要是为了进行 APP 的调试和运行，设备有两种，一种是虚拟设备，也就是模拟器，另一种是真机调试。

安装教程还是直接查看官方文档即可，讲得很详细了。

Step6 检查开发配置

flutter doctor -v

然后就是有问题解决问题了，基本上按照错误描述就可以解决大多数问题，解决完问题项目大概率就可以运行了。

参考资料

• 开始在 Windows 上构建 Flutter Android 应用
• Start building Flutter iOS apps on macOS