QQmlEngineExtensionPlugin Class

详细说明

QQmlEngineExtensionPlugin 是一个插件接口，可让您创建可动态加载到 QML 应用程序中的 QML 扩展。这些扩展允许 QML 引擎使用自定义 QML 类型。

要编写 QML 扩展插件

1. 子类QQmlEngineExtensionPlugin 并使用Q_PLUGIN_METADATA() 宏向 Qt XML 元对象系统注册插件。
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);

用 C++ 编写 QML 扩展教程》（Writing QMLExtensions with C++tutorial）中也有一章是关于创建 QML 插件的。