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

3161次阅读 | 发布于5年以前

在 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

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

下载并安装 Android Studio。

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

运行 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）或者更高的设备。

在设备上打开 Developer options 和 USB debugging 选项，你可以在 Androiddocumentation 上查看更详细的方法介绍。
如果是在 Windows 平台上使用，需要安装 Google USB Driver

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

通过 USB 接口连接手机和电脑，如果在设备上弹出需要授权弹窗，允许授权以便让电脑能够访问你的开发设备。
在命令行中，使用 flutter devices 命令来确保 Flutter 能够识别出你所连接的 Android 设备。

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

3.3 配置 Android 模拟器

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

激活机器上的 VMacceleration 选项。
启动 Android Studio > Tools >Android > AVD Manager，然后选择 Create VirtualDevice 选项。（只有在 Android 项目中才会显示 Android 子选项。）
选择相应的设备并选择 Next 选项。
选择一个或多个你想要模拟的 Android 版本的系统镜像，然后选择 Next 选项。推荐选择 x86 或者 x86_64 镜像。
在 Emulated Performance 下选择 Hardware - GLES 2.0 选项来开启硬件加速。
确保 AVD 选项配置正确，并选择 Finish 选项。
想要查看上述步骤的更多详细信息，请查看 ManagingAVDs 页面。
在 Android Virtual Device Manager 中，点击工具栏中的 Run 选项，模拟器会启动并为你所选择的系统版本和设备显示出相应的界面。