使用 QML 模块插件

QML 模块可使用C++ 插件，将 C++ 中定义的组件公开给Qt Quick 应用程序。

创建 QML 模块：

1. 创建自定义组件，并将所有.qml 文件放到模块专用目录中。例如，imports\asset_imports 。
2. 对于Qt Quick UI Prototype 项目 (.qmlproject)，在要使用模块的应用程序的.qmlproject 文件中指定模块所在目录的路径，作为importPaths 变量的值。例如，importPaths: [ "imports", "asset_imports" ] 。
3. 为模块创建qmldir 文件，并将其放在模块目录中。更多信息，请参阅模块定义 qmldir 文件。
4. 在模块目录下创建名为designer 的目录。
5. 为模块创建.metainfo 文件，并将其放在designer 目录中。以 Qt XML 提供的 metainfo 文件（如qtquickcontrols2.metainfo ）为例。
6. 按照导入 QML 模块的说明，将模块导入项目。

使用 Qt 6.1 或更早版本开发

自 Qt 6.2 起，CMake 会自动生成qmltypes 和qmldir 文件。

生成类型描述文件

注册 QML 类型时，确保 QML 模块有plugins.qmltypes 文件。理想情况下，它应与qmldir 文件位于同一目录。qmltypes 文件描述了模块插件导出的组件，并在模块导入时由Qt Creator 加载。

更多信息，请参阅类型描述文件。

自动转储插件

如果带有插件的模块缺少qmltypes 文件，Qt Creator 会尝试在后台运行qmldump 程序，自行生成临时文件。不过，这种自动转储是一种后备机制，有许多故障点，不能依赖它。

导入 QML 模块

默认情况下，Qt Creator 会在 Qt 的 QML 导入路径中查找 QML 模块。

如果您使用 qmake，而且您的应用程序添加了Qt Creator 应使用的其他导入路径，请在应用程序的.pro 文件中使用QML_IMPORT_PATH 指定它们：QML_IMPORT_PATH += path/to/module 。

如果使用 CMake，请在CMakeLists.txt 文件中添加以下命令来设置 QML 导入路径：

set(QML_IMPORT_PATH ${CMAKE_SOURCE_DIR}/qml ${CMAKE_BINARY_DIR}/imports CACHE STRING "" FORCE)

导入路径会影响 CMake 项目构建的所有目标。

在设计模式下运行 QML 模块

QML Puppet 在Design 模式下用于渲染、预览图像和收集数据。为能正确渲染来自 QML 模块的自定义组件，QML Puppet 必须使用与 QML 模块相同的 Qt 版本和编译器构建。

插件的行为应根据它是由 QML Puppet 运行还是由应用程序运行而有所不同。例如，动画不应在Design 模式下运行。你可以使用QML_PUPPET_MODE 环境变量的值来检查插件当前是由应用程序运行，还是在Design 模式下编辑。