桌面应用 / 系统课时
打包 Windows macOS Linux
打包 Windows macOS Linux
本篇解决 Qt 6 QML 桌面应用从开发环境到可分发程序的问题。你将了解不同平台的部署工具、运行库处理方式和签名差异,并完成发布前的基础验证。
学习目标
- 理解 Windows、macOS、Linux 三个平台的 Qt 应用部署方式。
- 使用 Qt 官方部署工具收集运行依赖并验证发布目录。
- 认识应用签名、公证和权限限制对发布流程的影响。
选择合适的部署方式
Qt 应用发布时不能只复制编译生成的可执行文件,因为 QML 引擎、Qt 模块和平台插件通常位于独立目录中。部署工具的作用是分析程序依赖,把运行所需文件复制到发布目录。
常见平台的部署工具如下:
| 平台 | 工具 | 主要作用 |
|---|---|---|
| Windows | windeployqt | 收集 Qt DLL、插件和 QML 依赖 |
| macOS | macdeployqt | 创建应用包并处理框架依赖 |
| Linux | linuxdeployqt 或发行版打包工具 | 准备 AppImage 或系统软件包 |
对于 QML 应用,部署时尤其需要检查 QtQuick、QtQml 等模块依赖,否则程序可能在开发机之外启动失败。
Windows 平台部署
Windows 发布通常先生成 Release 构建结果,再使用 windeployqt 扫描可执行文件。
bash
windeployqt --release --qmldir <PATH> <PATH>\\MyApp.exe其中 <PATH> 代表实际项目路径,命令会根据程序使用的 Qt 模块复制对应 DLL 和插件。
执行后可以在发布目录中直接启动程序进行验证。
预期结果
text
MyApp.exe
Qt6Core.dll
Qt6Gui.dll
Qt6Qml.dll
platforms\\qwindows.dll
qml\\QtQuick如果程序依赖第三方动态库,也需要单独检查这些库是否位于系统搜索路径中。
macOS 平台部署
macOS 应用通常以 .app 包形式发布。macdeployqt 会把 Qt Framework 和插件放入应用包内部,并调整依赖路径。
bash
macdeployqt MyApp.app预期结果
text
MyApp.app/
Contents/
MacOS/
Frameworks/
PlugIns/
Resources/正式发布到用户设备前,还需要考虑代码签名和公证流程。未签名或签名异常的应用可能被系统安全策略阻止运行。
Linux 平台部署
Linux 环境差异较大,需要明确目标发行版和运行方式。常见方案包括制作发行版软件包、使用 AppImage 或准备自包含运行目录。
部署时重点检查:
- Qt 动态库是否包含在发布目录。
- QML 模块路径是否正确。
- 平台插件是否存在,例如
platforms/libqxcb.so。
可以通过启动程序验证依赖是否完整:
bash
./MyApp预期结果
text
Application started successfully如果出现平台插件加载失败,通常需要检查环境变量或缺失的系统库。
发布前验证清单
完成打包后,不要直接认为程序可以发布,应在干净环境中测试:
- 使用没有安装 Qt 开发环境的机器启动程序。
- 验证窗口显示、QML 页面加载和资源访问。
- 检查系统权限、安全提示和签名状态。
- 确认应用版本信息和日志输出符合发布要求。
跨平台发布的关键不是复制文件,而是保证目标用户环境中拥有完整、正确且可验证的运行时依赖。
按自己的节奏,确认真正理解。