qt_import_qml_plugins
Assure que les plugins QML nécessaires à une cible sont importés pour les constructions statiques.
Cette commande a été introduite dans Qt 6.0.
La commande est définie dans le composant Qml du paquetage Qt6, qui peut être chargé comme suit :
find_package(Qt6 REQUIRED COMPONENTS Qml)
Synopsis
qt_import_qml_plugins(target)
Si les commandes sans version sont désactivées, utilisez qt6_import_qml_plugins() à la place. Il prend en charge le même ensemble d'arguments que cette commande.
Description
Note : Cette commande n'a d'effet que si Qt a été construit de manière statique. Si elle est appelée avec un Qt non statique, elle ne fera rien et retournera immédiatement.
qt_import_qml_plugins() exécute qmlimportscanner sur target immédiatement en tant que partie de l'appel (à moins que l'option NO_IMPORT_SCAN n'ait été passée à qt_add_qml_module() lors de la définition du module QML). Il trouve les plugins QML statiques utilisés par target et le lie à ces plugins pour qu'ils fassent partie de l'exécutable ou de la bibliothèque partagée que target représente. La recherche suit les importations de modules QML de manière récursive.
Étant donné que l'appel à qmlimportscanner s'exécute au moment de la configuration plutôt qu'au moment de la génération ou de la construction, qt_import_qml_plugins() ne connaît que les informations enregistrées sur target (ou d'autres cibles qu'il lie ou importe) au moment de l'appel à qt_import_qml_plugins(). Toute relation de liaison ou d'importation ajoutée après cet appel ne sera pas prise en compte. Par conséquent, cette commande doit être appelée le plus tard possible dans la portée du répertoire de target afin que toutes les relations de liaison et d'importation soient connues.
Si target a été créé en utilisant qt_add_executable(), les projets n'ont normalement pas besoin d'appeler qt_import_qml_plugins() directement. Lorsque Qt est construit statiquement, la commande est appelée automatiquement dans le cadre de la finalisation de la cible si target est lié à la bibliothèque Qml. Par défaut, cette finalisation se produit à la fin du même répertoire dans lequel target a été créé. Si target a été créé à l'aide de la commande CMake standard add_executable(), le projet doit appeler lui-même qt_import_qml_plugins().
Voir aussi Q_IMPORT_QML_PLUGIN.
© 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.