Compilación e implementación de aplicaciones Qt para HarmonyOS
Nota: Qt para HarmonyOS se encuentra en fase de vista previa tecnológica y puede sufrir cambios en futuras versiones.
Esta página describe cómo compilar y empaquetar una aplicación Qt para HarmonyOS, y cómo ejecutarla en un dispositivo o en el emulador.
Empaquetado en un HAP
Nota: Puedes compilar aplicaciones Qt para HarmonyOS tanto con CMake como con qmake, pero el empaquetado de una aplicación en un HAP y su implementación solo son compatibles con CMake.
Las aplicaciones de HarmonyOS se distribuyen como paquetes de capacidades de HarmonyOS (HAP). Cuando se crea un ejecutable de una aplicación Qt con qt_add_executable() y se selecciona HarmonyOS como destino, Qt genera automáticamente un objetivo de compilación « <target>_make_hap ». Al compilar ese objetivo se genera el HAP de la aplicación:
cmake --build . --target <target>_make_hapCómo funciona la implementación
El objetivo « <target>_make_hap » ejecuta harmonydeployqt, la herramienta de implementación de HarmonyOS. Sigue el mismo enfoque que androiddeployqt: recopila la biblioteca compartida de la aplicación, el complemento de la plataforma HarmonyOS (libqohos.so), los módulos de Qt necesarios y, en el caso de las aplicaciones « Qt Quick », los módulos QML, y los coloca en una plantilla de aplicación de HarmonyOS. A continuación, invoca la herramienta de compilación de OpenHarmony hvigor para ensamblar el HAP final.
Para configurar los metadatos que se escriben en los manifiestos de HarmonyOS (app.json5 y module.json5) y para declarar permisos, utiliza los comandos descritos en la API de CMake de Qt para HarmonyOS.
Ejecución de la aplicación
Instala y ejecuta el HAP resultante en un dispositivo HarmonyOS conectado o en el emulador. La forma más cómoda de implementar y depurar es abrir el proyecto generado en DevEco Studio y utilizar sus herramientas de ejecución y depuración.
© 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.