Référence des variables CMake
Variables de compilation de Qt
Lors de la construction de Qt, vous pouvez utiliser des variables CMake pour contrôler le résultat de la construction.
| Variable | Description de la variable |
|---|---|
| QT_HOST_PATH | Qt Location de l'installation hôte de Qt à partir de laquelle les outils hôtes peuvent être utilisés lors d'une autre compilation de Qt, qu'il s'agisse d'une compilation normale ou d'une compilation croisée. |
QT_FORCE_BUILD_TOOLS | Force la construction des outils même si les outils hôtes ont déjà été trouvés. Utile lors de la compilation croisée de Qt pour s'assurer que le SDK dispose d'outils construits de manière croisée. |
QT_FORCE_FIND_TOOLS | Utilise les outils Qt du Qt préconstruit dans QT_HOST_PATH lorsque vous ne procédez pas à une compilation croisée. La variable ne prend effet que si QT_FORCE_BUILD_TOOLS est défini comme ON. Dans le cas contraire, QT_FORCE_FIND_TOOLS n'affecte pas le comportement par défaut. |
Variables de module
Les modules Qt chargés avec find_package définissent diverses variables.
Remarque : il est rare que vous ayez besoin d'accéder directement à ces variables. Les tâches courantes telles que l'édition de liens avec un module doivent être effectuées par l'intermédiaire des cibles de bibliothèque définies par chaque module.
Par exemple, find_package(Qt6 COMPONENTS Widgets), lorsqu'il réussit, rend les variables suivantes disponibles :
| Variable | Description |
|---|---|
Qt6Widgets_COMPILE_DEFINITIONS | Une liste de définitions de compilation à utiliser lors de la construction par rapport à la bibliothèque. |
Qt6Widgets_DEFINITIONS | Une liste de définitions à utiliser lors de la compilation avec la bibliothèque. |
Qt6Widgets_EXECUTABLE_COMPILE_FLAGS | Une chaîne de drapeaux à utiliser lors de la compilation d'exécutables avec la bibliothèque. |
Qt6Widgets_FOUND | Un booléen qui indique si le module a été trouvé avec succès. |
Qt6Widgets_INCLUDE_DIRS | Une liste de répertoires d'inclusion à utiliser lors de la compilation avec la bibliothèque. |
Qt6Widgets_LIBRARIES | Le nom de la cible importée pour le module : Qt6::Widgets |
Qt6Widgets_PRIVATE_INCLUDE_DIRS | Une liste de répertoires d'inclusion privés à utiliser lors de la compilation avec la bibliothèque et de l'utilisation de l'API Qt privée. |
Qt6Widgets_VERSION | Une chaîne contenant la version du module. |
Pour tous les paquets trouvés avec find_package, des équivalents de ces variables sont disponibles ; ils sont sensibles à la casse.
Variables d'installation
Il existe également des variables qui ne sont pas liées à un paquetage particulier, mais à l'installation de Qt elle-même.
| Variable | Description |
|---|---|
| Un entier qui contrôle la version de Qt que qt_ commande en cas de projets mixtes Qt 5 et Qt 6. Elle doit être définie à 5 ou 6 avant les appels respectifs à find_package().Si elle vaut Si la valeur n'est pas définie, le premier appel à |
QT_LIBINFIX | Une chaîne qui contient l'infixe utilisé dans les noms de bibliothèques, lorsque Qt est configuré avec -libinfix. |
| Masque les commandes qui commencent par qt_, ne laissant que les commandes versionnées commençant par qt6_. |
| Masque les cibles importées commençant par Qt::, au lieu de cela, vous devez utiliser les cibles commençant par Qt6::. |
QT_VISIBILITY_AVAILABLE | Sous Unix, un booléen qui indique si les bibliothèques et les plugins Qt ont été compilés avec -fvisibility=hidden. Cela signifie que seuls les symboles sélectionnés sont exportés. |
Variables de projet
Ces variables peuvent influencer les commandes CMake fournies par Qt. Elles peuvent être définies par le projet, un fichier de chaîne d'outils ou d'autres paquets tiers.
Qt6::Core
Architecture du système hôte spécifique à Android | |
Emplacement du SDK Android | |
Liste des ABI pour lesquelles les paquets du projet sont construits | |
Liste des arguments à transmettre aux applications Android | |
Permet de construire des paquets multi-ABI à l'aide de la liste autodétectée de Qt for Android SDK | |
Création de liens symboliques uniquement pour les dépendances situées dans le répertoire du projet Gradle | |
Force ou désactive la signature des paquets de version, quel que soit le type de construction | |
Permet la génération de classes basées sur QtQuickViewContent | |
Permet de partager les variables CMake dans les constructions multi-ABI | |
Effectuer un nettoyage Gradle après la création du paquetage Android | |
Signe le paquet .aab avec le keystore, l'alias et le mot de passe du magasin spécifiés | |
Signe le paquet avec le keystore, l'alias et le mot de passe de stockage spécifiés | |
Sous-répertoire relatif au préfixe pour le déploiement des binaires d'exécution sur certaines plates-formes cibles | |
Répertoires exclus de la recherche de dépendances d'exécution | |
Sous-répertoire relatif au préfixe pour le déploiement d'exécutables de programmes sur certaines plateformes cibles | |
Sous-répertoire relatif au préfixe pour le déploiement des bibliothèques sur certaines plates-formes cibles | |
Sous-répertoire relatif au préfixe pour le déploiement des plugins Qt sur certaines plates-formes cibles | |
Emplacement de base pour un déploiement | |
Sous-répertoire préfixe pour le déploiement de plugins QML sur certaines plates-formes cibles | |
Nom du fichier à inclure pour la mise en place d'un support de déploiement | |
Sous-répertoire relatif au préfixe pour le déploiement des traductions Qt sur certaines plates-formes cibles | |
Active le mode verbeux des outils de déploiement | |
Location de l'installation hôte de Qt lors de la compilation croisée | |
Spécifie la langue des chaînes traduisibles | |
Liste des langues à utiliser pour l'internationalisation du projet | |
Chemin d'accès au storyboard de l'écran de lancement d'iOS utilisé par toutes les cibles | |
Empêche la collecte des cibles de bibliothèques partagées construites dans le cadre d'un projet pendant le déploiement d'Android | |
Empêche la collecte des cibles importées pendant le déploiement d'Android | |
Désactive la fourniture d'un identifiant de repli pour le bundle d'applications lors de la finalisation des cibles sur iOS | |
Désactive la fourniture d'un identifiant d'équipe de secours lors de la finalisation de la cible sur iOS | |
Empêche les appels ultérieurs à qt_standard_project_setup() d'apporter des modifications. | |
Ensemble de variables pour spécifier le chemin d'accès à Qt pour Android pour l'ABI correspondant | |
Permet l'utilisation de répertoires de compilation Android par cible |
Qt6::InterfaceFramework
Activer la journalisation verbeuse pour toutes les fonctions d'ifcodegen | |
Chemin de recherche pour les modèles ifcodegen |
Qt6::Multimedia
Désactive la signature du code FFmpeg sur iOS |
Qt6::Qml
Active le dumping des propriétés du contexte dans les cibles de lint | |
Contrôle l'activation de la collecte des statistiques de QML Compiler | |
Permet la génération automatique de fichiers .qmlls.ini pour les projets de développement. QML Language Server | |
Personnalise la valeur de no-cmake-calls dans les fichiers .qmlls.ini pour QML Language Server | |
Désactive la compilation des fichiers QML en bytecode ou en code C++. | |
Répertoire de sortie de base sous lequel les modules QML seront créés par défaut |
Variables CMake standard
| CMAKE_AUTOGEN_BETTER_GRAPH_MULTI_CONFIG | Améliore le graphe de dépendance pour les générateurs multi-configuration |
© 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.
