qt_add_qml_preview

Configure la prise en charge de qmlpreview pour un exécutable qui n'est pas lui-même un module QML.

Cette commande a été introduite dans Qt 6.12.

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

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

Description

qt_add_qml_preview() Configure la prise en charge du rechargement en direct (live-reload) de qmlpreview pour un exécutable target qui charge du QML à partir d’un ou plusieurs modules QML créés avec qt_add_qml_module(), mais qui n’est pas lui-même créé par qt_add_qml_module(). Elle crée une cible de compilation supplémentaire nommée <target>_qmlpreview qui lance qmlpreview sur l’exécutable.

target doit être une cible exécutable compilée par le projet en cours. Le passage d’une cible de bibliothèque ou d’une cible importée depuis un autre paquet entraîne une erreur lors de la configuration.

Si target est lui-même un module QML, cette commande se termine immédiatement sans rien faire, car ces cibles bénéficient déjà de la prise en charge de qmlpreview dans le cadre de qt_add_qml_module().

Si target est lié à Qt6::Qml mais qu’aucun module QML du projet ne se trouve dans sa clôture de liens, un avertissement est émis lors de la compilation, car le rechargement en direct du QML intégré dans les ressources Qt ne fonctionnera pas dans ce cas. Si cela se produit, liez la ou les cibles qt_add_qml_module() dont vous souhaitez prévisualiser les fichiers QML à target.

Par défaut, la prise en charge de qmlpreview est déjà configurée automatiquement pour chaque cible exécutable liée à Qt6::Qml; vous n’avez donc normalement pas besoin d’appeler qt_add_qml_preview(). Cette fonction n’est utile qu’en tant que redéfinition par cible lorsque ce comportement automatique a été désactivé : son appel active la prise en charge de qmlpreview pour target même si l’aperçu a été désactivé globalement via la variable QT_QML_NO_QML_PREVIEW, ou pour cette cible via sa propriété QT_QML_NO_QML_PREVIEW.

Exemple

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)