qt_add_qml_preview

Richtet die qmlpreview-Unterstützung für eine ausführbare Datei ein, die selbst kein QML-Modul ist.

Dieser Befehl wurde in Qt 6.12 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)

Syntax

qt_add_qml_preview(target)

Wenn versionlose Befehle deaktiviert sind, verwenden Sie stattdessen „ qt6_add_qml_preview() “. Dieser Befehl unterstützt dieselben Argumente wie der vorliegende Befehl.

Beschreibung

qt_add_qml_preview() Richtet die Live-Reload-Unterstützung von `qmlpreview` für eine ausführbare Datei ` target ` ein, die QML aus einem oder mehreren mit `qt_add_qml_module()` erstellten QML-Modulen lädt, selbst jedoch nicht mit `qt_add_qml_module()` erstellt wurde. Es wird ein zusätzliches Build-Ziel namens ` <target>_qmlpreview ` erstellt, das `qmlpreview` für die ausführbare Datei startet.

Die Datei „ target “ muss ein vom aktuellen Projekt erstelltes ausführbares Ziel sein. Die Übergabe eines Bibliotheksziels oder eines aus einem anderen Paket importierten Ziels führt zu einem Fehler bei der Konfiguration.

Ist „ target “ selbst ein QML-Modul, kehrt dieser Befehl sofort zurück, ohne etwas auszuführen, da solche Ziele bereits im Rahmen von „qt_add_qml_module()“ Unterstützung für „qmlpreview“ erhalten.

Wenn „ target “ gegen „ Qt6::Qml “ verknüpft ist, aber in seiner Verknüpfungsumgebung keine projektinternen QML-Module gefunden werden können, wird beim Erstellen eine Warnung ausgegeben, da in diesem Fall das Live-Neuladen von in Qt-Ressourcen eingebetteten QML-Dateien nicht funktioniert. In diesem Fall verknüpfen Sie das/die qt_add_qml_module() -Ziel(e), deren QML-Dateien Sie in der Vorschau anzeigen möchten, mit „ target “.

Standardmäßig ist die qmlpreview-Unterstützung bereits automatisch für jedes ausführbare Ziel eingerichtet, das gegen „ Qt6::Qml “ verknüpft ist, sodass Sie „ qt_add_qml_preview() “ normalerweise gar nicht aufrufen müssen. Der Aufruf ist nur als zielspezifische Überschreibung sinnvoll, wenn dieses automatische Verhalten deaktiviert wurde: Er aktiviert die qmlpreview- Unterstützung für target, selbst wenn die Vorschau global über die Variable `QT_QML_NO_QML_PREVIEW` oder für dieses Ziel über dessen Eigenschaft `QT_QML_NO_QML_PREVIEW` deaktiviert wurde.

Beispiel

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)