Qt para Linux: requisitos
Dependencias del complemento de plataforma
En Linux se utiliza el complemento de plataforma xcb QPA (Qt Platform Abstraction). Este proporciona la funcionalidad básica que necesita Qt GUI y Qt Widgets para que funcionen con X11. Sus dependencias de bibliotecas se describen en la siguiente tabla. Para compilar Qt a partir de su código fuente, también tendrás que instalar los paquetes de desarrollo de estas bibliotecas para tu sistema.
| Nombre | Biblioteca | Notas | Opciones de configuración | Versión mínima necesaria |
|---|---|---|---|---|
| XRender | libXrender | Extensión de renderizado X; se utiliza para el suavizado y la compatibilidad con el cursor alfa | -xrender o detectada automáticamente | 0.9.0 |
| xcb-render | libxcb-render | Enlaces C de X para la extensión Render | detectado automáticamente | 1.11 |
| xcb-render-util | libxcb-render-util | Biblioteca de utilidades para XCB para la extensión Render | detectado automáticamente | 0.3.9 |
| xcb-shape | libxcb-shape | Enlaces XCB para la extensión Shape | detectado automáticamente | 1.11 |
| xcb-randr | libxcb-randr | Enlaces X C para la extensión «Resize and Rotate» | detectado automáticamente | 1.11 |
| xcb-xfixes | libxcb-xfixes | Enlaces X C para la extensión «Fixes» | detectado automáticamente | 1.11 |
| xcb-xkb | libxcb-xkb | Enlaces C para la extensión XKeyboard | detectado automáticamente | 1.11 |
| xcb-sync | libxcb-sync | Enlaces C de X para la extensión Sync | detectado automáticamente | 1.11 |
| xcb-shm | libxcb-shm | Enlaces X C para la extensión de memoria compartida | detectado automáticamente | 1.11 |
| xcb-icccm | libxcb-icccm | Enlaces C de X para el protocolo ICCCM | detectado automáticamente | 0.3.9 |
| xcb-keysyms | libxcb-keysyms | Biblioteca de utilidades para XCB destinada a la conversión de códigos de teclas | detectado automáticamente | 0.3.9 |
| xcb-image | libxcb-image | Biblioteca de utilidades para XCB destinada a XImage y XShmImage, utilizada para el soporte de « QBackingStore » y del cursor | detectado automáticamente | 0.3.9 |
| xcb-util | libxcb-util | Biblioteca de utilidades para XCB destinada a atom, aux y event | Detectado automáticamente | 0.3.9 |
| xcb-cursor0 | libxcb-cursor0 | Biblioteca de utilidades para XCB destinada a cursor | detectado automáticamente | 0.1.1 |
| xkbcommon | libxkbcommon | Gestión de mapas de teclas | -xkbcommon o detección automática | 0.9.0 |
| xkbcommon-x11 | libxkbcommon-x11 | Gestión de mapas de teclas | detección automática | 0.9.0 |
| Fontconfig | libfontconfig | Personalización y configuración de fuentes | -fontconfig o detectado automáticamente | 2.6 |
| FreeType | libfreetype | Motor de fuentes | 2.3.0 | |
| Xext | libXext | Extensiones X | 6.4.3 | |
| X11 | libX11 | Biblioteca del lado del cliente de X11 | 6.2.1 | |
| xcb | libxcb | Biblioteca de enlaces 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 detectada automáticamente | 6.0.4 |
| ICE | libICE | Inter-Client Exchange | -sm o detectado automáticamente | 6.3.5 |
| glib | libglib-2.0 | Gestión común del bucle de eventos | -glib o detectado automáticamente | 2.8.3 |
| pthread | libpthread | Multihilo | 2.3.5 |
Los paquetes de desarrollo de las bibliotecas mencionadas contienen archivos de cabecera que se utilizan al compilar Qt a partir de su código fuente. Los nombres de los paquetes pueden variar según la distribución de Linux, y es posible que algunas distribuciones no incluyan todos los paquetes en la configuración predeterminada de su sistema de gestión de paquetes.
A modo de ejemplo, puedes 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 al instalar uno es posible que se instalen automáticamente otros. Es posible que otras distribuciones ofrezcan paquetes del sistema con nombres similares.
Qt no mantiene una lista exhaustiva de paquetes para todas las distribuciones. Algunas distribuciones, como Red Hat™ y sus derivadas, pueden requerir repositorios adicionales para determinados paquetes (p. ej., EPEL para RHEL). Consulta la documentación de tu distribución para conocer los nombres específicos de los paquetes. Los usuarios de RHEL pueden ponerse en contacto con el servicio de asistencia 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 Asistiva (AT-SPI). Además de DBUS, debe instalarse el paquete de desarrollo libatspi2.0-dev.
Dependencias de OpenGL
Configure intenta detectar automáticamente OpenGL ES 2.0 o posterior, o bien OpenGL de escritorio estándar. Puede desactivar la compatibilidad con OpenGL utilizando la opción « -no-opengl ».
Nota: El módulo Qt OpenGL (que contiene clases que comienzan por QGL) ha quedado obsoleto en favor del Qt GUI módulo (que contiene clases que comienzan por QOpenGL).
Dependencias de QDoc
QDoc utiliza Clang para analizar el código C++. Si deseas compilar QDoc manualmente, consulta «Instalación de 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.