在 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 归档页面:

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

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

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

要升级本地已安装的 Flutter,请参阅升级 Flutter 文档:

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

  1. 运行 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 optionsUSB debugging 选项,你可以在 Androiddocumentation 上查看更详细的方法介绍。

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

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

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

  2. 在命令行中,使用 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 选项,模拟器会启动并为你所选择的系统版本和设备显示出相应的界面。

来自flutter官方公众号: Flutter社区