Qt Qml

Qt Qml 模块为使用QML语言开发应用程序和库提供了一个框架。它定义并实现了该语言及引擎的基础架构，并提供了一个API，使应用程序开发人员能够注册自定义的QML类型和模块，并将QML代码与JavaScript和C++进行集成。Qt Qml 模块同时提供了QML API 和C++ API 。

使用该模块

QML API

可通过QtQml 导入使用该模块的 QML 类型。要使用这些类型，请在您的 .qml 文件中添加以下导入语句：

import QtQml

Qt Qml 模块包含QML框架以及应用程序中使用的关键QML类型。QML的语法结构在《QML参考手册》中进行了说明。

Qt Qml 模块的QML API 提供了多种QML对象类型、QML值类型和命名空间。

C++ API

要使用 Qt 模块的 C++ API，需要将程序链接到该模块库，可以是直接链接，也可以通过其他依赖项间接链接。包括CMake和qmake 在内的多种构建工具都对此提供了专门支持。

C++ API 包含一些您应熟悉的重要类，同时也提供了用于存储 JavaScript 值的类型。

使用 CMake 进行构建

使用 `find_package() ` 命令在 `Qt6 ` 软件包中定位所需的模块组件：

find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)

更多详细信息，请参阅《使用 CMake 构建》概述。

若要为非 QML 库提供外部 QML 类型支持，请按以下方式定位QmlIntegration 模块：

find_package(Qt6 REQUIRED COMPONENTS QmlIntegration)
target_link_libraries(mytarget PRIVATE Qt6::QmlIntegration)

详情请参阅qt_generate_foreign_qml_types()。

使用 qmake 进行构建

要配置模块以便使用 qmake 进行构建，请在项目的 .pro 文件中将该模块作为QT 变量的值添加：

QT += qml

注册 QML 类型和 QML 模块

为了注册可在 QML 中使用的类型，首先需要定义一个QML 模块，建议在 CMake 中使用qt_add_qml_module()函数。然后，您可以将 C++ 头文件添加到新模块中，并在其中定义要向 QML 暴露的 类型。

调整引擎

有多种配置选项可用于自定义 QML 引擎的行为。关于配置 JavaScript 引擎的页面列出了可用于此目的的环境变量。QML 磁盘缓存的说明介绍了与 QML 组件编译和加载方式相关的选项。

文章与指南

这些文章包含有关Qt Qml 的信息。

• QML 参考手册
• Qt Qml 开发工具
• 编写 QML 模块
• QML 中的单例

参考

• C++ Classes
• QML Types

许可与归属

Qt Qml 由The Qt Company 提供商业许可。此外，它还提供自由软件许可。自 Qt 5.4 起，这些自由软件许可包括GNU 较宽通用公共许可证第 3 版或GNU 通用公共许可证第 2 版。更多详情请参阅Qt 许可。

此外，Qt 6.12.0 中的Qt Qml 可能包含采用以下宽松许可证的第三方模块：