qt_import_qml_plugins

Garantit que les plugins QML requis par une cible sont importés pour les compilations statiques.

Cette commande a été introduite dans Qt 6.0.

La commande est définie dans le composant « Qml » du paquet « Qt6 », qui peut être chargé comme suit :

find_package(Qt6 REQUIRED COMPONENTS Qml)

Syntaxe

qt_import_qml_plugins(target)

Si les commandes sans version sont désactivées, utilisez plutôt qt6_import_qml_plugins(). Elle prend en charge le même ensemble d'arguments que cette commande.

Description

qt_import_qml_plugins() Exécute immédiatement « qmlimportscanner » sur le module QML ( target ) dans le cadre de l’appel (à moins que l’option « NO_IMPORT_SCAN » n’ait été transmise à « qt_add_qml_module() » lors de la définition du module QML). Elle recherche les plugins QML statiques utilisés par le module « target » et le lie à ces plugins afin qu’ils fassent partie de l’exécutable ou de la bibliothèque partagée que représente « target ». La recherche suit de manière récursive les importations du module QML.

Comme l’appel à ` qmlimportscanner ` s’effectue au moment de la configuration plutôt qu’au moment de la génération ou de la compilation, ` qt_import_qml_plugins() ` ne dispose que des informations enregistrées sur ` target ` (ou sur d’autres cibles auxquelles il est lié ou qu’il importe) au moment où ` qt_import_qml_plugins() ` est appelé. 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 le périmètre du répertoire de l'target, afin que toutes les relations de liaison et d’importation soient connues.

Si target a été créé à l’aide de qt_add_executable(), les projets n’ont normalement pas besoin d’appeler directement qt_import_qml_plugins(). Lorsque Qt est compilé de manière statique, 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 a lieu à la fin de la même portée de répertoire dans laquelle l’ target a été créé. Si l’ target a été créé à l’aide de la commande CMake standard add_executable(), le projet doit appeler lui-même qt_import_qml_plugins().