Qt for HarmonyOS CMake API

This page lists the CMake commands, target properties, and variables that configure how a Qt application is packaged into a HarmonyOS Ability Package (HAP).

When you create a Qt executable with qt_add_executable() while targeting HarmonyOS, Qt automatically generates a <target>_make_hap build target that produces the HAP. The commands, properties, and variables below control the contents of that HAP and the metadata written into the HarmonyOS manifest files.

A HarmonyOS application bundle is described by two kinds of manifest: the application-level app.json5, which holds metadata that applies to the whole bundle, and the module-level module.json5, which describes a single HAP module within that bundle. The target properties below mirror this split: the QT_HARMONYOS_APP_* properties set application-level metadata, such as the vendor, version, label, and icon, while properties such as QT_HARMONYOS_MODULE_DESCRIPTION and QT_HARMONYOS_ABILITY_ORIENTATION set module-level metadata. See the Target Properties section below for the full list.

Commands

• qt_add_harmonyos_permission() adds a HarmonyOS permission to the application.

Target Properties

The following target properties affect how the HAP is built:

Variables

The following variables affect how the HAP is built: