Qt para HarmonyOS: compilación a partir del código fuente
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 configurar y compilar Qt para HarmonyOS a partir del código fuente.
Requisitos previos
Antes de continuar, asegúrate de cumplir todos los requisitos indicados en «Requisitos previos de Qt para HarmonyOS».
La compilación de Qt para HarmonyOS es una compilación cruzada: se compilan las bibliotecas de Qt para el destino HarmonyOS utilizando herramientas de compilación de una compilación de Qt del host compatible. Por lo tanto, primero necesitas una compilación de Qt para tu plataforma host. Para obtener información general sobre la compilación cruzada de Qt, consulta «Qt para la creación de dispositivos » y «Compilación cruzada de Qt».
Configuración y compilación
Configure Qt para HarmonyOS indicando al proceso de compilación el SDK de OpenHarmony y la compilación de Qt del sistema anfitrión:
configure -ohos-sdk <SDK_ROOT> -qt-host-path <HOST_QT_PATH> -ohos-arch arm64-v8a
cmake --build .Las opciones de configuración relevantes son:
-ohos-sdkestablece la ruta raíz del SDK de OpenHarmony. Si se omite,configureutiliza el valor de la variable de entornoOHOS_SDK_ROOT.-ohos-archestablece la arquitectura de destino. Utilicearm64-v8apara dispositivos físicos yx86_64para el emulador. Si se omite,configureselecciona una arquitectura basada en el SDK.-qt-host-pathEspecifica la ruta a la compilación del host de Qt utilizada para la compilación cruzada.
Instalación
Una vez finalizada la compilación, instala Qt para HarmonyOS:
cmake --install .Por defecto, Qt se instala en /usr/local/Qt-<version>. Indica la opción -prefix en configure para instalarlo en una ubicación diferente. La instalación resultante de Qt para HarmonyOS es la que se utiliza para compilar e implementar aplicaciones, tal y como se describe en «Compilación e implementación de aplicaciones Qt para HarmonyOS».
© 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.