Cambios en el sistema de compilación de Qt 6
Gran parte del trabajo realizado en Qt 6 estuvo relacionado con la forma en que se compilan Qt y sus módulos. El objetivo era preparar Qt para el futuro mediante la adopción de una herramienta de compilación popular y ampliamente utilizada: CMake.
Compilación de Qt a partir del código fuente
El sistema de compilación de Qt 5 se basaba en qmake. En Qt 6, hemos migrado el sistema de compilación a CMake.
Nota: Esto solo afecta a los usuarios que deseen compilar Qt a partir del código fuente. Sigues pudiendo utilizar qmake como herramienta de compilación para tus aplicaciones.
Es posible configurar Qt directamente desde la línea de comandos ejecutando cmake. Sin embargo, seguimos recomendando la herramienta de línea de comandos configure, que ofrece una interfaz posiblemente más intuitiva y una comprobación de errores adicional.
Consulta también Opciones de configuración de Qt para obtener una visión general de la nueva API de «configure».
CMake y Ninja como dependencias externas
Se necesita una versión reciente de CMake para configurar y compilar Qt. Para Qt 6.0, se requiere CMake 3.16. A partir de Qt 6.2, se requiere CMake 3.21 al compilar Qt como bibliotecas estáticas. A partir de Qt 6.6, se requiere CMake 3.21.1 al compilar Qt para plataformas de Apple. A partir de Qt 6.9, se requiere CMake 3.22. A partir de Qt 6.12, se requiere CMake 3.25. También debe tener instalada una versión actualizada de la herramienta Ninja.
Tanto CMake como Ninja son herramientas de código abierto que se pueden instalar de diversas formas. También están disponibles en Qt Online Installer.
Consulte «Compilación de los fuentes de Qt » para obtener una descripción más detallada de los requisitos de compilación en diferentes plataformas.
Selección de una licencia de Qt
En Qt 5, el programa «configure» te obligaba a seleccionar si tenías previsto utilizar Qt bajo licencias comerciales o de código abierto. Si disponías de varias licencias comerciales, también tenías que seleccionar la licencia que deseabas utilizar.
En Qt 6 hemos eliminado ambas opciones. La elección de las licencias disponibles depende de los contratos legales que tengas con The Qt Company, no de ningún artefacto.
Las opciones de «configure» -opensource, -commercial y -confirm-license se ignoran en Qt 6 y podrían eliminarse en futuras versiones de Qt.
Volver a ejecutar `configure`
A veces es conveniente volver a ejecutar «configure» para probar diferentes opciones. En Qt 5, «configure» almacenaba en caché diversa información del entorno entre ejecuciones, pero por lo demás partía de un estado limpio: había que utilizar la opción -redo o el script de shell config.status para reutilizar los argumentos de una ejecución anterior. También se podían utilizar las opciones -recheck y -recheck-all para forzar una reevaluación de las pruebas almacenadas en caché.
CMake y, por lo tanto, «configure» en Qt 6 almacenan en caché los resultados de forma aún más agresiva. La configuración del entorno detectada, así como las selecciones realizadas mediante otros argumentos de línea de comandos, se almacenan en un archivo llamado CMakeCache.txt. Si ejecutas «configure» con nuevas opciones, estas se fusionan en este archivo. Elimina el archivo para empezar desde cero. Las opciones de «configure» mencionadas anteriormente ya no son compatibles.
Compilación de solo algunas partes de Qt
El sistema de compilación de Qt 5 permitía ejecutar la herramienta de compilación (por ejemplo, make) en un subdirectorio para realizar una recompilación parcial.
CMake sigue un paradigma diferente y requiere que se compilen los objetivos desde el directorio de nivel superior, teniendo en cuenta toda la compilación. Utilice «ninja -t targets» para ver todos los objetivos disponibles en la compilación.
Resolución de bibliotecas de terceros
Una de las tareas de `configure` es detectar la disponibilidad de diferentes paquetes de terceros en el entorno. En Qt 5, `configure` utilizaba opcionalmente `pkg-config` para ello, pero también recurría a diversas comprobaciones en tiempo de compilación. Estas comprobaciones podían ajustarse desde la línea de comandos mediante diversas asignaciones como `ICU_PREFIX`, `ICU_LIBS`, etc.
En Qt 6, `configure` se basa en CMake para resolver las dependencias. Para la mayoría de las dependencias, esto requiere que la biblioteca de terceros proporcione un paquete de CMake en la ruta de búsqueda de CMake. Puedes utilizar la variable ` CMAKE_PREFIX_PATH ` para ampliar esta ruta con ubicaciones personalizadas.
Algunas dependencias, como OpenSSL, también se detectan mediante la lógica interna de CMake: si OpenSSL no se detecta, es posible que tengas que configurar la variable de CMake ` OPENSSL_ROOT_DIR ` para que apunte al directorio de instalación.
Selección de la cadena de herramientas
En Qt 5, configure utilizaba los denominados mkspecs para especificar tanto la plataforma de compilación como las plataformas de destino (opciones-platform, -xplatform y -device ). CMake no los utiliza, sino que se basa en comprobaciones del entorno y en archivos de cadena de herramientas (véase también la documentación sobre cadenas de herramientas de CMake). Las opciones -platform y -xplatform siguen estando disponibles, pero solo se utilizan para establecer los valores predeterminados de la herramienta qmake generada.
Compilación cruzada de Qt
La compilación cruzada consiste en compilar código para un sistema informático (el de destino) en otro sistema diferente (el de origen). Un entorno de compilación para aplicaciones Qt requiere que las herramientas de Qt estén disponibles en el sistema de origen (como moc o rcc), así como que las bibliotecas de Qt se compilen para el sistema de destino.
En Qt 5, configure permitía compilar tanto las herramientas del host como las del destino y las bibliotecas en un solo paso. En Qt 6, esto ya no es compatible. En su lugar, es necesario tener Qt instalado y en ejecución en el sistema anfitrión antes de poder realizar la compilación cruzada de Qt para el sistema de destino. Además, la versión de Qt instalada debe ser la misma que la que se va a compilar de forma cruzada.
Para obtener más detalles sobre la compilación cruzada, consulta «Configurar un dispositivo Linux embebido», «Qt para Android: compilación a partir del código fuente» y «Qt para iOS: compilación a partir del código fuente».
Portar complementos de Qt y bibliotecas adicionales
Aunque qmake sigue siendo compatible para compilar aplicaciones Qt, ya no se puede utilizar para compilar complementos Qt personalizados ni bibliotecas que dependan de componentes internos del sistema de compilación de Qt 5. Dichas bibliotecas o complementos deben portarse a CMake para poder utilizarlos con Qt 6.
En el momento del lanzamiento de Qt 6.0, la API para compilar complementos o bibliotecas personalizadas de Qt se encuentra aún en fase de vista previa técnica, lo que significa que podría sufrir cambios en futuras versiones. Se pondrá a disposición una API pública estable en una versión posterior de Qt 6.
Temas relacionados
- Cambios en los módulos de Qt en Qt 6: una lista de los cambios en la API de los módulos de Qt
- Cambios en los módulos compatibles: estado de los módulos de Qt 5 en Qt 6.0
- Compatibilidad entre Qt 5 y Qt 6: creación de aplicaciones tanto con Qt 5 como con Qt 6
© 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.