Qt pour Linux - Compilation à partir du code source

Cette page décrit comment configurer et compiler Qt pour Linux à partir des sources. Notez qu’il est généralement plus simple d’installer les bibliothèques et outils Qt précompilés via Qt Online Installer. De nombreuses distributions Linux proposent également des paquets Qt via leur gestionnaire de paquets. Compilez toutefois Qt à partir des sources si vous souhaitez personnaliser davantage Qt ou si vous utilisez une distribution pour laquelle aucun paquet binaire Qt (de la bonne version) n'est disponible.

Les responsables de paquets des distributions trouveront de plus amples informations sur la manière de créer des paquets Qt dans les recommandations de packaging.

Étape 1 : Obtenir les sources

Les sources de Qt peuvent être installées à l'adresse Qt Online Installer. Les paquets source sont également disponibles via Git, sous forme d'archives dans le compte Qt (utilisateurs commerciaux) et sur download.qt.io (utilisateurs open source).

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.12.0/Src.

Si vous avez téléchargé l’archive unique contenant les sources, extrayez-la dans un répertoire de votre choix :

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

Étape 2 : Installer les prérequis de compilation

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

Outils de compilation

Compilateurs et paquets de développement

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

D'autres compilateurs et configurations peuvent fonctionner, mais ne font pas l'objet de tests actifs.

Qt dépend également de 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 distribution concernée. Consultez la page Qt pour Linux - Configuration requise pour plus de détails.

Étape 3 : Compiler 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.12.0/configure

Par défaut, Qt est configuré pour être installé dans le répertoire /usr/local/Qt-6.12.0. Vous pouvez modifier cela à l'aide de l'option -prefix. Consultez la liste des options de configuration pour effectuer d'autres réglages.

Le script ` configure ` s'est-il exécuté avec succès ? Dans ce cas, passez à la compilation des bibliothèques et des outils :

cmake --build . --parallel

Une fois la compilation terminée, vous devez installer les bibliothèques et les outils à l'emplacement approprié (sauf si vous avez activé une compilation pour développeurs) :

cmake --install .

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

Étape 4 : Compilation de votre application

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

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

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

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

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

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

Si vous prévoyez de compiler votre application à partir d’un IDE, vous devez y enregistrer explicitement la version de Qt :

• Pour Qt Creator, consultez Qt Creator: Ajouter des versions de Qt.
• Pour l'Qt Extension for Visual Studio Code, consultez Qt Extension for Visual Studio Code: Enregistrer les installations Qt.