QT_QML_NO_QML_PREVIEW (globale Eigenschaft)

Steuert, ob die Unterstützung für qmlpreview automatisch für ausführbare Dateien eingerichtet wird, die gegen Qt6::Qml verknüpft sind.

Diese Variable wurde in Qt 6.12 eingeführt.

Standardmäßig wird für jedes ausführbare Ziel, das gegen „ Qt6::Qml “ verknüpft ist, die „qmlpreview“-Unterstützung bei der Zielfinalisierung automatisch eingerichtet, so als wäre „qt_add_qml_preview()“ explizit dafür aufgerufen worden. Ausführbare Ziele, die selbst QML-Module sind, die mit ` qt_add_qml_module() ` erstellt wurden, sind davon nicht betroffen, da sie die qmlpreview- Unterstützung bereits über diesen Befehl erhalten.

Wird diese Variable auf einen wahren Wert gesetzt, wird das automatische Verhalten für alle Ziele deaktiviert. Dadurch entfällt der geringe zusätzliche Aufwand bei der Konfiguration, der durch die Erstellung eines Vorschau-Ziels für jede ausführbare Datei entsteht. Dies lohnt sich für Projekte, die qmlpreview nicht verwenden – beispielsweise Anwendungen, die QML lediglich über eine „ QJSEngine “ für Skripte steuern, oder Release- und CI-Builds, bei denen Live-Reload keine Rolle spielt. Deaktivieren Sie diese Funktion für einen gesamten Build, indem Sie

-DQT_QML_NO_QML_PREVIEW=ON

an das CMake-Programm übergeben oder in der Projektdatei ` CMakeLists.txt ` festlegen, falls eine Vorschau niemals benötigt wird.

Für eine feinere Steuerung können einzelne Ziele mit der Eigenschaft ` QT_QML_NO_QML_PREVIEW ` deaktiviert oder mit ` qt_add_qml_preview() ` wieder aktiviert werden, selbst wenn die Vorschau global deaktiviert ist.