Compilación de una versión optimizada de Qt
Esta página describe el proceso para configurar y compilar una versión más ligera y adaptada de Qt, según tus necesidades específicas.
Paso 1: Obtener los códigos fuente, instalar los requisitos de compilación y configurar el entorno
Para obtener los códigos fuente, instalar las dependencias y configurar el entorno, consulta las instrucciones específicas para cada plataforma:
- Qt para Windows: compilación a partir del código fuente
- Qt para macOS: compilación a partir del código fuente
- Qt para Linux: compilación a partir del código fuente
- Configuración de un dispositivo Linux embebido
- Qt para Android: compilación a partir del código fuente
- Qt para iOS: compilación a partir del código fuente
Paso 2: Compilación de las bibliotecas y herramientas de Qt
Sigue las instrucciones específicas de tu plataforma y utiliza las siguientes opciones de configuración de Qt para crear una compilación optimizada para tus necesidades.
La siguiente tabla describe con más detalle las opciones de configuración que ayudan a reducir el tamaño de la compilación.
| Opción de configuración de Qt | Descripción |
|---|---|
| -static | Genera archivos comprimidos para la vinculación estática. Un binario estático se enlaza con todas las bibliotecas y dependencias necesarias incrustadas en el propio archivo ejecutable. Esto significa que, al ejecutar el programa, este utiliza su propia copia interna de las bibliotecas necesarias, en lugar de depender de otras externas. Esto permite al enlazador eliminar partes innecesarias del código binario. Es la solución más óptima para distribuciones con un único ejecutable. |
| -ltcg | La optimización en tiempo de enlace (LTO) es una potente técnica que puede mejorar significativamente el rendimiento y reducir el tamaño del archivo ejecutable mediante el análisis y la optimización del código binario en la fase de enlace. |
| -reduce-exports | Reduce la cantidad de símbolos exportados. |
| -gc-binaries | Elimina partes innecesarias del binario. Coloca cada función o elemento de datos en su propia sección y habilita la recolección de basura del enlazador para las secciones no utilizadas. |
| -submodules qtbase,qtdeclarative,qtqmlscriptcompiler,qtsvg | Submódulos que se van a compilar. Limita las dependencias a las características innecesarias. |
| -skip qtlanguageserver,qtquicktimeline | Elimina de la compilación los submódulos incluidos automáticamente. Limita las dependencias a las características que no sean necesarias. |
| -disable-deprecated-up-to <versión> | Elimina la implementación obsoleta. Establece el valor de « QT_DISABLE_DEPRECATED_UP_TO » en <versión>. « QT_DISABLE_DEPRECATED_UP_TO » se utiliza para eliminar métodos obsoletos tanto de la API como de la ABI. <versión> es un valor hexadecimal. Por ejemplo, utiliza 0x070000 para eliminar todo el código obsoleto en Qt 7.0.0 o versiones anteriores. Por defecto, <versión> se establece en 0x040000 y 0x050000 en Windows y en sistemas distintos de Windows, respectivamente. |
Además, puedes eliminar características una por una tal y como se describe en «Incluir o excluir características». Esto puede suponer restricciones en los componentes y funcionalidades disponibles. No se han probado todas las combinaciones. Qt Test combina opciones mínimas específicas de configuración en el sistema de integración continua (CI); prueba una configuración de Linux embebido muy minimizada y configuraciones ligeramente menos minimizadas para otras plataformas. Estas configuraciones están pensadas para ejecutar aplicaciones Quick.
El comando `configure` de Qt también admite el parámetro de línea de comandos ` -- ` (doble guión), que permite al usuario introducir argumentos CMake adicionales, como `-DCMAKE_CXX_FLAGS="-march=native"`. En caso de compilación cruzada, estos parámetros se pueden añadir mediante -DCMAKE_TOOLCHAIN_FILE=ruta/a/toolchain.cmake, tal y como se describe en «Un ejemplo de archivo de cadena de herramientas». La siguiente tabla enumera algunas opciones que puedes considerar utilizar con GCC:
| Opción del compilador | Descripción |
|---|---|
| -march <arch> | Arquitectura de destino. Utilice «native» si la aplicación se ejecuta en la misma arquitectura en la que se compila. |
| -mtune <tune> | Indica al compilador que genere código que aproveche las características de la arquitectura del procesador especificada, como su conjunto de instrucciones, el número de registros y la jerarquía de caché. |
| -fno-asynchronous-unwind-tables | Reduce el tamaño del binario. Ten en cuenta que desactivar las tablas de desenrollado asíncronas puede afectar al rendimiento, la compatibilidad y la facilidad de mantenimiento de tu código. Por lo general, se recomienda utilizar esta opción solo cuando sea necesario, tras considerar cuidadosamente sus posibles efectos. |
| -fno-unwind-tables | Reduce el tamaño del binario. Ten en cuenta que desactivar las tablas de desenrollado puede afectar al rendimiento, la compatibilidad y la facilidad de mantenimiento de tu código. Por lo general, se recomienda utilizar esta opción solo cuando sea necesario, tras considerar detenidamente sus posibles efectos. Cabe señalar que « |
| -fomit-frame-pointer | Reduce el tamaño del binario. Cuando se activa esta opción, el compilador no almacena un puntero de marco en la pila para cada llamada a función. En su lugar, utiliza el puntero de pila como puntero de marco, lo que puede ahorrar memoria y mejorar el rendimiento. Cabe señalar que algunos compiladores, como GCC y Clang, activan « -fomit-frame-pointer » de forma predeterminada al compilar para determinadas arquitecturas, como ARM y PowerPC, o en ciertos modos de optimización. |
| -fno-exceptions | Reduce el tamaño del binario. Cuando se activa esta opción, el compilador no genera código para los bloques try-catch, y cualquier intento de lanzar o capturar excepciones da lugar a errores en tiempo de ejecución. Qt funciona sin excepciones, pero algunas dependencias pueden requerirlas. |
| -no-pie | Reduce el tamaño del binario. En general, la opción « -fno-pie » debe utilizarse con precaución y solo cuando sea necesario, ya que puede afectar a la compatibilidad y al rendimiento del código compilado. Los ejecutables independientes de la posición también aportan seguridad. Para obtener más información sobre el código independiente de la posición, consulta el artículo «Randomización de la disposición del espacio de direcciones» en Wikipedia. |
La siguiente tabla enumera las opciones del enlazador:
| Opción del enlazador | Descripción |
|---|---|
| -no-pie | Reduce el tamaño del binario. En general, la opción « -fno-pie » debe utilizarse con precaución y solo cuando sea necesario, ya que puede afectar a la compatibilidad y al rendimiento del código compilado. Los ejecutables independientes de la posición también aportan seguridad. Para obtener más información sobre el código independiente de la posición, consulta el artículo «Aleatorización de la disposición del espacio de direcciones» en Wikipedia. |
Paso 3: Compilación de la aplicación
Una vez instalado Qt, puedes empezar a compilar aplicaciones con él.
Optimiza la generación de código QML con los comandos de proyecto de CMake. Para obtener más información sobre la generación de código QML, consulta qt_add_qml_module y «Prácticas recomendadas para QML y Qt Quick ».
El comando del siguiente fragmento de código de CMake reduce el tamaño del binario:
set_target_properties(
ExampleApp
PROPERTIES
QT_QMLCACHEGEN_ARGUMENTS "--only-bytecode"
)Si tiene previsto compilar su aplicación desde un IDE, deberá registrar allí explícitamente la versión de Qt:
- Para Qt Creator, consulta Qt Creator: Añadir versiones de Qt.
- Para Qt Extension for Visual Studio Code, consulta Qt Extension for Visual Studio Code: Registrar instalaciones de Qt.
Si utiliza la línea de comandos para compilar su aplicación, siga la guía específica de su plataforma.
© 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.