En esta página

qt_import_qml_plugins

Garantiza que se importen los complementos QML necesarios para un destino en las compilaciones estáticas.

Este comando se introdujo en Qt 6.0.

El comando está definido en el componente « Qml » del paquete « Qt6 », que se puede cargar de la siguiente manera:

find_package(Qt6 REQUIRED COMPONENTS Qml)

Sinopsis

qt_import_qml_plugins(target)

Si los comandos sin versión están desactivados, utiliza en su lugar qt6_import_qml_plugins(). Admite el mismo conjunto de argumentos que este comando.

Descripción

Nota: Este comando solo tiene efecto si Qt se ha compilado de forma estática. Si se invoca utilizando un Qt no estático, no hará nada y retornará inmediatamente.

qt_import_qml_plugins() Ejecuta « qmlimportscanner » en « target » inmediatamente como parte de la llamada (a menos que se haya pasado la opción « NO_IMPORT_SCAN » a «qt_add_qml_module()» al definir el módulo QML). Busca los complementos QML estáticos utilizados por « target » y lo vincula a dichos complementos para que formen parte del ejecutable o de la biblioteca compartida que representa « target ». La búsqueda sigue de forma recursiva las importaciones del módulo QML.

Dado que la llamada a qmlimportscanner se ejecuta en el momento de la configuración, y no durante la generación o la compilación, qt_import_qml_plugins() solo tiene constancia de la información registrada en target (u otros objetivos a los que se vincule o importe) en el momento en que se invoca a qt_import_qml_plugins(). No se tendrán en cuenta las relaciones de vinculación o importación añadidas tras esta llamada. Por lo tanto, este comando debe invocarse lo más tarde posible dentro del ámbito del directorio de target, de modo que se conozcan todas las relaciones de enlace e importación.

Si target se creó mediante qt_add_executable(), los proyectos no necesitarían normalmente llamar directamente a qt_import_qml_plugins(). Cuando Qt se compila de forma estática, el comando se invoca automáticamente como parte de la finalización del objetivo si target enlaza con la biblioteca Qml. Por defecto, esta finalización tiene lugar al final del mismo ámbito de directorio en el que se creó el target. Si, por el contrario, el target se creó utilizando el comando estándar de CMake add_executable(), el proyecto debe invocar qt_import_qml_plugins() por sí mismo.

Véase también 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.