Sur cette page

Qt pour Linux - Configuration requise

Dépendances des plugins de plateforme

Sous Linux, on utilise le plugin de plateforme xcb (Qt Platform Abstraction, ou QPA). Il fournit les fonctionnalités de base requises par Qt GUI et Qt Widgets pour fonctionner sous X11. Ses dépendances de bibliothèques sont décrites dans le tableau suivant. Pour compiler Qt à partir de son code source, vous devrez également installer les paquets de développement correspondant à ces bibliothèques sur votre système.

NomBibliothèqueRemarquesOptions de configurationVersion minimale fonctionnelle
XRenderlibXrenderExtension de rendu X ; utilisée pour l'anticrénelage et la prise en charge du curseur alpha-xrender ou détectée automatiquement0.9.0
xcb-renderlibxcb-renderLiaisons X C pour l'extension Renderdétecté automatiquement1.11
xcb-render-utillibxcb-render-utilBibliothèque d'utilitaires pour XCB pour l'extension Renderdétecté automatiquement0.3.9
xcb-shapelibxcb-shapeLiaisons XCB pour l’extension Shapedétecté automatiquement1.11
xcb-randrlibxcb-randrLiaisons C pour l'extension Resize et Rotatedétecté automatiquement1.11
xcb-xfixeslibxcb-xfixesLiaisons X C pour l'extension « Fixes »détecté automatiquement1.11
xcb-xkblibxcb-xkbLiaison C pour l'extension XKeyboarddétecté automatiquement1.11
xcb-synclibxcb-syncLiaisons C pour l'extension Syncdétecté automatiquement1.11
xcb-shmlibxcb-shmLiaisons C pour l'extension de mémoire partagéedétecté automatiquement1.11
xcb-icccmlibxcb-icccmLiaisons C pour X relatives au protocole ICCCMdétecté automatiquement0.3.9
xcb-keysymslibxcb-keysymsBibliothèque d'utilitaires pour XCB permettant la conversion des codes de touchesdétecté automatiquement0.3.9
xcb-imagelibxcb-imageBibliothèque utilitaire pour XCB destinée à XImage et XShmImage, utilisée pour la prise en charge d'QBackingStore s et de curseursdétecté automatiquement0.3.9
xcb-utillibxcb-utilBibliothèque d'utilitaires XCB pour atom, aux et eventdétecté automatiquement0.3.9
xcb-cursor0libxcb-cursor0Bibliothèque d'utilitaires XCB pour cursordétecté automatiquement0.1.1
xkbcommonlibxkbcommonGestion des plans de clavier-xkbcommon ou détecté automatiquement0.9.0
xkbcommon-x11libxkbcommon-x11Gestion des configurations de clavierdétecté automatiquement0.9.0
FontconfiglibfontconfigPersonnalisation et configuration des polices-fontconfig ou détectée automatiquement2.6
FreeTypelibfreetypeMoteur de polices2.3.0
XextlibXextExtensions X6.4.3
X11libX11Bibliothèque côté client X116.2.1
xcblibxcbBibliothèque de liaison X C1.11
X11-xcblibX11-xcbBibliothèque d'interface Xlib/XCB1.3.2
SMlibSMGestion des sessions X-sm ou détectée automatiquement6.0.4
ICElibICEÉchange inter-clients-sm ou détection automatique6.3.5
gliblibglib-2.0Gestion commune de la boucle d'événements-glib ou détecté automatiquement2.8.3
pthreadlibpthreadMultithreading2.3.5

Les paquets de développement pour les bibliothèques ci-dessus contiennent des fichiers d'en-tête utilisés lors de la compilation de Qt à partir de son code source. Les noms des paquets peuvent varier d'une distribution Linux à l'autre, et certaines distributions peuvent ne pas inclure tous les paquets dans la configuration par défaut de leur système de gestion de paquets.

À titre d'exemple, vous pouvez exécuter la commande suivante pour installer les paquets recommandés sur les systèmes GNU/Linux basés sur 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

Certains de ces paquets dépendent d’autres paquets de cette liste ; l’installation de l’un d’entre eux peut donc entraîner l’installation automatique d’autres paquets. D’autres distributions peuvent fournir des paquets système portant des noms similaires.

Qt ne tient pas à jour de liste exhaustive des paquets pour toutes les distributions. Certaines distributions, telles que Red Hat™ et ses dérivés, peuvent nécessiter des dépôts supplémentaires pour certains paquets (par exemple, EPEL pour RHEL). Consultez la documentation de votre distribution pour connaître les noms précis des paquets. Les utilisateurs de RHEL peuvent contacter le support Red Hat pour obtenir des informations détaillées.

Dépendances d'accessibilité

L’implémentation de l’accessibilité Qt utilise l’interface AT-SPI ( Assistive Technology Service Provider Interface ). Outre DBUS, le paquet de développement libatspi2.0-dev doit être installé.

Dépendances OpenGL

Configure tente de détecter automatiquement OpenGL ES 2.0 ou une version ultérieure, ou encore OpenGL de bureau standard. Vous pouvez désactiver la prise en charge d’OpenGL à l’aide de l’option -no-opengl.

Remarque : le module Qt OpenGL (qui contient des classes commençant par QGL) a été déprécié au profit du Qt GUI module (qui contient des classes commençant par QOpenGL).

Dépendances de QDoc

QDoc utilise Clang pour analyser le code C++. Si vous souhaitez compiler QDoc manuellement, consultez la section « Installation de Clang pour QDoc » pour connaître les exigences de compilation spécifiques.

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