Sur cette page

Lier le tout avec CMake

Lors de la création de modules QML, CMake fournit l'infrastructure nécessaire pour enregistrer correctement les types QML, générer les métadonnées nécessaires et s'assurer que votre module est correctement empaqueté et déployable. Cette page décrit le flux de travail recommandé.

Utilisation de qt_add_qml_module

La commande qt_add_qml_module est la méthode standard et recommandée pour créer des modules QML. Elle gère tous les détails complexes de la création de modules QML :

qt_add_qml_module(my_qml_module
    URI MyModule
    QML_FILES
        MyType.qml
        AnotherType.qml
    SOURCES
        mytype.cpp mytype.h
)

Cette commande unique

  • crée la cible du module
  • Enregistre les types QML à partir des fichiers C++ et QML
  • génère un fichier qmldir
  • gère l'enregistrement des types
  • Définit les chemins d'importation appropriés
  • Active le support des outils QML(qmllint, qmlls, etc.)

Ajout d'autres fichiers QML

Pour les fichiers QML ajoutés après l'appel initial à qt_add_qml_module, utilisez qt_target_qml_sources:

qt_target_qml_sources(my_qml_module
    QML_FILES
        DynamicallyAddedType.qml
)

Ceci peut être fait en fonction de la plate-forme, de la configuration ou d'autres facteurs.

Référence CMake détaillée

Pour des détails complets sur toutes les commandes, propriétés, variables et politiques de CMake, voir Intégration de CMake pour QML.

Voir aussi Modules QML et qt_add_qml_module.

© 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.