Compilation de projets en ligne de commande

Cette page explique comment configurer et compiler des projets existants. Si vous souhaitez savoir comment créer un projet CMake basé sur Qt, consultez la documentation sur la prise en main de CMake.

Pour compiler un projet Qt, CMake doit connaître l'emplacement de l'installation de Qt. En général, cela s'effectue en définissant la variable CMake CMAKE_PREFIX_PATH sur le préfixe d'installation de Qt. Si vous effectuez une compilation croisée, consultez la section Compilation croisée pour plus de détails sur les variables supplémentaires que vous devrez définir.

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

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

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

Générateurs CMake

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

Le générateur par défaut de CMake dépend de la plateforme et de l’environnement de compilation. 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 soit en définissant la variable d’environnement ` CMAKE_GENERATOR `, soit en utilisant l’argument ` -G ` :

cmake -G Ninja ...

qt-cmake

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

C:\Qt\6.12.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 compilé :

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 de votre projet pour une plateforme différente de votre machine de développement s’appelle la compilation croisée. Un exemple est la compilation 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 la machine hôte de développement, en plus d’une version de Qt pour la plateforme cible. Par exemple, vous devez avoir installé Qt pour Windows et Qt pour Android afin de compiler de manière croisée pour Android sur Windows.

Utilisez la commande « qt-cmake » issue de l'installation de Qt pour la plateforme cible afin de compiler votre projet de manière croisée pour cette plateforme :

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

Cela permettra de configurer votre projet pour la plateforme cible. Le fichier de 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 à CMake un fichier de chaîne d’outils interne à Qt. Ce fichier définit plusieurs variables spécifiques à la plateforme cible de Qt.

Si vous utilisez une installation Qt qui n’a pas été compilée sur votre machine, qt-cmake doit connaître l’emplacement du fichier de chaîne d’outils CMake 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.12.0/android_armv7/bin/qt-cmake -DQT_CHAINLOAD_TOOLCHAIN_FILE=<file-path> -S <source-dir> -B <build-dir>

Cela indique à la chaîne d’outils interne de Qt de charger également votre fichier de chaîne d’outils personnalisé.