在 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

下载下面的安装包以获取最新版本 stable 的 Flutter SDK

flutter_windows_v1.5.4-hotfix.2-stable.zip?

storage.flutter-io.cn

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

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

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

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

要升级本地已安装的 Flutter，请参阅升级 Flutter。

2.1 更新 path 环境变数

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

在开始菜单的搜索功能键入「env」，然后选择编辑当前用户的环境变数
在 用户变数 (User variables) 一栏中，检查是否有 Path 这个条目：

如果存在，直接把 flutterin 目录的完整路径以 ; 作为分隔加到已有的值后面。
如果不存在的话，在用户环境变数中创建一个新的 Path 变数，然后将 flutterin 所在的完整路径作为新变数的值。

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

2.2 运行 flutter doctor

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

C:srcflutter>flutter doctor

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

举个例子：

[-] Android toolchain - develop for Android devices ? Android SDK at D:Androidsdk ? 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

下载并安装 Android 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 选项，你可以在 Android documentation 上查看更详细的方法介绍。

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

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

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

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

3.3 配置 Android 模拟器

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

1. 激活机器上的VM acceleration选项。

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

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