桌面应用 / 系统课时
打包 Windows 桌面应用
打包 Windows 桌面应用
本篇介绍如何将 Qt 6 桌面程序从开发环境转换为可分发的 Windows 应用。你将使用 Qt 部署工具收集运行库、插件和资源文件,并验证应用在没有 Qt 开发环境的机器上是否可以正常启动。
学习目标
- 理解 Windows 平台 Qt 应用发布时需要收集的运行依赖。
- 使用部署工具生成独立运行目录并检查缺失文件。
- 掌握发布前启动验证的基本流程。
认识 Windows Qt 应用发布依赖
Qt 应用在开发机上可以运行,是因为系统中存在 Qt 库、编译器运行时和插件目录。直接复制可执行文件到其他 Windows 机器,通常会因为缺少动态库或平台插件启动失败。
Windows 发布包通常需要包含以下内容:
- 应用程序可执行文件(
.exe)。 - Qt 动态库文件(例如
Qt6Core.dll)。 - 平台插件目录,例如
platforms下的 Windows 平台插件。 - 编译器运行时依赖。
- 应用自身使用的资源文件。
Qt 提供的 windeployqt 工具可以分析可执行文件依赖,并自动复制大部分 Qt 运行文件。
使用 windeployqt 收集依赖
windeployqt 位于 Qt 安装目录的工具路径中。执行前需要确保应用已经使用目标发布配置构建完成,例如 Release 模式。
下面示例假设生成的程序名为 MyApp.exe,实际路径需要替换为自己的构建目录。
bash
windeployqt --release <PATH>\MyApp.exe预期结果
text
Adding Qt6Core.dll
Adding Qt6Gui.dll
Adding Qt6Widgets.dll
Adding platforms/qwindows.dll
Deployment completed执行完成后,程序所在目录会增加 Qt 运行依赖文件。<PATH> 表示实际构建输出路径,不同项目目录会不同。
验证脱离开发环境运行
部署完成后,不要只在开发机中测试。开发机可能通过环境变量或 Qt 安装目录提供了隐藏依赖,需要在干净环境中验证。
推荐检查流程:
- 将发布目录复制到没有安装 Qt 的 Windows 机器。
- 双击启动应用。
- 检查窗口、资源文件和插件功能是否正常。
- 如果启动失败,使用依赖检查工具定位缺失 DLL。
常见问题包括:
| 现象 | 原因 | 处理方式 |
|---|---|---|
| 提示缺少 DLL | Qt 或编译器运行库未复制 | 重新执行部署工具并检查依赖 |
| 程序启动后无界面 | 平台插件缺失 | 检查 platforms/qwindows.dll |
| 功能缺少 | 插件目录未部署 | 补充对应 Qt 插件 |
发布包优化与注意事项
windeployqt 会优先保证程序可以运行,但生成目录可能包含暂时不需要的模块。正式发布前可以结合实际功能清理无用文件,并确认许可证要求。
如果应用依赖数据库驱动、第三方 DLL 或自定义插件,需要额外检查这些文件是否已经放入发布目录。Qt 部署工具只能处理它能够识别的依赖,业务自己的文件仍需要手动管理。
完成 Windows 打包后,最终交付物应该是一个完整目录,用户无需安装 Qt 或开发工具即可启动应用。
按自己的节奏,确认真正理解。