在 Windows 操作系统上安装和配置 Flutter 开发环境
系统配置要求
要想安装和运行 Flutter,你的开发环境至少应该满足如下的需求:
-
操作系统:Windows 10 或更高的版本(基于 x86-64 的 64 位操作系统)。
-
磁盘空间:除安装 IDE 和一些工具之外还应有至少 1.64 GB 的空间。
-
设置: 必须在 Windows 10/11 上启用开发者模式。
-
工具:要让 Flutter 在你的开发环境中正常使用,依赖于以下的工具:
-
Windows PowerShell 5.0 或者更高的版本(Windows 10 中已预装)
-
Git for Windows 2.x,并且勾选从 Windows 命令提示符使用 Git 选项。
如果 Windows 版的 Git 已经安装过了,那么请确保能从命令提示符或者 PowerShell 中直接执行 git 命令。
-
获取 Flutter SDK
-
点击下方的安装包,获取 stable 发行通道的 Flutter SDK 最新版本:
要查看其他发行通道和以往的版本,请参阅 SDK 版本列表 页面。
-
将压缩包解压,然后把其中的
flutter
目录整个放在你想放置 Flutter SDK 的路径中(例如C:\src\flutter
)。
现在你可以在控制台当中使用 Flutter 的命令了。
更新 path 环境变量
如果你想在 Windows 控制台中运行 Flutter 命令,需要按照下面的步骤来将 Flutter 的运行文件路径加入到 PATH
环境变量。
-
在开始菜单的搜索功能键入「env」,然后选择 编辑系统环境变量。
-
在 用户变量 一栏中,检查是否有 Path 这个条目:
-
如果存在这个条目,以
;
分隔已有的内容,加入flutter\bin
目录的完整路径。 -
如果不存在的话,在用户环境变量中创建一个新的
Path
变量,然后将flutter\bin
所在的完整路径作为新变量的值。
-
你需要重新打开已经打开的命令行提示符窗口,这样下次启动命令提示符时,才能访问到刚才修改的变量。
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.cn/docs/setup/#android-setup for detailed instructions.
下面的章节介绍了对缺失的内容进行配置的方法。每当您安装了任何一个的依赖项,就可以随时执行 flutter doctor
来检查是否正确配置了所有内容。
设置 Android 开发环境
安装 Android Studio
-
下载并安装 Android Studio。
-
运行 Android Studio,并进入 ‘Android Studio Setup Wizard’,这会安装最新的 Android SDK, Android SDK Platform-Tools 以及 Android SDK Build-Tools,这些都是在开发 Android Flutter 应用时所需要的。
-
运行
flutter doctor
确保 Flutter 已经定位到了你的 Android Studio 的安装位置。如果 Flutter 并未定位到,运行flutter config --android-studio-dir <directory>
设置你的 Android Studio 的安装目录。
配置 Android 设备
在 Android 设备上运行或测试 Flutter 应用之前,你需要一个运行 Android 4.1(API 版本 16)或者更高的设备。
-
在设备上打开 Developer options 和 USB debugging 选项,你可以在 Android documentation 上查看更详细的方法介绍。
-
[可选] 要使用无线调试,启用设备上的 Wireless debugging。详细的操作步骤在 Android 文档 里有。
-
如果是在 Windows 平台上使用,需要安装 Google USB Driver
-
通过 USB 接口连接手机和电脑,如果在设备上弹出需要授权弹窗,允许授权以便让电脑能够访问你的开发设备。
-
在终端中,运行
flutter devices
命令来确认 Flutter 是否识别到你连接的 Android 设备。默认情况下,Flutter 会使用你的adb
工具所在的 Android SDK 版本。如果你希望 Flutter 使用不同的 Android SDK 安装版本,你必须设置ANDROID_SDK_ROOT
环境变量到那个安装目录。
配置 Android 模拟器
根据以下步骤来将 Flutter 应用运行或测试于你的 Android 模拟器上:
-
激活机器上的 VM acceleration 选项。
-
打开 Android Studio,点击 Device Manager 按钮,在 Virtual 这个标签页下选择 Create Device
-
在一些旧的 Android Studio 版本里,需要通过 Android Studio > Tools > Android > AVD Manager,然后选择 Create Virtual Device… 选项。(只有在 Android 项目中才会显示 Android 子选项。)
-
如果你以及还没打开某个项目,你可以选择 3-Dot Menu / More Actions > Virtual Device Manager 然后选择 Create Device 选项
-
-
选择相应的设备并选择 Next 选项。
-
选择一个或多个你想要模拟的 Android 版本的系统镜像,然后选择 Next 选项。推荐选择 x86 或者 x86_64 镜像。
-
在 Emulated Performance 下选择 Hardware - GLES 2.0 选项来开启 硬件加速。
-
确保 AVD 选项配置正确,并选择 Finish 选项。
想要查看上述步骤的更多详细信息,请查看 Managing AVDs 页面。
-
在 Android Virtual Device Manager 中,点击工具栏中的 Run 选项,模拟器会启动并为你所选择的系统版本和设备显示出相应的界面。
同意 Android 协议
在使用 Flutter 前,你必须同意 Android SDK 平台的协议。你可以在安装完上述工具后执行这一步。
-
打开一个已经提升管理员权限的终端窗口,运行以下命令进行协议的确认。
$ flutter doctor --android-licenses
-
仔细阅读每条协议后同意。
-
当你同意所有协议后,再次运行
flutter doctor
以确认是否已经可以正常使用 Flutter。
Windows 设置
其他 Windows 需要的内容
对于 Windows 桌面开发而言,除了 Flutter SDK 以外你还需要以下内容:
-
Visual Studio 2022 或 Visual Studio 2022 生成工具 在选择安装 Visual Studio 时或只安装生成工具的时候,你需要选择「使用 C++ 的桌面开发」,包括其所有默认组件,以安装必要的 C++ 工具链和 Windows SDK 的头文件。
更多详情请查看 构建基于 Flutter 的 Windows 应用程序。
下一步
编辑工具设定。