API CMake de Qt pour HarmonyOS

Remarque : l'API CMake HarmonyOS est en préversion technologique et est susceptible d'évoluer dans les prochaines versions.

Cette page répertorie les commandes CMake, les propriétés de cible et les variables qui permettent de configurer la manière dont une application Qt est intégrée dans un HarmonyOS Ability Package (HAP).

Lorsque vous créez un exécutable Qt à l’aide de `qt_add_executable()` en ciblant HarmonyOS, Qt génère automatiquement une cible de compilation ` <target>_make_hap ` qui produit le HAP. Les commandes, propriétés et variables ci-dessous contrôlent le contenu de ce HAP ainsi que les métadonnées écrites dans les fichiers de manifeste HarmonyOS.

Un ensemble d’applications HarmonyOS est décrit par deux types de manifestes : le manifeste au niveau de l’application app.json5, qui contient les métadonnées s’appliquant à l’ensemble du paquet, et le manifeste au niveau du module module.json5, qui décrit un module HAP unique au sein de ce paquet. Les propriétés de cible ci-dessous reflètent cette distinction : les propriétés QT_HARMONYOS_APP_* définissent les métadonnées au niveau de l’application, telles que le fournisseur, la version, le libellé et l’icône, tandis que des propriétés telles que QT_HARMONYOS_MODULE_DESCRIPTION et QT_HARMONYOS_ABILITY_ORIENTATION définissent les métadonnées au niveau du module. Consultez la section « Propriétés de la cible » ci-dessous pour obtenir la liste complète.

Commandes

qt_add_harmonyos_permission() ajoute une autorisation HarmonyOS à l’application.

Propriétés de la cible

Les propriétés de cible suivantes influencent la manière dont le HAP est construit :

QT_HARMONYOS_ABILITY_ORIENTATION	La politique d'orientation de l'écran de la capacité HarmonyOS.
QT_HARMONYOS_APP_BUNDLE_NAME	Le nom du bundle de l’application HarmonyOS.
QT_HARMONYOS_APP_ICON	L'icône de l'application HarmonyOS.
QT_HARMONYOS_APP_LABEL	Le libellé de l'application HarmonyOS.
QT_HARMONYOS_APP_NAME	Le nom de l'application HarmonyOS.
QT_HARMONYOS_APP_VENDOR	Le fournisseur de l'application HarmonyOS.
QT_HARMONYOS_APP_VERSION_CODE	Le code de version de l’application HarmonyOS.
QT_HARMONYOS_APP_VERSION_NAME	Le nom de la version de l'application HarmonyOS.
QT_HARMONYOS_COMPATIBLE_SDK_VERSION	La version SDK compatible avec l'application HarmonyOS.
QT_HARMONYOS_COMPILE_SDK_VERSION	La version du SDK de compilation de l'application HarmonyOS.
QT_HARMONYOS_EXTRA_LIBS	Bibliothèques supplémentaires à déployer avec la cible HarmonyOS.
QT_HARMONYOS_EXTRA_PLUGINS	Plugins Qt supplémentaires à déployer avec la cible HarmonyOS.
QT_HARMONYOS_MODULE_DESCRIPTION	La description du module HarmonyOS.
QT_HARMONYOS_MODULE_DEVICE_TYPES	Les types d'appareils pris en charge par le module HarmonyOS.
QT_HARMONYOS_PACKAGE_SOURCE_DIR	Chemin d'accès à un modèle de paquet HarmonyOS personnalisé.
QT_HARMONYOS_TARGET_ARCHS	Les architectures cibles de l'application HarmonyOS.
QT_HARMONYOS_TARGET_SDK_VERSION	La version SDK cible de l'application HarmonyOS.

Variables

Les variables suivantes ont une incidence sur la manière dont le HAP est compilé :

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.