qt_import_qml_plugins

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

このコマンドはQt6 パッケージのQml コンポーネントで定義されています：

find_package(Qt6 REQUIRED COMPONENTS Qml)

概要

qt_import_qml_plugins(target)

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

説明

qt_import_qml_plugins() QML モジュールを定義する際にNO_IMPORT_SCAN オプションがqt_add_qml_module()に渡されていなければ）呼び出しの一部としてtarget でqmlimportscanner を即座に実行します。target が使用する静的 QML プラグインを検索し、それらのプラグインがtarget が表す実行形式または共有ライブラリの一部となるようにリンクします。検索はQMLモジュールのインポートを再帰的にたどります。

qmlimportscanner の呼び出しは生成時やビルド時ではなく configure 時に実行されるため、qt_import_qml_plugins() はqt_import_qml_plugins() が呼び出された時点でtarget (またはリンクやインポートする他のターゲット) に記録されている情報しか知りません。この呼び出しの後に追加されたリンクやインポートの関係は考慮されない。したがって、このコマンドは、target のディレクトリースコープ内で、リンクとインポートの関係がすべてわかるように、できるだけ遅い段階で呼び出すべきである。

target がqt_add_executable() を使用して作成された場合、通常、プロジェクトはqt_import_qml_plugins() を直接呼び出す必要はありません。Qtが静的にビルドされた場合、target がQmlライブラリにリンクしていれば、ターゲットのファイナライゼーションの一部として、このコマンドが自動的に呼び出されます。デフォルトでは、この最終化はtarget が作成されたのと同じディレクトリ・スコープの末尾で行われます。target が標準の CMakeadd_executable() コマンドで作成された場合、プロジェクトはqt_import_qml_plugins() を呼び出す必要があります。