En esta página

qt_add_qml_preview

Configura la compatibilidad con qmlpreview para un ejecutable que no es en sí mismo un módulo QML.

Este comando se introdujo en Qt 6.12.

Nota: Este comando se encuentra en fase de vista previa tecnológica y puede sufrir cambios en futuras versiones.

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_add_qml_preview(target)

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

Descripción

qt_add_qml_preview() Configura la compatibilidad con la recarga en tiempo real de qmlpreview para un ejecutable target que carga QML desde uno o más módulos QML creados con qt_add_qml_module(), pero que no ha sido creado por qt_add_qml_module(). Crea un objetivo de compilación adicional denominado <target>_qmlpreview que ejecuta qmlpreview en el ejecutable.

El target debe ser un objetivo ejecutable compilado por el proyecto actual. Si se pasa un objetivo de biblioteca o un objetivo importado de otro paquete, se produce un error en la fase de configuración.

Si target es en sí mismo un módulo QML, este comando finaliza inmediatamente sin realizar ninguna acción, ya que dichos objetivos ya cuentan con compatibilidad con qmlpreview como parte de qt_add_qml_module().

Si target se enlaza con Qt6::Qml pero no se encuentran módulos QML del proyecto en su cierre de enlaces, se emite una advertencia en el momento de la compilación, ya que la recarga en tiempo real del QML incrustado en los recursos de Qt no funcionará en ese caso. Si esto ocurre, vincula los objetivos de ` qt_add_qml_module() ` cuyos archivos QML desees previsualizar a ` target`.

Nota: Para poder utilizar el objetivo <target>_qmlpreview resultante, es necesario que target se compile con la infraestructura de depuración de QML, el mismo requisito que se aplica al uso directo de la herramienta qmlpreview. Además, el objetivo no se crea durante la compilación cruzada.

Por defecto, la compatibilidad con qmlpreview ya está configurada automáticamente para cada objetivo ejecutable que se vincule con Qt6::Qml, por lo que normalmente no es necesario llamar a qt_add_qml_preview() en absoluto. Solo resulta útil como anulación específica para cada objetivo cuando se ha desactivado ese comportamiento automático: al llamarla, se habilita la compatibilidad con qmlpreview para target incluso si la vista previa se ha desactivado globalmente mediante la variable QT_QML_NO_QML_PREVIEW, o para ese objetivo concreto mediante su propiedad QT_QML_NO_QML_PREVIEW.

Ejemplo

qt_add_library(mylib STATIC)
qt_add_qml_module(mylib
    URI My.Lib
    VERSION 1.0
    QML_FILES
        Main.qml
)

qt_add_executable(myapp main.cpp)
target_link_libraries(myapp PRIVATE mylib)

qt_add_qml_preview(myapp)

Véase también qmlpreview y qt_add_qml_module.

© 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.