Qt pour Windows - Compilation à partir du code source

Cette page décrit la procédure de configuration et de compilation de Qt pour Windows. Pour télécharger et installer une version précompilée de Qt pour Windows, suivez les instructions de la page « Premiers pas avec Qt ».

Étape 1 : Obtenir les sources

Les sources de Qt peuvent être installées via Qt Online Installer. Les paquets sources 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 C:\Qt\6.12.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 : Installation des prérequis de compilation et configuration de l’environnement

Pour compiler Qt à partir des sources, vous avez besoin d’un environnement de compilation comprenant un compilateur pris en charge et divers outils de compilation.

Outils de compilation

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

Compilateurs

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

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.

Qt GRPC et les dépendances d'Qt Protobuf

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 sous Windows à l’aide de vcpkg.

Configuration de l’environnement

Pour MSVC, procédez de l’une des manières suivantes :

• Exécutez le fichier vcvarsall.bat :

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

• Recherchez « Invite de commande VS Native Tools » dans la barre de recherche Windows.

Pour Mingw-w64 : ajoutez Mingw-w64 à la variable d'PATH:

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

Étape 3 : Compilation 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ù la combinaison « major.minor.patch » représente la version de Qt en cours de compilation. Vous pouvez modifier cette valeur à l'aide de l'option « -prefix ». Consultez la liste des options de configuration de Qt pour effectuer d'autres ajustements.

Compilez ensuite les bibliothèques et les outils :

cmake --build . --parallel
# or
ninja

Le point après « --build » désigne le dossier actuel.

Une fois la compilation terminée, vous devez installer les bibliothèques et les outils dans le chemin d’accès souhaité (sauf si vous avez activé une compilation pour développeurs) :

cmake --install .
# or
ninja install

É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 variable d’environnement ` PATH ` comme suit :

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