Qt pour Windows - Construction à partir des sources

Cette page décrit le processus de configuration et de construction de Qt pour Windows. Pour télécharger et installer une version préconstruite de Qt pour Windows, suivez les instructions de la page Démarrer avec Qt.

É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, sous forme d'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 C:\Qt\6.11.0\Src.

Si vous avez téléchargé l'archive des sources, extrayez-la dans un répertoire de votre choix, par exemple C:\dev\Qt\src.

Étape 2 : Installer les exigences de construction et définir l'environnement

Pour construire Qt à partir des sources, vous avez besoin d'un environnement de construction avec un compilateur supporté et divers outils de construction.

Outils de construction

Les exécutables cmake.exe, ninja.exe, et python.exe doivent être disponibles dans votre environnement de construction. Ajoutez le répertoire correspondant à votre variable d'environnement PATH.

Compilateurs

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

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 exigences spécifiques en matière de compilation.

Qt GRPC et Qt Protobuf Dépendances

Qt GRPC et Qt Protobuf nécessitent l'installation des paquets gRPC et Protobuf. Vous trouverez les instructions d'installation de ces paquets dans l'exemple d'installation pour Windows à l'aide de vcpkg.

Définition de l'environnement

Pour MSVC, effectuez l'une des opérations suivantes :

• Exécutez le fichier vcvarsall.bat :

  "C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvarsall.bat" amd64

• Recherchez l'invite de commande VS Native Tools dans la barre de recherche de Windows.

Pour Mingw-w64 : Ajoutez Mingw-w64 à la variable d'environnement PATH:

Set PATH=C:\qt\tools\mingw1120_64\bin;%PATH%

Étape 3 : Construction des bibliothèques et des outils Qt

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

mkdir C:\dev\qt-build
cd C:\dev\qt-build
C:\dev\Qt\src\configure.bat

Par défaut, Qt est configuré pour être installé dans le répertoire C:\Qt\Qt-major.minor.patch, où le triplet major.minor.patch représente la version de Qt en cours de construction. Ceci peut être modifié en utilisant l'option -prefix. Voir la liste des options de configuration de Qt pour plus de détails.

Construisez ensuite les bibliothèques et les outils :

cmake --build . --parallel
# or
ninja

Le point après --build signifie le dossier actuel.

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

cmake --install .
# or
ninja install

Étape 4 : Création de votre application

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

Si vous travaillez à partir de la ligne de commande, envisagez d'ajouter les outils Qt à votre variable d'environnement PATH comme suit :

set PATH=C:\Qt\Qt-major.minor.patch\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.