Construire des projets en ligne de commande

Cette page explique comment configurer et construire des projets existants. Si vous souhaitez savoir comment créer un projet CMake basé sur Qt, consultez la documentation sur la façon de démarrer avec CMake.

Pour construire un projet Qt, CMake doit savoir où se trouve l'installation de Qt. Habituellement, cela se fait en définissant la variable CMake CMAKE_PREFIX_PATH avec le préfixe d'installation de Qt. Si vous effectuez une compilation croisée, voir Compilation croisée pour plus de détails sur les variables supplémentaires que vous devrez définir.

Si Qt est installé à l'aide de Qt Online Installer, choisissez une version de Qt dans le répertoire d'installation de premier niveau. Par exemple, la commande suivante montre comment procéder sous Windows :

cmake -DCMAKE_PREFIX_PATH=C:\Qt\6.11.0\msvc2022_64 -S <source-dir> -B <build-dir>

Les espaces réservés <source-dir> et <build-dir> représentent les répertoires source et build de votre projet.

Générateurs CMake

CMake génère les fichiers nécessaires au système de construction qui permettent aux outils de construction tels que GNU Make ou Ninja de construire votre projet.

Le générateur par défaut de CMake dépend de la plate-forme et de l'environnement de construction. Par exemple, sous Windows, CMake génère des fichiers de projet Visual Studio si un environnement Visual Studio est détecté.

Pour une expérience de développement cohérente sur toutes les plateformes, utilisez le générateur Ninja ou Ninja Multi-Config.

Vous pouvez sélectionner le générateur CMake en définissant la variable d'environnement CMAKE_GENERATOR ou en utilisant l'argument -G:

cmake -G Ninja ...

qt-cmake

Le script qt-cmake est une alternative pratique pour configurer votre projet. Il vous évite d'avoir à spécifier la variable d'environnement CMAKE_PREFIX_PATH. Vous le trouverez dans le répertoire bin de votre préfixe d'installation de Qt. Le script transmet tous les paramètres à CMake, vous pouvez donc l'utiliser comme vous le feriez avec cmake:

C:\Qt\6.11.0\msvc2022_64\bin\qt-cmake -G Ninja -S <source-dir> -B <build-dir>

Une fois les fichiers du système de construction générés, votre projet est prêt à être construit :

cd <build-dir>
ninja

Vous pouvez également utiliser la commande CMake indépendante du générateur :

cmake --build <build-dir>

Compilation croisée

La compilation croisée consiste à construire votre projet pour une plateforme différente de votre machine de développement. Un exemple est la construction pour Android (la plateforme cible) sur une machine Windows (la plateforme hôte).

La compilation croisée avec CMake nécessite un fichier de chaîne d'outils pour la plupart des plateformes. Elle nécessite également une version de Qt pour l'hôte de développement, en plus d'une version de Qt pour la plateforme cible. Par exemple, vous devez installer Qt for Windows et Qt for Android pour effectuer une compilation croisée pour Android sur Windows.

Utilisez qt-cmake à partir de l'installation de Qt pour la plateforme cible, afin de procéder à la compilation croisée de votre projet pour cette plateforme :

<target-qt>/bin/qt-cmake -S <source-dir> -B <build-dir>

Cela configurera votre projet pour la plateforme cible. Le fichier de la chaîne d'outils est automatiquement transmis et d'autres variables spécifiques à la plateforme sont éventuellement définies.

Spécification d'un fichier de chaîne d'outils personnalisé

Le script qt-cmake transmet un fichier de chaîne d'outils interne à CMake. Ce fichier de chaîne d'outils définit plusieurs variables spécifiques à la plate-forme cible de Qt.

Si vous utilisez une installation de Qt qui n'a pas été construite sur votre machine, qt-cmake a besoin de connaître l'emplacement du fichier CMake toolchain pour la plate-forme cible.

Dans ce cas, vous pouvez demander à qt-cmake de charger en chaîne un fichier de chaîne d'outils personnalisé en définissant la variable QT_CHAINLOAD_TOOLCHAIN_FILE:

~/Qt/6.11.0/android_armv7/bin/qt-cmake -DQT_CHAINLOAD_TOOLCHAIN_FILE=<file-path> -S <source-dir> -B <build-dir>

Cela indique au fichier de chaîne d'outils interne de Qt de charger également votre fichier de chaîne d'outils personnalisé.