💻 壹信 IM Windows 编译环境详细配置指南#

💡 核心信息

适用系统: Windows 10 21H2 (64位) 或 Windows 11 22H2 (64位)

适用版本: Flutter 3.24.0+ | Visual Studio 2022

最后更新: 2026-03-07

编译目标: x64 (64位)

所需内存: 16GB+

所需存储: 50GB+

📌 一、系统准备与检查#

1.1 系统要求确认#

🛠️ 二、必备软件安装详细指南#

2.1 Flutter SDK (最核心组件)#

2.1.1 下载与安装#

Flutter 3.24.0 • channel stable • https://github.com/flutter/flutter.git
Framework • revision 8c4d3d7b0d (1 week ago) • 2023-11-15 14:43:11 -0800
Engine • revision 6a0c2a8a50
Tools • Dart 2.19.5 • Flutter 3.24.0

2.2 Visual Studio 2022 (C++ 编译工具链)#

2.2.1 下载与安装#

cmake version 3.24.0
CMake suite maintained and supported by Kitware (kitware.com/cmake).

2.3 Git (版本控制工具)#

2.3.1 下载与安装#

git version 2.39.0.windows.1

2.4 JDK 17 (Java Development Kit)#

2.4.1 下载与安装#

openjdk version "17.0.8" 2023-07-18
OpenJDK Runtime Environment Temurin-17.0.8+7 (build 17.0.8+7)
OpenJDK 64-Bit Server VM Temurin-17.0.8+7 (build 17.0.8+7, mixed mode)

2.5 Android Studio (可选，如需编译 Android)#

2.5.1 下载与安装#

Android Debug Bridge version 1.0.41
Version 34.0.3-10080042
Installed as D:\Android\AndroidStudio\platform-tools\adb.exe

⚙️ 三、Flutter 环境详细配置#

3.1 启用 Windows 支持#

Enabled Windows support for Flutter.

3.2 验证 Flutter 环境#

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.0, on Microsoft Windows [Version 10.0.22621.2729], locale en-US)
[✓] Android toolchain - develop for Android devices
[✓] Chrome - develop for the web
[✓] Visual Studio - develop Windows applications
[✓] Android Studio (version 2022.3.1)
[✓] VS Code (version 1.77.3)
[✓] Connected device (3 available)
[✓] Windows support - develop for Windows desktop

3.3 安装 Flutter 依赖#

🧪 四、验证编译环境（详细步骤）#

4.1 创建测试项目#

4.2 编译测试项目#

4.3 运行测试应用#

❓ 五、常见问题与详细解决方案#

5.1 问题: flutter doctor 显示 "Visual Studio not installed"#

5.2 问题: flutter build windows 提示 "CMake not found"#

5.3 问题: flutter build windows 提示 "MSVC not found"#

5.4 问题: "The application has failed to start because its side-by-side configuration is incorrect"#

5.5 问题: flutter pub get 失败#

📌 六、壹信 IM 项目编译详细步骤#

6.1 进入项目目录#

6.2 配置项目#

6.3 编译项目#

6.4 运行项目#

🎉 七、编译完成验证#

7.1 验证编译产物#

7.2 运行编译后的可执行文件#

💡 八、高级配置建议#

8.1 配置 VS Code 作为开发环境#

{
  "dart.sdkPath": "D:/flutter",
  "flutter.sdkPath": "D:/flutter",
  "terminal.integrated.defaultProfile.windows": "Command Prompt"
}

8.2 配置代码自动格式化#

{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "dart-code.dart-code",
  "dart.formatOnSave": true
}

📌 九、总结#

安全提示: 首次运行应用时，系统可能会提示 "未知发布者"，请在"安全设置"中信任应用，否则应用无法运行。

📎 附录：环境配置检查清单#

✅ 最终验证#

Building Windows application...
✓ Built build\windows\runner\Release\yixinim.exe.