开始在 Windows 上构建 Flutter 原生桌面应用
软件要求
#要在桌面端编写和编译 Flutter 代码,你必须拥有以下版本的 Windows 和列出的软件包。
操作系统
#Flutter 支持在 64 位 Windows 10 和 11 上进行开发。
开发工具
#下载并安装以下软件包的 Windows 版本
Git for Windows 用于管理 Flutter 版本和你的源代码版本。
Visual Studio 2022 用于调试和编译原生 C++ Windows 代码。请确保安装使用 C++ 的桌面开发工作负载。这允许构建 Windows 应用,包括其所有默认组件。Visual Studio 是一个独立的 IDE,与Visual Studio Code不同。
上述软件的开发者提供这些产品的支持。要解决安装问题,请查阅该产品的文档。
配置文本编辑器或 IDE
#你可以使用任何文本编辑器或集成开发环境 (IDE) 结合 Flutter 的命令行工具来构建应用。
使用带有 Flutter 扩展或插件的 IDE 可提供代码补全、语法高亮、小部件编辑辅助、调试及其他功能。
流行的选项包括
- Visual Studio Code 以及适用于 VS Code 的 Flutter 扩展。
- Android Studio 以及适用于 IntelliJ 的 Flutter 插件。
- IntelliJ IDEA 以及适用于 IntelliJ 的 Flutter 插件。
安装 Flutter SDK
#要安装 Flutter SDK,你可以使用 VS Code Flutter 扩展,或自行下载并安装 Flutter 包。
使用 VS Code 安装 Flutter
#要按照这些说明安装 Flutter,请确认你已安装 Visual Studio Code 和 适用于 VS Code 的 Flutter 扩展。
提示 VS Code 安装 Flutter
#启动 VS Code。
要打开命令面板,请按 Control + Shift + P。
在命令面板中,输入
flutter
。选择Flutter: 新建项目。
VS Code 会提示你定位电脑上的 Flutter SDK。
如果你已安装 Flutter SDK,请点击定位 SDK。
如果你未安装 Flutter SDK,请点击下载 SDK。
如果你尚未按照开发工具先决条件中的指示安装 Git for Windows,此选项会带你到 Flutter 安装页面。
当提示哪个 Flutter 模板?时,请忽略。按 Esc。你可以在检查开发环境设置后创建一个测试项目。
下载 Flutter SDK
#当显示选择 Flutter SDK 文件夹对话框时,选择你想要安装 Flutter 的位置。
VS Code 会首先将你定位到用户配置文件目录。请选择其他位置。
可以考虑
%USERPROFILE%
或C:\dev
。点击克隆 Flutter。
下载 Flutter 时,VS Code 会显示以下弹窗通知:
Downloading the Flutter SDK. This may take a few minutes.
Initializing the Flutter SDK. This may take a few minutes.
下载和安装需要几分钟。如果你怀疑下载已卡住,请点击取消,然后重新开始安装。
Flutter 安装成功后,VS Code 会显示此弹窗通知:
Do you want to add the Flutter SDK to PATH so it's accessible in external terminals?
点击添加 SDK 到 PATH。
成功时,会显示通知
The Flutter SDK was added to your PATH
VS Code 可能会显示 Google Analytics 通知。
如果你同意,点击确定。
要在所有 PowerShell 窗口中启用
flutter
- 关闭,然后重新打开所有 PowerShell 窗口。
- 重新启动 VS Code。
下载然后安装 Flutter
#要安装 Flutter,请从其存档下载 Flutter SDK 包,将该包移动到你希望存储的位置,然后解压 SDK。
下载以下安装包以获取 Flutter SDK 的最新稳定版本。
对于其他发布渠道和旧版本,请查阅 SDK 存档。
Flutter SDK 应该下载到 Windows 默认的下载目录:
%USERPROFILE%\Downloads
。如果你更改了“下载”目录的位置,请将此路径替换为你的实际路径。要查找“下载”目录的位置,请查阅这篇Microsoft 社区帖子。
创建一个你可以安装 Flutter 的文件夹。
可以考虑在
%USERPROFILE%
(C:\Users\{username}
) 或%LOCALAPPDATA%
(C:\Users\{username}\AppData\Local
) 创建目录。将文件解压到你希望存储 Flutter SDK 的目录中。
PS C:\> Expand-Archive ` –Path $env:USERPROFILE\Downloads\flutter_sdk_v1.0.0.zip ` -Destination $env:USERPROFILE\dev\
完成后,Flutter SDK 应该位于
C:\user\{username}\dev\flutter
目录中。
更新你的 Windows PATH 变量
#要在 PowerShell 中运行 Flutter 命令,请将 Flutter 添加到 PATH
环境变量。本节假定你已将 Flutter SDK 安装在 %USERPROFILE%\dev\flutter
中。
按下 Windows + Pause。
如果您的键盘没有 Pause 键,请尝试 Windows + Fn + B。
显示系统 > 关于对话框。
点击高级系统设置 > 高级 > 环境变量...
显示环境变量对话框。
在用户变量 (username) 部分,查找Path条目。
如果条目存在,双击它。
显示编辑环境变量对话框。
双击一个空白行。
输入
%USERPROFILE%\dev\flutter\bin
。点击%USERPROFILE%\dev\flutter\bin条目。
点击上移,直到 Flutter 条目位于列表顶部。
点击三次确定。
如果该条目不存在,请点击新建...。
显示编辑环境变量对话框。
在“变量名”框中,输入
Path
。在变量值框中,输入
%USERPROFILE%\dev\flutter\bin
点击三次确定。
要使这些更改生效,请关闭并重新打开所有现有命令提示符和 PowerShell 实例。
检查开发环境设置
#运行 Flutter doctor
#flutter doctor
命令会验证 Windows 上完整的 Flutter 开发环境的所有组件。
打开 PowerShell。
要验证所有组件的安装,请运行以下命令。
PS C:> flutter doctor
由于你选择进行桌面开发,所以不需要所有组件。如果你按照本指南进行操作,该命令应该会为你设置的工具和平台输出 [✓]
。
Flutter doctor 问题排查
#当 flutter doctor
命令返回错误时,可能与 Flutter、VS Code、Visual Studio、连接的设备或网络资源有关。
如果 flutter doctor
命令针对这些组件中的任何一个返回错误,请使用详细模式标志再次运行它。
PS C:> flutter doctor -v
检查输出,看是否需要安装其他软件或执行其他任务。
如果你更改了 Flutter SDK 或其相关组件的配置,请再次运行 flutter doctor
来验证安装。
开始使用 Flutter 开发 Windows 桌面应用
#恭喜你。在安装完所有先决条件和 Flutter SDK 后,你现在可以开始为 Windows 桌面开发 Flutter 应用了。
要继续你的学习之旅,请查阅以下指南:
管理 Flutter SDK
#要了解更多关于管理 Flutter SDK 安装的信息,请查阅以下资源: