QQmlEngineExtensionPlugin Class

詳しい説明

QQmlEngineExtensionPlugin は、QML アプリケーションに動的に読み込まれる QML 拡張を作成するためのプラグインインタフェースです。このプラグインを使うことで、QMLエンジンに独自のQML型を追加することができます。

QML拡張プラグインを作成するには

1. QQmlEngineExtensionPlugin をサブクラス化し、Q_PLUGIN_METADATA() マクロを使用して Qt メタオブジェクトシステムにプラグインを登録します。
2. QML_ELEMENT とQML_NAMED_ELEMENT() マクロを使って QML タイプを宣言します。
3. ビルドファイルを設定します。

   CMake を使用してください：

   qt_add_qml_module(<target>
       URI <my.import.name>
       VERSION 1.0
       QML_FILES <app.qml>
       NO_RESOURCE_TARGET_PATH
   )

   qmake：

   CONFIG += qmltypes
   QML_IMPORT_NAME = <my.import.name>
   QML_IMPORT_MAJOR_VERSION = <version>

4. qmakeを使っている場合は、プラグインを記述するqmldirファイルを作成する。CMakeはデフォルトでqmldirファイルを自動的に生成します。

QML拡張プラグインには、アプリケーション固有のプラグインと、ライブラリのようなプラグインがあります。ライブラリプラグインは、エンジンのルートコンテキストを操作することで、ライブラリユーザーのコードにコンフリクトやその他の問題を引き起こす可能性があるため、型の登録に限定してください。

リンカは最適化のために、生成された型登録関数を誤って削除することがあります。これを防ぐには、コードのどこかで関数への合成揮発性ポインターを宣言します。モジュールの名前が "my.module "であれば、グローバル・スコープに前方宣言を追加する：

void qml_register_types_my_module();

そして、登録と同じバイナリに含まれる関数の実装に、以下のコードを追加します：

volatile auto registration = &qml_register_types_my_module;
Q_UNUSED(registration);

チュートリアル「Writing QML Extensions with C++」には、QMLプラグインの作成に関する章もあります。