桌面应用 / 系统课时

打包 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 安装目录提供了隐藏依赖,需要在干净环境中验证。

推荐检查流程:

  1. 将发布目录复制到没有安装 Qt 的 Windows 机器。
  2. 双击启动应用。
  3. 检查窗口、资源文件和插件功能是否正常。
  4. 如果启动失败,使用依赖检查工具定位缺失 DLL。

常见问题包括:

现象 原因 处理方式
提示缺少 DLL Qt 或编译器运行库未复制 重新执行部署工具并检查依赖
程序启动后无界面 平台插件缺失 检查 platforms/qwindows.dll
功能缺少 插件目录未部署 补充对应 Qt 插件

发布包优化与注意事项

windeployqt 会优先保证程序可以运行,但生成目录可能包含暂时不需要的模块。正式发布前可以结合实际功能清理无用文件,并确认许可证要求。

如果应用依赖数据库驱动、第三方 DLL 或自定义插件,需要额外检查这些文件是否已经放入发布目录。Qt 部署工具只能处理它能够识别的依赖,业务自己的文件仍需要手动管理。

完成 Windows 打包后,最终交付物应该是一个完整目录,用户无需安装 Qt 或开发工具即可启动应用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

打包 Windows 桌面应用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通