Obtenir les sources de Qt à partir du dépôt Git

Cette page décrit comment obtenir les sources de Qt à partir des dépôts publics Git. 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 de Qt à l'adresse Qt Online Installer, par le biais de votre compte Qt (utilisateurs commerciaux), ou à partir de download.qt.io (utilisateurs de logiciels libres).

Vous avez besoin d'une version récente de Git et de CMake Documentation pour lancer l'outil init-repository lors de l'initialisation des sous-modules Git.

Cloner le dépôt Qt

Qt est développé et maintenu dans plusieurs sous-modules Git du dépôt principal qt5.git. Pour obtenir les sources de Qt à partir de Git, il faut cloner le dépôt Git de premier niveau à l'aide de la ligne de commande.

Ces instructions utilisent une syntaxe 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.11.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.11.0 https://code.qt.io/qt/qt5.git qt

Après le clonage, le répertoire qt contient le dépôt Git principal de Qt qui contient des fichiers d'installation et des sous-modules Qt non initialisés.

Initialisation des sous-modules Qt

Le répertoire qt5.git contient les modules Qt sous forme de sous-modules Git. Pour initialiser et cloner les sous-modules, lancez l'outil init-repository dans le répertoire de premier niveau.

./init-repository

Sous Windows, sans environnement Linux, utilisez plutôt init-repository.bat.

init-repository.bat

init-repository clone et initialise les fichiers d'installation pour construire les sources de Qt. En outre, le référentiel contient des outils qui aident les contributeurs de Qt Help à créer des correctifs, à tester le code et à générer de la documentation. Pour plus d'informations sur la contribution, visitez le site Contribuer à Qt.

Si vous avez déjà un dépôt Qt dans le même répertoire, vous pouvez passer -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 de Qt, utilisez plutôt addon.

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

Vous pouvez également sélectionner plusieurs sous-modules en même temps. 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 minimum de sous-modules.

Pour plus d'informations, consultez le manuel init-repository en mettant -help en argument :

./init-repository -help

Après le clonage et l'initialisation

L'étape suivante consiste à configurer et à construire Qt. Lisez la page Construire les sources de Qt pour plus d'informations.