En esta página

Compilación cruzada de Qt

Esta página describe el proceso general y los requisitos para la compilación cruzada de Qt.

Si solo buscas una forma de compilar Qt en el sistema host, consulta Creación de la compilación de Qt en el sistema host.

Términos y definiciones

La compilación cruzada consiste en configurar y compilar para una plataforma de destino diferente de tu plataforma de host.

El host es el ordenador en el que estás compilando Qt, por ejemplo, una máquina Linux. El destino es el dispositivo para el que estás compilando Qt, por ejemplo, una tableta Android.

Al compilar Qt, se ejecutan varias herramientas que generan código o realizan algún otro tipo de procesamiento. Estas herramientas se ejecutan en el host y, por lo tanto, se denominan «herramientas del host». Estas herramientas del host forman parte de una compilación de Qt para el host. Esta compilación para el host debe prepararse como requisito previo para compilar Qt para la plataforma de destino.

Una compilación mínima de Qt para el host es una compilación de Qt para el host que solo contiene las herramientas de host necesarias para crear una compilación de Qt para la plataforma de destino.

Qt se compila con CMake, y CMake necesita un archivo de cadena de herramientas al realizar una compilación cruzada. Este archivo contiene información sobre la plataforma de destino y la cadena de herramientas utilizada. Consulta la documentación de CMake sobre compilación cruzada.

Para algunas plataformas de destino, el script de configuración de Qt selecciona automáticamente el archivo. Consulte la documentación específica de la plataforma de destino deseada para obtener más detalles.

Para algunas plataformas de destino, es necesario especificar un sysroot. Se trata de un entorno autónomo que incluye todos los archivos y bibliotecas necesarios para compilar y enlazar aplicaciones.

Notas generales sobre la compilación de Qt en el host

Durante la compilación de Qt para la plataforma de destino, se invocan desde allí herramientas como moc, rcc, qmlcachegen, qsb y otras. Por ejemplo, si se realiza una compilación cruzada para ARM en una máquina x64, primero debe disponerse de una compilación local x64 de la misma versión de Qt. La ruta a esta compilación de Qt se pasará a configure o cmake. La compilación de Qt en el host suele ser una compilación normal de Qt para tu dispositivo host.

La compilación de Qt en el host debe contener todas las herramientas necesarias del host para compilar Qt para la plataforma de destino. Por ejemplo, si se supone que el Qt de destino debe ser compatible con Qt Quick, el Qt del host debe contener qsb, el compilador de shaders. Una forma sencilla de asegurarse de que el Qt del host proporciona todas las herramientas necesarias es compilar en el host los mismos módulos de Qt que necesitarás en el destino.

Evita compilar el Qt del host de forma estática si el Qt de destino se compila como compartido. Es posible que una compilación estática de Qt no contenga todas las herramientas necesarias para compilar un Qt compartido.

Asegúrate de utilizar la misma versión de Qt tanto para el Qt de origen como para el de destino, a fin de evitar problemas de incompatibilidad.

Creación de la compilación de Qt para el host

Consulta la documentación del host deseado para obtener detalles sobre cómo compilar Qt para esa plataforma.

Para compilar un Qt de host mínimo, utiliza el siguiente comando de compilación tras configurar Qt:

mkdir ~/QtHostBuild
cd ~/QtHostBuild
~/QtSource/configure -developer-build -nomake tests
cmake --build . --target host_tools

Esta compilación no será adecuada para desarrollar programas Qt para tu plataforma de host, pero contendrá las herramientas necesarias para realizar una compilación cruzada de Qt.

Especificación de la compilación de Qt para la plataforma de origen al realizar una compilación cruzada

Al realizar una compilación cruzada, debes indicar al Qt de destino la ubicación del Qt del sistema host.

Al utilizar el script «configure», se utiliza

~/QtSource/configure -qt-host-path ~/QtHostBuild ...target-specific options...

Si se utiliza CMake directamente, se utiliza

cmake -S ~/QtSource -DQT_HOST_PATH=~/QtHostBuild ...target-specific options...

Consulte la documentación del destino deseado para conocer las opciones específicas de cada destino.

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