QT_QML_NO_QML_PREVIEW (propriété globale)

Détermine si la prise en charge de qmlpreview est automatiquement configurée pour les exécutables liés à Qt6::Qml.

Cette variable a été introduite dans Qt 6.12.

Par défaut, chaque cible exécutable liée à Qt6::Qml bénéficie automatiquement de la prise en charge de qmlpreview lors de la finalisation de la cible, comme si la fonction qt_add_qml_preview() avait été appelée explicitement sur celle-ci. Les cibles exécutables qui sont elles-mêmes des modules QML créés par ` qt_add_qml_module()` ne sont pas concernées, car elles bénéficient déjà de la prise en charge de ` qmlpreview ` grâce à cette commande.

Définir cette variable sur une valeur « true » désactive ce comportement automatique pour toutes les cibles. Cela permet d’éviter le léger surcroît de travail lors de la configuration nécessaire à la création d’une cible de prévisualisation pour chaque exécutable, ce qui est utile pour les projets qui n’utilisent pas qmlpreview, par exemple les applications qui utilisent QML uniquement via QJSEngine pour le scriptage, ou les builds de production et d’intégration continue (CI) où le rechargement en direct n’est pas pertinent. Désactivez-le pour l’ensemble d’un build en passant

-DQT_QML_NO_QML_PREVIEW=ON

à l’exécutable cmake, ou définissez-la dans l’ CMakeLists.txt du projet si l’aperçu n’est jamais nécessaire.

Pour un contrôle plus fin, les cibles individuelles peuvent désactiver la prévisualisation à l’aide de la propriété QT_QML_NO_QML_PREVIEW, ou la réactiver avec qt_add_qml_preview() même lorsque la prévisualisation est désactivée globalement.