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
- qt_add_harmonyos_permission() añade un permiso de HarmonyOS a la aplicación.
Propiedades del destino
Las siguientes propiedades de destino afectan a la forma en que se compila el HAP:
La política de orientación de pantalla de la capacidad de HarmonyOS. | |
El nombre del paquete de la aplicación de HarmonyOS. | |
El icono de la aplicación de HarmonyOS. | |
La etiqueta de la aplicación de HarmonyOS. | |
El nombre de la aplicación de HarmonyOS. | |
El proveedor de la aplicación de HarmonyOS. | |
El código de versión de la aplicación de HarmonyOS. | |
El nombre de la versión de la aplicación HarmonyOS. | |
La versión del SDK compatible con la aplicación HarmonyOS. | |
La versión del SDK de compilación de la aplicación de HarmonyOS. | |
Bibliotecas adicionales que se van a implementar con el destino HarmonyOS. | |
Complementos Qt adicionales para implementar con el destino HarmonyOS. | |
La descripción del módulo de HarmonyOS. | |
Los tipos de dispositivos compatibles con el módulo de HarmonyOS. | |
Ruta a una plantilla de paquete personalizada de HarmonyOS. | |
Las arquitecturas de destino de la aplicación de HarmonyOS. | |
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.