Modules QML

Un module QML fournit des types versionnés et des ressources JavaScript dans un espace de noms de types qui peuvent être utilisés par les clients qui importent le module. Les types fournis par un module peuvent être définis en C++ dans un plugin ou dans des documents QML. Les modules utilisent le système de versions QML qui permet aux modules d'être mis à jour de manière indépendante.

La définition d'un module QML permet

  • le partage de types QML communs au sein d'un projet - par exemple, un groupe de composants d'interface utilisateur utilisés par différentes fenêtres
  • la distribution de bibliothèques basées sur QML
  • la modularisation de fonctionnalités distinctes, de sorte que les applications ne chargent que les bibliothèques nécessaires à leurs besoins individuels
  • le versionnage des types et des ressources afin que le module puisse être mis à jour en toute sécurité sans casser le code client.

Définition d'un module QML

Note : Utilisez l'API CMake pour définir un module QML. Ne définissez votre module QML manuellement que si vous avez besoin d'utiliser qmake.

Un module est défini par un fichier qmldir de définition de module. Chaque module possède un espace de noms de type associé, qui est l'identifiant du module. Un module peut fournir des types d'objets QML (définis soit par des documents QML, soit par un plugin C++) et des ressources JavaScript, et peut être importé par des clients.

Pour définir un module, un développeur doit rassembler les différents documents QML, les ressources JavaScript et les plugins C++ qui appartiennent au module dans un seul répertoire, et écrire un fichier de définition de module qmldir approprié qui doit également être placé dans le répertoire. Le répertoire peut alors être installé dans le chemin d'importation de QML en tant que module.

Notez que la définition d'un module n'est pas le seul moyen de partager des types QML communs au sein d'un projet - une simple importation de répertoire de documents QML peut également être utilisée à cette fin.

Types de modules QML pris en charge

Il existe deux types de modules pris en charge par QML :

Les modules identifiés définissent explicitement leur identifiant et sont installés dans le chemin d'importation de QML. Les modules identifiés sont plus faciles à maintenir (en raison du versionnement des types) et bénéficient de garanties d'enregistrement des types par le moteur QML, ce qui n'est pas le cas des modules hérités. Les modules hérités ne sont pris en charge que pour permettre au code hérité de continuer à fonctionner avec la dernière version de QML, et devraient être évités par les clients dans la mesure du possible.

Les clients peuvent importer un module QML à partir de documents QML ou de fichiers JavaScript. Veuillez consulter la documentation sur l'importation d'un module QML pour plus d'informations à ce sujet.

Fournir des types et des fonctionnalités dans un plugin C

Une application dont une grande partie de la logique est mise en œuvre en C++, ou qui définit des types en C++ et les expose à QML, peut souhaiter mettre en œuvre un module d'extension QML. Le développeur d'un module d'extension QML peut souhaiter implémenter certains types dans un plugin C++ (plutôt que de les définir via des documents QML) afin d'obtenir de meilleures performances ou une plus grande flexibilité.

Chaque module d'extension C++ pour QML possède une fonction d'initialisation qui est appelée par le moteur QML lorsqu'il charge le module d'extension. Cette fonction d'initialisation doit enregistrer tous les types fournis par le plugin, mais ne doit rien faire d'autre (par exemple, l'instanciation de QObjects n'est pas autorisée).

Voir Créer des plugins C++ pour QML pour plus d'informations.

Voir aussi Modules QML modernes et Porter des modules QML dans CMake.

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