qt_add_qml_preview

それ自体が QML モジュールではない実行ファイルに対して、qmlpreview のサポートを設定します。

このコマンドは Qt 6.12 で導入されました。

このコマンドは、Qt6 パッケージのQml コンポーネントで定義されており、次のように読み込むことができます:

find_package(Qt6 REQUIRED COMPONENTS Qml)

概要

qt_add_qml_preview(target)

バージョン指定なしのコマンドが無効になっている場合は、代わりに `qt6_add_qml_preview() ` を使用してください。このコマンドと同じ引数セットをサポートしています。

説明

qt_add_qml_preview() qt_add_qml_module() で作成された 1 つ以上の QML モジュールから QML を読み込むが、それ自体がqt_add_qml_module() によって作成されていない実行可能ファイル `target ` に対して、qmlpreviewのライブリロード機能をセットアップします。これにより、`<target>_qmlpreview ` という名前の追加のビルドターゲットが作成され、その実行可能ファイルに対してqmlpreview が起動されます。

target は、現在のプロジェクトによってビルドされた実行可能ターゲットでなければなりません。ライブラリターゲットや、別のパッケージからインポートされたターゲットを指定すると、configure 実行時にエラーが発生します。

target 自体がQMLモジュールである場合、このコマンドは何も実行せずに直ちに終了します。これは、そのようなターゲットはqt_add_qml_module()の一環として既にqmlpreviewのサポートを受けているためです。

target がQt6::Qml に対してリンクしているにもかかわらず、そのリンククロージャ内にプロジェクト内のQMLモジュールが見つからない場合、ビルド時に警告が出力されます。これは、その場合はQtリソースに埋め込まれたQMLのライブリロードが機能しないためです。 この場合は、プレビューしたい QML ファイルを含むqt_add_qml_module()ターゲットをtarget にリンクしてください。

デフォルトでは、Qt6::Qml にリンクするすべての実行可能ターゲットに対してqmlpreviewサポートが自動的に設定されているため、通常はqt_add_qml_preview() を呼び出す必要はまったくありません。 これは、その自動動作が無効にされている場合にのみ、ターゲットごとのオーバーライドとして有用です。これを呼び出すことで、QT_QML_NO_QML_PREVIEW 変数によってグローバルに、あるいはそのターゲットのQT_QML_NO_QML_PREVIEWプロパティによってプレビューが無効にされている場合でも、target に対するqmlpreviewサポートを有効にすることができます。

例

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)