入门

基础入门

Archived

应用开发导读

快速入门

开发准备

构建第一个ArkTS应用（Stage模型）

从TypeScript到ArkTS的适配指导

ArkTS语法适配背景

从TypeScript到ArkTS的适配规则

@LocalBuilder装饰器：维持组件父子关系

@BuilderParam装饰器：引用@Builder函数

wrapBuilder：封装全局@Builder

@Styles装饰器：定义组件重用样式

@Extend装饰器：定义扩展组件样式

stateStyles：多态样式

@AnimatableExtend装饰器：定义可动画属性

@Provide装饰器和@Consume装饰器：与后代组件双向同步

@Observed装饰器和@ObjectLink装饰器：嵌套类对象属性变化

管理应用拥有的状态

管理应用拥有的状态概述

LocalStorage：页面级UI状态存储

AppStorage：应用全局的UI状态存储

PersistentStorage：持久化存储UI状态

@Track装饰器：class对象属性级更新

@ObservedV2装饰器和@Trace装饰器：类属性变化观测

@ComponentV2装饰器：自定义组件

@Provider装饰器和@Consumer装饰器：跨组件层级双向同步

AppStorageV2: 应用全局UI状态存储

PersistenceV2: 持久化储存UI状态

!!语法：双向绑定

自定义组件冻结功能

Repeat：可复用的循环渲染

getTarget接口：获取状态管理框架代理前的原始对象

makeObserved接口：将非观察数据变为可观察数据

开发

应用开发准备

Archived

应用开发准备

应用框架

Archived

EmbeddedUIExtensionAbility

常见action与entities（不推荐使用）

（可选）使用canOpenLink判断应用是否可访问

使用Deep Linking实现应用间跳转

拉起导航类应用（startAbilityByType）

拉起邮件类应用（startAbilityByType）

拉起邮件类应用（mailto方式）

拉起金融类应用（startAbilityByType）

拉起图片编辑类应用（startAbilityByType）

拉起文件处理类应用（startAbility）

Accessibility Kit（无障碍服务）

RelationalStore开发指导 (C/C++)

UDMF开发指导（C/C++）

通过用户首选项实现数据持久化 (C/C++)

异步并发 (Promise和async/await)

TaskPool和Worker的对比 (TaskPool和Worker)

Transferable对象（NativeBinding对象）

CPU密集型任务开发指导 (TaskPool和Worker)

I/O密集型任务开发指导 (TaskPool)

同步任务开发指导 (TaskPool和Worker)

在build-profile.json5中配置arkOptions

相对布局 (RelativeContainer)

栅格布局 (GridRow/GridCol)

媒体查询 (@ohos.mediaquery)

组件导航 (Navigation)(推荐)

导航转场

页面路由 (@ohos.router)(不推荐)

文本输入 (TextInput/TextArea)

富文本（RichEditor）

图标小符号 (SymbolGlyph/SymbolSpan)

属性字符串（StyledString/MutableStyledString）

不依赖UI组件的全局自定义弹出框 (openCustomDialog)（推荐）

基础自定义弹出框 (CustomDialog)(不推荐)

绑定全模态页面（bindContentCover）

自定义声明式节点 (BuilderNode)

自定义扩展

自定义扩展能力概述

属性修改器 (AttributeModifier)

属性更新器 (AttributeUpdater)

使用UI上下文接口操作界面（UIContext）

CanvasRenderingContext2D对象

Path2D对象

OffscreenCanvasRenderingContext2D对象

background-position样式动画

使用NativeWindowEventFilter过滤多模输入事件（C/C++）

在应用程序中使用画中画功能

画中画开发概述

使用XComponent实现画中画功能开发

使用OH_DisplayManager实现屏幕基础信息查询和状态监听 (C/C++)

使用Display实现屏幕属性查询及状态监听 (ArkTS)

建立应用侧与前端页面数据通道(C/C++)

使用crashpad收集Web组件崩溃信息

Background Tasks Kit（后台任务开发服务）

Background Tasks Kit简介

Core File Kit（文件基础服务）

拉起卡片提供方的UIAbility(router事件)

拉起卡片提供方的UIAbility到后台(call事件)

通过message事件刷新卡片内容

通过router或call事件刷新卡片内容

在自绘编辑框中使用输入法开发指导 (C/C++)

Localization Kit（本地化开发服务）

UI Design Kit（UI设计套件）

UI Design Kit简介

应用展示图标HarmonyOS设计风格化处理

（推荐）分层图标处理

单层图标处理

UI Design Kit常见问题

怎么获取layeredDrawableDescriptor对象信息？

系统

Archived

Asset Store Kit（关键资产存储服务）

Asset Store Kit开发指导(ArkTS)

Asset Store Kit开发指导(C/C++)

Crypto Architecture Kit（加解密算法框架服务）

Crypto Architecture Kit简介

指定二进制数据转换非对称密钥对(ArkTS)

指定二进制数据转换非对称密钥对(C/C++)

指定密钥参数生成非对称密钥对

使用ECC压缩/非压缩公钥格式转换(ArkTS)

使用ECC压缩/非压缩公钥格式转换(C/C++)

使用ECC压缩/非压缩点格式转换

指定PEM格式字符串数据转换非对称密钥对(ArkTS)

指定PEM格式字符串数据转换非对称密钥对(C/C++)

使用AES对称密钥（GCM模式）加解密(ArkTS)

使用AES对称密钥（GCM模式）加解密(C/C++)

使用AES对称密钥（CCM模式）加解密(ArkTS)

使用AES对称密钥（CCM模式）加解密(C/C++)

使用AES对称密钥（CBC模式）加解密(ArkTS)

使用AES对称密钥（CBC模式）加解密(C/C++)

使用AES对称密钥（ECB模式）加解密(ArkTS)

使用AES对称密钥（ECB模式）加解密(C/C++)

使用AES对称密钥（GCM模式）分段加解密(ArkTS)

使用AES对称密钥（GCM模式）分段加解密(C/C++)

使用3DES对称密钥（ECB模式）加解密(ArkTS)

使用3DES对称密钥（ECB模式）加解密(C/C++)

使用SM4对称密钥（ECB模式）加解密(ArkTS)

使用SM4对称密钥（ECB模式）加解密(C/C++)

使用SM4对称密钥（CBC模式）加解密(ArkTS)

使用SM4对称密钥（CBC模式）加解密(C/C++)

使用SM4对称密钥（GCM模式）加解密(ArkTS)

使用SM4对称密钥（GCM模式）加解密(C/C++)

使用SM4对称密钥（GCM模式）分段加解密(ArkTS)

使用SM4对称密钥（GCM模式）分段加解密(C/C++)

使用RSA非对称密钥（PKCS1模式）加解密

使用RSA非对称密钥分段加解密

使用RSA非对称密钥（PKCS1_OAEP模式）加解密

使用RSA密钥对（PKCS1模式）签名验签(ArkTS)

使用RSA密钥对（PKCS1模式）验签(C/C++)

使用RSA密钥对（PKCS1模式）签名及签名恢复(ArkTS)

使用RSA密钥对（PKCS1模式）签名恢复(C/C++)

使用RSA密钥对分段签名验签（PKCS1模式）(ArkTS)

使用RSA密钥对分段验签（PKCS1模式）(C/C++)

使用RSA密钥对签名验签（PSS模式）(ArkTS)

使用RSA密钥对验签（PSS模式）(C/C++)

使用ECDSA密钥对签名验签(ArkTS)

Data Protection Kit（数据保护服务）

数据防泄漏服务简介

数据防泄漏服务开发指导

Device Certificate Kit（设备证书服务）

Device Certificate Kit简介

证书链校验时从p12文件构造TrustAnchor对象数组

证书链校验器对象的创建和校验

证书集合及证书吊销列表集合对象的创建和获取

Device Security Kit（设备安全服务）

Device Security Kit简介

Enterprise Data Guard Kit（企业数据保护服务）

Enterprise Data Guard Kit简介

Enterprise Data Guard Kit常见问题

Enterprise Data Guard Kit权限获取

Online Authentication Kit（在线认证服务）

Online Authentication Kit简介

Universal Keystore Kit（密钥管理服务）

Universal Keystore Kit简介

User Authentication Kit（用户认证服务）

User Authentication Kit简介

Connectivity Kit（短距通信服务）

Distributed Service Kit（分布式管理服务）

Distributed Service Kit简介

Network Boost Kit（网络加速服务）

Remote Communication Kit（远场通信服务）

Remote Communication Kit简介

使用fetchsync发送同步网络请求 (C/C++)

使用fetch发起异步网络请求 (C/C++)

使用delete发送网络请求 (C/C++)

使用cancel取消网络请求 (C/C++)

Service Collaboration Kit（协同服务）

Service Collaboration Kit简介

Service Collaboration Kit常见问题

接入跨设备互通控件后，设备选择列表没有周围设备

Telephony Kit（蜂窝通信服务）

Basic Services Kit（基础服务）

Function Flow Runtime Kit（任务并发调度服务）

Function Flow Runtime Kit概述

Function Flow Runtime 开发指导

EnterpriseAdminExtensionAbility开发指南

Status Bar Extension Kit（状态栏开放服务）

Status Bar Extension Kit简介

Driver Development Kit（驱动开发服务）

Driver Development Kit简介

外设扩展驱动客户端开发指导

外设扩展驱动开发指导

常见问题

Multimodal Awareness Kit（多模态融合感知服务）

Multimodal Awareness Kit简介

Pen Kit手写套件是否支持自定义笔刷？

Pen Kit手写套件是否支持自定义笔宽？

Pen Kit手写套件是否支持自定义颜色？

Pen Kit手写套件的工具栏是否可以单独提供？

集成了Pen Kit手写套件，还需要集成报点预测吗？

集成了Pen Kit手写套件，还需要集成一笔成形吗？

Pen Kit报点预测功能能够调整预测的程度吗？

为什么一笔成形识别不出来？

Sensor Service Kit（传感器服务）

Sensor Service Kit开发简介

Wear Engine Kit（穿戴服务）

管理应用与Wear Engine服务的连接状态

穿戴侧应用开发

调测验证

Wear Engine常见问题

如果工程已有APP ID，是否需要重新申请，填写新的APP ID

使用AppInfo时，如何获取应用身份标识

没有弹出用户授权界面

接口调用时返回App has not applied for the Wear Engine service错误信息

打开HR传感器后，没有立刻上报数据

HR传感器数据中，有值为0或255的数据

手机和轻量级智能穿戴设备通信，提示错误码206

手机侧应用发送文件给穿戴设备侧应用时，提示错误码1008500011

更多：若以上FAQ仍不能解决，可通过在线提单反馈

个人数据处理说明

调测调优

Performance Analysis Kit（性能分析服务）

Performance Analysis Kit简介

订阅24h功耗器件分解统计事件（ArkTS）

HiTraceMeter使用指导

使用HiTraceMeter跟踪性能（ArkTS/JS）

使用HiTraceMeter跟踪性能（C/C++）

查看HiTraceMeter日志

HiTraceChain使用指导

使用HiTraceChain打点（ArkTS/JS）

使用HiTraceChain打点（C/C++）

HiChecker使用指导

使用HiChecker检测问题（ArkTS）

HiDebug使用指导

使用HiDebug获取调试信息（ArkTS）

使用HiDebug获取调试信息（C/C++）

HiCollie使用指导

使用HiCollie检测业务线程卡死卡顿问题（C/C++）

分析Resource Leak（资源泄露）

媒体

Archived

使用AudioSession管理应用音频焦点(ArkTS)

使用AudioSession管理应用音频焦点(C/C++)

音频播放

音频播放开发概述

使用AudioRenderer开发音频播放功能

响应音频流输出设备变更

使用OHAudio开发音频播放功能(C/C++)

使用AudioHaptic开发音振协同播放功能

使用AudioCapturer开发音频录制功能

使用OHAudio开发音频录制功能(C/C++)

从OpenSL ES切换到OHAudio(C/C++)

使用OpenSL ES开发音频播放功能(C/C++)

使用OpenSL ES开发音频录制功能(C/C++)

AVCodec Kit（音视频编解码服务）

AVSession Kit（音视频播控服务）

适配不同折叠状态的摄像头变更(ArkTS)

分段式拍照(ArkTS)

动态照片(ArkTS)

相机基础动效(ArkTS)

在Worker线程中使用相机(ArkTS)

使用ImageSource完成多图对象解码

使用PixelMap完成图像变换

使用PixelMap完成位图操作

使用ImagePacker完成图片编码

使用ImagePacker完成多图对象编码

编辑图片EXIF信息

图片开发指导(C/C++)

介绍Image_NativeModule结构体信息

使用Image_NativeModule完成图片解码

使用Image_NativeModule完成多图对象解码

使用Image_NativeModule完成图片接收器

使用Image_NativeModule完成位图操作

使用Image_NativeModule处理图像信息

使用Image_NativeModule完成图片编码

使用Image_NativeModule完成多图对象编码

使用ImageEffect编辑图片

使用ImageProcessing处理图片

图片开发指导(依赖JS对象)(C/C++)

使用AVPlayer播放音频(ArkTS)

使用AVPlayer播放视频(ArkTS)

使用AVPlayer设置播放URL(ArkTS)

使用AVPlayer播放流媒体(ArkTS)

使用AVPlayer添加视频外挂字幕(ArkTS)

使用SoundPool播放短音频(ArkTS)

录制

使用AVRecorder录制音频(ArkTS)

使用AVRecorder录制视频(ArkTS)

使用AVScreenCaptureRecorder录屏写文件(ArkTS)

媒体信息查询

使用AVMetadataExtractor提取音视频元数据信息(ArkTS)

使用AVImageGenerator提取视频指定时间图像(ArkTS)

视频转码

使用AVTranscoder实现视频转码(ArkTS)

媒体开发指导(C/C++)

播放

使用AVPlayer播放音频(C/C++)

使用AVPlayer播放视频(C/C++)

录屏

使用AVScreenCapture录屏取码流(C/C++)

使用AVScreenCapture录屏写文件(C/C++)

Media Library Kit（媒体文件管理服务）

Media Library Kit 简介

使用Picker选择媒体库资源

保存媒体库资源

使用PhotoPicker组件访问图片/视频

使用AlbumPicker组件访问相册列表

使用RecentPhoto组件获取最近一张图片

使用PhotoPicker推荐图片

动态照片

访问和管理动态照片资源

使用MovingPhotoView播放动态照片

使用MediaAssetManager请求媒体资源(C/C++)

上传软件包时提示“上传的软件包与声明支持设备不一致”

自定义界面扫码如何连续扫码（customScan.rescan）

图形

Archived

获取检测平面的二维顶点数组时报错：“plane is nullptr!”，返回错误码：401

摄像头被遮挡一段时间后再放开，输出的位姿有跳变

反光、光线暗或者弱纹理场景（输入图像颜色变化小）下无法识别平面

某些特殊场景下（如附近存在磁场干扰、手机发烫或扫描到重复纹理等），出现平面漂移或者位姿数据跳变现象

ArkGraphics 2D（方舟2D图形服务）

NativeDisplaySoloist开发指导 (C/C++)

NativeBuffer开发指导 (C/C++)

NativeImage开发指导 (C/C++)

NativeVSync开发指导 (C/C++)

NativeWindow开发指导 (C/C++)

图形开发术语

ArkGraphics 3D（方舟3D图形）

ArkGraphics 3D简介

ArkGraphics 3D场景搭建以及管理

ArkGraphics 3D资源创建以及使用

ArkGraphics 3D场景动画控制以及管理

Graphics Accelerate Kit（图形加速服务）

Graphics Accelerate Kit简介

Graphics Accelerate Kit常见问题

超帧和ABR支持的图形API有哪些？

Kit支持的设备类型有哪些？

开启超帧外插模式后运动物体边缘出现严重拖影现象，可能的原因是什么？

哪些特征的Buffer适合使能ABR？

ABR进行Buffer分辨率调整引起其他Pass渲染效果异常，该如何解决？

集成ABR后，从游戏引擎获取到的Native纹理内容为空，该如何解决?

XEngine Kit（GPU加速引擎服务）

空域AI超分的输出颜色附件是否需要通过OH_NativeBuffer创建

应用服务

Archived

Account Kit（华为账号服务）

Account Kit简介

开发者使用Account Kit的登录能力的管理细则

华为账号一键登录（获取手机号和UnionID/OpenID）

华为账号登录（获取UnionID/OpenID）

Access Token和Refresh Token的有效时长是多久

Access Token和Refresh Token长度限制要求

调用接口获取应用级Access Token时，是否有次数和频率限制

无法获取手机号或获取到的手机号为空如何解决

ID Token的使用场景与使用方法

未成年人模式开启后USB断连如何解决

HarmonyOS APK应用和HarmonyOS应用在一键登录场景下的用户数据如何互通

使用华为账号一键登录功能时，是以华为账号的UnionID/OpenID还是以手机号作为用户的主要标识？

展示原生广告时传入广告数组为何只展示一个广告？

订阅或取消订阅voipCallUiEvent事件

Cloud Foundation Kit（云开发服务）

Cloud Foundation Kit简介

Cloud Foundation Kit常见问题

使用云存储上传文件失败，提示“404:Product does not exist”

使用云存储上传文件失败，app日志提示“"state":65”，upload进程日志提示“403 Forbidden”

个人数据处理说明

Contacts Kit（联系人服务）

Contacts Kit开发概述

Game Service Kit（游戏服务）

HarmonyOS NEXT游戏包名是否必须以.huawei结尾？

是否需要在游戏初始化成功后才可以调用其他业务接口？

是否支持游戏自定义联合登录面板？

当切换游戏账号或进行其它操作时，如何强制拉起联合登录面板？

“提交角色信息”这一步是否是必须接入？

把HarmonyOS游戏账号资产转移至HarmonyOS NEXT游戏的过程中，游戏侧需要做什么？

同一个游戏账号下的账号资产能否互通？

原系统游戏登录使用的openId/playerId/unionId，转移到新系统后，HarmonyOS NEXT游戏保存的玩家标识是gamePlayerId，如何进行绑定？

若HarmonyOS游戏没有玩家华为账号的登录记录，是否仅剩绑定流程可选？

玩家选错游戏的登录方式后如何补救？

玩家角色（转移）回退后，能否通知游戏侧，以便关联数据？

转移回退后再登录HarmonyOS NEXT游戏的玩家体验是什么？

实名认证、未成年人防沉迷等逻辑是华为侧实现还是游戏侧实现？

如何获取华为账号中的头像昵称等信息？

游戏没有历史渠道包，不存在转移场景，或者未配置支持转移，可以直接跳过吗？

绑定场景下，玩家不授权手机时，如何绑定华为账号和游戏官方账号？

玩家授权的手机号是华为账号绑定的手机号还是安全手机号？

Health Service Kit（运动健康服务）

Health Service Kit常见问题

读取今天的日常活动数据统计，与运动健康App页面数据不一致

授权后仍然没有数据类型权限

在授权时上报1001502003错误

在授权时上报1001502014错误

用户隐私未同意，如何引导用户打开运动健康App

AppGallery Connect中可以配置多个关键事件通知接收地址吗？

AppGallery Connect获取的IAP公钥最大长度是多少？便于用户存储设置的最大长度是多少？

AppGallery Connect商品管理页面，商品价格编辑界面的默认价格表示什么意思？

在AppGallery Connect中单独修改商品在某个地区的价格，以后汇率变动，是否会影响应用内的商品价格？

AppGallery Connect商品管理页面中，价格展示是否做了数字调整？比如小数点第二位6/9等调整？

是否必须使用SHA256的证书才能通过验签？

签名校验是否可以都在服务端执行？

是否能在删除商品后添加具有相同productId的商品？

IAP服务器支持的证书范围

IAP服务器支持的加密套件范围

如何解决证书链不完整？

应用在子窗口中调用createPurchase拉起IAP Kit收银台时，子窗口会被隐藏，此现象正常吗？

某些特殊场景下（如附近存在磁场干扰、手机发烫或扫描到重复纹理等），出现平面漂移或者位姿数据跳变现象

更新时间: 2025-03-14 09:23

本文导读

现象描述

可能原因

处理步骤

现象描述

某些特殊场景下，如使用环境附近存在强磁场，手机处于高负载场景下（后台开启很多应用或长时间使用导致手机发烫），或者扫描到重复纹理（见下图）时，可能出现识别到的平面无法锚定到现实世界中，或者通过HMS_AREngine_ARCamera_GetPose接口获取的位姿信息出现大幅度跳变等现象。

图1 重复纹理的地板

点击放大

可能原因

AR引擎通过获取到的加速度计传感器和磁力计传感器的信息进行平面计算和相机位姿计算，上述特殊场景下，系统传感器数据可能会存在异常，从而导致平面漂移或者位姿跳变的现象发生。

处理步骤

建议应用对通过HMS_AREngine_ARCamera_GetPose接口获取到的位姿数据，按照实际应用使用场景进行滤波，如步行导航场景，应用可以缓存多帧数据，通过多帧数据可以计算得到运动速度，如果检测到此速度明显高于步行速度，证明此时AR数据已经不可信，可以丢弃此数据或者重启AR算法。

说明

计算运动速度：x,y,z为在t时刻的位姿数据的位移量。

点击放大

反光、光线暗或者弱纹理场景（输入图像颜色变化小）下无法识别平面

ArkGraphics 2D（方舟2D图形服务）