Qt para Linux - Construir desde el código fuente
Esta página describe la configuración y construcción de Qt para Linux desde el código fuente. Ten en cuenta que normalmente es más fácil instalar las librerías y herramientas precompiladas de Qt vía Qt Online Installer. Muchas distribuciones de Linux también proporcionan paquetes Qt a través de su gestor de paquetes. Construya Qt desde las fuentes, sin embargo, si desea personalizar Qt aún más o está usando una distribución para la que no hay paquetes binarios Qt (en la versión correcta) disponibles.
Los empaquetadores de distribuciones pueden encontrar más información sobre cómo empaquetar Qt en las recomendaciones de empaquetado.
Paso 1: Obtener las fuentes
Los fuentes de Qt pueden instalarse en Qt Online Installer. Los paquetes fuente también están disponibles a través de Git, como archivos en la Cuenta Qt (usuarios comerciales), y en download.qt.io (usuarios de código abierto).
Si instalas los fuentes a través de Qt Online Installer, estarán disponibles en el directorio de instalación de Qt, por ejemplo $HOME/Qt/6.11.0/Src.
Si ha descargado el archivo de código fuente único, extráigalo a un directorio de su elección:
cd /tmp tar xf ~/Downloads/qt-everywhere-src-6.11.0.tar.xz
Paso 2: Instalar los requisitos de compilación
La compilación de Qt requiere un entorno de compilación con herramientas, compiladores y paquetes de desarrollo.
Herramientas de compilación
| Herramienta | Versiones soportadas |
|---|---|
| CMake | Versión 3.22 y posteriores. |
| Ninja | - |
| Python | Versión 3 |
Nota: configure siempre utiliza el generador Ninja y la herramienta de compilación si hay un ejecutable ninja disponible. Ninja es multiplataforma, rico en funciones, eficaz y recomendado en todas las plataformas. El uso de otros generadores puede funcionar pero no está soportado oficialmente.
Compiladores y paquetes de desarrollo
Los siguientes compiladores y configuraciones están soportados en Qt 6.11:
| Distribución | Arquitectura | Compilador | Notas |
|---|---|---|---|
| Red Hat™ 8.6 | x86_64 | GCC 10 (conjunto de herramientas) | |
| Red Hat 8.8 | x86_64 | GCC 10 (conjunto de herramientas) | |
| Red Hat 8.10 | x86_64 | GCC 10 (conjunto de herramientas) | |
| Red Hat 9.2 | x86_64 | GCC 11 | |
| Red Hat 9.4 | x86_64 | GCC 11 | |
| Red Hat 9.6 | x86_64 | GCC 11 | |
| openSUSE 15.6 | x86_64 | GCC 9, GCC 10, GCC 11, GCC 12 | |
| SUSE Linux Enterprise Server 15 SP6 | x86_64 | GCC 11 | |
| Ubuntu 22.04 | x86_64 | GCC proporcionado por Canonical, GCC 11.x | Véase también: Paquetes Enterprise Qt para Debian. |
| Ubuntu 24.04 | x86_64, arm64 | GCC proporcionado por Canonical, GCC 13.x | Véase la nota relativa a la compatibilidad con Linux en escritorios Arm. |
| Debian 11.6 | x86_64, arm64 | GCC 10 | Consulte la nota relativa a la compatibilidad con escritorios Linux on Arm. |
| Debian 12 | x86_64, arm64 | GCC 12 | Vea también: Paquetes Debian Enterprise Qt. Consulte la nota sobre compatibilidad con escritorios Linux en Arm. |
Nota: Para Linux on Arm en ordenadores de sobremesa, utilizamos Raspberry Pi 5 con 8GB RAM y Ubuntu 24.04 como plataforma de referencia. Si tiene un problema con otro hardware, por favor intente reproducir el problema en Raspberry Pi 5. Planeamos pasar a un soporte de plataforma regular cuando esté disponible una gama más amplia de hardware de escritorio basado en ARM. Los binarios oficiales en Qt Online Installer se construyen en Ubuntu 24.04 que viene con glibc 2.39, si su glibc es anterior a lo que construimos con, es necesario reconstruir a partir de fuentes.
Otros compiladores y configuraciones podrían funcionar, pero no se han probado activamente.
Qt también depende de la disponibilidad de varias librerías y paquetes de desarrollo, que normalmente son instalados por el gestor de paquetes de la resolución respectiva. Ver Qt para Linux - Requisitos para más detalles.
Paso 3: Construir las librerías y herramientas Qt
Para configurar su compilación, cree un directorio de compilación y ejecute el script ./configure en este directorio:
mkdir -p ~/dev/qt-build cd ~/dev/qt-build /tmp/qt-everywhere-src-6.11.0/configure
Por defecto, Qt está configurado para instalarse en el directorio /usr/local/Qt-6.11.0. Esto puede cambiarse utilizando la opción -prefix. Consulte la lista de opciones de configuración para realizar más ajustes.
¿Se ha ejecutado correctamente configure? Entonces procede con la construcción de las librerías y herramientas:
cmake --build . --parallel
Después de la compilación, necesitas instalar las librerías y herramientas en el lugar apropiado (a menos que hayas habilitado una compilación para desarrolladores):
cmake --install .
Tenga en cuenta que esto puede requerir acceso root.
Paso 4: Construir tu aplicación
Una vez instalado Qt, puede empezar a crear aplicaciones con él.
Si trabaja desde la línea de comandos, considere añadir las herramientas Qt a su PATH predeterminado. Esto se hace de la siguiente manera:
En .profile (si tu shell es bash, ksh, zsh o sh), añade las siguientes líneas:
PATH=/usr/local/Qt-6.11.0/bin:$PATH export PATH
En .login (si tu shell es csh o tcsh), añade la siguiente línea:
setenv PATH /usr/local/Qt-6.11.0/bin:$PATH
Si planeas usar Qt desde un IDE, necesitas registrar la versión de Qt explícitamente allí. Para Qt Creator, ver Qt Creator: Añadir versiones de Qt.
© 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.
