Intégration de CMake pour QML

Qt offre une intégration CMake complète pour la compilation de modules et d'applications QML.

Commandes CMake de base

qt_add_qml_module

La commande qt_add_qml_module est la fonction principale permettant de 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 au système de compilation de Qt, offrant ainsi 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 QML et des ressources à une cible de module QML existante. Elle est utile pour organiser des modules volumineux ou pour inclure des fichiers QML de manière conditionnelle en fonction de la configuration de compilation.

qt_add_qml_plugin

La commande qt_add_qml_plugin crée une bibliothèque de plugins QML pouvant être chargée dynamiquement par le moteur QML. Bien que la commande « qt_add_qml_module » gère généralement la création de plugins de manière automatique, cette fonction offre un contrôle de plus bas niveau lorsque cela s’avère nécessaire.

Commandes de déploiement

qt_deploy_qml_imports

La commande qt_deploy_qml_imports identifie et déploie toutes les importations QML utilisées par votre application, y compris leurs dépendances. Cela garantit que tous les modules et plugins QML nécessaires sont intégrés à 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 plateforme qui se charge de copier les modules QML, les plugins et les autres ressources aux emplacements appropriés dans votre bundle d’application ou votre répertoire d’installation.

qt_import_qml_plugins

La commande qt_import_qml_plugins garantit que les plugins QML sont correctement liés aux applications compilées de manière statique, en générant le code d’initialisation nécessaire pour enregistrer les plugins auprès du 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'informations sur les types. Cela est utile pour l'introspection du système de compilation et l'intégration d'outils.

qt_target_compile_qml_to_cpp

La commande qt_target_compile_qml_to_cpp permet de compiler des fichiers QML en C++ à l’aide de qmltc(le compilateur de types QML). Elle offre une alternative à l’instanciation par composants, avec des performances améliorées pour les types QML connus de manière statique.

qt_add_qml_preview

La commande qt_add_qml_preview configure la prise en charge du rechargement en temps réel (live-reload) par qmlpreview pour une cible exécutable qui charge du code QML à partir d’une ou plusieurs cibles qt_add_qml_module, mais qui n’est pas elle-même un module QML. Elle crée une cible de compilation supplémentaire « <target>_qmlpreview » qui peut être utilisée pour prévisualiser les fichiers QML de l’exécutable.

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

Les variables globales CMake dans Qt6 Qml contrôlent le comportement par défaut de tous les modules QML de votre projet. Elles comprennent des variables relatives aux répertoires de sortie, à la génération de fichiers de cache et à l’intégration d’outils, vous permettant de configurer les paramètres de compilation QML à l’échelle du projet.

Propriétés globales

Les propriétés globales CMake de Qt6 Qml influencent la manière dont le système de compilation traite les modules QML et peuvent être utilisées pour personnaliser certains aspects, tels que l’organisation des cibles du linter et la génération de code lors de la compilation.

Propriétés des fichiers source

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

Propriétés des cibles

Les propriétés de cible CMake dans Qt6 QML vous permettent d’affiner le comportement de cibles individuelles, par exemple pour exclure une cible d’un comportement qui serait autrement activé pour elle à l’échelle du projet, comme la création automatique de la cible `qmlpreview`.

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 leur incidence sur le comportement des modules. Les politiques vous permettent d'activer de nouveaux comportements tout en conservant la compatibilité avec les projets existants.