HarmonyOS 6.0.2(22)
6.0.2(22)在6.0.1(21)的基础上，开发能力得到进一步增强：ArkUI增强了滚动组件相关能力，支持更多可配置和自定义的属性；Ability Kit增强了UIAbilityContext管理应用自身UIAbility的能力；ArkWeb增强了与终端用户交互的能力，提升Web页面的交互体验；Connectivity Kit的蓝牙模块增强了获取套接字链路信息的能力；Test Kit的UITest模块增强了模拟交互操作的能力；新增了FAST Kit（算法加速服务），提供高性能算法和数据结构等加速服务，等等。更多详情可参见OS平台新增和增强特性。
DevEco Studio进一步增强AI智能辅助编程的能力和Code Linter静态检测能力，编译构建脚本（如hvigorfile.ts）支持代码联想、跳转等编辑能力，新增支持数据库可视化调试能力，等等。更多详情可参见DevEco Studio新增和增强特性。
版本信息
使用正确的配套关系进行应用开发可以获得更流畅的开发体验。
请在阅读版本更新和变更内容前，务必确认版本的配套关系是否与当前您所使用的开发套件是一致的。
6.0.2(22)开发者套件配套信息
| 软件包 | 发布类型 | 版本号 | 发布时间 |
|---|---|---|---|
| API版本 | Release | 6.0.2(22) *注意：设备系统支持的API能力范围请以**API版本**为准。 | 2026/01/21 |
| DevEco Studio | Release | DevEco Studio 6.0.2 Release（6.0.2.660） （Patch版本） | 2026/05/12 |
| DevEco Studio | DevEco Studio 6.0.2 Release（6.0.2.650） （Patch版本） | Release | 2026/03/30 |
| DevEco Studio | DevEco Studio 6.0.2 Release（6.0.2.642） （Patch版本） | Release | 2026/03/06 |
| DevEco Studio | DevEco Studio 6.0.2 Release（6.0.2.640） | Release | 2026/01/21 |
| SDK | Release | HarmonyOS 6.0.2 Release SDK 基于OpenHarmony SDK Ohos_sdk_public 6.0.2.130 (API 22 Release) | 2026/01/21 |
-
该版本需通过开发者招募活动进行申请，申请通过后可获得对应设备的ROM版本推送。
-
API版本请在设备的“设置”中点击设备名称，进入“关于本机”进行查询。
-
DevEco Studio版本请从DevEco Studio界面菜单选择“Help > About DevEco Studio”进行查询。请点击此处获取最新的DevEco Studio软件版本。
-
SDK内置在DevEco Studio，安装DevEco Studio时自动安装配套版本SDK。具体版本请从DevEco Studio界面菜单选择“Help > About HarmonyOS SDK”进行查询。
应用工程版本信息配置建议
应用工程中应当正确配置应用运行所依赖的SDK版本信息，以确保应用在不同系统版本的设备上运行时的兼容性。
使用该版本开发的应用，其build-profile.json5配置项中关于版本的配置项建议如下：
| build-profile.json5配置项 | 已开发应用 | 新启动开发应用 | |
|---|---|---|---|
| build-profile.json5配置项 | 配置建议 | 配置示例 | 新启动开发应用 |
| compileSdkVersion | 无需显性配置，编译时默认使用配套的SDK版本，即默认为： “compileSdkVersion”: “6.0.2(22)” | NA | 推荐使用6.0.0(20)进行新应用的开发。 |
| compatibleSdkVersion | 建议与工程升级前的compatibleSdkVersion保持一致。 | 和升级前保持一致，如： “compatibleSdkVersion”: “5.0.5(17)” | 推荐使用6.0.0(20)进行新应用的开发。 |
| targetSdkVersion | 推荐您适配新版本的最新变更，然后配置为：“targetSdkVersion”: “6.0.2(22)”。 如果您期望延迟适配变更，可配置targetSdkVersion与工程升级前的targetSdkVersion一致。 | 1、应用适配变更，变更适配完成后配置为： “targetSdkVersion”: “6.0.2(22)” 2、应用暂不适配变更，需配置为工程升级前的值，如： “targetSdkVersion”: “5.0.5(17)” | 推荐使用6.0.0(20)进行新应用的开发。 |
历史Beta版本
6.0.2(22) Beta1
| 软件包 | 发布类型 | 版本号 | 发布时间 |
|---|---|---|---|
| API版本 | Beta | 6.0.2(22) Beta1 *注意：设备系统支持的API能力范围请以**API版本**为准。 | 2026/01/04 |
| DevEco Studio | Beta | DevEco Studio 6.0.2 Beta1（6.0.2.636） | 2026/01/04 |
| SDK | Beta | HarmonyOS 6.0.2 Beta1 SDK 基于OpenHarmony SDK Ohos_sdk_public 6.0.2.129 (API 22 Beta1) | 2026/01/04 |
6.0.2(22) Release
6.0.2(22) Release在Beta1版本基础上未引入新增特性。
6.0.2(22) Beta1关键特性
Ability Kit
- 新增C API支持获取本应用的应用级的日志文件目录。（API参考）
- UIAbilityContext新增支持在当前进程中启动应用程序自己的UIAbility。（API参考）
- UIAbilityContext新增支持重启应用的接口，处于获焦状态的UIAbility可以通过该接口重启当前UIAbility所在的进程，并拉起应用内的指定UIAbility。（API参考）
- 新增支持获取应用启动时预加载阶段的能力。（API参考）
- 新增支持根据传入的pid终止当前进程创建的Native子进程或ArkTS子进程。（指南）
AppGallery Kit
ArkData
UDMF新增iWork文件格式的标准数据类型定义。详见UTD预置列表的基础类型。
AR Engine
新增获取拍照流图片接口，支持配置高清图像。（API参考）
ArkTS
- 新增支持在Sendable class上叠加使用除@Sendable装饰器之外的其他自定义装饰器。（指南）
- Util新增接口类AutoFinalizer，用于在ArkTS对象释放时提供回调。通过实现回调接口，开发者可自定义对象被回收时自动触发的资源清理逻辑。（API参考）
- 新增支持通过taskId或taskId与taskName获取对应的Task实例。（API参考）
ArkUI
- 新增Picker容器组件，支持开发者自定义构造Picker选择器。（API参考）
- 滚动组件相关能力增强：
- TextArea控件新增C API支持配置滚动条是否显示。（API参考）
- 滚动组件新增支持获取内容总大小的能力。（API参考）
- 滚动组件通用接口支持设置滚动内容区域偏移量，实现内容滚动到边缘时有留白、未滚动到边缘时有内容的效果。（API参考）
- Grid组件支持通过C API设置布局选项（例如大小规则的GridItem在Grid中占的行数和列数）（API参考），滚动通用属性和事件（例如，设置滚动条宽度，在API参考Attribute表中搜索“Grid从API version 22开始支持”）
- scrollBarColor的入参支持Resource类型，覆盖滚动组件通用接口（API参考）、Scroll组件（API参考）、Grid组件（API参考）。
- 新增组件可见区域变化事件的回调。（API参考-ArkTS、API参考-C API）
- 新增C API支持停止指定的Swiper节点正在执行的翻页动画。（API参考）
- Tabs组件新增回调，支持监听Tabs组件初始化时显示首个页签的事件。（API参考）
- Navigation新增回调，支持监听Navigation页面在跳转前的拦截事件。（API参考）
- Tabs组件新增支持自定义indicator，支持图片格式的下划线风格。（API参考）
- UIContext新增支持获取后端实例的唯一标识ID。（API参考）
- UIContext新增静态方法，提供静态获取UIContext的能力。（指南、API参考）
- 新增ReactiveBuilderNode，支持通过无状态的UI方法@Builder生成组件树，并持有该组件树的根节点。（API参考）
- 新增一套自定义组件生命周期的机制，可使组件生命周期回调函数受状态机限制，保证生命周期回调函数调用时机符合预期。（指南）
- 窗口新增支持获取当前应用窗口的避让区域，即使避让区域当前处于不可见状态。（API参考）
- 窗口新增支持以vp单位获取当前应用窗口的尺寸限制。（API参考）
- 窗口扩展了maximize接口能力，新增参数acrossDisplay控制折叠屏悬停态下主窗口在最大化时的瀑布流模式行为。（API参考）
ArkWeb
- 将分词高亮与文本选择后弹出AI菜单的功能进行解耦，允许开发者单独进行功能配置。（指南、API参考）
- 新增支持监听Web页面白屏事件，并提供事件的回调。（API参考）
- 新增属性emulateTouchFromMouseEvent，支持Web组件设置mouse事件转touch事件。（API参考）
- 新增支持设置软键盘自动控制模式，用于控制Web组件在失去焦点或获得焦点、状态切换为inactive或active时是否尝试触发软键盘自动隐藏或拉起。（API参考）
- 新增支持通过ContextMenuDataMediaType获取触发onContextMenuShow的Web元素类型，类型包含NONE、IMAGE 、VIDEO 、AUDIO 、CANVAS。（API参考）
- 新增支持快速返回Web页面顶部的能力。当网页处于非顶部状态或向下抛滑时，此时若需返回网页顶部，可以使用backToTop方法，开启后通过点击状态栏，打断抛滑并将网页滚动到网页顶部。（API参考）
- 新增设置属性，支持设置是否通过组合按键（Ctrl+'-/+'或Ctrl+鼠标滚轮/触摸板）进行缩放。（API参考）
- OnRefreshAccessedHistoryEvent新增可选参数isMainFrame，用于标记是否为主文档触发。（API参考）
- 新增支持在使用CookieManager的场景下，延后初始化ArkWeb内核的能力。（指南、ArkTS API参考、C API参考）
AVSession Kit
新增支持返回当前进程已创建过的会话对象。（API参考）
Basic Services Kit
新增API注解能力，可用于标记API支持的最低可用版本。在源码定义处添加注解后，编译工具会在使用处检查潜在的兼容性问题。（API参考）
Call Service Kit
Connectivity Kit
- 蓝牙新增支持查询指定套接字链路下的最大接收数据大小（API参考）和最大发送数据大小（API参考）。
- 蓝牙新增支持查询指定套接字链路下的连接状态。（API参考）
- 蓝牙新增支持获取指定server端服务的能力。（API参考）
- 蓝牙新增支持将16位、32位UUID转128位UUID的能力。（API参考）
- NFC新增支持应用声明off_host_apdu能力，将应用添加到默认付款应用列表中。（指南）
Crypto Architecture Kit
DeskTop Extension Kit
Device Security Kit
Enterprise Space Kit
空间管理场景下，新增支持设置工作空间策略、查询工作空间策略、设置深度冻结豁免名单、查询深度冻结豁免名单功能。（指南、API参考）
FAST Kit
【新增Kit】FAST Kit（算法加速服务）提供高性能算法和数据结构等加速服务，用于提升开发者的开发效率和用户的应用使用体验。（指南、API参考）
Game Service Kit
IME Kit
新增输入法扩展信息模块，提供对输入法扩展信息的管理，支持ArkUI编辑框在拉起输入法时传递扩展信息给输入法应用。（API参考）
Input Kit
新增支持注入修饰键后查询到修饰键状态。（API参考）
Live View Kit
实况窗支持显示本地天气效果，典型场景包括即时配送、出行打车等。（API参考）
Localization Kit
新增国际化能力的C API能力。（API参考）
Map Kit
MDM Kit
NDK开发
Network Kit
- 新增支持保护应用进程不受VPN连接影响的能力。（API参考）
- 新增支持获取本地设备IP邻居表条目信息，包括IPv4和IPv6，每个条目信息包括IP地址、MAC地址、网卡名。（API参考）
- TLS新增支持设置timeout字段，TLSSocket会在timeout后断开连接。（API参考）
- 新增支持在VPN首次启动时传递want中的parameters字段。（API参考）
- 新增网络策略的接口，在需要设置当前应用能否使用Wi-Fi/蜂窝联网时，可调用该接口打开当前应用的联网设置界面，以设置应用的联网权限。（API参考）
Network Boost Kit
新增C API，支持连接迁移（多网并发），包括业务场景设置、多网状态监听、多网建议监听、多网配额查询、多网发起和释放。（指南）
Notification Kit
PDF Kit
新增PDFView组件嵌套滚动能力。（API参考）
Performance Analysis Kit
- AppFreeze采样栈新增支持对libuv异步栈的跟踪。（指南）
- HiAppEvent新增支持主线程超时事件配置策略，支持主线程超时结束自动停止采样栈的功能。（指南，API参考）
- HiDebug新增接口支持对指定的数个线程进行Perf采样，并在调用结束后返回采样栈内容。（API参考）
- JS Crash增加混合栈字段（HybridStack），支持打印CPP和JS之间跨语言的代码调用栈。（指南）
Scan Kit
Scenario Fusion Kit
Screen Time Guard Kit
Share Kit
碰一碰分享新增支持当前界面无可分享内容时，引导用户前往可分享场景的能力。（指南、API参考）
Test Kit
- 单元测试框架新增接口beforeEachIt和afterEachIt，用于支持嵌套场景下生命周期函数的执行。（指南）
- UITest新增支持窗口变化和组件操作事件监听能力。（API参考）
- UITest新增支持指关节操作模拟能力。（API参考）
- UITest新增支持在模拟操作的同时查找目标控件是否存在。（API参考）
- UITest新增支持触摸板双指滚动操作模拟能力 。（API参考）
UI Design Kit
HdsVisualComponent组件新增支持卡片能力。（API参考）
标准库
ICU4C新增支持ICU版本、名称本地化、码点处理及CLDR版本。（API参考）