En esta página

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:

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 QtDescripción
-staticGenera 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.
-ltcgLa 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-exportsReduce la cantidad de símbolos exportados.
-gc-binariesElimina 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,qtsvgSubmódulos que se van a compilar. Limita las dependencias a las características innecesarias.
-skip qtlanguageserver,qtquicktimelineElimina 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 compiladorDescripció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-tablesReduce 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-tablesReduce 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 « -fno-unwind-tables » es una versión más agresiva de « -fno-asynchronous-unwind-tables », ya que desactiva por completo la creación de tablas de desenrollado, mientras que esta última solo desactiva la generación asíncrona de dichas tablas.

-fomit-frame-pointerReduce 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-exceptionsReduce 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-pieReduce 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 enlazadorDescripción
-no-pieReduce 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:

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.