qt_import_qml_plugins
Stellt sicher, dass die von einem Ziel benötigten QML-Plugins für statische Builds importiert werden.
Dieser Befehl wurde in Qt 6.0 eingeführt.
Der Befehl ist in der Komponente „ Qml “ des Pakets „ Qt6 “ definiert, die wie folgt geladen werden kann:
find_package(Qt6 REQUIRED COMPONENTS Qml)Übersicht
qt_import_qml_plugins(target)Wenn versionslose Befehle deaktiviert sind, verwenden Sie stattdessen „ qt6_import_qml_plugins() “. Dieser Befehl unterstützt dieselben Argumente wie der vorliegende Befehl.
Beschreibung
Hinweis: Dieser Befehl hat nur dann eine Wirkung, wenn Qt statisch kompiliert wurde. Wird er mit einem nicht-statischen Qt aufgerufen, führt er keine Aktion aus und kehrt sofort zurück.
qt_import_qml_plugins() Führt „ qmlimportscanner “ sofort als Teil des Aufrufs auf dem „ target “ aus (es sei denn, bei der Definition des QML-Moduls wurde die Option „ NO_IMPORT_SCAN “ an „qt_add_qml_module()“ übergeben). Er ermittelt die vom „ target “ verwendeten statischen QML-Plugins und verknüpft das Modul mit diesen Plugins, sodass sie Teil der ausführbaren Datei oder der gemeinsam genutzten Bibliothek sind, die „ target “ darstellt. Die Suche folgt rekursiv den Importen des QML-Moduls.
Da der Aufruf von ` qmlimportscanner ` bereits zur Konfigurationszeit und nicht erst zur Generierungs- oder Erstellungszeit erfolgt, kennt ` qt_import_qml_plugins() ` nur die Informationen, die zum Zeitpunkt des Aufrufs von ` qt_import_qml_plugins() ` auf dem ` target ` (oder anderen Zielen, mit denen es verknüpft ist oder die es importiert) verzeichnet waren. Alle nach diesem Aufruf hinzugefügten Verknüpfungs- oder Importbeziehungen werden nicht berücksichtigt. Daher sollte dieser Befehl so spät wie möglich im Verzeichnisbereich von „ target “ aufgerufen werden, damit alle Verknüpfungs- und Importbeziehungen bekannt sind.
Wenn „ target “ mit „qt_add_executable()“ erstellt wurde, müssten Projekte „ qt_import_qml_plugins() “ normalerweise nicht direkt aufrufen. Wenn Qt statisch kompiliert wird, wird der Befehl automatisch als Teil der Zielfinalisierung aufgerufen, sofern „ target “ mit der Qml-Bibliothek verknüpft ist. Standardmäßig erfolgt diese Finalisierung am Ende desselben Verzeichnisbereichs, in dem „ target “ erstellt wurde. Wurde „ target “ stattdessen mit dem Standard-CMake-Befehl „ add_executable() “ erstellt, muss das Projekt „ qt_import_qml_plugins() “ selbst aufrufen.
Siehe auch 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.