Windows Flutter开发环境配置指南：从安装到打包分发完整教程

flutter-setting-up-on-windows by flutter/skills

1,600 周安装量

792 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/flutter/skills --skill flutter-setting-up-on-windows

开发开发运维 Flutter

🇨🇳中文介绍

在 Windows 上配置 Flutter 开发环境

核心要求

配置 Windows 环境以同时支持 Flutter 框架运行和原生 C/C++ 编译。请严格区分 Visual Studio（Windows 桌面 C++ 编译所需）和 VS Code（推荐的 Dart/Flutter 代码编辑器）。

工作流程：安装和配置 SDK

按照此顺序工作流程在 Windows 计算机上初始化 Flutter SDK。

下载适用于 Windows 的最新稳定版 Flutter SDK。
将 SDK 解压到具有标准用户权限的目录（例如 C:\src\flutter）。请勿安装到受保护的目录，如 C:\Program Files\。
复制 Flutter SDK 的 bin 目录的绝对路径。
打开 Windows 环境变量设置，并将 bin 目录路径追加到系统或用户的 PATH 变量中。
打开一个新的终端会话以应用更改。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

工作流程：配置工具和 IDE

安装 Visual Studio（不是 VS Code）。
在 Visual Studio 安装过程中，选择并安装 使用 C++ 的桌面开发 工作负载。这对于编译 Windows 桌面应用程序是强制性的。
安装您偏好的代码编辑器（VS Code、Android Studio 或 IntelliJ）。
在您选择的编辑器内安装官方的 Flutter 和 Dart 扩展/插件。

工作流程：配置目标平台

根据您要针对开发的特定平台应用条件逻辑。

如果目标是 Windows 桌面：

确保 Visual Studio C++ 工作负载已完全更新。
重新启动您的 IDE，以便它检测到 Windows 桌面设备。
要禁用您不打算编译的平台，请执行 flutter config --no-enable-<platform>（例如 flutter config --no-enable-windows-desktop）。

如果目标是 Windows 上的 Android：

对于物理设备： 在设备上启用开发者选项和 USB 调试。为 Windows 安装特定的 OEM USB 驱动程序。
对于模拟器： 打开 Android 虚拟设备（AVD）管理器。在“模拟性能” -> “图形加速”下，选择一个指定“硬件”的选项以启用硬件加速。
通过运行 flutter devices 来验证设备连接。

工作流程：为 Windows 构建和打包

要分发 Windows 桌面应用程序，请将编译后的可执行文件及其所需的依赖项组装到一个可分发存档中。

执行 flutter build windows 以编译发布版本。
导航到 build\windows\runner\Release\。
为分发 zip 文件创建一个新的暂存目录。
从 Release 目录复制以下资源到暂存目录：
- 应用程序可执行文件（.exe）。
- 所有生成的 .dll 文件。
- 整个 data 目录。
将所需的 Visual C++ 可再发行组件复制到暂存目录中，与可执行文件放在一起：
- msvcp140.dll
- vcruntime140.dll
- vcruntime140_1.dll
将暂存目录压缩成 .zip 文件以供分发。

工作流程：生成和安装证书

如果您需要用于 MSIX 打包或本地测试的自签名证书，请使用 OpenSSL。

安装 OpenSSL 并将其 bin 目录添加到您的 PATH 环境变量中。
生成私钥：openssl genrsa -out mykeyname.key 2048
生成证书签名请求（CSR）：openssl req -new -key mykeyname.key -out mycsrname.csr
生成签名证书（CRT）：openssl x509 -in mycsrname.csr -out mycrtname.crt -req -signkey mykeyname.key -days 10000
生成 .pfx 文件：openssl pkcs12 -export -out CERTIFICATE.pfx -inkey mykeyname.key -in mycrtname.crt
在本地 Windows 计算机上安装 .pfx 证书。在安装应用程序之前，将其放置在证书存储中的 受信任的根证书颁发机构 下。

Windows 分发目录结构

在为分发组装 Windows 构建时，请确保在压缩前目录结构严格匹配以下布局：

Release_Archive/
│   my_flutter_app.exe
│   flutter_windows.dll
│   msvcp140.dll
│   vcruntime140.dll
│   vcruntime140_1.dll
│
└───data/
    │   app.so
    │   icudtl.dat
    │   ...

🇺🇸English

Setting Up Flutter for Windows Development

Core Requirements
Workflow: Installing and Configuring the SDK
Workflow: Configuring Tooling and IDEs
Workflow: Configuring Target Platforms
Workflow: Building and Packaging for Windows
Workflow: Generating and Installing Certificates
Examples

Core Requirements

Configure the Windows environment to support both Flutter framework execution and native C/C++ compilation. Differentiate strictly between Visual Studio (required for Windows desktop C++ compilation) and VS Code (the recommended Dart/Flutter code editor).

Workflow: Installing and Configuring the SDK

Follow this sequential workflow to initialize the Flutter SDK on a Windows machine.

Download the latest stable Flutter SDK for Windows.
Extract the SDK to a directory with standard user privileges (e.g., C:\src\flutter). Do not install in protected directories like C:\Program Files\.
Copy the absolute path to the Flutter SDK's bin directory.
Open Windows Environment Variables settings and append the bin directory path to the system or user PATH variable.
Open a new terminal session to apply the PATH changes.
Feedback Loop: Run validator -> review errors -> fix.
1. Execute flutter doctor -v.
2. Review the output for missing dependencies or path issues.
3. Resolve any flagged errors before proceeding to tooling setup.

Workflow: Configuring Tooling and IDEs

Install Visual Studio (not VS Code).
Select and install the Desktop development with C++ workload during the Visual Studio installation process. This is mandatory for compiling Windows desktop applications.
Install your preferred code editor (VS Code, Android Studio, or IntelliJ).
Install the official Flutter and Dart extensions/plugins within your chosen editor.

Workflow: Configuring Target Platforms

Apply conditional logic based on the specific platform you are targeting for development.

If targeting Windows Desktop:

Ensure the Visual Studio C++ workload is fully updated.
Restart your IDE so it detects the Windows desktop device.
To disable platforms you do not intend to compile for, execute flutter config --no-enable-<platform> (e.g., flutter config --no-enable-windows-desktop).

If targeting Android on Windows:

For physical devices: Enable Developer Options and USB debugging on the device. Install the specific OEM USB drivers for Windows.
For emulators: Open the Android Virtual Device (AVD) manager. Under "Emulated Performance" -> "Graphics acceleration", select an option specifying "Hardware" to enable hardware acceleration.
Verify the device connection by running flutter devices.

Workflow: Building and Packaging for Windows

To distribute a Windows desktop application, assemble the compiled executable and its required dependencies into a single distributable archive.

Execute flutter build windows to compile the release build.
Navigate to build\windows\runner\Release\.
Create a new staging directory for the distribution zip.
Copy the following assets from the Release directory into the staging directory:
- The application executable (.exe).
- All generated .dll files.
- The entire data directory.
Copy the required Visual C++ redistributables into the staging directory alongside the executable:
- msvcp140.dll
- vcruntime140.dll

Workflow: Generating and Installing Certificates

If you require a self-signed certificate for MSIX packaging or local testing, use OpenSSL.

Install OpenSSL and add its bin directory to your PATH environment variable.
Generate a private key: openssl genrsa -out mykeyname.key 2048
Generate a Certificate Signing Request (CSR): openssl req -new -key mykeyname.key -out mycsrname.csr
Generate the signed certificate (CRT): openssl x509 -in mycsrname.csr -out mycrtname.crt -req -signkey mykeyname.key -days 10000
Generate the .pfx file: openssl pkcs12 -export -out CERTIFICATE.pfx -inkey mykeyname.key -in mycrtname.crt
Install the .pfx certificate on the local Windows machine. Place it in the Certificate Store under Trusted Root Certification Authorities prior to installing the application.

Examples

Windows Distribution Directory Structure

When assembling your Windows build for distribution, ensure the directory structure strictly matches the following layout before zipping:

Release_Archive/
│   my_flutter_app.exe
│   flutter_windows.dll
│   msvcp140.dll
│   vcruntime140.dll
│   vcruntime140_1.dll
│
└───data/
    │   app.so
    │   icudtl.dat
    │   ...

Weekly Installs

1.6K

Repository

flutter/skills

GitHub Stars

792

First Seen

12 days ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

codex1.5K

opencode1.5K

github-copilot1.5K

gemini-cli1.5K

kimi-cli1.5K

cursor1.5K

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

102,200 周安装

vcruntime140_1.dll

Compress the staging directory into a .zip file for distribution.