Qt pour Linux - Exigences
Dépendances du plugin de plateforme
Sous Linux, le plugin de plateforme xcb QPA (Qt Platform Abstraction) est utilisé. Il fournit les fonctionnalités de base nécessaires à Qt GUI et Qt Widgets pour fonctionner avec X11. Les dépendances de sa bibliothèque sont décrites dans le tableau suivant. Pour construire Qt à partir de son code source, vous devrez également installer les paquets de développement de ces bibliothèques pour votre système.
| Nom de la bibliothèque | Bibliothèque | Remarques | Options de configuration | Version minimale de travail |
|---|---|---|---|---|
| XRender | libXrender | Extension de rendu X ; utilisée pour l'anticrénelage et la prise en charge du curseur alpha | -xrender ou auto-détecté | 0.9.0 |
| xcb-render | libxcb-render | X Liaisons en C pour l'extension de rendu | détecté automatiquement | 1.11 |
| xcb-render-util | libxcb-render-util | Bibliothèque utilitaire 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 | X C Bindings for Resize and Rotate Extension (Liaisons en C pour l'extension de redimensionnement et de rotation) | 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 | Liaisons en X C pour l'extension XKeyboard | détecté automatiquement | 1.11 |
| xcb-sync | libxcb-sync | Liaisons en C pour l'extension Sync | détecté automatiquement | 1.11 |
| xcb-shm | libxcb-shm | Liaisons X C pour l'extension de mémoire partagée | détecté automatiquement | 1.11 |
| xcb-icccm | libxcb-icccm | Liaisons en C pour le protocole ICCCM | détecté automatiquement | 0.3.9 |
| xcb-keysyms | libxcb-keysyms | Bibliothèque utilitaire pour XCB pour la conversion des codes clés | détecté automatiquement | 0.3.9 |
| xcb-image | libxcb-image | Bibliothèque utilitaire pour XCB pour XImage et XShmImage, utilisée pour QBackingStore et le support du curseur | auto-détecté | 0.3.9 |
| xcb-util | libxcb-util | Bibliothèque utilitaire pour XCB pour atom, aux et event | auto-détecté | 0.3.9 |
| xcb-cursor0 | libxcb-cursor0 | Bibliothèque utilitaire pour XCB pour le curseur | détecté automatiquement | 0.1.1 |
| xkbcommon | libxkbcommon | Gestion des cartes-clés | -xkbcommon ou auto-détection | 0.9.0 |
| xkbcommon-x11 | libxkbcommon-x11 | Gestion de la carte-clé | auto-détecté | 0.9.0 |
| Configuration des polices de caractères | libfontconfig | Personnalisation et configuration des polices | -fontconfig ou auto-détection | 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 auto-détection | 6.0.4 |
| ICE | libICE | Échange entre clients | -sm ou auto-détecté | 6.3.5 |
| glib | libglib-2.0 | Gestion des boucles d'événements communs | -glib ou auto-détecté | 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 qui sont utilisés lors de la construction de Qt à partir de son code source. Les noms des paquets peuvent différer 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 des paquets.
Par 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, de sorte que l'installation de l'un d'entre eux peut entraîner l'installation automatique des autres. D'autres distributions peuvent fournir des paquets système avec des noms similaires.
Qt ne maintient pas une liste complète 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 de paquets spécifiques. Les utilisateurs de RHEL peuvent contacter l'assistance Red Hat pour obtenir des informations détaillées.
Dépendances en matière d'accessibilité
L'implémentation de l'accessibilité de Qt Assistant utilise l'interface AT-SPI ( Assistive Technology Service Provider Interface ). En plus de DBUS, le paquet de développement libatspi2.0-dev doit être installé.
Dépendances OpenGL
Configurez les tentatives de détection automatique d'OpenGL ES 2.0, ou plus récent, ou d'OpenGL de bureau classique. Vous pouvez désactiver la prise en charge d'OpenGL en utilisant l'option -no-opengl.
Note : Le module Qt OpenGL (qui contient des classes commençant par QGL) a été déprécié en faveur du module Qt GUI (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, reportez-vous à la section Installation de Clang pour QDoc pour connaître les conditions spécifiques de compilation.
© 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.