Qt 6.12 LTS 首次在 Qt 主线发布版本中引入 HarmonyOS 支持，将 Qt 的跨平台应用开发能力进一步拓展至鸿蒙生态，并为长期维护的产品提供新的平台选择。在此前 Qt 5 for HarmonyOS 工作的基础上，本次发布让 HarmonyOS 适配进入 Qt 主线的开发与发布体系。开发者可以继续使用熟悉的 C++ 和 QML API，复用现有应用的业务逻辑与界面代码，并按 HarmonyOS 的系统接口、权限和设备特性完成必要适配；新产品也可以在共享代码的基础上面向鸿蒙与其他平台开发。
华为与Qt上游的直接协作
HarmonyOS 支持是华为、Qt Group 与 Qt 上游社区直接协作的成果。合作团队围绕平台适配、系统接口对接和问题修复开展协作，推动 HarmonyOS 支持融入 Qt 主线。这种操作系统厂商与关键软件上游协同推进适配的方式，为鸿蒙生态建设提供了具有示范意义的合作实践，也使后续维护与功能演进能够持续在上游开展。
界面开发与图形渲染
构建触控界面或迁移桌面工具时，开发者可以分别使用 Qt Quick 与 Qt Widgets，复用既有的界面和交互设计。HarmonyOS 平台集成对接窗口管理、输入法、剪贴板和拖放等系统能力，并提供多屏及原生组件嵌入支持，帮助应用适应目标设备的使用方式。
在产品展示、模型交互或自定义仪表等场景中，Qt Quick 3D 可将三维内容融入 QML 界面，Qt Canvas Painter 则提供面向 GPU 的二维绘制能力。HarmonyOS 平台支持 Vulkan 和 OpenGL ES，Qt 的渲染硬件接口 RHI 为 Qt Quick、Qt Quick 3D 等渲染组件提供统一的图形后端抽象，帮助应用复用渲染逻辑；团队已围绕 Qt Quick 3D 与 Qt Canvas Painter 开展了多轮测试和验证 。
多媒体与文档集成
面向多媒体与文档处理场景，Qt Multimedia 的 HarmonyOS 原生后端提供音频、视频播放和摄像头集成，Qt TextToSpeech 可用于语音播报。应用还可以通过 Qt WebView 和 Qt PDF 嵌入网页与 PDF 文档，将内容浏览、媒体展示和业务操作组织在同一界面中。
设备连接与位置服务
需要连接外设或构建位置感知应用时，开发者可以通过 Qt Bluetooth 与蓝牙设备通信，利用 Qt Sensors 获取传感器数据，并结合 Qt Positioning 与 Qt Location 构建定位和地图界面。具体功能需按目标设备、系统权限和业务场景完成验证。
构建与部署工作流
从构建到设备验证，开发团队可以沿用熟悉的 CMake 工作流，使用 harmonydeployqt 准备应用及其依赖，并结合 HarmonyOS 工具链完成应用包（HAP）的构建、签名和部署，减少迁移过程中重新搭建工程流程的工作。
开发环境配置与示例入门
你可以通过 Qt Account或申请商业试用下载并安装Qt 6.12 LTS和Qt for HarmonyOS SDK。安装完成后，按入门指南配置 SDK、构建示例并部署到设备，再接入现有项目。
HarmonyOS开发与迁移网络研讨会
10月28日（周三）下午三点，CSDN官网将直播《把 Qt 应用带到鸿蒙：Qt 6.12 for HarmonyOS 上手实战》网络研讨会。Qt研发主管齐亮将演示如何下载与安装、编译 Qt Widgets 与 Qt Quick 示例以及部署并在鸿蒙设备上运行。
点击上图链接报名参会并提交你关心的问题，有机会赢取小礼物。
持续跟进Qt主线开发
首次进入主线发布版本，也是持续演进的起点。后续我们将继续在 HarmonyOS 平台上跟进 Qt 主线的开发进展，推进功能适配、测试覆盖和问题修复，并与华为及上游社区保持协作。借助 Qt 6.12，开发团队可以复用现有 Qt 代码和技术积累，减少重复开发，缩短产品进入鸿蒙生态的周期。
Qt 5项目的维护与迁移
对于仍在使用 Qt 5 的团队，Qt 5.15.16 for HarmonyOS 开源源码包已于 2026 年 9 月 30 日发布，面向鸿蒙平板与 PC 提供适配代码。开发者可以获取源码并参考发布说明，评估现有项目的维护与迁移路径。
相关资源/推荐阅读
Qt for HarmonyOS 开发文档与入门指南
Qt for HarmonyOS构建与部署示例
Qt for HarmonyOS已知平台限制
END
往期推荐
博客｜Qt 6.12 LTS正式发布！
技术文档丨Qt在HarmonyOS上的主窗口与子窗口开发指南
博客 | 使用vcpkg为HarmonyOS构建C/C++库
