En esta página

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.

NombreBibliotecaNotasOpciones de configuraciónVersión mínima necesaria
XRenderlibXrenderExtensión de renderizado X; se utiliza para el suavizado y la compatibilidad con el cursor alfa-xrender o detectada automáticamente0.9.0
xcb-renderlibxcb-renderEnlaces C de X para la extensión Renderdetectado automáticamente1.11
xcb-render-utillibxcb-render-utilBiblioteca de utilidades para XCB para la extensión Renderdetectado automáticamente0.3.9
xcb-shapelibxcb-shapeEnlaces XCB para la extensión Shapedetectado automáticamente1.11
xcb-randrlibxcb-randrEnlaces X C para la extensión «Resize and Rotate»detectado automáticamente1.11
xcb-xfixeslibxcb-xfixesEnlaces X C para la extensión «Fixes»detectado automáticamente1.11
xcb-xkblibxcb-xkbEnlaces C para la extensión XKeyboarddetectado automáticamente1.11
xcb-synclibxcb-syncEnlaces C de X para la extensión Syncdetectado automáticamente1.11
xcb-shmlibxcb-shmEnlaces X C para la extensión de memoria compartidadetectado automáticamente1.11
xcb-icccmlibxcb-icccmEnlaces C de X para el protocolo ICCCMdetectado automáticamente0.3.9
xcb-keysymslibxcb-keysymsBiblioteca de utilidades para XCB destinada a la conversión de códigos de teclasdetectado automáticamente0.3.9
xcb-imagelibxcb-imageBiblioteca de utilidades para XCB destinada a XImage y XShmImage, utilizada para el soporte de « QBackingStore » y del cursordetectado automáticamente0.3.9
xcb-utillibxcb-utilBiblioteca de utilidades para XCB destinada a atom, aux y eventDetectado automáticamente0.3.9
xcb-cursor0libxcb-cursor0Biblioteca de utilidades para XCB destinada a cursordetectado automáticamente0.1.1
xkbcommonlibxkbcommonGestión de mapas de teclas-xkbcommon o detección automática0.9.0
xkbcommon-x11libxkbcommon-x11Gestión de mapas de teclasdetección automática0.9.0
FontconfiglibfontconfigPersonalización y configuración de fuentes-fontconfig o detectado automáticamente2.6
FreeTypelibfreetypeMotor de fuentes2.3.0
XextlibXextExtensiones X6.4.3
X11libX11Biblioteca del lado del cliente de X116.2.1
xcblibxcbBiblioteca de enlaces X C1.11
X11-xcblibX11-xcbBiblioteca de interfaz Xlib/XCB1.3.2
SMlibSMGestión de sesiones X-sm o detectada automáticamente6.0.4
ICElibICEInter-Client Exchange-sm o detectado automáticamente6.3.5
gliblibglib-2.0Gestión común del bucle de eventos-glib o detectado automáticamente2.8.3
pthreadlibpthreadMultihilo2.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-dev

Algunos 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.