Qt For OpenHarmony Alpha v8 版本重磅发布（时隔半年再迭代）

Qt For OpenHarmony Alpha v8 版本重磅发布（时隔半年迭代）

Qt For OpenHarmony 迎来重要更新，Alpha v8 版本正式上线！本次版本基于 Qt5.15.12 构建，深度适配 HarmonyOS 6 系统，在模块支持、功能增强、兼容性优化等方面实现全面升级，具体核心信息如下：

核心版本适配信息

• Qt 基础版本：Qt5.15.12
• OpenHarmony API 级别：API 18
• 适配系统版本：HarmonyOS NEXT 5.1.0.320 SP37
• 依赖 SDK 版本：ohos-sdk-full 5.1.0.107
• 源码仓库地址：https://atomgit.com/openharmony-sig/qt[1]

模块支持总览

本次版本全面覆盖 Qt5.15 核心能力，基础模块 100%支持，附件模块按需适配高频场景。新增 OpenHarmony 专属扩展模块 OH Extras，补充系统级能力适配，具体支持清单如下：

Qt5.15 基础模块（全量支持）

Qt5.15 附件模块（精准适配）

已知问题

当前版本暂无明确已知问题，若在使用过程中遇到功能异常、兼容性问题或优化建议，可通过 AtomGit 仓库 Issue 板块反馈。

关键更新说明

本次更新聚焦“系统适配深化、功能能力增强、稳定性优化”三大核心目标，新增 OpenHarmony 专属扩展模块，同时完善基础模块功能，具体更新如下：

一、Qt OHExtras（鸿蒙专属扩展模块）

专为 OpenHarmony 系统设计的非官方扩展模块，补充系统级能力适配：

• 权限管理增强：QOhAppContext 新增权限申请、查询、状态管理接口，简化应用权限处理流程。
• 系统主题自适应：新增主题颜色变化信号，支持实时监听系统主题切换并同步应用样式。
• 子进程生命周期管理：提供 getSubProcessAliveState（状态查询）、getSubProcessPid（进程 ID 获取）、killSubProcess（进程终止）等接口，完善子进程管控。
• 多窗模式监听：添加全局自由多窗模式监听能力，实时获取多窗切换状态。
• 窗口功能升级：支持窗口阴影半径设置、背景色自定义、标题栏三键（最小化/最大化/关闭）隐藏，优化窗口管理体验。
• 应用退出增强：适配 terminateSelfWithResult 接口，支持应用退出时返回自定义结果。

二、Qt Base（基础模块优化）

• 图形渲染升级：新增 Vulkan surface 获取接口，正式支持 Vulkan 图形渲染。
• 窗口管理优化：
  • 智能资源管理：窗口隐藏时自动释放 vsync 资源，降低内存占用；
  • 窗口类型修复：解决嵌入窗口、悬浮窗创建与显示异常问题；
  • 多窗适配：完善自由多窗模式切换逻辑，确保窗口状态稳定。
• 新增实用功能：
  • 窗口截图：新增 C 语言接口，支持直接获取窗口图像数据；
  • 设备判断：新增 isSupportFreeWindow 函数，对手机设备不支持的 JS 接口进行防护；
  • 时区适配：支持时区信息获取与转换，优化国际化体验；
  • DNS 解析：适配 QDnsLookup，完善域名解析功能；
  • ICU 支持：集成 ICU 库，增强多语言、国际化处理能力；
  • C++17 兼容：添加 C++17 标准支持，优化代码实现效率。
• 稳定性修复：
  • 输入法：解决闪烁问题，优化显示判断逻辑，支持密码框输入；
  • 事件处理：修复拖拽事件阻塞、数位板手写笔坐标偏移、三折叠触屏事件异常等问题，完善多指触控判断；
  • 窗口相关：修复初始状态设置异常、几何计算错误、析构崩溃、子窗口坐标偏移等问题；
  • 控件优化：修复 QFileDialog selectedFilter 错误、日历选择框菜单触发隐藏问题；
  • 托盘图标：支持深浅色主题区分，实现主题自适应。
• NAPI 封装增强：新增 QJsObject::call 模板接口，优化 Napi::Value 创建与读取封装，提升 JS 调用效率。

三、Qt Declarative（QML 相关优化）

• 路径优化：修改 Extension 组件 QML 文件导入路径，提升资源加载效率。
• 关闭通知：Quick 模块新增 windowWillClose 信号，支持窗口关闭前预处理逻辑。
• 渲染稳定：优化 Quick 抖动临时处理方案，提升界面渲染流畅度。

四、QtQuick Controls（控件模块优化）

• 资源定位：调整 QML 文件加载路径，优化控件资源定位与加载速度，提升界面启动效率。

五、Qt Multimedia（多媒体模块升级）

• 稳定性增强：修复多线程检测崩溃问题，提升线程安全等级。
• 功能扩展：
  • 数据处理：添加预览数据转码功能，支持不同像素格式转换；
  • 音频优化：适配浮点采样类型（AUDIOSTREAM_SAMPLE_F32LE），支持高精度音频处理，新增音频输出模块，完善设备管理；
  • 视频能力：新增视频解码处理类，优化解码流程，添加相机录像功能，支持视频录制与保存；
  • 录音适配：修复录音初始化失败、杂音问题，完善鸿蒙平台录音功能。
• 兼容性优化：适配 QMediaPlayer::setAudioRole 接口，支持音频角色配置；添加 SDK 版本编译防护，提升跨版本兼容性。
• 状态管理：修复无 BufferedMedia 状态问题，完善媒体播放状态管控。

六、Qt Connectivity（连接模块重构）

• 蓝牙/NFC 适配：重新设计类名与文件结构，修复扫描、连接异常问题，提升设备交互稳定性。
• 线程安全优化：将 JS 函数移至 JS 线程调用，解决跨线程调用崩溃问题。
• 能力检测：新增 canIUse 函数，支持 API 能力动态检测，适配不同系统版本。

七、Qt Sensors（传感器模块优化）

• 适配更新：优化传感器数据获取与处理逻辑，提升数据准确性。
• 线程安全：JS 函数移至 JS 线程调用，避免跨线程风险，增强模块稳定性。

邀您参与共建

Qt For OpenHarmony 项目持续迭代优化，欢迎开发者加入 AtomGit 仓库一起交流学习、贡献代码！

• 项目地址：https://atomgit.com/openharmony-sig/qt[2]
• 反馈渠道：仓库 Issue 板块（功能建议、Bug 反馈）、Merge Request（代码贡献）

让我们携手打造更完善、更强大的 Qt for OpenHarmony 生态！

我的联系方式，一起交个朋友！未来也会推出更多新技术的分享

参考资料

[1]

https://atomgit.com/openharmony-sig/qt: https://atomgit.com/openharmony-sig/qt

[2]

https://atomgit.com/openharmony-sig/qt: https://atomgit.com/openharmony-sig/qt