桌面应用 / 系统课时

准备 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 应用才具备交付条件。

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

目录与阅读设置

阅读设置

17

记录一个想法

准备 macOS 与 Linux 发布包

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

登录哪都通