Sur cette page

Récupération des sources Qt à partir du dépôt Git

Cette page décrit comment récupérer les sources de Qt à partir des dépôts Git publics. Les dépôts Git contiennent les dernières branches de développement et les versions publiées de Qt 6.

Vous pouvez également obtenir les sources Qt sur Qt Online Installer, via votre compte Qt (utilisateurs commerciaux) ou sur download.qt.io (utilisateurs open source).

Vous devez disposer d'une version récente de Git et de la documentation CMake pour exécuter l'outil init-repository lors de l'initialisation des sous-modules Git.

Remarque : ces instructions partent du principe que vous maîtrisez l’utilisation des outils en ligne de commande.

Clonage du dépôt Qt

Qt est développé et maintenu dans plusieurs sous-modules Git au sein du dépôt principal qt5.git. Pour récupérer les sources de Qt depuis Git, il faut cloner le dépôt Git de niveau supérieur via la ligne de commande.

Remarque : Qt 5 et Qt 6 partagent le même dépôt, qt5.git, et vous obtiendrez le dépôt Qt 5 même si vous utilisez Qt 6.

Ces instructions utilisent une syntaxe de shell de type Unix. Sous Windows, les commandes sont similaires. La commande ci-dessous clone la version actuelle de Qt 6 dans un répertoire nommé qt.

git clone --branch v6.12.0 git://code.qt.io/qt/qt5.git qt

Si le protocole Git est bloqué par votre pare-feu, envisagez d'utiliser HTTPS à la place :

git clone --branch v6.12.0 https://code.qt.io/qt/qt5.git qt

Une fois le clonage terminé, le répertoire qt contient le dépôt Git principal de Qt, qui comprend les fichiers d’installation et les sous-modules Qt non initialisés.

Initialisation des sous-modules Qt

Le dépôt qt5.git contient les modules Qt sous forme de sous-modules Git. Pour initialiser et cloner les sous-modules, exécutez l’outil init-repository dans le répertoire racine.

./init-repository

Sous Windows, en l’absence d’environnement Linux, utilisez plutôt init-repository.bat.

init-repository.bat

init-repository clone et initialise les fichiers de configuration nécessaires à la compilation des sources Qt. De plus, le dépôt contient des outils destinés à aider les contributeurs Qt à créer des correctifs, à tester le code et à générer de la documentation. Pour plus d’informations sur la contribution, rendez-vous sur le site Contribuer à Qt.

Si vous disposez déjà d’un dépôt Qt dans le même répertoire, vous pouvez passer l’option ` -f ` pour forcer ` init-repository ` à réinitialiser les sous-modules.

./init-repository -f

Initialisation des sous-modules spécifiques à Qt

Si vous n’avez besoin que d’un ensemble spécifique de modules Qt, initialisez un ensemble minimal de sous-modules en utilisant --module-subset comme argument de init-repository. Par exemple, vous pouvez initialiser uniquement les modules Qt Essentials en spécifiant essential comme argument.

./init-repository --module-subset=essential

Pour les modules complémentaires Qt, utilisez plutôt addon.

./init-repository --module-subset=addon

Vous pouvez également sélectionner plusieurs sous-modules à la fois. Par exemple, pour initialiser les sous-modules qtgrpc et qtmqtt ainsi que leurs sous-modules requis, exécutez :

./init-repository --module-subset=qtgrpc,qtmqtt

L'outil init-repository initialise toujours un ensemble minimal de sous-modules.

Pour plus d’informations, consultez le manuel d’ init-repository en passant -help en argument :

./init-repository -help

Après le clonage et l'initialisation

L'étape suivante consiste à configurer et à compiler Qt. Consultez la page « Compilation des sources Qt » pour plus d'informations.

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