在 Windows 下安装配置 Flutter 开发环境

接下来的一段时间里，我们将为大家持续推送最新的 Flutter 中文文档，这些文档由国内的 Flutter 开发者、爱好者翻译发布和共同维护。欢迎分享给身边的开发者朋友，也欢迎随时通过 Issue、PR 的方式向我们提出翻译错误，你的贡献会造福全球读中文的开发者。

Flutter 是 Google 开源的便携式 UI 工具包，帮助开发者通过一套代码库高效构建多平台精美应用，支持移动、Web、桌面和嵌入式平台。

要想入手开发，开发环境搭建是首要，本文为 Flutter 开发环境在 Windows 下安装全过程：

一、系统配置要求

要想安装和运行 Flutter，你的开发环境至少应该满足如下的需求：

• 操作系统：Windows 7 SP1 或更高的版本（64 位操作系统）。
• 磁盘空间：除安装 IDE 和一些工具之外还应有至少 400 MB 的空间。
• 工具：要让 Flutter 在你的开发环境中正常使用，依赖于以下的工具：
• Windows PowerShell 5.0 或更高版本（Windows 10 中已经预装了）
• Git for Windows 2.x，并勾选从 Windows 命令提示符使用 Git 选项。

如果 Windows 版的 Git 已经安装过了，那么请确保能从命令提示符或者 PowerShell 中直接执行 git 命令。

二、获取 Flutter SDK

1. 下载下面的安装包以获取最新稳定版本的 Flutter SDK，下载链接：

https://storage.flutter-io.cn/flutter_infra/releases/stable/windows/flutter_windows_v1.5.4-hotfix.2-stable.zip

要查看其他发行通道和以往的版本，请参阅 SDK 归档页面：

https://flutter-io.cn/docs/development/tools/sdk/releases

2. 将压缩包解压，然后把其中的 flutter 目录整个放在你预想的 Flutter SDK 安装目录中（比如 C:\src\flutter；请勿将该目录放在一些需要额外操作权限的目录，比如 C:\Program Files\）。

3. 找到 flutter 目录中的 flutter_console.bat 文件，双击执行该批处理脚本。

好的，现在你可以在控制台当中使用 Flutter 的命令了。

要升级本地已安装的 Flutter，请参阅升级 Flutter 文档：

https://flutter-io.cn/docs/development/tools/sdk/upgrading

2.1 更新 path 环境变量

如果你想要在普通的 Windows 控制台中使用 Flutter 命令，那就需要按照下面的步骤来将 Flutter 的二进制文件路径加入到 PATH 环境变量。

• 在开始菜单的搜索功能键入“env”，然后选择编辑当前用户的环境变量
• 在 用户变量 (User variables) 一栏中，检查是否有 Path 这个条目：
• 如果存在，直接把 flutter\bin 目录的完整路径以 ; 作为分隔加到已有的值后面。
• 如果不存在的话，在用户环境变量中创建一个新的 Path 变量，然后将 flutter\bin 所在的完整路径作为新变量的值。

注意，你需要关闭和重新启动已经打开的各个控制台窗口，这样下次启动控制台时才能访问到刚才修改的变量。

2.2 运行 flutter doctor

在将 Path 变量更新后，打开一个新的控制台窗口，然后将下面的命令输入进去执行。如果它提示有任何的平台相关依赖，那么你就需要按照指示完成这些配置：

C:\src\flutter>flutter doctor

上述命令会检查你的现有环境，然后把检测结果以报告形式呈现出来。仔细阅读它显示的内容，检查是否有尚未安装的软件或是有其他的步骤需要完成（通常会以粗体呈现）。

举个例子：

[-] Android toolchain - develop for Android devices
    • Android SDK at D:\Android\sdk
    ✗ Android SDK is missing command line tools; download from https://goo.gl/XxQghQ
    • Try re-installing or updating your Android SDK,
      visit https://flutter-io.cn/setup/#android-setup for detailed instructions. 

下面的章节描述了如何执行报告中提到的任务来完成整体配置。每当按照报告安装了任何的依赖项，就可以执行 flutter doctor 来检查还有什么没有完成的。

flutter 工具使用了 Google Analytics 来对基本使用情况和崩溃报告进行匿名的统计。这些数据用来帮助改善 Flutter 工具。在第一次运行或者任何涉及到 flutter config 的信息都不会进行发送，所以你可以在发送分析数据之前选择禁止分析数据的统计。要禁用这一功能，只需要输入 flutter config --no-analytics 即可，想要查看当前设置使用命令 flutter config 即可。你可以在 Google 隐私政策中查看更详细的内容。

三、设置 Android 开发环境

备忘: Flutter 依赖 Android Studio 的全量安装来为其提供 Android 平台的支持。但你也可以使用其他的编辑器来写 Flutter 应用，稍后会说明讨论这个问题。

3.1 安装 Android Studio

1. 下载并安装 Android Studio。

下载链接：https://developer.android.google.cn/studio

2. 运行 Android Studio，并进入 ‘Android Studio Setup Wizard’，这会安装最新的 Android SDK， Android SDK Platform-Tools 以及 Android SDK Build-Tools，这些都是在开发 AndroidFlutter 应用时所需要的。

3.2 配置 Android 设备

在 Android 设备上运行或测试 Flutter 应用之前，你需要一个运行 Android 4.1（API 版本 16）或者更高的设备。

1. 在设备上打开 Developer options 和 USB debugging 选项，你可以在 Androiddocumentation 上查看更详细的方法介绍。

2. 如果是在 Windows 平台上使用，需要安装 Google USB Driver

安装链接：https://developer.android.google.cn/studio/run/win-usb

3. 通过 USB 接口连接手机和电脑，如果在设备上弹出需要授权弹窗，允许授权以便让电脑能够访问你的开发设备。

4. 在命令行中，使用 flutter devices 命令来确保 Flutter 能够识别出你所连接的 Android 设备。

默认情况下，Flutter 会使用当前版本 adb 工具所依赖的 Android SDK 版本，如果你想让 Flutter 使用别的 Android SDK，你可以通过设置 ANDROID_HOME 环境变量来达到目的。

3.3 配置 Android 模拟器

根据以下步骤来将 Flutter 应用运行或测试于你的 Android 模拟器上：

1. 激活机器上的 VMacceleration 选项。

2. 启动 Android Studio > Tools >Android > AVD Manager，然后选择 Create VirtualDevice 选项。（只有在 Android 项目中才会显示 Android 子选项。）

3. 选择相应的设备并选择 Next 选项。

4. 选择一个或多个你想要模拟的 Android 版本的系统镜像，然后选择 Next 选项。推荐选择 x86 或者 x86_64 镜像。

5. 在 Emulated Performance 下选择 Hardware - GLES 2.0 选项来开启硬件加速。

6. 确保 AVD 选项配置正确，并选择 Finish 选项。

7. 想要查看上述步骤的更多详细信息，请查看 ManagingAVDs 页面。

8. 在 Android Virtual Device Manager 中，点击工具栏中的 Run 选项，模拟器会启动并为你所选择的系统版本和设备显示出相应的界面。