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.
| Nom | Bibliothèque | Remarques | Options de configuration | Version minimale fonctionnelle |
|---|---|---|---|---|
| XRender | libXrender | Extension de rendu X ; utilisée pour l'anticrénelage et la prise en charge du curseur alpha | -xrender ou détectée automatiquement | 0.9.0 |
| xcb-render | libxcb-render | Liaisons X C pour l'extension Render | détecté automatiquement | 1.11 |
| xcb-render-util | libxcb-render-util | Bibliothèque d'utilitaires pour XCB pour l'extension Render | détecté automatiquement | 0.3.9 |
| xcb-shape | libxcb-shape | Liaisons XCB pour l’extension Shape | détecté automatiquement | 1.11 |
| xcb-randr | libxcb-randr | Liaisons C pour l'extension Resize et Rotate | détecté automatiquement | 1.11 |
| xcb-xfixes | libxcb-xfixes | Liaisons X C pour l'extension « Fixes » | détecté automatiquement | 1.11 |
| xcb-xkb | libxcb-xkb | Liaison C pour l'extension XKeyboard | détecté automatiquement | 1.11 |
| xcb-sync | libxcb-sync | Liaisons C pour l'extension Sync | détecté automatiquement | 1.11 |
| xcb-shm | libxcb-shm | Liaisons C pour l'extension de mémoire partagée | détecté automatiquement | 1.11 |
| xcb-icccm | libxcb-icccm | Liaisons C pour X relatives au protocole ICCCM | détecté automatiquement | 0.3.9 |
| xcb-keysyms | libxcb-keysyms | Bibliothèque d'utilitaires pour XCB permettant la conversion des codes de touches | détecté automatiquement | 0.3.9 |
| xcb-image | libxcb-image | Bibliothèque utilitaire pour XCB destinée à XImage et XShmImage, utilisée pour la prise en charge d'QBackingStore s et de curseurs | détecté automatiquement | 0.3.9 |
| xcb-util | libxcb-util | Bibliothèque d'utilitaires XCB pour atom, aux et event | détecté automatiquement | 0.3.9 |
| xcb-cursor0 | libxcb-cursor0 | Bibliothèque d'utilitaires XCB pour cursor | détecté automatiquement | 0.1.1 |
| xkbcommon | libxkbcommon | Gestion des plans de clavier | -xkbcommon ou détecté automatiquement | 0.9.0 |
| xkbcommon-x11 | libxkbcommon-x11 | Gestion des configurations de clavier | détecté automatiquement | 0.9.0 |
| Fontconfig | libfontconfig | Personnalisation et configuration des polices | -fontconfig ou détectée automatiquement | 2.6 |
| FreeType | libfreetype | Moteur de polices | 2.3.0 | |
| Xext | libXext | Extensions X | 6.4.3 | |
| X11 | libX11 | Bibliothèque côté client X11 | 6.2.1 | |
| xcb | libxcb | Bibliothèque de liaison X C | 1.11 | |
| X11-xcb | libX11-xcb | Bibliothèque d'interface Xlib/XCB | 1.3.2 | |
| SM | libSM | Gestion des sessions X | -sm ou détectée automatiquement | 6.0.4 |
| ICE | libICE | Échange inter-clients | -sm ou détection automatique | 6.3.5 |
| glib | libglib-2.0 | Gestion commune de la boucle d'événements | -glib ou détecté automatiquement | 2.8.3 |
| pthread | libpthread | Multithreading | 2.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-devCertains 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.