QT_QML_NO_QML_PREVIEW (전역 속성)

Qt6::Qml을 링크하는 실행 파일에 대해 qmlpreview 지원이 자동으로 설정되는지 여부를 제어합니다.

이 변수는 Qt 6.12에서 도입되었습니다.

기본적으로, ` Qt6::Qml `에 링크된 모든 실행 파일 대상은 대상 최종화 시점에 qmlpreview 지원이 자동으로 설정되며, 이는 마치 `qt_add_qml_preview()` 가 해당 대상에 명시적으로 호출된 것과 같습니다. qt_add_qml_module() 로 생성된 QML 모듈 자체인 실행 파일 타깃은 해당 명령을 통해 이미 qmlpreview 지원을 받고 있으므로 이 설정의 영향을 받지 않습니다.

이 변수를 참(true) 값으로 설정하면 모든 타깃에 대해 자동 동작이 비활성화됩니다. 이렇게 하면 각 실행 파일에 대한 미리보기 타깃을 생성하는 데 소요되는 소량의 추가 구성 작업을 건너뛸 수 있으며, 이는 qmlpreview를 사용하지 않는 프로젝트(예: 스크립팅을 위해 QJSEngine 를 통해서만 QML을 구동하는 애플리케이션이나, 라이브 리로드가 필요 없는 릴리스 및 CI 빌드)의 경우 유용합니다. 전체 빌드에 대해 이 기능을 비활성화하려면

-DQT_QML_NO_QML_PREVIEW=ON

를 cmake 실행 파일에 전달하거나, 미리 보기가 전혀 필요하지 않은 경우 프로젝트의 CMakeLists.txt 에서 설정하십시오.

보다 세밀한 제어를 위해 개별 타깃에서는 QT_QML_NO_QML_PREVIEW 속성을 사용하여 미리보기를 비활성화하거나, 전역적으로 미리보기가 비활성화된 상태에서도 qt_add_qml_preview() 를 사용하여 다시 활성화할 수 있습니다.