Sur cette page

Qt pour Linux - Construction à partir des sources

Cette page décrit la configuration et la construction de Qt pour Linux à partir des sources. Notez qu'il est généralement plus facile d'installer les bibliothèques et outils Qt préconstruits via la commande Qt Online Installer. De nombreuses distributions Linux fournissent également des paquets Qt via leur gestionnaire de paquets. Construisez Qt à partir des sources, cependant, si vous souhaitez personnaliser davantage Qt ou si vous utilisez une distribution pour laquelle aucun paquetage binaire de Qt (dans la bonne version) n'est disponible.

Les responsables de l'empaquetage des distributions peuvent trouver de plus amples informations sur la manière d'empaqueter Qt dans les recommandations d'empaquetage.

Étape 1 : Obtenir les sources

Les sources de Qt peuvent être installées sur Qt Online Installer. Les paquets de sources sont également disponibles via Git, en tant qu'archives dans le compte Qt (utilisateurs commerciaux), et sur download.qt.io (utilisateurs de logiciels libres).

Si vous installez les sources via Qt Online Installer, elles seront disponibles dans le répertoire d'installation de Qt, par exemple $HOME/Qt/6.11.0/Src.

Si vous avez téléchargé l'archive des sources uniques, extrayez-la dans un répertoire de votre choix :

cd /tmp
tar xf ~/Downloads/qt-everywhere-src-6.11.0.tar.xz

Étape 2 : Installer les exigences de construction

La construction de Qt nécessite un environnement de construction avec des outils, des compilateurs et des paquets de développement.

Outils de construction

OutilVersions prises en charge
CMakeVersion 3.22 et plus récente.
Ninja-
PythonVersion 3

Remarque : configure utilise toujours le générateur et l'outil de construction Ninja si un exécutable ninja est disponible. Ninja est multiplateforme, riche en fonctionnalités, performant et recommandé sur toutes les plateformes. L'utilisation d'autres générateurs peut fonctionner mais n'est pas officiellement supportée.

Compilateurs et paquets de développement

Les compilateurs et configurations suivants sont pris en charge dans Qt 6.11 :

DistributionArchitectureCompilateurNotes
Red Hat 8.6x86_64GCC 10 (ensemble d'outils)
Red Hat 8.8x86_64GCC 10 (jeu d'outils)
Red Hat 8.10x86_64GCC 10 (jeu d'outils)
Red Hat 9.2x86_64GCC 11
Red Hat 9.4x86_64GCC 11
Red Hat 9.6x86_64GCC 11
openSUSE 15.6x86_64GCC 9, GCC 10, GCC 11, GCC 12
SUSE Linux Enterprise Server 15 SP6x86_64GCC 11
Ubuntu 22.04x86_64GCC tel que fourni par Canonical, GCC 11.xVoir aussi : Enterprise Qt Paquets Debian.
Ubuntu 24.04x86_64, arm64GCC tel que fourni par Canonical, GCC 13.xVoir la note concernant la prise en charge des ordinateurs de bureau Linux on Arm.
Debian 11.6x86_64, arm64GCC 10Voir la note concernant la prise en charge de Linux on Arm.
Debian 12x86_64, arm64GCC 12Voir aussi : Paquets Debian Enterprise Qt.

Voir la note concernant la prise en charge des ordinateurs de bureau Linux on Arm.

Note : Pour Linux on Arm sur les ordinateurs de bureau, nous utilisons Raspberry Pi 5 avec 8GB RAM et Ubuntu 24.04 comme plateforme de référence. Si vous rencontrez un problème avec un autre matériel, essayez de le reproduire sur Raspberry Pi 5. Nous prévoyons de passer à une prise en charge régulière des plateformes lorsqu'une gamme plus large de matériel de bureau basé sur ARM sera disponible. Les binaires officiels dans Qt Online Installer sont construits sur Ubuntu 24.04 qui est livré avec glibc 2.39, si votre glibc est plus ancien que ce que nous construisons, vous devez reconstruire à partir des sources.

D'autres compilateurs et configurations peuvent fonctionner mais ne sont pas activement testés.

Qt s'appuie également sur la disponibilité de diverses bibliothèques et paquets de développement, qui sont généralement installés par le gestionnaire de paquets de la résolution respective. Voir Qt pour Linux - Exigences pour plus de détails.

Étape 3 : Construire les bibliothèques et les outils Qt

Pour configurer votre compilation, créez un répertoire de compilation et exécutez le script ./configure dans ce répertoire :

mkdir -p ~/dev/qt-build
cd ~/dev/qt-build
/tmp/qt-everywhere-src-6.11.0/configure

Par défaut, Qt XML est configuré pour être installé dans le répertoire /usr/local/Qt-6.11.0. Ceci peut être modifié en utilisant l'option -prefix. Voir la liste des options de configuration pour plus de détails.

Est-ce que configure s'est exécuté avec succès ? Alors passez à la construction des bibliothèques et des outils :

cmake --build . --parallel

Après la construction, vous devez installer les bibliothèques et les outils à l'endroit approprié (à moins que vous n'ayez activé une construction pour développeurs) :

cmake --install .

Notez que cela peut nécessiter un accès root.

Étape 4 : Construction de votre application

Une fois Qt installé, vous pouvez commencer à créer des applications avec.

Si vous travaillez à partir de la ligne de commande, pensez à ajouter les outils Qt à votre adresse PATH par défaut. Pour ce faire, procédez comme suit :

Dans .profile (si votre shell est bash, ksh, zsh ou sh), ajoutez les lignes suivantes :

PATH=/usr/local/Qt-6.11.0/bin:$PATH
export PATH

Dans .login (si votre shell est csh ou tcsh), ajoutez la ligne suivante :

setenv PATH /usr/local/Qt-6.11.0/bin:$PATH

Si vous prévoyez d'utiliser Qt à partir d'un IDE, vous devez y enregistrer explicitement la version de Qt. Pour Qt Creator, voir Qt Creator: Ajouter des versions de Qt.

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