Qt 6.7 的新功能

Qt 6.7 的新功能

Qt Core 模块

• 新增了QSpan ，这是 Qt 对 C++20 std::span 的重新实现。
• 新增了Qt::strong_ordering 、Qt::weak_ordering 和Qt::partial_ordering 类，它们是std::*_ordering 类的C++17兼容实现。
• 添加了辅助宏，以便在 Qt 类中便捷地实现关系运算符。这些宏在 C++20 构建中提供 operator<=>()，而在 C++17 构建中则回退到全部六个关系运算符。
• 将这些辅助宏应用于QDate 、QTime 、QDateTime 、QTimeZone 和qfloat16 类。
• 新增了QAtomicScopedValueRollback 类。
• 新增了Qt::Key_micro ，最终将取代命名有误的Key_mu：它表示的是微符号U+00B5，而非希腊字母mu（U+03BC或U+039C）。
• QLocale' 的 name()、bcp47Name() 和 uiLanguages() 方法现在允许调用者指定名称中标签之间使用的分隔符。
• QLocale 现在会（在可能的情况下）对格式化日期时间中的时区部分进行本地化处理。
• 对两位数年份的日期（和日期时间）解析现在允许调用者控制选取这些年份所属的世纪。
• QCalendar 现在提供了 matchCenturyToWeekday() 方法，以支持对两位数年份的解析。
• QDateTime 现在接受 TransitionResolution 参数，允许调用者控制时区转换的解析方式。间隙中日期时间的默认解析现在是有效的，但其 time() 和可能的 date() 现在与 toMSecsSinceEpoch() 报告的结果一致，而不是与请求的结果一致。

Qt D-Bus 模块

• 已移除已弃用的 <qdbusmacros.h> 头文件。请改用 <qtdbusglobal.h>。
• 新函数QDBusAbstractInterface::setInteractiveAuthorizationAllowed() 允许为异步调用设置ALLOW_INTERACTIVE_AUTHORIZATION 标志。

Qt Graphs 模块

Qt Graphs3D

• 数据 API 不再要求将每个数据项都创建在堆内存中。
• 添加了“渲染到图像”功能。

Qt Graphs2D

• 2D 图表的技术预览版。
• 包含对条形图、折线图和散点图的初步支持。

Qt GRPC 模块

• 新增了使用拦截器来定制 QtGRPC 调用和流行为的功能。现在，您可以继承 QGrpcClientInterceptor 并重写所需的拦截方法。
• 引入了QGrpcServerStream 、QGrpcClientStream 和QGrpcBidirStream类。这些类分别用于实现客户端、服务器端和双向流调用。

Qt GUI 模块

• 添加了QIconEngine 的实现，可访问 Windows 10 和 11、macOS、iOS 以及 Android 平台上的原生图标库。
• 新增了QEvent::ChildWindowAdded 和QEvent::ChildWindowRemoved 两种事件类型，并配有相应的QChildWindowEvent 类，用于在子窗口添加或移除时通知父窗口。
• 启用了在所有平台上加载可变应用程序字体的功能（Windows 系统需使用 DirectWrite 或 FreeType 后端）。
• QFont 新增了用于处理 `variable fonts` 的 API。
• 新的QFont::Tag 类型可用于配合新的可变字体支持 API 指定轴，以及配合support for typographical features ——该 API 作为预发布 API 首次出现在 Qt 6.6 中，现已正式发布。

Qt Multimedia 模块

• FFmpeg 多媒体后端现在可在 Windows 上与 FFmpeg 进行动态链接。预编译的 FFmpeg 二进制文件通过在线安装程序提供。使用 FFmpeg 后端的 Windows 应用程序现在必须使用 windeployqt 将其作为安装程序的一部分打包 FFmpeg 二进制文件。
• 新增的MediaPlayer::autoPlay 和Video::autoPlay 属性可用于在设置媒体源后自动开始播放。
• QCameraDevice 新增了correctionAngle 属性。该属性表示为补偿相机相对于其原生方向的物理旋转所需的旋转角度。

Qt Network 模块

• 添加了QHttpHeaders 类来表示 HTTP 头。
• 新增了对 std::chrono 的支持，用于通过 `QNetworkRequest ` 和 `QNetworkAccessManager` 设置传输超时。
• 新增了QNetworkRequestFactory 类（技术预览版）。该类是用于创建网络请求的便捷类。
• 新增了QRestAccessManager 和QRestReply （技术预览版）。这些类是针对 RESTful 用例进行优化的便捷封装类。

Qt OPC UA 模块

• 新增了QOpcUaHistoryEvent 和QOpcUaHistoryReadEventRequest 类，用于读取历史事件。
• 新增了QOpcUaGenericStructHandler 类和相关数据类，以支持通用 OPC UA 结构的解码和编码。

Qt Protobuf 模块

• 新增了序列化器，为基于QProtobufMessage 的类实现了JSON序列化和反序列化功能。
• 在Qt Protobuf 生成器中增加了对“可选”字段的支持。如果消息字段被标记为“可选”，除了常规字段的方法外，它还会拥有 clear<fieldName> 和 has<fieldName> 方法。
• 由Qt Protobuf 生成器生成的枚举字段现在会保留首字母的大小写。此前，生成器会将生成的枚举字段名称首字母大写。

Qt Qml 模块

• QML Language Server 新增了以下功能：格式化、语义和代码片段补全、重命名用法，以及通过 QT_QML_GENERATE_QMLLS_INI 在 CMake 中设置文件生成。
• QML 文件的翻译上下文可通过以下方式设置pragma Translator
• 现在可以在值类型上声明QML_CONSTRUCTIBLE_VALUE 和QML_STRUCTURED_VALUE ，并从QML中构造此类类型的对象。实际上，自Qt 6.5起这一功能已可使用，但现在已获得官方支持。

Qt Quick Compiler

• 将值类型的属性写入的绑定和函数现在可以编译为 C++
• 可选链式调用现可编译为 C++
• for..in 迭代现在可以编译为 C++

Qt Quick 模块

• 新增了用于从文件加载的TextEdit.textDocument.source 属性，以及用于写入的save() 和saveAs() 函数。这些功能旨在在文本处理场景中取代 XMLHttpRequest。
• 在TextEdit 和TextArea 中添加了cursorSelection 属性，用于检查和修改所选文本的属性。
• 更新了“文本编辑器”示例以演示这些功能。
• 新增了文本渲染器，在渲染超大文本时能提供更佳效果。可通过将 `renderType ` 设置为 `Text.CurveRendering` 来启用该渲染器。
• 文本类新增了用于处理 `variable fonts` 的 API。
• 矩形现在可以具有不同的radii 、on 、each 和corner 。
• 新增了对将 QWindows 嵌入Qt Quick 场景的初步支持，同时在 Window 上添加了 parent 属性，以便设置 Window 的视觉父对象。
• Control 中的focusReason 和focusPolicy 属性已移至Item 。
• 新增了 `QQuickRhiItem `，作为 `QQuickFramebufferObject` 的现代替代方案。这允许创建自定义的 `QQuickItem ` 对象，通过 Qt 渲染硬件接口支持的任何硬件加速图形 API（即 OpenGL、Vulkan、Direct3D 或 Metal）来渲染 3D 图形。
• 新增了一个名为 QQuickRenderControl 的示例，该示例使用QRhi ，因此具有完全的可移植性，并支持所有受支持的 3D API。该示例展示了如何以跨平台的方式将Qt Quick 内容重定向到纹理中。

Qt Quick Controls 模块

• 添加了以下接受强类型参数的函数：
  • pushItem()
  • pushItems()
  • popToItem()
  • popToIndex()
  • popCurrentItem()
  • replaceCurrentItem()
• 与push 、pop 和replace 函数不同，这些函数可以由QML编译器编译为C++。

Qt Quick Shapes 模块

• 曲线渲染器及其相关属性preferredRendererType 现已获得官方支持，不再被视为实验性功能。
• 新增了pathHints 属性，用于描述形状。渲染器可利用该属性优化路径的处理和渲染。
• 形状现在具有基于其边界矩形的隐式大小，并在布局中得到适当定位。新增了fillMode 、horizontalAlignment 和verticalAlignment 属性，用于在项目被赋予与隐式大小不同的显式大小时，修改形状的行为。
• 工具svgtoqml作为技术预览版已添加。该工具可用于将 SVG 文件转换为 QML 代码。目前该工具仍处于实验阶段，仅支持Qt SVG 所支持功能的一小部分。

Qt Quick Timeline 模块

• QtQuick.Timeline.BlendTrees子模块新增了 API，用于实现多个时间线动画的混合。

Qt Quick 3D 模块

• QQuick3DRenderExtension 是一个用于实现应用程序端渲染扩展的新类，这意味着用户现在无需修改 QtQuick3D 引擎，即可扩展 QtQuick3D 的渲染管道。 结合QtQuick3D 提供的新半公开 API 以及 Qt 渲染硬件接口（QRhi ），现在可以将自定义渲染代码插入到QtQuick3D 的渲染管道中，既可以作为主渲染过程的一部分进行渲染，也可以作为独立的渲染记录。 独立渲染记录的结果可供前置扩展使用，这可通过extensions 的声明顺序进行控制。独立渲染扩展还可以作为Texture项的纹理提供者，这意味着其结果可用于其他使用QtQuick3D 中Texture类型的QtQuick3D 类型，例如材质、特效等。
• QSSG 类家族已编写文档，并作为具有有限兼容性保证的 API 提供。Qt Spatial Scene Graph 类提供了访问QtQuick3D 内部类型的途径以及有用的辅助函数。QSSG 类可分为两大主要组。 第一组类通过QRhi 提供访问状态的功能，以便在QtQuick3D 场景中进行自定义渲染；而第二组类则提供对QtQuick3D 中可渲染对象的访问，并提供辅助函数，使开发者能够利用QtQuick3D 内部使用的相同基础设施来修改、获取或重新渲染这些可渲染对象。
  • QSSGRenderExtension - 渲染扩展的后端实现。
  • QSSGRenderContextInterface -QtQuick3D 内部使用的子系统的聚合类。
  • QSSGRhiContext，QSSGRhiGraphicsPipelineState ，QSSGRhiSamplerDescription - 由QtQuick3D 使用的QRhi 便捷类。
  • QSSGFrameData - 渲染扩展所使用的每帧数据。
  • QSSGRenderHelpers,QSSGModelHelpers,QSSGCameraHelpers 以及QSSGRenderExtensionHelpers - 用于访问、配置和渲染QtQuick3D 可渲染对象的辅助类。
• CustomMaterial 新增了sourceAlphaBlend 和destinationAlphaBlend 属性。
• Texture 增加了新的textureProvider 和tilingModeDepth 属性。
• View3D 新增了explicitTextureWidth 、explicitTextureHeight 和effectiveTextureSize 属性。

Qt Quick 3D 物理模块

• HeightFieldShape：支持通过image 属性将QML Image类型用作源。
• ConvexMeshShape：支持通过geometry 属性使用QQuick3DGeometry 作为源。
• TriangleMeshShape: 支持通过geometry 属性使用QQuick3DGeometry 作为源。
• PhysicsWorld:
  • 新增reportKinematicKinematicCollisions 和reportStaticKinematicCollisions 属性，分别用于启用运动学-运动学和静态-运动学碰撞报告。
  • 支持设置模拟线程数。
• PhysicsNode: 新增碰撞过滤支持。现在可以为节点指定组 ID，从而忽略它们之间的碰撞。
• PhysicsBody: 支持通过simulationEnabled 属性禁用刚体的模拟。

Qt Serial Bus 模块

• 在QCanDbcFileParser 中添加了一个方法，支持使用UTF-8以外的编码解析DBC文件。

Qt SQL 模块

• 已移除已弃用的 <qsql.h> 头文件。请改用 <qtsqlglobal.h>。

Qt WebEngine 模块

• 新增了 API QWebEngineWebAuthUXRequest 以及 QML 类型 WebEngineWebAuthUXRequest，以支持 FIDO2 用户验证和常驻凭据。
• 新增了QWebEngineDesktopMediaRequest API，用于启用桌面屏幕截图的源选择功能。
• 新增了 WebEngineDriver，用于跨浏览器自动化测试网站。WebEngineDriver 基于ChromeDriver。
• 新增了QWebEngineUrlRequestInfo::requestBody ，用于通过QIODevice API访问请求正文。
• 新增了设置forceDarkMode （QML）和ForceDarkMode （C++），用于启用使用深色主题自动渲染所有网页内容。
• 添加了信号QWebEngineProfile::clearHttpCacheCompleted 和QQuickWebEngineProfile::clearHttpCacheCompleted 。

Qt Widgets 模块

• 添加了QRhiWidget 类（处于技术预览阶段），用于通过 Qt 渲染硬件接口支持的任何硬件加速图形 API（即 OpenGL、Vulkan、Direct3D 或 Metal）渲染 3D 图形。
• QCheckBox 新增了一个名为 checkStateChanged 的信号，该信号会以类型安全的Qt::CheckState 枚举值形式发出新的检查状态。
• QDateTimeEdit 新增了一个 `timeZone ` 属性
• 在运行 Windows 11 及以上版本的系统上，默认使用新的 Windows 11 控件样式。该样式支持 Windows 深色模式。

Qt SVG 模块

• 新增了对 SVG 1.1 标准中部分元素的支持。这些元素包括 Mask、Symbol、Marker、Pattern、Filter 以及 Filter Primitives（feMerge、feColorMatrix、feGaussianBlur、feOffset、feComposite、feFlood）
• 新增了QtSvg::Options 标志，用于启用或禁用这些新元素的渲染。
• 为QSvgRenderer 和QSvgWidget 添加了QtSvg::Options 的设置器和获取器。这些新功能默认处于启用状态。

工具

Qt Widgets Designer

• Qt Widgets Designer 现在会将完全限定的枚举值写入.ui 文件，以支持作用域枚举和Qt for Python 。对读取这些值的支持已回溯移植到6.6.1和6.5.4版本。

平台变更

桌面平台

Windows

• 新增了 Windows 11 样式
• 新增了QNativeInterface::QWindowsScreen ，可在 Windows 上访问QScreen 的底层句柄。

macOS

• macOS 14 现已成为受支持的构建和目标平台。

Linux 上的 Wayland 客户端

• 新增了QNativeInterface::QWaylandScreen ，用于访问QScreen 的底层Wayland对象。

WebAssembly

• 新增拖放支持（拖拽操作）。当用户将内容拖放到应用程序窗口上时，Qt 现将发送拖放事件。
• OpenGL ES 3 / WebGL2 现已成为默认选项，并支持回退至 OpenGL ES2 / WebGL 1。
• Emscripten 版本更新至 3.1.50

移动平台

Android

• 重构了 Android 插件的 Java 代码，具体包括：
  • 简化了架构以及各个类之间的关系（例如，QtActivity、QtActivityLoader 和 QtActivityDelegate 之间的关系）。
  • 将 QtLoader 类从 public bindings 包中移出。
  • 移除了对反射的使用。
• 为 Android 添加了子窗口的初步支持，以保持与 Qt 及其其他 QPA 的一致性。因此，QScreen::grabWindow() 目前暂时不支持。
• 将 Android 14 设为支持的最高平台版本，并将默认平台 SDK 和目标级别设为 API 34。
• 将支持的 Android NDK 版本设置为 r26b (26.1.10909125)，JDK 版本设置为 17。
• 将“移动”类别的示例与 iOS 示例保持一致。
• 添加了QNativeInterface::QAndroidScreen ，该方法可访问QScreen 的 Android 显示 ID。
• 新增了对使用 ndk-stack 配合 androidtestrunner 进行测试崩溃报告美化打印的支持。
• 添加了 CMake 变量 QT_ANDROID_DEPLOYMENT_TYPE，用于显式设置 Android 包的部署类型。
• 全面重写并更新了 Qt for Android 平台文档。
• 引入了可在 Android 项目中发挥 Qt 强大功能的新特性：
  • QtQuickView，可在 Java 或 Kotlin 代码中使用Qt Quick （技术预览版）。
  • 适用于 Android Studio的Qt Tools forAndroid Studio（技术预览版）。

iOS

• iOS 17 现已成为受支持的目标平台。

嵌入式平台

Boot to Qt

• 已添加对 Yocto 4.3（Nanbield）的支持。
• 已新增对 ARM Linux 开发主机的支持。
• 目标镜像中已包含对 Squish 的支持。
• 目标硬件支持级别已更新，新增了以下 Tier 3 级别的支持主板：
  • Amazon AWS EC2 ARM64
  • NVIDIA Jetson AGX Orin 开发套件
  • NXP i.MX8M Nano LPDDR4 EVK（取代 DDR4 EVK 版本）
  • 高通 Robotics RB5 开发套件
  • TI SK-AM69

VxWorks

• 已将 VxWorks 23.09 作为技术预览版添加支持。

构建系统变更

• Qt C++ 头文件现已包含针对IWYU工具的元数据。
• CMake：现在可以通过设置 DEPLOY_TOOL_OPTIONS 来调整 qt_generate_deploy_app_script() 和 qt_deploy_runtime_dependencies() 中 *deployqt 工具的参数。
• CMake：qt_add_library() 现在会考虑 BUILD_SHARED_LIBS 变量的值。如果该变量已定义，在添加库目标时，其优先级将高于 qt_add_library() 中的库类型检测逻辑。
• CMake：现在，qt_standard_project_setup() 允许您设置应用程序的本机 UI 语言，以及 UI 被翻译成的语言。 随后，qt_add_translations() 调用会采用这些设置，生成与给定语言匹配的 .ts 和 .qm 文件，并为本地语言生成一个“仅复数形式”的 .ts 文件。
• CMake：现在，您可以向 qt_add_translations() 传递多个目标，以便从中提取翻译。 或者，您可以让 qt_add_translations() 收集项目的所有目标（通过新的 qt_collect_translation_source_targets() 函数完成），并可选择在目录或目标级别排除不需要的目标。
• CMake：qt_add_translations() 已退出技术预览阶段。

WebOS

• Qt 6.7 已通过与 LG webOS OSE 2.25.0（Qt for webOS）的兼容性验证。

API 变更列表

以下页面概述了 Qt 6.7 中的 API 变更：

• Qt 6.7 中的新类和函数
• 已弃用的类