QT_QML_NO_QML_PREVIEW (グローバルプロパティ)

Qt6::Qml にリンクする実行ファイルに対して、qmlpreview のサポートが自動的に設定されるかどうかを制御します。

この変数は Qt 6.12 で導入されました。

デフォルトでは、Qt6::Qml にリンクするすべての実行可能ターゲットに対して、ターゲットの最終化時にqmlpreviewサポートが自動的に設定されます。これは、あたかもそのターゲットに対してqt_add_qml_preview()が明示的に呼び出されたかのような動作です。qt_add_qml_module()によって作成された QML モジュールそのものである実行可能ターゲットは、そのコマンドからすでにqmlpreviewサポートを取得しているため、この設定の影響を受けません。

この変数を真の値に設定すると、すべてのターゲットに対してこの自動動作が無効になります。 これにより、実行可能ファイルごとにプレビューターゲットを作成するために費やされる、設定時のわずかな余分な作業が省略されます。これは、qmlpreview を使用しないプロジェクト、たとえば、スクリプト作成のためにQJSEngine を通じてのみ QML を駆動するアプリケーションや、ライブリロードが関係のないリリースおよび CI ビルドなどにおいて有益です。プレビューが一切必要ない場合は、CMake 実行可能ファイルに

-DQT_QML_NO_QML_PREVIEW=ON

を`cmake`実行ファイルに渡し、またはプレビューが一切不要な場合はプロジェクトのCMakeLists.txt で設定することで、ビルド全体に対して無効化できます。

よりきめ細かな制御を行うには、個々のターゲットでQT_QML_NO_QML_PREVIEWプロパティを使用してプレビューを無効にしたり、グローバルにプレビューが無効になっている場合でもqt_add_qml_preview()を使用して再び有効にしたりできます。