qt_import_qml_plugins
Garantiza que los plugins QML necesarios para un objetivo se importen para las compilaciones estáticas.
Este comando se introdujo en Qt 6.0.
El comando está definido en el componente Qml del paquete Qt6, que puede cargarse de la siguiente manera:
find_package(Qt6 REQUIRED COMPONENTS Qml)
Sinopsis
qt_import_qml_plugins(target)
Si los comandos versionless están deshabilitados, utilice qt6_import_qml_plugins() en su lugar. Soporta el mismo conjunto de argumentos que este comando.
Descripción
Nota: Este comando sólo tiene efecto si Qt fue construido estáticamente. Si se llama usando un Qt no estático, no hará nada y volverá 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 plugins QML estáticos utilizados por target y los enlaza a dichos plugins para que formen parte del ejecutable o biblioteca compartida que representa target. La búsqueda sigue recursivamente las importaciones de módulos QML.
Dado que la llamada a qmlimportscanner se ejecuta en tiempo de configuración y no en tiempo de generación o compilación, qt_import_qml_plugins() sólo conoce la información registrada en target (u otros objetivos que vincule o importe) en el momento en que se llama a qt_import_qml_plugins(). Cualquier relación de enlace o importación añadida después de esta llamada no será tenida en cuenta. Por lo tanto, este comando debe invocarse lo más tarde posible en el ámbito del directorio de target para que se conozcan todas las relaciones de vinculación e importación.
Si target fue creado usando qt_add_executable(), los proyectos normalmente no necesitarán llamar directamente a qt_import_qml_plugins(). Cuando Qt se construye estáticamente, el comando es llamado automáticamente como parte de la finalización del objetivo si target enlaza con la librería Qml. Por defecto, esta finalización se produce al final del mismo ámbito de directorio en el que se creó target. Si target se creó utilizando el comando estándar de CMake add_executable(), el proyecto deberá llamar a qt_import_qml_plugins().
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.