Qt para Linux - Requisitos
Dependencias del plugin de plataforma
En Linux, se utiliza el plugin de plataforma xcb QPA (Qt Platform Abstraction). Proporciona la funcionalidad básica que necesitan Qt GUI y Qt Widgets para ejecutarse en X11. Sus dependencias de biblioteca se describen en la siguiente tabla. Para compilar Qt desde su código fuente, también necesitarás instalar los paquetes de desarrollo de estas librerías para tu sistema.
| Nombre | Biblioteca | Notas | Opciones de configuración | Versión mínima de trabajo |
|---|---|---|---|---|
| XRender | libXrender | Extensión de renderizado X; se utiliza para antialiasing y soporte de cursor alfa | -xrender o autodetección | 0.9.0 |
| xcb-render | libxcb-render | X Enlaces C para la extensión de renderizado | detección automática | 1.11 |
| xcb-render-util | libxcb-render-util | Librería de utilidades para la extensión XCB for Render | auto-detectado | 0.3.9 |
| xcb-shape | libxcb-shape | X C Bindings para la extensión Shape | detección automática | 1.11 |
| xcb-randr | libxcb-randr | X C Bindings para la extensión Resize y Rotate | auto-detectado | 1.11 |
| xcb-xfixes | libxcb-xfixes | X C Bindings para la extensión Fixes | auto-detectado | 1.11 |
| xcb-xkb | libxcb-xkb | Extensión X C Bindings para XKeyboard | auto-detectado | 1.11 |
| xcb-sync | libxcb-sync | X C Bindings para extensión Sync | auto-detectado | 1.11 |
| xcb-shm | libxcb-shm | X C Bindings para Extensión de Memoria Compartida | auto-detectado | 1.11 |
| xcb-icccm | libxcb-icccm | X C Bindings para Protocolo ICCCM | auto-detectado | 0.3.9 |
| xcb-keysyms | libxcb-keysyms | Biblioteca de utilidades para XCB para la conversión de códigos de teclas | detección automática | 0.3.9 |
| xcb-image | libxcb-image | Librería utilitaria para XCB para XImage y XShmImage, usada para QBackingStore y soporte de cursor | autodetectado | 0.3.9 |
| xcb-util | libxcb-util | Librería de utilidades para XCB para atom, aux y event | auto-detectados | 0.3.9 |
| xcb-cursor0 | libxcb-cursor0 | Libreria utilitaria para XCB para cursor | auto-detectado | 0.1.1 |
| xkbcommon | libxkbcommon | Manejo de mapas de teclas | -xkbcommon o detección automática | 0.9.0 |
| xkbcommon-x11 | libxkbcommon-x11 | Manejo del mapa de teclas | detección automática | 0.9.0 |
| Fontconfig | libfontconfig | Personalización y configuración de fuentes | -fontconfig o detección automática | 2.6 |
| FreeType | libfreetype | Motor de fuentes | 2.3.0 | |
| Xext | libXext | Extensiones X | 6.4.3 | |
| X11 | libX11 | Librería cliente X11 | 6.2.1 | |
| xcb | libxcb | Biblioteca de enlace X C | 1.11 | |
| X11-xcb | libX11-xcb | Biblioteca de interfaz Xlib/XCB | 1.3.2 | |
| SM | libSM | Gestión de sesiones X | -sm o autodetectada | 6.0.4 |
| ICE | libICE | Intercambio entre clientes | -sm o autodetectado | 6.3.5 |
| glib | libglib-2.0 | Gestión de bucles de eventos comunes | -glib o autodetectado | 2.8.3 |
| pthread | libpthread | Multihilo | 2.3.5 |
Los paquetes de desarrollo de las bibliotecas anteriores contienen archivos de cabecera que se utilizan al compilar Qt a partir de su código fuente. Los nombres de los paquetes pueden diferir entre distribuciones de Linux, y algunas distribuciones pueden no incluir todos los paquetes en la configuración por defecto de su sistema de gestión de paquetes.
Como ejemplo, puede ejecutar el siguiente comando para instalar los paquetes recomendados en sistemas GNU/Linux basados en Debian:
apt install \
libfontconfig1-dev \
libfreetype-dev \
libgtk-3-dev \
libx11-dev \
libx11-xcb-dev \
libxcb-cursor-dev \
libxcb-glx0-dev \
libxcb-icccm4-dev \
libxcb-image0-dev \
libxcb-keysyms1-dev \
libxcb-randr0-dev \
libxcb-render-util0-dev \
libxcb-shape0-dev \
libxcb-shm0-dev \
libxcb-sync-dev \
libxcb-util-dev \
libxcb-xfixes0-dev \
libxcb-xkb-dev \
libxcb1-dev \
libxext-dev \
libxfixes-dev \
libxi-dev \
libxkbcommon-dev \
libxkbcommon-x11-dev \
libxrender-devAlgunos de estos paquetes dependen de otros de esta lista, por lo que la instalación de uno puede hacer que otros se instalen automáticamente. Otras distribuciones pueden proporcionar paquetes de sistema con nombres similares.
Qt no mantiene una lista completa de paquetes para todas las distribuciones. Algunas distribuciones, como Red Hat™ y sus derivados, pueden requerir repositorios adicionales para ciertos paquetes (por ejemplo, EPEL para RHEL). Consulte la documentación de su distribución para conocer los nombres específicos de los paquetes. Los usuarios de RHEL pueden ponerse en contacto con el soporte de Red Hat para obtener información detallada.
Dependencias de accesibilidad
La implementación de accesibilidad de Qt utiliza la Interfaz de Proveedor de Servicios de Tecnología Asistencial (AT-SPI). Además de DBUS, debe instalarse el paquete de desarrollo libatspi2.0-dev.
Dependencias de OpenGL
Configure los intentos de detectar automáticamente OpenGL ES 2.0, o posterior, u OpenGL de escritorio normal. Puede desactivar la compatibilidad con OpenGL mediante la opción -no-opengl.
Nota: El módulo Qt OpenGL (que contiene clases que empiezan por QGL) ha quedado obsoleto en favor del módulo Qt GUI (que contiene clases que empiezan por QOpenGL).
Dependencias de QDoc
QDoc utiliza Clang para analizar el código C++. Si desea compilar QDoc manualmente, consulte Instalar Clang para QDoc para conocer los requisitos específicos de compilación.
© 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.
