En esta página

API de CMake de Qt para HarmonyOS

Nota: La API de CMake de HarmonyOS se encuentra en fase de vista previa tecnológica y puede sufrir cambios en futuras versiones.

Esta página enumera los comandos de CMake, las propiedades de los objetivos y las variables que configuran cómo se empaqueta una aplicación Qt en un paquete de capacidades de HarmonyOS (HAP).

Al crear un ejecutable de Qt con `qt_add_executable() ` para HarmonyOS, Qt genera automáticamente un objetivo de compilación ` <target>_make_hap ` que produce el HAP. Los comandos, propiedades y variables que se indican a continuación controlan el contenido de dicho HAP y los metadatos que se escriben en los archivos de manifiesto de HarmonyOS.

Un paquete de aplicación de HarmonyOS se describe mediante dos tipos de manifiesto: el de nivel de aplicación app.json5, que contiene los metadatos aplicables a todo el paquete, y el de nivel de módulo module.json5, que describe un único módulo HAP dentro de dicho paquete. Las propiedades de destino que se indican a continuación reflejan esta división: las propiedades QT_HARMONYOS_APP_* establecen los metadatos a nivel de aplicación, como el proveedor, la versión, la etiqueta y el icono, mientras que propiedades como QT_HARMONYOS_MODULE_DESCRIPTION y QT_HARMONYOS_ABILITY_ORIENTATION establecen los metadatos a nivel de módulo. Consulte la sección «Propiedades del destino» más abajo para ver la lista completa.

Comandos

Propiedades del destino

Las siguientes propiedades de destino afectan a la forma en que se compila el HAP:

QT_HARMONYOS_ABILITY_ORIENTATION

La política de orientación de pantalla de la capacidad de HarmonyOS.

QT_HARMONYOS_APP_BUNDLE_NAME

El nombre del paquete de la aplicación de HarmonyOS.

QT_HARMONYOS_APP_ICON

El icono de la aplicación de HarmonyOS.

QT_HARMONYOS_APP_LABEL

La etiqueta de la aplicación de HarmonyOS.

QT_HARMONYOS_APP_NAME

El nombre de la aplicación de HarmonyOS.

QT_HARMONYOS_APP_VENDOR

El proveedor de la aplicación de HarmonyOS.

QT_HARMONYOS_APP_VERSION_CODE

El código de versión de la aplicación de HarmonyOS.

QT_HARMONYOS_APP_VERSION_NAME

El nombre de la versión de la aplicación HarmonyOS.

QT_HARMONYOS_COMPATIBLE_SDK_VERSION

La versión del SDK compatible con la aplicación HarmonyOS.

QT_HARMONYOS_COMPILE_SDK_VERSION

La versión del SDK de compilación de la aplicación de HarmonyOS.

QT_HARMONYOS_EXTRA_LIBS

Bibliotecas adicionales que se van a implementar con el destino HarmonyOS.

QT_HARMONYOS_EXTRA_PLUGINS

Complementos Qt adicionales para implementar con el destino HarmonyOS.

QT_HARMONYOS_MODULE_DESCRIPTION

La descripción del módulo de HarmonyOS.

QT_HARMONYOS_MODULE_DEVICE_TYPES

Los tipos de dispositivos compatibles con el módulo de HarmonyOS.

QT_HARMONYOS_PACKAGE_SOURCE_DIR

Ruta a una plantilla de paquete personalizada de HarmonyOS.

QT_HARMONYOS_TARGET_ARCHS

Las arquitecturas de destino de la aplicación de HarmonyOS.

QT_HARMONYOS_TARGET_SDK_VERSION

La versión del SDK de destino de la aplicación HarmonyOS.

Variables

Las siguientes variables influyen en la compilación del HAP:

© 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.