目录

文档变更说明

2026年8月28日

[h2]API参考的支持设备标记优化

在API参考中完善设备类型支持标记。凡包含设备支持属性的类、方法、结构体等内容,均在下方标注各设备类型的起始支持版本,便于开发者快速掌握接口的设备支持情况。

标记示意图如下:

[h2]DevEco Studio新增文档

新增编译构建性能和内存优化的实践指导,帮助开发者提升多目标编译、多HAP/HSP工程编译、自定义插件和任务等场景下的构建效率。具体请参考实践说明。

[h2]Ability Kit新增文档

新增PC/2in1设备上的应用开发指导。

新增进程模型开发指导。

新增应用启动流程指导:说明应用启动依次经历进程启动、AbilityStage启动、UIAbility启动三阶段,并给出各阶段生命周期回调使用建议与启动入口说明。

新增使用ModularObjectDispatcher实现动态接口调用指导:介绍客户端如何在运行时查询服务端接口信息并按方法名发起跨进程调用,涵盖分发器创建、接口元数据查询、多种参数类型传递与资源释放规则。

2026年7月28日

[h2]Spatial Recon Kit删除文档

因空间照片功能的技术策略调整,该功能暂时下线。

[h2]Wallet Kit

新增园区卡、会员卡、酒店房卡、出行凭证、活动/景点门票和通用凭证的场景化接入指南,便于开发者按需接入,为用户提供更丰富的数字凭证管理服务,增强用户粘性。

2026年7月20日

[h2]DevEco Studio删除文档

由于模拟器能力策略变更,不再支持远程控制功能,指南中删除了模拟器远程控制的内容。相关场景建议使用DevEco CLI操控模拟器。

2026年6月25日

[h2]ArkUI新增文档

2026年6月12日

[h2]Ability Kit新增文档

新增应用生命周期章节。

新增方舟智能开发框架开发指导章节。

[h2]窗口管理新增文档

窗口管理补充完善20+开发场景,优化整体文档结构目录,包括窗口类型、窗口模式、窗口布局、窗口焦点等各个场景指导。

新增窗口开发常见日志问题与定位指导,帮助开发者高效使用hidumper命令快速完成问题定位与解决。

[h2]ArkTS新增文档

Sendable对象改造实践:提供Sendable改造实例,介绍使用TurboTransJSON工具在ArkTS中操作Sendable对象的典型用法。

[h2]FA模型开发指导迁移

随着应用模型的演进发展,从API 7开始提供的FA模型已经不再主推,当前FA模型主要用于轻量级智能穿戴设备。其他设备推荐采用未来会长期演进的Stage模型。

为了让开发者在使用应用模型文档时有更好的阅读体验,HarmonyOS指南中仅保留Stage模型相关文档(详见应用模型),FA模型相关文档已迁移至轻量级智能穿戴-应用开发基础。

2026年4月20日

[h2]ArkUI新增文档

使用网格:新增网格组件的NDK开发指南,包括创建网格组件、创建后如何设置子组件所占行列数、如何处理滚动事件。

丰富UI开发常见问题:新增20+常见问题及对应的解决措施,帮助开发者快速完成问题定位与解决。例如:FrameNode节点运行时出现jscrash、文本超长时如何展示等。

[h2]AVSession Kit新增桌面歌词接入指南

应用接入桌面歌词:支持音乐播放器或有歌词展示需求的音频类应用接入桌面歌词功能,可以实现将歌词以悬浮窗形式展示在系统桌面,让用户无需进入应用即可查看歌词。

2026年3月10日

[h2]Ability Kit新增应用跳转相关指导

获取目标应用的URL信息:在使用UIAbilityContext.openLink接口拉起目标应用时,需要传入目标应用的URL信息。主要介绍如何通过aa工具与bm工具,获取目标应用的URL信息。

2026年3月5日

[h2]ArkUI状态管理V1->V2迁移指导文档优化

状态管理V1-V2迁移指导:梳理迁移场景,将迁移场景分为组件内状态变量迁移、数据对象状态变量迁移、应用内状态变量迁移、组件复用迁移,新增内置对象迁移指导、AnimateTo使用迁移指导。

[h2]Image Kit增加位图操作

使用PixelMap完成位图操作文档中,增加将两张宽度相同的位图纵向拼接成一张长图的开发示例。

[h2]AVSession Kit提供音频模板功能

使用音频模板:AVSession Kit支持媒体应用通过音频模板接入播控中心,实现音视频在播控中心进行统一的界面显示和播控管理。

2026年2月9日

[h2]ArkTS新增基础库开发常见问题

基础库常见问题:介绍基础库开发过程中的常见问题,帮助开发者快速完成问题定位与解决。例如,如何解决解析大文件xml发生的内存溢出问题。

[h2]Camera Kit新增高性能拍照指南

优化原有拍照(ArkTS)及拍照(C/C++)文档内容,新增高性能拍照指南示例,介绍在单段式拍照时,通过设置明确的画质优先策略满足不同拍照效果要求。

2026年2月2日

[h2]ArkGraphics 2D新增离线图像处理文档

添加图像效果(C/C++):新增离线图像处理指导文档,介绍如何基于滤镜(Filter)设置不同的图像效果,比如设置图像模糊程度、调节图像亮度和灰度、设置图像反色等。

2026年1月26日

[h2]ArkUI新增状态管理文档

状态管理原理介绍:新增状态管理基本原理介绍,帮助开发者更好地理解其工作流程。

状态管理常见问题:新增状态管理开发过程中的常见问题,帮助开发者快速完成问题定位与解决。

[h2]Audio Kit文档目录调整

文档目录新增音频性能调优节点,了解如何提升音频性能体验及对音频工作组进行管理。

“音频录制流管理”文档名称变更为“查询和监听其他应用录制状态”。

“共享音频输入”文档名称变更为“录音并发策略说明”。

“管理麦克风”文档名称变更为“管理麦克风静音状态”。

[h2]Camera Kit新增相机旋转C++开发文档

适配相机旋转角度:新增适配相机旋转C++指导文档,以确保在不同屏幕状态下、在合适的方向显示相机图像。

相机旋转角度术语:介绍适配相机旋转角度C++开发过程中涉及的设备方向、镜头角度、屏幕显示角度等术语。

[h2]AVcodec Kit文档优化

ROI视频编码:新增在Surface模式下通过NativeBuffer接口配置ROI场景。

2026年1月23日

[h2]丰富窗口开发常见问题

窗口开发常见问题:补充20+个窗口开发过程中的常见问题与指导,包含如何实现横竖屏切换、如何获取窗口宽高、如何设置隐私窗口等。

2026年1月8日

[h2]优化应用真实性证明文档

为帮助开发者更好地理解应用场景,提高应用接入效率,我们优化了应用真实性证明文档。

具体请见应用真实性证明。

2025年12月31日

[h2]新增音频文档

实现音频输入设备路由切换:当应用有音频输入时,系统会根据音频流类型选择对应的输入设备。若默认输入设备不满足应用需求,可通过setBluetoothAndNearlinkPreferredRecordCategory或selectMediaInputDevice实现音频输入设备路由切换。

空间音频能力查询和状态订阅:空间音频是一种能够将传统立体声体验扩展到三维空间的音频技术,对于音频类播放应用,开发者可以查询到设备是否支持空间音频,以及当前设备空间音频的开关状态。

2025年12月29日

[h2]新增窗口开发常见问题

窗口开发常见问题:介绍窗口开发过程中的常见问题,帮助开发者快速完成问题定位与解决。

2025年12月23日

[h2]新增屏幕管理术语

屏幕管理开发术语:介绍屏幕管理开发的核心概念,便于开发者了解屏幕开发相关概念及内容,更好地完成应用开发。

[h2]新增ArkData常见问题

ArkData常见问题:介绍ArkData开发过程中的常见问题,帮助开发者快速完成问题定位与解决。

2025年11月15日

[h2]新增ArkUI文档

UI开发常见问题:介绍UI开发时的常见问题,主要包括自定义节点常见问题和按钮与选择组件常见问题的现象和解决措施。

2025年11月5日

[h2]DevEco Studio新增仿真器文档

使用仿真器运行轻量级穿戴应用:介绍在DevEco Studio上通过仿真器运行和调试Lite Wearable设备应用的使用方式,包括模拟传感器、电池等。

2025年11月3日

[h2]新增日历服务实践案例

日历服务实践案例:介绍了不同“一键服务”类型对应的实践场景及各字段取值建议,提供了对应的示例及案例示意图,指导快速完成各场景服务的一键直达开发,提升用户体验。

2025年10月24日

[h2]获取体验增强

为提升文档获取体验,官网上线划词召出“AI问答”功能,通过生成式问答、深度思考、生成总结,可快速生成相关特性功能概念、使用场景、信息来源等。

使用HarmonyOS开发者官网账号登录网站,在文档区域选中内容单击“AI提问”即可召出。

在文档中,选中“ExtensionAbility组件”,单击“AI提问”。

图1 AI提问

在“智能客服”窗口中,可看到相关内容的生成总结。

图2 智能客服

2025年10月20日

[h2]新增窗口旋转文档

窗口旋转:介绍了窗口旋转与屏幕方向的关系、旋转接口规格、旋转策略及设备差异性等内容,便于开发者系统了解窗口旋转相关内容,从而进行应用窗口旋转相关的适配与开发。

[h2]新增ArkUI文档

[h2]优化ArkUI文档

[h2]UI开发 (基于NDK构建UI)章节目录结构调整

将UI开发 (基于NDK构建UI)调整至“开发”-“应用框架”-“ArkUI(方舟UI框架)”目录下,调整后的目录结构更符合基于NDK接口开发UI界面的学习历程。目录结构调整不影响原页面URL链接地址,原地址可正常访问。

图3 UI开发 (基于NDK构建UI)目录调整后结构

[h2]自动化测试框架指南优化结构

优化前文档中,自动化测试框架的内容在同一个页面承载信息庞杂。为了提升开发者体验,便于检索,将指南分为三篇:

2025年10月14日

[h2]录屏指南优化结构

优化前文档中,所有的能力均在同一个顺序列表里以步骤承载阅读体验不佳。为了提升开发者的使用体验,将录屏指南分为三篇:

帮助开发者按照入门-进阶-问题解决的逻辑使用开发文档。同时,本次更新将页面内的每个功能点分小节展示,更直观地呈现系统的录屏能力,提高检索效率,便于使用。

2025年9月30日

[h2]ArkWeb新增文档

2025年9月8日

[h2]应用程序包新增场景指导

新增HAP转HAR开发指导,HAP不支持导出接口或ArkUI组件给其他模块或应用使用,HAR支持,本页面为开发者提供该场景下通过配置项变更将HAP工程变成HAR工程的指导。

2025年8月21日

[h2]窗口管理新增文档

[h2]文本开发新增场景指导

2025年7月9日

[h2]新增文档

ArkWeb

Longque JS Engine 提供了一批Longque JS API指导指南,旨在HarmonyOS 平台构建稳定、高性能的应用。

2025年7月2日

[h2]优化了Node-API常见问题汇总指南

新增了Node-API常见问题汇总,方便开发者快速获取相关指导。

[h2]新增并发常见问题指导文档

为了帮助开发者快速定位并解决在使用TaskPool、Worker及Sendable特性时遇到的各类问题,新增并发常见问题指导文档。

主要包括TaskPool任务不执行快速定位指导、TaskPool任务执行慢排查思路指导、TaskPool序列化失败定位指导、使用Sendable特性抛JS异常排查指导以及一些开发者咨询的高频问题及解决方案。

此指导文档也将持续不断完善并补充,助力开发者快速定位解决问题。

2025年6月24日

[h2]一次开发,多端部署文档路径调整

2025年6月20日

[h2]API参考文档架构优化(试点)

在优化前的API参考文档中,一个功能模块中不同类型的元素(如函数、类、枚举、类型等)均在一个页面承载。为了提升开发者的使用体验,我们选取了几个API参考页面开展优化试点,将一个功能模块按照元素类型细分为多个子页面进行展示。

本次API参考文档架构优化对于开发者体验提升具有双重价值:一方面,通过分类展示机制能够更直观地呈现接口所属的类型,提升检索效率,便于开发者使用;另一方面,分页策略能够改善单一页面规模过大导致的阅读体验问题,包括页面加载延迟、浏览器渲染卡顿以及搜索定位不精准等。

API参考文档架构试点优化的范围如下:

为便于快速获取API变更范围,官网文档新增HarmonyOS SDK API变更查询能力:

[h2]新增文档代码解读功能

为提升代码易理解性,官网上线文档示例代码AI“代码解读”功能,介绍代码核心知识点、代码逻辑。

使用HarmonyOS开发者官网账号登录网站,在示例代码区域单击“代码解读”即可召出。

“代码解读”功能为Beta体验特性。

图5 代码解读

[h2]新增示例代码自动换行功能

官网上线文档示例代码“自动换行”功能,提升的示例代码阅读体验,避免由于示例代码或注释过长显示不全的问题。

图6 示例代码自动换行

2025年6月11日

[h2]API参考支持按设备品类筛选

为便于快速查看不同设备品类适用的API范围,API参考新增支持按设备品类筛选能力:

同时,每个接口下也会显示其支持的设备(默认开启,可一键隐藏):

[h2]版本说明新增信息

2025年4月20日

[h2]新增文档

Media Kit

创建异步线程执行AVTranscoder视频转码:添加视频转码的开发实践,简要介绍了视频码率和分辨率的关系,帮助开发者选择合适的码率、分辨率,并提供了使用异步线程转码的开发指导。

2025年4月17日

[h2]学习ArkTS语言章节目录结构调整

将UI范式基本语法、状态管理、渲染控制节点从“入门”-“学习ArkTS语言”移至“开发”-“应用框架”-“ArkUI(方舟UI框架)”-“UI开发 (ArkTS声明式开发范式)”目录下,调整后目录结构更符合UI开发框架学习历程。

变更影响:

目录结构调整不影响原页面URL链接地址,原地址可正常访问。

图7 学习ArkTS语言章节目录结构变更对比

2025年3月31日

[h2]新增文档

ArkGraphics 2D

针对文本开发,新增提供了字体管理、文本测量、文本绘制与显示三个章节内容,各章节按实现语言分为ArkTS和C/C++对应的具体指导内容。此次指南优化上新了约15个页面,进一步丰富完善了应用在开发和布局时,针对文本元素或内容进行的排版、测量、绘制和显示等场景。

2025年3月25日

[h2]搜索体验变更预告

为解决官网全站搜索场景下搜索结果重复项多的问题(即存在多个版本相同内容搜索结果),开发者联盟官网优化搜索机制。从4月下旬起,将不再支持已归档版本的全站搜索。

变更前:全站搜索提供多个版本搜索筛选项。

图8 官网搜索版本筛选

变更后:

2025年3月12日

[h2]获取体验增强

新增通过API version筛选获取支持接口范围

HarmonyOS 5.0.3(15)版本API参考文档提供API version筛选功能,开发者可便捷获取某个API version支持的接口范围。

  1. 打开API参考文档,在左侧导航栏“高级筛选”下拉选项中设置“API version”版本号。
    图9 “API version”筛选
  2. 设置目标API version后,默认显示支持的API范围,不支持的接口在导航栏中置灰。
    图10 导航栏筛选后效果
  3. 选择“只看筛选内容”,导航中不支持接口将被隐藏。
    图11 只看筛选内容效果

官网文档默认版本变更为“HarmonyOS 5.0.3(15)”

官网文档默认版本近期将由“HarmonyOS 5.0.0(12)”变更为“HarmonyOS 5.0.3(15)”。

变更前:以下任意入口进入文档页面,默认打开“HarmonyOS 5.0.0(12)”版本配套文档。

变更后:以上任意入口进入文档页面,默认打开“HarmonyOS 5.0.3(15)”版本配套文档

[h2]文档维护策略变更

HarmonyOS 5.0.2(14)、 HarmonyOS 5.0.1(13)、HarmonyOS 5.0.0(12)分支官网文档版本统一收编至HarmonyOS 5.0.3(15)版本,历史版本文档停止更新。

后续新增版本在HarmonyOS 5.0.3(15)文档目录上前向演进。

变更原因:

HarmonyOS文档针对不同API version(如API 12/API 13/API 14等)提供多个文档分支,带来搜索结果重复项多等问题。

自API 15版本起HarmonyOS开发者文档官网版本合一,参考业界仅提供一套文档同时配套不同API version。

通过API version筛选支持接口范围可便捷了解不同API version支持接口范围,请参考获取体验增强。

变更影响:

推荐使用HarmonyOS 5.0.3(15)版本开发者文档。

2025年1月24日

[h2]新增文档

ArkGraphics 2D

围绕实际图形的绘制与显示流程,新增提供了画布的获取与绘制结果的显示、画布操作及状态、绘制效果、图元绘制四个章节内容,各章节内容下按实现语言分为ArkTS和C/C++对应的具体指导内容。

画布的获取与绘制结果的显示:介绍图形绘制中画布的获取与显示。画布为图形绘制的核心,所有绘制操作都是基于画布Canvas实现的。

画布操作及状态:介绍获取得到画布Canvas之后,可以基于画布进行的图形操作和状态处理。

绘制效果:介绍基于画布,使用画刷(Brush)或画笔(Pen)添加的绘制效果。其中画刷主要用于实现填充效果;画笔主要用于实现描边效果。

图元绘制:无论多复杂的图形,都是由基础的图元组合而来。介绍了当前支持绘制的基础图元,包括几何形状绘制(点、圆、矩形等)、图片绘制和字块绘制。

图形开发术语:介绍图形开发过程中的术语概念。

2025年1月16日

[h2]新增文档

Game Service Kit

游戏场景感知:提供了游戏场景感知的C/C++开发指导,帮助开发者快速实现游戏与系统的交互,在系统资源有限的情况下进一步改善玩家的游戏体验。

IAP Kit

非续期订阅类型商品的购买:提供了非续期订阅类型商品的接入购买和权益发放开发指导,助力应用实现非续期订阅商品的购买。

Payment Kit

通用收银台接入:介绍了Payment Kit通用收银台业务规则、混合支付场景、纯外部支付场景,助力应用实现混合支付、纯外部支付模式。

Scenario Fusion Kit

Store Kit

应用内快捷方式加桌:介绍了在应用市场推荐场景下,如何实现应用内快捷方式加桌。

2024年12月6日

[h2]新增文档

ArkTS

模块加载副作用及优化:介绍当使用ArkTS模块化时,模块的加载和执行可能会产生非预期的顶层代码执行、全局状态变化、原型链修改、导入内容未定义等副作用,并介绍如何优化,减少副作用对应用的影响。

2024年11月30日

[h2]新增文档

Share Kit

XEngine Kit

时域AI超分:介绍时域AI超分的使用场景、业务流程和接入步骤,助力开发者实现超采样率和超分辨率并达到抗锯齿效果。

2024年11月15日

[h2]新增文档

NDK

2024年11月12日

[h2]新增文档

Payment Kit

数字人民币支付场景:介绍如何接入数字人民币支付服务,快速实现应用的数字人民币支付。

Remote Communication Kit

URPC场景:介绍在URPC场景下如何实现远程函数调用。

NearLink Kit

从NearLink Kit简介、查询星闪开关状态、发送星闪广播、发起星闪扫描、SSAP连接及数据传输,全面介绍如何实现星闪设备之间的连接、数据交互。

[h2]优化文档

IAP Kit

2024年11月5日

[h2]优化文档

Audio Kit

[h2]删除文档

NDK

在非ArkTS线程中回调ArkTS接口:不推荐使用uv_queue_work接口来实现“非JS线程向JS线程提交任务”的功能,否则存在冗余的线程创建。推荐使用Node-API接口进行线程安全开发文章中“从任意线程往JS线程提交任务”的实现方法。uv_queue_work的使用建议,请参考libuv指导文档。

2024年10月29日

[h2]新增文档

ArkUI

ArkWeb

ArkTS

Camera Kit

Share Kit

2024年10月25日

[h2]删除文档

Scenario Fusion Kit

由于实时验证手机号Button开放策略变更,指南中删除了实时验证手机号Button相关内容。

2024年10月22日

[h2]版本号变化

HarmonyOS NEXT Release更名为HarmonyOS 5.0.0 Release。HarmonyOS 5.0.0 Release继承自HarmonyOS NEXT Release,隶属于HarmonyOS NEXT,标志着HarmonyOS NEXT经过概念阶段、开发者体验阶段、消费者体验阶段的打磨后,正式面向消费者发布。

详情请参见HarmonyOS 5.0.0 Release版本概览。

[h2]新增文档

Camera Kit

2024年10月14日

[h2]新增文档

Ability Kit

Camera Kit

Media Kit

ArkUI

不依赖UI组件的全局自定义弹窗:介绍如何使用UIContext中获取到的PromptAction对象提供的openCustomDialog接口来实现自定义弹窗。

2024年9月30日

[h2]删除文档

Account Kit

由于获取实名信息、实名信息校验、人脸核身、实时验证手机号能力策略变更,指南中删除了Account Kit获取实名信息、实名信息校验、人脸核身、实时验证手机号相关内容。

2024年9月27日

[h2]优化文档

获取支持与帮助:详细介绍官方面向公共开发者提供的支持与帮助渠道、官网文档“意见反馈”功能。

2024年9月18日

[h2]优化文档

Ability Kit

ArkUI

ArkData

ArkWeb

[h2]新增文档

Ability Kit

ArkUI

ArkWeb

NDK

2024年9月4日

[h2]新增文档

Car Kit

Device Security Kit

安全审计:介绍安全审计的使用场景、约束和限制以及接入步骤等,助力应用实现审计相关业务。

HiAI Foundation Kit

单算子应用:介绍单算子应用场景以及接入步骤,助力三方框架性能提升。

Map Kit

设置地图元素压盖顺序:介绍如何设置地图和各种覆盖物元素的层级压盖关系。

Network Boost Kit

Online Authentication Kit

SOTER免密身份认证:介绍SOTER免密身份认证应用场景以及接入步骤,助力应用通过用户的生物特征来代替传统的密码验证,实现免密身份认证能力。

2024年8月30日

[h2]获取体验增强

2024年8月28日

[h2]新增文档

Pen Kit

全局取色:介绍全局取色能力的使用场景以及接入步骤,助力应用获取手写笔/手指目标位置的图像颜色信息。

[h2]ArkUI组件参考目录结构优化

API参考ArkUI组件目录结构优化,将分散的组件按照使用场景进行划分,组件获取更便捷。

图15 ArkUI组件参考目录变更对比

2024年8月20日

[h2]新增文档

Device Security Kit

涉诈剧本检测:介绍涉诈剧本检测的使用场景以及接入步骤,助力应用实现对用户支付或转账时存在欺诈威胁,给出有效提示或拦截。

2024年8月9日

[h2]获取体验增强

文档包内搜索入口归一,文档包内搜索框位置调整到导航目录搜索框旁边,优化搜索输入路径。

变更前:文档包内搜索框位于文档页面阅读区右侧。

变更后:文档包内搜索框位于导航栏上方。

文档包内搜索:支持在当前阅读的文档类型内全量搜索,如支持在版本说明书、指南、API参考等不同文档类型内全量搜索。

图16 文档包内搜索框入口优化效果

2024年8月8日

[h2]新增文档

Intents Kit

本地搜索方案:介绍本地搜索的场景以及接入步骤,助力开发者快速实现“一步搜索,内容直达”。

Map Kit

弧线:介绍如何在地图上绘制弧线,包括设置弧线的位置、宽度、颜色等参数。

Network Boost Kit

网络场景识别:介绍如何实现网络场景识别。

PDF Kit

介绍通过PdfView组件实现打开PDF文档、PDF文档与图片格式互转、添加页眉页脚、添加水印、添加背景、添加批注、添加书签。

Ringtone Kit

介绍Ringtone Kit(铃声服务)的场景以及如何设置铃声。

Vision Kit

AI识图:介绍如何实现AI识图。

2024年8月2日

[h2]新增文档

UI Design Kit

从UI Design Kit简介、分层图标处理、单层图标处理,全面介绍应用如何实现跟随HarmonyOS Design System高端精致设计效果UI界面。

Weather Service Kit

介绍如何查询天气数据,用于支撑应用的天气预报、分钟级降水预报、天气预警、天气指数、天文数据等场景的实现。

Wear Engine Kit

从Wear Engine简介、开发准备、手机侧应用开发、手表侧应用开发、调测验证,全面介绍如何获取穿戴设备基础信息、应用间消息通信、发送模板化的通知到穿戴设备、获取穿戴用户状态等,实现手机与穿戴设备能力共享。

Network Boost Kit

网络场景识别:介绍应用如何订阅络场景识别,网络场景信息包括数据传输的链路类型、网络场景类型、数传策略建议、弱信号信息等。

2024年8月1日

[h2]优化文档

Core File Kit

文件授权访问(ArkTS):文档下线,其中获取并使用公共目录,调整至获取并使用公共目录;通过FilePicker设置永久授权获取调整至授权持久化。

2024年7月19日

[h2]公共

[h2]新增文档

AR Engine Kit

Core Vision Kit

Core File Kit

应用数据迁移适配指导:更新了“迁移调试”工具的获取方式,HarmonyOS NEXT Developer Beta1及之后版本,开发者需要联系华为方技术支持人员申请“迁移调试”工具,模拟进行数据迁移验证。或通过“华为开发者联盟官网”->“支持”,在线提单方式获取。

Graphics Accelerate Kit

介绍如何在Vulkan图形API平台开启超帧内插模式和超帧外插模式。

Map Kit

Network Boost Kit

Scan Kit

字节数组生成码图:介绍如何将字节数组转换为自定义格式的码图。

Scenario Fusion Kit

Service Collaboration Kit

跨设备互通能力:介绍如何通过NDK接口实现跨设备的相机、扫描、图库访问能力。

Speech Kit

AI字幕控件:介绍如何实现AI字幕的展示。

Store Kit

隐私管理服务:介绍如何实现隐私链接查询、隐私签署状态查询、停止隐私协议和未上架应用接入隐私托管服务。

[h2]优化文档

AR Engine Kit

优化文档结构,从介绍管理AR会话、获取设备位姿、检测环境中的平面、识别平面语义、识别目标形状等原子化场景如何实现,由部分到整体,引导开发者开发AR场景的应用(AR物体摆放)。

[h2]获取体验增强

指南、API参考一级节点页面URL地址发生变更,本次版本更新升级,优化节点页面URL地址规则。如果您发现已收藏文档页面不可访问,请重新搜索并收藏新地址。

变更前:URL最后一段为该一级节点页面标题转义后的字符串,不易理解和记忆。

变更后:URL最后一段为该Kit标准英文名,方便理解、获取和记忆。

【示例】以“Ability Kit(程序框架服务)”指南为例:

变更前URL:https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/it_uff08_u7a0b_u5e8f_u6846_u67b6_u670d_u52a1_uff09-V5

变更后URL:https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ability-kit-V5

2024年7月12日

[h2]FAQ目录结构变更

变更背景

根据开发者的反馈,了解到开发者习惯于从左侧导航目录中搜索所需内容。FAQ内容在每一篇文档的内部以Section的形式呈现,无法通过左侧导航栏直接访问,导致查找效率不高。

此外,每一篇文档中有多条FAQ,开发者在提交反馈意见时,无法清晰指明是针对哪一条FAQ的意见,不便于问题定位与改进。

变更内容

为了提升开发者的使用体验,对FAQ的目录结构进行了以下优化:

  1. 导航目录结构优化

    将原来在文档内部呈现的FAQ内容,切换到文档的左侧导航目录结构中,以Topic的形式呈现。这样,开发者可以更加便捷地通过左侧导航目录查阅FAQ内容,提升获取信息的效率。

  2. 分类方式优化

    从原来的按照Kit进行分类,优化为按照开发旅程进行分类。使得开发者可以更加方便地根据自己所处的开发阶段查找相关的FAQ,从而提升查找的准确性和效率。

变更效果

通过此次变更,实现了以下效果:

图17 FAQ目录结构变更

2024年6月21日

[h2]获取路径变更

获取方式1:华为开发者联盟官网-“文档”页面中,提供HarmonyOS NEXT版本、HarmonyOS 3.1/4.0及以下版本配套文档获取入口。

  1. 打开“华为开发者联盟”官网,单击网页右上角“文档”按钮,进入文档获取概览页。
  2. 根据文档使用场景,选择设计、HarmonyOS SDK相关主题文档。

获取方式2:华为开发者联盟官网-“开发”页面中,提供HarmonyOS NEXT版本配套文档获取入口。

[h2]新增文档

Ability Kit

新增应用间跳转章节。

ArkUI

Graphics Accelerate Kit

OpenGTX功能:介绍如何通过LTPO(动态帧率/刷新率)方案,动态调整游戏的帧率/刷新率以及设备的SOC/DDR频率。

[h2]文档目录结构变更

ArkWeb开发指南目录结构优化。根据实际开发旅程,从管理网页交互、文件上传下载等维度,将分散的章节按照场景进行划分。

图18 ArkWeb开发指南目录变更对比

2024年6月16日

[h2]导航目录结构变更

开发指南和API参考导航目录结构优化,在现有Kit维度基础上增加HarmonyOS SDK分类:

应用框架、系统(安全、网络、基本功能、硬件、调测调优)、媒体、图形、应用服务、AI。

方便开发者根据不同能力Kit获取相应内容,提升获取体验。

变更背景:

开发者反馈文档导航中Kit划分较细,查找常用能力不高效。

开发指南和API参考导航优化,通过增加分类,将Kit能力按照不同能力维度进行汇聚呈现,提升获取体验。

变更效果:

仅导航结构变更,页面URL地址无变化。

图19 开发指南导航变更对比

[h2]获取体验增强

为了提供更优的文档获取体验,避免因文档页面中Section标题URL地址中随机数字变化产生的链接访问问题。本次网站更新升级,优化部分内容页面内Section标题URL地址规则。

变更背景:

页面URL地址为确保地址唯一性,每个页面URL携带一串随机数字,不同版本之间随机数字可能产生变化,Section标题URL地址继承页面URL流水号,存在频繁变更情况。

变更效果:

本次优化仅涉及Section标题URL地址中携带以ZH-CN_TOPIC_XXX开头的文档页面。

图20 页面内Section标题URL地址变更对比

存在部分存量页面中链接出现:跳转到Section标题URL地址跳转不精准,重定向至页面链接的问题。

文档团队将会及时清理相关跳转不精准问题,清理期间给您带来不便敬请谅解。

2024年6月10日及之前

[h2]新增文档

ArkUI

ArkTS

Account Kit

应用跟随系统未成年人模式:介绍应用如何实现跟随系统未成年人模式。

AR Engine

命中检测与运动跟踪:介绍如何实现命中检测与运动跟踪。

ArkGraphics 3D

新增提供ArkGraphics 3D各模块,为开发者提供基础3D场景绘制能力,供开发者便捷、高效地构建3D场景并完成渲染。

Cloud Foundation Kit

介绍如何使用Cloud Foundation Kit在应用中开发云函数、开发云数据库、开发云存储。

Core Vision Kit

主体分割:介绍如何检测出图片中区别于背景的的前景物体或区域(即“显著主体”),并将其从背景中分离出来。

Connectivity Kit

WLAN服务开发指南:介绍WLAN服务的实现原理、模式,以及P2P模块的开发指导。

Device Certificate Kit

设备真实性证明:介绍系统提供的设备真实性证明和应用身份证明的能力。应用可校验业务请求是否来自真实设备和合法应用,帮助开发者识别黑灰产的攻击行为。

Device Security Kit

从Device Security Kit简介、服务配额、开发准备、应用设备状态检测、系统完整性检测、URL检测、(该特性在6月11日补丁版本带入)可信应用服务,全面介绍应用如何实现对某台设备上的使用状态、设备环境进行管理和检测。

Graphics Accelerate Kit

顶点标记:介绍增强模式的运动估计原理及顶点标记方法。

Map Kit

Natural Language Kit

Payment Kit

Pen Kit

介绍如何实现接入手写套件、报点预测、一笔成形,助力应用创造更多的手写应用场景。

PDF Kit

介绍如何实现打开PDF文档、以及如何在PDF文档中添加页眉页脚、添加水印、添加背景、添加批注、添加书签。

Scan Kit

“扫码直达”服务:介绍如何接入“扫码直达”服务,确保用户可通过锁屏、控制中心等系统级的常驻入口,扫应用的二维码、条形码并跳转到应用对应服务页面。

Share Kit

Remote Communication Kit

Store kit

支持应用归因服务:介绍如何实现登记归因来源及转化、归因结果回传。

Wallet Kit

从Wallet Kit简介、创建Wallet Kit服务、数字车钥匙、接入交通卡,全面介绍如何使用Wallet Kit在应用中接入数字车钥匙和交通卡。

[h2]优化文档

《DevEco Studio使用指南》中将Code Linter支持的检查规则,从表格升级为单页面的形式展示规则详情,提供正反例、配置方法、选项等信息,方便用户查阅与使用。具体请参考Code Linter代码检查规则。

ArkUI

组件导航 (Navigation):补充页面跳转、页面返回等路由操作方法,说明页面生命周期原理与页面转场动效实现逻辑,提供系统路由表和自定义路由表定义机制与实践步骤。

2024年5月

[h2]新增文档

标准

应用安全隐私体验建议:介绍应用设计、开发及检测阶段需关注的应用全生命周期的安全、隐私行为。

应用功耗体验建议:介绍提升应用功耗热体验,如何合理使用应用全生命周期软硬件资源规范建议。

Ability Kit

应用启动框架AppStartup:介绍如何使用AppStartup来设置组件的初始化顺序以及之间的依赖关系,加速应用启动。

密码自动填充服务:介绍如何在应用中快速集成自动填充等功能,完成在登录、注册等场景下自动保存或填充用户密码。

Account Kit

获取发票抬头:介绍如何使用获取发票抬头能力,帮助应用快速打开用户发票抬头选择页或管理页,并返回用户选择的发票抬头信息。

AR Engine

从AR Engine、开发准备、平面检测,介绍如何实现运动跟踪、环境跟踪和命中检测等空间计算能力。

Call kit

向系统通知去电消息:介绍如何实现向系统通知去电消息,实现来电横幅通知的展示。

应用上报通话中的静音、扬声器事件:介绍如何实现应用上报通话中的静音、扬声器事件。

Game Service Kit

游戏场景感知功能:介绍游戏场景感知功能的使用场景、业务流程,以及如何订阅设备状态变化、上报游戏信息、取消订阅设备状态,帮助游戏应用感知游戏场景和运行状态的不同,使用不同策略调度系统资源以达到更精细化的优化效果。

Graphics Accelerate Kit

从Graphics Accelerate Kit简介、超帧功能(内插模式、外插模式)、ABR功能,全面介绍游戏应用如何快速构建超帧、ABR(自适应稳态渲染)等游戏渲染加速能力,实现游戏帧率和运行流畅度的提升、系统负载和功耗的降低等。

IAP Kit

沙盒测试:介绍如何接入IAP Kit实现在应用调测过程中,无需真实支付即可实现支付测试。

Intent Kit

优化章节组织结构,按照特性类别展示具体特性,提升开发者阅读体验。

事件推荐方案:从典型场景、卡片展示效果、接入方案,介绍接入事件推荐的步骤,助力应用将新动态主动推荐给用户。

Map kit

覆盖物:介绍如何为地图增加覆盖物。

Preview Kit

文件预览:新增多文件预览,用户打开文件预览可以一次性传入多个文件,可在预览窗口选择对应文件进行查看。

Remote Communication Kit

自定义证书校验:介绍如何实现自定义服务器证书的验证。

Scan Kit

Scenario Fusion Kit

Status Bar Extension Kit

应用接入状态栏:介绍应用如何接入状态栏,在状态栏中添加应用图标以及管理图标。

XEngine Kit

[h2]优化文档

[h2]获取体验增强

为了提供更优的文档获取体验,避免因文档页面地址中随机数字变化产生的链接不可访问问题。本次网站更新升级,优化页面URL地址规则。

优化前:页面URL地址为确保地址唯一性,每个页面URL携带一串随机数字,不同版本之间随机数字可能产生变化,导致历史链接不可访问。

优化后:页面URL地址去掉随机数字,且支持优化前页面URL重定向至优化后页面URL地址。

为解决去掉随机数字过程中产生的页面URL地址重复问题,文档修改少量重名URL地址,如果您发现已收藏文档页面不可访问,请重新搜索并收藏新地址。

2024年4月

[h2]新增文档

ArkTS

代码混淆:介绍如何使用代码混淆,降低工程被破解攻击的风险,缩短代码的类与成员的名称,减小应用的大小。

Account Kit

Game Service Kit

防沉迷:介绍防沉迷的场景以及未成年人游戏时间自动检测功能。

Map Kit

Remote Communication Kit

拦截器:介绍如何实现拦截HTTP请求和响应,并修改响应、请求内容。

Speech Kit

朗读控件:介绍应用如何实现将文本实时转化成语音并进行朗读。

Vision Kit

文档扫描:介绍应用如何实现拍摄文档并将其转换为高清扫描件。

XEngine Kit

空域GPU超分:介绍如何基于单帧输入图像,使用空间邻域信息实现超采样,并提供了示例代码。

[h2]优化文档

Push Kit

根据开发旅程,优化开发指导文档结构,从Push Kit简介、开发准备、发送场景化消息到端云调试等逐步展开,提升开发者阅读体验。

2024年3月

[h2]新增文档

Core Vision Kit

Health Service Kit

从Health Service、接入流程、应用开发者申请资质说明、开发接入,全面介绍如何实现管理用户运动健康采样数据、锻炼记录、健康记录以及读取实时三环数据。

Map Kit

Payment Kit

签约代扣:介绍如何实现直连商户通过预签约、申请免密代扣。

Store Kit

应用市场更新:介绍应用市场升级检测、显示升级对话框接口,以及如何实现检测应用是否有待更新版本,并升级弹框提示用户更新。

Vision Kit