桌面应用 / 系统课时
准备 macOS 与 Linux 发布包
准备 macOS 与 Linux 发布包
本篇介绍 Qt 6 应用在 macOS 和 Linux 平台发布时的核心准备工作。你将了解不同系统的依赖管理方式、macOS 签名机制以及 Linux 发布包检查流程,避免应用只能在开发机运行的问题。
学习目标
- 理解 macOS 与 Linux 发布包和 Windows 的主要差异。
- 掌握 macOS 应用包结构和基础签名流程。
- 建立 Linux 发布前的依赖检查方法。
理解跨平台发布差异
Qt 可以使用同一套代码生成多个平台的桌面应用,但发布方式依赖操作系统规则。
Windows 主要关注 DLL 收集;macOS 关注应用包结构、动态库路径和签名;Linux 则更依赖系统发行版、动态库版本和打包方式。
不同平台的发布关注点如下:
| 平台 | 主要发布内容 | 重点检查 |
|---|---|---|
| macOS | .app 应用包 |
签名、公证、库路径 |
| Linux | 可执行文件和依赖包 | 动态库兼容、发行版差异 |
准备 macOS 应用包
macOS 应用通常以 .app 目录形式发布。Qt 提供 macdeployqt 工具,可以收集 Qt 框架和插件,并调整应用包中的库引用。
bash
macdeployqt <PATH>/MyApp.app预期结果
text
Deploying Qt frameworks into application bundle
Copied Qt plugins<PATH> 表示实际应用包路径。部署完成后,可以在其他 macOS 环境测试应用启动。
发布正式版本时,还需要考虑代码签名。未签名或签名不正确的应用,可能被 macOS 安全机制阻止运行。
检查 Linux 发布依赖
Linux 没有统一的应用发布模型,需要根据目标用户环境选择方案。
常见方式包括:
- 使用系统包管理器制作
.deb或.rpm包。 - 使用 AppImage 提供相对独立的运行环境。
- 针对服务器或企业环境维护依赖安装脚本。
发布前可以使用依赖检查命令确认动态库是否完整。
bash
ldd <PATH>/MyApp预期结果
text
libQt6Core.so.6 => found
libQt6Gui.so.6 => found
libQt6Widgets.so.6 => found实际输出会根据目标系统安装的库版本变化。如果出现 not found,说明程序依赖的动态库无法被系统定位。
建立跨平台发布检查流程
跨平台发布时,不应只验证编译成功,还需要验证用户环境中的运行结果。
建议至少检查:
- 应用是否可以启动。
- 窗口显示和字体是否正常。
- 文件读写路径是否符合目标系统规则。
- 第三方库和插件是否正确加载。
- 安装包卸载后是否清理完整。
macOS 和 Linux 的发布重点不同,但共同目标都是让用户在没有开发环境的情况下稳定运行程序。完成依赖部署、权限检查和真实环境测试后,Qt 应用才具备交付条件。
按自己的节奏,确认真正理解。