Back to Qt.io
Contact Us Blog Download Qt
在此页面

Qt 6.11 中的新功能

Qt 6.11 中的新模块

Qt 6.11 添加了以下模块：

  • Qt Canvas Painter- 基于Qt Quick 和QRhi 渲染目标的加速 2D绘画解决方案。
  • Qt OpenAPI- 上游 Open API 生成器的扩展，可生成 Qt HTTP 客户端，通常用于 RESTful API。
  • Qt TaskTree- 提供了一种声明式方法来组成和执行异步任务工作流。
  • Qt Labs StyleKit- 专用的样式 API，可通过一组共享设计属性简化Qt Quick Controls 的样式。

新模块处于技术预览阶段，其 API 不在Qt 的兼容性承诺范围内。但我们非常欢迎反馈意见，以进一步改进它们！请通过Qt 支持中心、Qt Bug 跟踪器、Qt 论坛或链接博文的评论提出反馈意见。

Qt 画布画家模块

Qt Canvas Painter是一种加速的 2D 绘画解决方案，适用于Qt Quick 和基于QRhi 的渲染目标。另请参阅Qt Canvas Painter 博客系列，了解相关概述。

Qt OpenAPI 模块

Qt OpenAPI扩展了Open API 生成器，可生成 Qt HTTP 客户端，通常用于 RESTful API。

Qt TaskTree 模块

Qt TaskTree提供了一种声明式方法，可在 C++ 中组成和执行异步任务工作流。有关概述，请参阅简介系列博文。

Qt Labs StyleKit 模块

Qt Labs StyleKit是一个专用的样式 API，可通过一组共享设计属性简化Qt Quick Controls 的样式。

Qt 6.11 中的新功能

ActiveQt 模块

没有值得注意的变化。

Qt Bluetooth 模块

无值得注意的更改。

Qt CoAP 模块

Qt Core 模块

  • QDate 现在是弱递增的，即实现了前和后固定递增（和递减）操作符，并可在 C++20std::views::iota 中使用。
  • QJniObject API 现在可以使用std::expected （或同等类型）作为返回类型进行调用，在这种情况下，Java 异常不会被框架消耗，而是作为意外结果传回给调用者。
  • QRangeModel::ItemAccess 为访问多角色项目类型的角色数据提供了一个自定义点。
  • QRangeModel 现在可以与不提供常量std::begin/end 实现的 C++ 范围一起使用，如 C++20std::views::filter 。
  • 对于使用同一QObject 子类的多角色项目范围，可将新的QRangeModel::autoConnectPolicy 设置为 Full 或 OnRead，以将QObject 项目的所有暴露属性的更改信号连接到相应的dataChanged() 信号发射。
  • QRangeModelAdapter 该类为QRangeModel 的操作范围提供了典型的 C++ 容器 API，确保在发生变化时发出相关的QAbstractItemModel 信号，而用户代码无需处理QModelIndex 。这个新类正在技术预览中。
  • 在 Windows 上，Qt 现在会自动为使用 CMake 构建的可执行文件生成应用程序清单。该清单从PROJECT_VERSION 派生应用程序版本，支持通过 CMake 变量自定义项目标识符和执行级别，声明与 Windows 10 和 Windows 11 兼容，并启用longPathAware 。

Qt Concurrent 模块

无显著变化。

Qt D-Bus 模块

无值得注意的更改。

Qt Graphs 模块

Qt GRPC 模块

Qt GUI 模块

  • 当停靠窗口部件在停靠和浮动之间变化时，停靠窗口框架会发出新的 QAccessible::RoleChange 类型的辅助功能事件。
  • Qt Quick 控件中的 Switch 类型使用了新的可访问性角色Switch 。
  • 滑块和类似控件使用新的可访问属性Orientation 向可访问客户端报告其方向。
  • QRawFont 新增了获取glyphCount() 和查找glyphName() 字体字形索引的 API。
  • QTextCharFormat 新增了用于设置font features 和variable axes 的 API。

Qt Help 模块

无值得注意的更改。

Qt HttpServer 模块

Qt Image Formats 模块

更新了一些捆绑的第三方模块，请参见许可变更。

Qt Lottie Animation

Qt MQTT 模块

无值得注意的更改。

Qt Multimedia 模块

  • 为QAudioSource 和QAudioSink 的 start 方法添加了基于回调的重载，以允许实时音频处理。

Qt Network 模块

  • QNetworkRequest 现在可以为当前请求指定 TCP 保持在线参数。此外，QNetworkAccessManager 中的默认 TCP 保持在线参数也已更改，现在不活动连接会在两分钟后终止。

Qt Network 授权模块

没有值得注意的更改。

Qt NFC 模块

无值得注意的更改。

Qt OPC UA 模块

Qt OpenGL 模块

无值得注意的更改。

Qt Positioning 模块

  • Qt for WebAssembly应用程序现在可以使用浏览器的 GeoLocation API 作为后台。

Qt 打印支持模块

  • 改进了打印对话框的可访问性：建立了标签伙伴和适当的焦点顺序，以改进屏幕阅读器支持和键盘导航。

Qt Protobuf 模块

Qt Qml 模块

  • 在QML Language Server 中添加了工作区支持。
  • 在QML Language Server 中添加了转到 C++ 定义支持。
  • 为 qmllint 添加了通过.contextProperties.ini 配置文件静默上下文属性警告的支持。
  • 引入了override 和virtual 关键字，它们与现有的final 关键字和工具支持一起，有助于防止意外的属性阴影，并允许在 QML 中显式覆盖属性。详见属性阴影和覆盖语义。
  • 为easingCurve 值类型命名，并将Easing命名空间转换为单例。
  • 为QQmlContext 添加了获取list of child contexts 和find an object by id 的 API。
  • 为 qmlformat 添加了 GroupAttributesTogether 选项。这意味着使用 NormalizeOrder 选项，无需对属性（属性定义、属性绑定、方法、信号和枚举）进行排序就能对 QML 类别重新排序。
  • 为 qmlformat 添加了 SingleLineEmptyObjects 选项。这可防止空对象扩展到第二行。

Qt Quick 模块

Qt Quick 控制模块

Qt Quick 对话框模块

没有值得注意的更改。

Qt Quick 效果模块

Qt Quick 布局模块

没有值得注意的更改。

Qt Quick 粒子模块

无值得注意的更改。

Qt Quick 时间轴模块

无值得注意的更改。

Qt Quick Test 模块

无值得注意的更改。

Qt Quick 小工具模块

无值得注意的更改。

Qt Quick 3D 模块

  • 为用户定义的渲染通道添加了 QML API，无需 C++ 知识即可直接在 QML 中启用自定义渲染管道
  • 在ExtendedSceneEnvironment 中添加了ssrEnabled 属性，以启用屏幕空间反射 (SSR)
  • 在ExtendedSceneEnvironment 中添加了屏幕空间全局照明（SSGI）效果，可提供环境遮蔽和实时间接照明
  • 为时态 AA 和运动模糊效果添加了每个对象的运动矢量生成功能
  • 添加了分层支持，允许对节点进行分组并控制摄像机渲染的层数
  • 添加了链表顺序无关透明度（OIT）渲染方法
  • 在后期处理效果和自定义材质中添加了NORMAL_ROUGHNESS_TEXTURE 支持
  • 为 PCF 柔光阴影添加了蓝色噪点采样，可通过更少可见的噪点模式提高质量
  • 为纹理中的Qt Quick 内容添加了对预乘法 alpha 的正确处理
  • 为后期处理效果添加了VIEW_MATRIX 和PROJECTION_MATRIX 曝光
  • 在View3D 中添加了pickInRect() 方法，用于基于矩形的对象选择
  • 在View3D 中添加了closestPointPick() 方法，用于查找曲面上与给定点最近的点
  • 添加了可接受特定模型参数的重载rayPick()
  • 为粒子发射器添加了场景形状，可根据场景几何形状动态计算形状
  • 添加了用于简化自定义纹理提供程序创建的QQuick3DTextureProviderExtension API
  • 在QSSGFrameData 中添加了scheduleRenderResults() 函数，用于请求特定的渲染传递结果
  • 将 Assimp 更新至 6.0.2 版

Qt Quick 3D XR 模块

  • 已添加 OpenGL 桌面 Linux 支持（Monado、Xlib 和 Wayland 平台）
  • 扩展了processTouch() 以向任何可拾取的Model 传递触摸事件，而不仅仅是XrItem
  • 增强了touchpointState() 功能，可为 3D 触摸交互返回表面位置和法向量信息
  • 通过专用的 QQuickOverlay 在XrItem 中添加了弹出窗口和菜单支持
  • 将 OpenXR 更新至 1.1.49 版

Qt Quick 三维物理模块

无值得注意的更改。

Qt Quick 矢量图像模块

  • 已添加对 SVG 掩码的支持。
  • 添加了对 SVG 后处理过滤器的支持，以匹配 Qt SVG：feGaussianBlur、feColorMatrix、feOffset、feFlood、feBlend、feComposite 和 feMerge。
  • 已添加对沿路径动画形状的支持。
  • 已添加对 SVG <symbol> 标记的支持。

Qt Serial Port 模块

无值得注意的更改。

Qt Serial Bus 模块

无值得注意的更改。

Qt SQL 模块

无值得注意的更改。

Qt SVG 模块

  • 通过offset-path 和offset-distance 添加了对 CSS 运动路径动画的支持。请注意，offset-path 只支持用于定义路径的路径函数。
  • 已添加对 CSS 动画定时功能的支持。目前只支持预定义的关键字（linear,step-start,ease 等）。

Qt Test 模块

  • 已添加QTest::currentGlobalDataTag() 函数，用于获取当前全局测试数据的名称。
  • 添加了QTest::defaultTryTimeout ，允许配置 QTRY_* 函数使用的默认超时。
  • QCOMPARE 现在可打印负零和 NaN 值的符号，并打印 NaN 有效负载。
  • QTEST_THROW_ON_FAIL 当在QtConcurrent 中调用 QCOMPARE/QSKIP 时，现在 QCOMPARE_* 和QTEST_THROW_ON_SKIP 都能正常工作。
  • QTest::failOnWarning() 现在在消息类型 >= 警告（包括关键消息）时都会失败。
  • 在 macOS 上，显示休眠和 App Nap 现在会在整个测试执行过程中无条件禁用。
  • 将 Callgrind 支持更新至 Valgrind v3.25.1，增加了对 RISCV 64 位 Linux 的支持。

Qt 虚拟键盘模块

  • Qt 6.11 在VirtualKeyboardSettings 中引入了arrowKeyNavigationEnabled 属性，允许开发人员控制在输入面板可见时是否可以使用方向键（左、右、上、下）和 Return 键在键盘键之间导航。该属性默认基于构建时配置标志QT_VIRTUALKEYBOARD_ARROW_KEY_NAVIGATION 。
  • 为KeyboardStyle 类型添加了keyboardDesignMaximumHeight 属性。使用该属性可避免键盘与屏幕大部分区域重叠。

Qt WebEngine 模块

  • Qt XMLWebEngine 现在基于 Chromium 140。
  • Chromium 添加了新的 Rust 组件，以取代 C++ 对应组件。QtWebEngine 现在可以选择使用这些 Rust 组件构建。这需要安装 Rust 工具链，并通过-feature-webengine-rust-build 进行配置。默认行为是使用旧版 C++ 组件构建。
  • 添加了OnlyPersistentCookies 策略，以防止会话 cookie 被保存到磁盘。
  • 添加了TrimAccessibilityIdentifiers 设置，以强制将 HTML "id "属性用作自动化 ID，实现可访问性。
  • 已添加对 HTMLinputmode 全局属性的支持。
  • 改进了fetch() API 对重定向到跨源码资源的处理。
  • 删除了 Pepper Plugin API 代码。
  • 启用chrome://usb-internals 调试页面。

Qt WebView 模块

  • 为WebView 添加了 C++ 绑定，允许在基于Qt Widgets 的应用程序中使用该模块。新的 C++ API 以技术预览版状态发布，将来可能会更改。

Qt Widgets 模块

Qt XML 模块

没有值得注意的更改。

工具

QDoc 文档生成器

  • 新增了对 QML 单例类型的全面支持，包括新的\qmlsingletontype 命令、自动检测QML_SINGLETON 宏以及识别 QML 文件中的pragma singleton 。
  • QDoc 现在完全支持 QML 模块别名（import ... as ... 语法），包括链接、限定标识符的语法高亮显示，以及属性符号（如anchors.fill ）和附加属性（如Component.onCompleted ）的正确标记。
  • 您可以使用新的\toc/\endtoc 和\tocentry 命令在文档源文件中指定分层目录结构。QDoc 可为导航侧边栏生成<project>_toc.xml 文件。
  • 该 \overload命令现在带有一个可选参数。使用\overload primary 语法指定重载集中的主要函数。
  • QDoc 现在可为重载信号和插槽生成上下文连接示例。
  • includeprivate 配置变量可用于记录私有 C++ 成员。纯虚函数现在已无条件文档化。
  • C++20 概念：QDoc 现在可提取并显示函数和类模板的 C++20 requires 子句。支持模板头和尾部约束位置。
  • 该 \code命令现在接受一个可选参数，用于指定代码块的编程语言。使用 "text "可禁用语法高亮。
  • \meta keywords 参数可将自定义关键字添加为 HTML<meta> 元素，用于搜索引擎优化和后处理。
  • 使用 "attached "链接标准，现在可支持对 QML 附加属性的显式链接，从而在常规属性和附加属性名称冲突时消除歧义。
  • 现在，带有两个以上参数的模板声明将以多行格式呈现，以提高可读性。HTML 输出使用template-block CSS 类自定义样式。
  • QDoc 现在会对使用Q_PROPERTY 声明的未注明的 C++ 属性发出警告，确保所有 API 元素的文档覆盖范围保持一致。
  • 在\sa 命令中，当文档链接到自身时，QDoc 现在会对自链接发出警告。
  • logwarnings 配置变量可让 QDoc 将所有警告写入<project>-qdoc-warnings.log 文件。新的logwarnings.disablecliargs 子选项可从可移植日志的日志头中省略 CLI 参数。
  • QDoc 警告现在包含多模块构建的项目名称前缀。
  • 配置改进：
    • codelanguages:在\code 块中指定更多可接受的编程语言，允许文档包含没有内置语法高亮标记的语言代码。
    • imagesoutputdir:自定义图像输出子目录，以解决多模块构建中的文件名冲突问题。
    • internalfilepatterns:根据文件/路径名模式自动将类标记为内部类，如*_p.h 。
    • projectroot:设置根目录，以便在警告日志中将绝对路径转换为相对路径，从而提高跨构建环境的可移植性。也可作为QDOC_PROJECT_ROOT 环境变量使用。
  • 格式化命令现在可在\title 参数中使用，\generatelist 可在 Qt Help 项目 TOC 结构中正确工作，\qmlenum 中支持自定义枚举器前缀。
  • 统一了 QML 和 C++ 成员文档的 HTML 结构。这一变更在 QDoc 的 HTML 输出中引入了新的 CSS 类 (qml-member,qml-property,qml-method,qml-property-group)。
  • 代码解析：改进了作用域枚举解析、带有循环检测功能的 QML 继承处理，以及索引文件中声明类型和变量信息的正确保存。
  • 新增 LLVM/Clang 21 兼容性，最低支持版本更新为 17.0.6。
  • \tableofcontents 命令已被正式弃用。

Qt Linguist

  • 添加了标签，以便在不影响运行时行为的情况下将基于 ID 的翻译归类为有意义的组。有关详情，请参阅基于文本 ID 的翻译文档和博文。
  • 为文档添加了新的 i18n 示例。
  • 为Qt Linguist 添加了 AI 翻译，以便使用 LLM 进行自动翻译。有关详情，请参阅AI 翻译文档和博文。
  • 已添加 ltext2id 可执行文件，用于将项目从基于文本的翻译迁移到基于 ID 的翻译。更多详情，请参阅使用 ltext2id。
  • 已添加 lcheck 可执行程序，用于对 TS 文件执行批量验证。更多详情，请参见使用 lcheck。
  • 在 lupdate 解析器中添加了对 C++ 属性的支持
  • 取消了在 lupdate 解析器中使用 //= 元字符串。
  • 废弃了用于直接处理 .pro 文件的lupdate -pro 选项。改用lupdate-pro 。
  • 删除了 lprodump 可执行文件。现在可通过lupdate-pro -dump-json 选项使用其功能。

平台变更

构建系统变更

  • 添加了 -generate-vcpkg-manifest 配置选项。这会在联编目录中生成 vcpkg.json 文件。要只生成清单而不配置 Qt，可使用 -generate-vcpkg-manifest -dry-run 运行 configure。
  • 使用 -vcpkg 配置时，在联编目录中生成 vcpkg 清单文件，并将 VCPKG_MANIFEST_DIR 设置为联编目录，以使用该清单文件。你可以使用 -no-generate-vcpkg-manifest 关闭清单生成。通过向 configure 传递 -UVCPKG_MANIFEST_DIR 可以关闭设置清单目录。

桌面平台

Windows 平台

  • 通过QOperatingSystemVersion 添加了对 Windows 11 25H2 (Build 10.0.26200) 的支持和检测。
  • 对顶层窗口和焦点的可访问性进行了各种改进。
  • 改进了刷新率更新处理。
  • 在使用 Visual Studio 2026 时添加了对ARM64EC的实验性支持。要使用此配置，请在 Windows on ARM 机器上将/arm64EC 添加到CFLAGS ，并将/arm64EC 和/d2arm64ECMarkAllFuncsPatchable 添加到CXXFLAGS 环境变量，然后像通常一样配置和构建 Qt。

Linux

  • Wayland 插件获得了服务器端按键重复、服务器端装饰首选项、对xx-session-management-v1 的实验性支持以及大量稳定性修复（弹出窗口、滚动、屏幕外表面、剪贴板）。
  • 删除了 XCB 的传统 X11 原生绘画引擎 (XRender)。使用该引擎需要在编译时通过 CMake 选项 (-xcb-native-painting) 启用，并在运行时通过QT_XCB_NATIVE_PAINTING 环境变量启用。
  • 通过添加对 AT-SPI Collection 接口的支持，增强了可访问性，该接口为在应用程序的可访问性层次结构中检索可访问对象提供了更有效的机制。该界面还支持 Orca 屏幕阅读器的浏览模式。
  • XKB：为Qt::Key_Call /Qt::Key_Hangup 扩展了按键映射。

macOS

  • 沙盒应用程序现在可以访问应用程序沙盒以外的文件（即所谓的安全范围资源）进行读写。用户通过文件对话框或类似的本地机制选择的文件或文件夹会自动得到透明处理，包括跨应用程序和设备重启时的持久访问。
  • 为访问底层 NSScreen 添加了QNativeInterface::QCocoaScreen 。
  • CGImageRef 和QImage 之间的转换现在支持更广泛的图像格式，包括对 HDR 内容非常重要的QImage::Format_RGB30 和浮点格式。
  • Apple 图标引擎现在尊重绘制者的布局方向，如果 SF Symbols 图标集中有可用的图标，会生成 RTL 专用图标。
  • 通过本地打开/保存面板选择的文件路径现在已进行 NFC 归一化处理，无论文件系统是否以 NFD 形式存储文件名，都能确保文件名比较的一致性。

移动平台

安卓

安卓版 Qt
  • Qt Jenny 现在支持在 C++ 中实现 Java 接口和扩展 Java 类。
  • 支持 Play Store 的功能交付。
  • 支持 Android 16。
  • 更新至 Gradle 9.3.1 和 Android Gradle Plugin 9.0.0。
  • 更新至 JDK 21 LTS，并将兼容性提升至 JDK 17 LTS。
Qt Quick 针对安卓
  • 添加了 QtQuickView.invokeMethod()，用于从 Java/Kotlin 调用 QML 函数。
  • 支持在加载 QML View 之前注册信号。

iOS

  • 已添加对平台主题中文件图标的支持。
  • 已添加QFileOpenEvent 支持打开文件的外部请求。
  • 沙盒应用程序现在可以访问应用程序沙盒以外的文件（所谓的安全范围资源）进行读写。用户通过文件对话框或类似的本地机制选择的文件或文件夹会自动得到透明处理，包括跨应用程序和设备重启时的持续访问。
  • 新增了对本地保存对话框的支持。

嵌入式平台

嵌入式平台

  • EGLFS/KMS 现在支持在运行时热插拔和热重载显示器（由QT_QPA_EGLFS_HOTPLUG_ENABLED 环境变量保护）。
  • 新增基于 ConnMan 的QNetworkInformation 后端。
  • DirectFB：新增Qt::Key_Call 映射。

Boot to Qt

  • 新的二级平台：
    • NXP i.MX 8M Plus LDDPR4 EVK
    • Toradex i.MX 95 Verdin
    • 高通 RB3 Gen2 Vision Kit

网络平台

WebAssembly

  • Qt Positioning为 GeoLocation API 提供了一个后端。
  • 使用新的wasmdeployqt 工具来部署和发布动态链接的Qt for WebAssembly应用程序。它取代了之前的preload_qt_plugins.py 和preload_qml_imports.py Python 脚本。

API 更改列表

这些页面概述了 Qt 6.11 中的 API 变化：

已知问题

有关 Qt 6.11 中已知问题的信息，请参阅Qt Wiki。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.