1. 文档教程
壹信-开源即时通讯
  • 壹信 — 即时通讯系统
  • 项目源码结构与功能说明书
  • 功能核心分类明细
  • 客户端打包教程
  • Android安卓打包教程
  • iOS苹果打包教程
  • 苹果推送apns配置教程
  • macOS电脑打包教程
  • Windowsn桌面端打包教程
  • mac编译环境配置
  • windows编译环境配置
  • Docker部署后端教程
  • 用宝塔面板搭建服务端
  • API全局接口
  • 并发压力测试报告
  • 服务器配置推荐
  • 适用于上架的隐私协议
  • 端口说明
  • 更新日志
  • 法律声明
文档教程
文档教程
  1. 文档教程

Windowsn桌面端打包教程

💻 壹信 IM · Windows 环境配置与打包指南#

💡 核心信息
适用版本: Flutter 3.x+ | Windows 10/11 (64位)
最后更新: 2026-03-07
架构目标: x64 (64位)
适用系统: Windows 10/11 (64位)

📑 目录导航#

1.
🛠️ 环境准备
2.
📦 项目初始化
3.
⚙️ 关键配置核查
4.
▶️ 调试运行 (Debug)
5.
🎁 正式打包 (Release)
6.
❓ 常见问题 (FAQ)

🛠️ 一、环境准备#

在开始之前,请确保您的 Windows 机器已安装以下核心组件。

1.1 必装软件清单#

组件推荐版本说明
Flutter SDK3.24.0 + (稳定版)官方下载链接
Visual Studio 202217.0 +包含 C++ 开发工具
GitLatest代码版本管理
Windows SDK10.0.19041.0 +通过 Visual Studio 安装

1.2 安装步骤#

1.
安装 Flutter SDK
下载并安装 Flutter SDK
将 Flutter 的 bin 目录添加到系统 PATH
2.
安装 Visual Studio 2022
下载 Visual Studio 2022
安装时勾选 "使用 C++ 的桌面开发" 组件
确保安装了 Windows 10 SDK (版本 10.0.19041.0 或更高)
3.
验证环境
确保输出中显示 Windows 和 Visual Studio 均为绿色对勾

📦 二、项目初始化#

2.1 获取源代码#

2.2 安装依赖#

2.3 清理与预热 (推荐)#


⚙️ 三、关键配置核查#

3.1 检查 Windows 项目配置#

打开 windows/runner/CMakeLists.txt,确认以下配置:

3.2 检查应用名称#

打开 windows/runner/main.cpp,确认应用名称:

3.3 检查应用图标#

1.
将图标文件 (1024x1024 PNG) 放入 windows/runner/res/
2.
打开 windows/runner/resource.h,确认图标ID:

▶️ 四、调试运行 (Debug)#

1. 连接开发环境#

2. 运行项目#

⚠️ 重要提醒: 首次运行可能需要等待较长时间,因为需要编译 Windows 依赖

🎁 五、正式打包 (Release)#

方式 A:使用自动化脚本 (推荐)#

项目根目录已内置优化脚本 build_windows.bat:
1.
赋予执行权限:
REM 无需权限,Windows 脚本默认可执行
2.
执行打包:
build_windows.bat
✅ 脚本执行后效果:
生成安装程序 (MSI)
自动重命名为 壹信IM_Setup.msi
保存至桌面

方式 B:手动命令行打包#

📦 产物位置: build/windows/Release/x64/壹信IM.exe
💡 生成安装程序 (MSI):
REM 安装 WiX Toolset (https://wixtoolset.org/)
REM 然后执行以下命令
candle -out build/windows/Release/x64/壹信IM.wixobj build/windows/Installer.wxs
light -out build/windows/Release/x64/壹信IM.msi build/windows/Release/x64/壹信IM.wixobj

❓ 六、常见问题 (FAQ)#

: CMake 未正确安装。
:
将 CMake 的 bin 目录添加到系统 PATH
: 未正确配置应用图标或启动项。
:
检查 windows/runner/main.cpp 中的 kMainWindowTitle
确保图标文件已正确放入 windows/runner/res/ 并命名正确
:
打开 windows/runner/manifest.xml
:
在 build_windows.bat 中添加 -v 参数以查看详细编译信息

🎉 恭喜!您已成功完成壹信 IM 的 Windows 环境配置与打包。#

如有其他问题,请参考项目根目录 README.md 或联系技术团队。
修改于 2026-03-06 16:07:02
上一页
macOS电脑打包教程
下一页
mac编译环境配置
Built with