Intégration de CMake pour QML

Qt fournit une intégration CMake étendue pour la construction de modules et d'applications QML.

Commandes principales de CMake

qt_add_qml_module

La commande qt_add_qml_module est la fonction principale pour créer des modules QML dans CMake. Elle gère l'enregistrement des types QML, l'intégration des ressources, la création de plugins et l'intégration avec le système de construction de Qt, en fournissant un moyen déclaratif de définir tous les aspects d'un module QML.

qt_target_qml_sources

La commande qt_target_qml_sources ajoute des fichiers et des ressources QML à une cible de module QML existante. Ceci est utile pour organiser des modules de grande taille ou pour inclure des fichiers QML de manière conditionnelle en fonction de la configuration de la compilation.

qt_add_qml_plugin

La commande qt_add_qml_plugin crée une bibliothèque de plugins QML qui peut être chargée dynamiquement par le moteur QML. Bien que qt_add_qml_module gère généralement la création de plugins de manière automatique, cette fonction permet un contrôle de niveau inférieur en cas de besoin.

Commandes de déploiement

qt_deploy_qml_imports

La commande qt_deploy_qml_imports identifie et déploie tous les imports QML utilisés par votre application, y compris leurs dépendances. Cela permet de s'assurer que tous les modules et plugins QML nécessaires sont empaquetés avec votre application.

qt_generate_deploy_qml_app_script

La commande qt_generate_deploy_qml_app_script génère un script de déploiement spécifique à la plate-forme qui gère la copie des modules QML, des plugins et des autres ressources aux emplacements corrects dans le bundle de l'application ou le répertoire d'installation.

qt_import_qml_plugins

La commande qt_import_qml_plugins permet de s'assurer que les plugins QML sont correctement liés aux applications statiques, en générant le code d'initialisation nécessaire pour enregistrer les plugins avec le moteur QML.

Commandes avancées

qt_generate_foreign_qml_types

La commande qt_generate_foreign_qml_types crée des enregistrements de types QML pour les types C++ définis dans d'autres bibliothèques ou modules. Cela vous permet d'exposer des types tiers ou Qt à QML sans modifier leur code source.

qt_query_qml_module

La commande qt_query_qml_module récupère des informations sur un module QML, telles que son URI, sa version, la cible du plugin et les chemins d'accès aux fichiers d'information sur les types. Ceci est utile pour l'introspection du système de construction et l'intégration de l'outillage.

qt_target_compile_qml_to_cpp

La commande qt_target_compile_qml_to_cpp permet de compiler les fichiers QML en C++ en utilisant qmltc(le compilateur de types QML). Ceci fournit une alternative à l'instanciation basée sur les composants avec des performances améliorées pour les types QML statiquement connus.

Variables et propriétés CMake

Qt QML fournit plusieurs variables et propriétés CMake pour configurer le comportement des modules QML :

Variables globales

Lesvariables globales CMake dans Qt6 Qml contrôlent le comportement par défaut de tous les modules QML de votre projet. Elles comprennent des variables pour les répertoires de sortie, la génération de fichiers de cache et l'intégration d'outils, ce qui vous permet de configurer les paramètres de compilation QML au niveau de l'ensemble du projet.

Propriétés globales

Lespropriétés globales de CMake dans Qt6 Qml affectent la façon dont le système de compilation traite les modules QML et peuvent être utilisées pour personnaliser des aspects tels que l'organisation de la cible du linter et la génération du code au moment de la compilation.

Propriétés du fichier source

Lespropriétés du fichier source de CMake dans Qt6 Qml permettent un contrôle fin sur les fichiers QML individuels au sein d'un module. Vous pouvez utiliser ces propriétés pour marquer les fichiers comme singletons, les exclure des étapes de compilation, spécifier des noms de type personnalisés, ou contrôler d'autres comportements par fichier dans le système de type QML.

Politiques CMake

Qt QML définit plusieurs politiques CMake pour contrôler la compatibilité ascendante et le comportement.

Politiques CMake pour QML

La page Politiques CMake pour QML fournit une vue d'ensemble de toutes les politiques CMake liées à QML et de la manière dont elles affectent le comportement du module. Les politiques vous permettent d'adopter de nouveaux comportements tout en maintenant la compatibilité avec les projets existants.