harmonydeployqt 工具

为 HarmonyOS 打包 Qt 应用程序涉及许多步骤，因此 Qt 提供了一个工具来为您处理这些工作。构建 CMake 的 `<target>_make_hap ` 目标会自动运行 `harmonydeployqt `，因此通常无需手动调用该命令。完整的打包和部署流程请参阅《构建和部署 HarmonyOS 的 Qt 应用程序》。

工作原理

与androiddeployqt 类似，harmonydeployqt 会收集应用程序运行所需的所有内容，并生成一个可部署的包：

• 它会收集应用程序的共享库、HarmonyOS 平台插件（libqohos.so ）、所需的 Qt 模块和插件，以及针对Qt Quick 应用程序的 QML 模块。
• 它将这些内容与通过Qt for HarmonyOS CMake API 声明的元数据和权限一起放入 HarmonyOS 应用程序模板中。
• 它调用 OpenHarmonyhvigor 构建工具，以组装最终的 HarmonyOS 能力包（HAP）。

驱动此过程的设置将通过一个 JSON 配置文件传递给该工具，该文件由 CMake 构建过程为您自动生成。

命令行参数

唯一的必填参数是--input 。通过向harmonydeployqt 传递--help ，也可获取以下列表。

对 HAP 进行签名

HAP必须经过签名才能安装到设备上。您可以通过命令行参数或相应的环境变量提供签名材料。当两者都提供时，该字段将优先采用命令行参数。

密码必须是hvigor-encrypted 格式的二进制数据块，而非明文。签名操作采用“全有或全无”原则：如果设置了任何签名输入，则必须提供全部六个必填值（证书、配置文件、密钥库、密钥别名、密钥密码和密钥库密码）。否则，HAP将保持未签名状态。

运行应用程序

在已连接的 HarmonyOS 设备或模拟器上安装并运行生成的 HAP。部署和调试的最便捷方式是在DevEco Studio中打开生成的项目，并使用其运行和调试工具。

有关为 HarmonyOS 打包和部署 Qt 应用程序的更多信息，请参阅《构建和部署 HarmonyOS 的 Qt 应用程序》。