桌面应用 / 系统课时

打包 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 页面加载和资源访问。
  • 检查系统权限、安全提示和签名状态。
  • 确认应用版本信息和日志输出符合发布要求。

跨平台发布的关键不是复制文件,而是保证目标用户环境中拥有完整、正确且可验证的运行时依赖。

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

目录与阅读设置

阅读设置

17

记录一个想法

打包 Windows macOS Linux

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

登录哪都通