HarmonyOS 6.0.1(21)
6.0.1(21)在6.0.0(20)的基础上，进一步增强ArkUI组件能力，新增一批属性样式的C API，增强了Image组件的SVG解析能力；Ability Kit增强了拉起应用的结果处理；ArkWeb增强了WebView相关能力；后台任务新增支持并行创建多个同样的长时任务；地图服务进一步丰富了可直接调用的场景，等等。更多详情可参见OS平台新增和增强特性。
DevEco Studio进一步增强AI智能辅助编程的能力和Code Linter静态检测能力，工程级配置文件新增多个可选配置字段，等等。更多详情可参见DevEco Studio新增和增强特性。
版本信息
使用正确的配套关系进行应用开发可以获得更流畅的开发体验。
请在阅读版本更新和变更内容前，务必确认版本的配套关系是否与当前您所使用的开发套件是一致的。
6.0.1(21)开发者套件配套信息
| 软件包 | 发布类型 | 版本号 | 发布时间 |
|---|---|---|---|
| API版本 | Release | 6.0.1(21) *注意：设备系统支持的API能力范围请以****API版本****为准。 | 2025/11/20 |
| DevEco Studio | Release | DevEco Studio 6.0.1 Release (6.0.1.268) （Patch版本） | 2026/02/13 |
| DevEco Studio 6.0.1 Release (6.0.1.260) （Patch版本） | 2025/12/17 | ||
| DevEco Studio 6.0.1 Release (6.0.1.251) （Patch版本） | 2025/11/24 | ||
| DevEco Studio 6.0.1 Release (6.0.1.249) | 2025/11/20 | ||
| SDK | Release | HarmonyOS 6.0.1 Release SDK 基于OpenHarmony SDK Ohos_sdk_public 6.0.1.112 (API 21 Release) | 2025/11/20 |
-
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配置项 | 已开发应用 | 新启动开发应用 | |
|---|---|---|---|
| 配置建议 | 配置示例 | ||
| compileSdkVersion | 无需显性配置，编译时默认使用配套的SDK版本，即默认为： “compileSdkVersion”: “6.0.1(21)” | NA | 推荐使用6.0.0(20)进行新应用的开发。 |
| compatibleSdkVersion | 建议与工程升级前的compatibleSdkVersion保持一致 | 和升级前保持一致，如： “compatibleSdkVersion”: “5.0.5(17)” | |
| targetSdkVersion | 推荐您适配新版本的最新变更，然后配置为：“targetSdkVersion”: “6.0.1(21)”。 如果您期望延迟适配变更，可配置targetSdkVersion与工程升级前的targetSdkVersion一致。 | 1、应用适配变更，变更适配完成后配置为： “targetSdkVersion”: “6.0.1(21)” 2、应用暂不适配变更，需配置为工程升级前的值，如： “targetSdkVersion”: “5.0.5(17)” |
历史Beta版本
6.0.1(21) Beta1
| 软件包 | 发布类型 | 版本号 | 发布时间 |
|---|---|---|---|
| API版本 | Beta | 6.0.1(21) Beta1 *注意：设备系统支持的API能力范围请以****API版本****为准。 | 2025/11/06 |
| DevEco Studio | Beta | DevEco Studio 6.0.1 Beta1 (6.0.1.246) | 2025/11/06 |
| SDK | Beta | HarmonyOS 6.0.1 Beta1 SDK 基于OpenHarmony SDK Ohos_sdk_public 6.0.1.111 (API 21 Beta1) | 2025/11/06 |
6.0.1(21) Release关键特性
Ability Kit
C API新增支持设置子进程配置信息对象的uid是否隔离。（API参考）
ArkUI
图像类型定义新增对内容切换时的过渡效果的定义。（API参考）
ArkWeb
Media Library Kit
新增PhotoPicker退出界面的上下文信息，可以用于下次使用PhotoPicker时恢复上次退出时的现场。（API参考）
6.0.1(21) Beta1关键特性
Ability Kit
- 新增支持通过C API获取应用版本号的能力。（API参考）
- 拉起UIExtensionAbility的回调新增属性completionHandler，用于返回拉起指定类型的Ability组件的回调结果。（API参考）
- 应用启动框架新增支持设置启动任务的调度阶段。（指南）
- openLink的可选参数OpenLinkOptions新增支持传递拉起应用结果的操作类（completionHandler），用于处理拉起应用的结果。（API参考）
- 包管理新增支持清理应用自身的缓存。（API参考）
- C API新增支持获取可打开特定文件类型的组件资源信息列表。（API参考）
Agent Framework Kit
新增支持图标与标题呈现上下结构的胶囊按钮。（API参考）
ArkGraphics 2D
新增行高缩放基数枚举，支持设置以字号大小或字形高度作为缩放基数进行行高设置。（API参考）
ArkUI
- 新增支持通过图片对象说明获取属性字符串中的图片的尺寸。（API参考）
- RichEditor新增支持设置组件滚动条的颜色。（API参考）
- FrameNode新增支持在当前帧触发节点属性更新。（ArkTS API参考、C API参考、C API指南）
- 新增支持通过C API注册目标节点的基础事件回调。（API参考）
- Image组件SVG新增多个解析处理能力，包括SVG易用性提升、仿射变换能力扩展、解析能力扩展、显示效果扩展。（API参考）
- 新增动画控制器的相关能力。（API参考）
- 新增支持发起图片资源的同步加载和异步加载，并返回加载结果。（API参考）
- Text组件新增支持设置文本内容区在组件内的垂直对齐方式，以便在文本内容区高度大于组件高度时确保文本内容区的对齐方式正确显示。（API参考）
- C API的属性样式集合ArkUI_NodeAttributeType的枚举项增强：（API参考）
- 背景图位置属性NODE_BACKGROUND_IMAGE_POSITION新增属性值.value[2].?i32，表示对齐模式；新增属性值.value[3].?i32，表示布局方向。
- 遮罩属性NODE_OVERLAY新增属性值.value[3]?.i32，表示浮层的布局方向；新增属性值.object，表示overlay的节点树。
- 新增属性NODE_WIDTH_LAYOUTPOLICY = 105，用于设置组件宽度布局策略。
- 新增属性NODE_HEIGHT_LAYOUTPOLICY = 106，用于设置组件高度布局策略。
- 新增属性NODE_POSITION_EDGES = 107，用于设置组件相对容器内容区边界的位置。
- 新增属性NODE_PIXEL_ROUND = 109，用于设置组件的像素取整策略。
- 新增属性NODE_TEXT_CONTENT_ALIGN = 1036，用于设置文本内容区垂直对齐方式。
- 新增属性NODE_IMAGE_SOURCE_SIZE = 4013，用于设置图片解码尺寸。
- 新增属性NODE_IMAGE_IMAGE_MATRIX = 4014，用于设置图片的变换矩阵属性。
- 新增属性NODE_IMAGE_MATCH_TEXT_DIRECTION = 4015，用于设置图片是否跟随系统语言方向。
- 新增属性NODE_IMAGE_COPY_OPTION = 4016，用于设置图片的拷贝方式。
- 新增属性NODE_IMAGE_ENABLE_ANALYZER = 4017，用于设置组件支持AI分析。
- 新增属性NODE_IMAGE_DYNAMIC_RANGE_MODE = 4018，用于定义图片显示动态范围属性。
- 新增属性NODE_IMAGE_HDR_BRIGHTNESS = 4019，用于定义图片HDR模式下的亮度属性。
- 新增属性NODE_IMAGE_ORIENTATION = 4020，用于设置图像内容的显示方向。
- 新增属性NODE_IMAGE_SUPPORT_SVG2 = 4021，用于通过启用SVG新解析能力开关设置SVG解析功能支持的范围。
- 新增属性NODE_IMAGE_CONTENT_TRANSITION = 4022，用于设置图像变化时的转场动效。
- 新增属性NODE_SLIDER_BLOCK_LINEAR_GRADIENT_COLOR，用于定义Slider滑块的颜色。
- 新增属性NODE_SLIDER_TRACK_LINEAR_GRADIENT_COLOR，用于定义Slider滑轨的背景颜色。
- 新增属性NODE_SLIDER_SELECTED_LINEAR_GRADIENT_COLOR，用于定义Slider滑轨的已滑动部分颜色。
- 新增ListItem划出菜单管理器，支持展开和收起指定ListItem的划出菜单。（ArkTS API参考、C API参考）
- 滚动组件通用接口增强生命周期回调事件，新增：
- NavDestination的页面显示事件onShown能力增强，新增支持通过VisibilityChangeReason说明onShown触发的原因。（API参考）
- 新增支持定制CheckboxGroup内容区的方法。（API参考）
- UIContext新增支持设置HSP资源管理对象缓存个数的上限。（API参考）
- 窗口管理新增支持设置窗口内容布局（不含边框和标题栏等装饰）的比例。（API参考）
- 窗口管理新增支持设置本应用进程下窗口的水印图片。（API参考）
ArkWeb
- 新增支持设置Web组件是否启用强制缩放功能。（API参考）
- WebView能力增强：
- Web组件的自定义菜单扩展项新增onMenuShow和onMenuHide事件回调。（API参考）
- Web组件的枚举属性增强：
Asset Store Kit
关键资产删除时机的规则优化。从API 21开始，应用卸载时清除存储在ASSET中的非群组数据，群组数据调整为仅在群组内所有应用卸载时清除。（指南）
Audio Kit
- 音频返听能力增强，新增支持设置音频返听器的混响模式（API参考）、获取当前音频返听器的混响模式（API参考）、设置音频返听器的均衡器类型（API参考）、获取当前音频返听器的均衡器类型（API参考）。
- 新增支持查询指定录音流类型的智能降噪开关是否已开启。（ArkTS API参考、C API参考）
Background Tasks Kit
- 新增支持申请长时任务的同名接口，新接口支持同一时间申请多个长时任务。（指南、API参考）
- 针对上述接口申请的长时任务，配套新增更新长时任务的接口。（API参考）
- 新增支持取消指定ID的长时任务。（API参考）
Basic Services Kit
- 系统时间：新增支持获取自动设置时间的开关的状态。（API参考）
- 设备信息：常量定义中新增设备CPU芯片型号（chipType）和设备重启次数（bootCount）。（API参考）
- 上传下载：通知栏的自定义信息新增支持设置任务的显示方式（visibility）。（API参考）
- 剪贴板：当使用延迟复制功能的应用退出时，支持应用主动通知剪贴板获取所有延迟数据。（指南、API参考）
Camera Kit
- 新增支持设置拍照画质优先策略。（API参考）
Cloud Foundation Kit
Connectivity Kit
新增支持通过C API获取设备真实Mac地址。（API参考）
Crypto Architecture Kit
新增支持开启硬件熵源的能力。（API参考）
Device Security Kit
新增支持拉起系统级防窥蒙层对窗口敏感内容进行覆盖。（指南、API参考）
Enterprise Space Kit
空间管理服务场景下，新增支持设置系统服务进程不可访问后台用户数据、获取系统服务进程不可访问的后台用户数据状态、获取不可访问后台用户数据的系统服务进程列表、新增不可访问后台用户数据的系统服务进程列表、删除不可访问后台用户数据的系统服务进程列表功能。（指南、API参考）
Game Controller Kit
【新增Kit】Game Controller Kit（游戏控制器服务）支持游戏类应用适配控制器外设（如游戏手柄），解决玩家操控性问题，保障用户体验。游戏开发者可通过接入该服务实现游戏外设的上下线和按键及轴事件监听等功能。（指南、API参考）
Game Service Kit
新增支持小游戏相关能力，包括小游戏登录和小游戏支付。（指南、API参考）
IME Kit
新增支持获取指定屏幕当前状态（例如：折叠或展开）下输入法软键盘相对系统面板的偏移区域。（指南-详见步骤2、API参考）
Input Kit
- 全局快捷键模块的按键事件消费设置新增支持识别媒体播放的播放/暂停（KEYCODE_MEDIA_PLAY_PAUSE）、下一首（KEYCODE_MEDIA_NEXT）、上一首（KEYCODE_MEDIA_PREVIOUS）的快捷键。（API参考）
- C API新增如下能力的相关接口：
Localization Kit
新增支持在开发者模式下通过param工具的“param get persist.global.language”命令获取系统语言。（指南）
Location Kit
新增支持判断指定的BSSID是否存在于最新的WLAN扫描结果里。（API参考）
Map Kit
- 新增支持更改我的位置图层相对于覆盖物的压盖顺序。（指南、API参考）
- 新增支持拉起地图应用的打车页面。（指南、API参考）
- 地图应用的POI详情页面，新增设置地图缩放级别和地图坐标系类型。（API参考）
- 路线规划场景下，新增支持设置地图坐标系类型。（API参考）
- 导航场景下，新增支持设置起点信息和地图坐标系类型。（API参考）
- 打开地图应用规划路线或导航，新增支持公交类型。（API参考）
MDM Kit
-
企业应用的应用管理（API参考）和包管理（API参考）的相关接口在需要传入appIds参数时均新增支持使用appIdentifier参数作为入参，代替原先使用appId的方式。可在对应模块的API参考中搜索“appIds”了解详情。
-
可设置禁用/启用的特性新增如下（API参考）：
- 应用分身能力（appClone）
- 外置存储能力（externalStorageCard）
- Wi-Fi链接时使用随机MAC（randomMac）
-
新增支持应用运行允许名单，添加至允许名单的应用允许在指定用户下运行，不在允许名单的应用不允许在指定用户下运行。（API参考）
同时调整了应用运行禁止名单的策略，如果应用运行允许名单addallowedRunningBundles非空，就不能再通过接口添加应用到应用运行禁止名单。（API参考）
Media Kit
- 媒体信息描述的枚举新增视频原始宽度（MD_KEY_ORIGINAL_WIDTH）和视频原始高度（MD_KEY_ORIGINAL_HEIGHT）两个信息。（API参考）
- 新增支持通过C API设置播放器的媒体源。（API参考）
NearLink Kit
新增支持获取已配对设备列表。（API参考）
Online Authentication Kit
FIDO新增支持业务切换自定义认证方式。（API参考）
PDF Kit
新增搜索关键词API，开发者可以对PDF文档进行搜索，并获取上下文、关键词位置等信息。（API参考）
Remote Communication Kit
- 发送简单的HTTP表单数据场景下，新增支持按照键列表的先后顺序发送。（指南、API参考）
- 发送HTTP多部分表格数据时，新增支持按照键列表的先后顺序发送。（指南、API参考）
- 新增C API，支持监听响应状态码的功能。（API参考）
Scenario Fusion Kit
新增支持关注组件API，开发者可在应用页面展示服务号关注组件，实现用户点击关注按钮可关注对应服务号。（指南、API参考）
Share Kit
新增支持宿主应用配置目标应用名单。（指南）
Spatial Recon Kit
【新增Kit】Spatial Recon Kit（空间建模套件）集成了3DGS（3D Gaussian Splatting）模型的渲染、运算等能力，支持3DGS模型的加载和渲染功能、3DGS渲染的复古风格、漫画风格和比特风格特效。（指南、API参考）
Speech Kit
Telephony Kit
新增支持订阅通话状态变化拓展事件。（API参考）
UI Design Kit
HdsNavigation提供标题栏顶部自定义区域。（API参考）