harmony 鸿蒙OpenHarmony 5.0.2 Release

2025-06-16
浏览 (7)

OpenHarmony 5.0.2 Release

版本概述

OpenHarmony 5.0.2 Release版本对标准系统的能力进行持续完善，以快速迭代的方式推出API 14，相比5.0.1 Release版本，重点做出了如下特性新增或增强：

进一步增强ArkUI、图形图像的能力，提供更多组件的高级属性设置，支持更多精致动效；进一步增强Web能力，满足更多应用诉求；针对2in1设备特点，新增一系列窗口管理和控制的能力及窗口生命周期行为管理；新增一批企业定制应用的能力，支持灵活管理企业定制应用，等等。

更详细的特性新增与增强的说明如下：

应用框架

针对2in1与平板设备，新增支持自定义应用启动时的启动页。（API参考）
通过Want传递对象间信息时支持在parameters参数中携带应用分身的索引（ohos.param.callerAppCloneIndex）。（API参考）
新增支持获取应用级上下文的能力。（API参考）
开放包管理能力供三方应用调用。（API参考）
新增支持UIAbility备份恢复的能力。（API参考，指南）
新增支持获取当前应用多实例的唯一实例标识。（API参考）
环境变化信息的定义中新增当前系统字体的唯一ID的定义fontId。（API参考）
新增C API，支持获取本应用适用的设备类型，用于判断应用是否可直接运行在2in1设备。（API参考）

ArkUI

路由导航能力增强。包括：
- Navigation页面栈新增支持配置可在异常退出时恢复。（API参考）
- NavDestination支持跟可滚动容器组件联动，当滑动可滚动容器组件时，会触发所有与其绑定的NavDestination组件的标题栏和工具栏的显示和隐藏动效。（API参考）
- Navigation支持设置单个页面的系统转场动画枚举，支持分别设置系统标题栏动画和内容动画以及无动画。（API参考）
- 页面路由新增支持设置页面是否可恢复。（API参考）
文本与输入组件能力增强。包括：
- 属性字符串新增支持设置文字背景色、支持设置为超链接、支持将有属性的字符串转换成HTML格式字符串的能力。（API参考）
- ImageSpan组件新增支持为图像设置颜色滤镜效果。（API参考）
- 支持获取文本组件中指定字符的绘制区域信息（API参考）、文本输入时的键盘避让模式支持光标避让（API参考）。
- 文本选择器组件（TextPicker）新增支持滑动停止时的事件回调。（API参考）
滚动与滑动组件能力增强。包括：
- 滚动组件新增支持设置滚动容器的内容层裁剪区域、支持设置边缘渐隐效果。（API参考）
- List组件新增支持配置是否显示预加载的ListItem/ListItemGroup。（API参考）
- Grid、WaterFlow组件新增新增支持配置是否显示预加载的GridItem、FlowItem。（API参考-Grid、API参考-WaterFlow）
C API通用能力增强。包括：
- 支持为OH_NativeXComponent实例注册带有返回值的按键事件回调。（API参考）
- 支持获取节点的各种自定义属性。（API参考）
- NodeAttributeType新增获取滚动类组件及所有子组件全展开尺寸的C API属性定义。（API参考）
按键事件新增unicode对象，支持返回当前keyEvent对应按键的unicode码值。（API参考）
半模态转场的SheetOptions新增enableHoverMode和hoverModeArea属性用于支持悬停。（API参考）
日期滑动选择器弹窗（DatePickerDialog）新增支持设置切换农历开关的样式。（API参考）
手势处理能力涉及到的六类手势事件新增支持设置允许的事件输入源（API参考）、FreamNode新增支持手势事件（API参考）。
组件的位置设置新增支持对形成链的组件进行重新布局（API参考）、组件的背景设置新增支持设置窗口失焦后窗口内控件模糊效果会被移除（API参考）。
新增支持对容器设置组件级的安全区域。（API参考）
Image组件新增支持设置图片的显示方向。（API参考）

窗口管理

针对2in1设备的应用，新增通过应用窗口关闭按钮关闭应用的监听，使用该API可忽略已设置的预关闭开关的回调。（API参考）
针对2in1设备的应用，新增自定义应用主窗口大小和位置的能力，通过配置文件module.json5进行配置。（指南）
针对2in1设备的应用，新增支持将应用从最小化恢复到前台显示的能力。（API参考）
针对2in1设备的应用，新增支持查询本应用内指定坐标下的可见窗口的能力。（API参考）
针对2in1设备的应用，新增支持使能/禁用通过拖拽方式缩放主窗口或子窗口。（API参考）
针对2in1设备的应用，新增支持设置主窗口为模态窗口。（API参考）
针对2in1设备的应用，新增支持应用控制启动页消失时机。（API参考）
针对2in1设备的应用，新增支持设置主窗的尺寸记忆是否启用。（API参考）
针对2in1设备的应用，新增支持设置主窗口进入全屏沉浸式时鼠标Hover到热区上隐藏窗口标题栏和dock栏。（API参考）
针对2in1设备的应用，新增支持设置主窗标题栏上的最大化、最小化、关闭按钮是否可见。（API参考）
针对2in1设备的应用，新增支持设置主窗口置于其他应用窗口之上而不被遮挡。（API参考）
针对2in1设备的应用，新增支持应用窗口无系统标题栏场景下拖拽移动窗口的能力。（API参考）
新增支持设置窗口使用效果模板，比如使用有透视的背景模糊效果。（API参考）
新增支持对窗口所在屏幕进行事件监听，例如当前窗口移动到其他屏幕时，可以调用此接口监听到这个行为。（API参考）
新增支持设置子窗的模态类型。（API参考）

应用包管理

HSP支持在配置文件中声明除入口Ability以外的UIAbility组件。（指南）
配置文件module.json5中abilities标签的orientation属性新增支持通过资源索引方式（$string）进行配置。
配置文件module.json5中extensionAbilities标签的extensionProcessMode属性新增支持配置runWithMainProcess类型，表示该ExtensionAbility和应用主进程共进程。
配置文件module.json5中extensionAbilities标签新增process属性，type为embeddedUI的ExtensionAbility可通过该属性的配置使ExtensionAbility和Ability运行在同一进程。

分布式数据管理

新增flushSync接口支持将缓存的Preferences实例中的数据存储到共享用户首选项的持久化文件中。（API参考）
关系型数据库（RDB）的配置属性StoreConfig新增参数cryptoParam，用于自定义加密参数。（API参考）
关系型数据库（RDB）新增支持创建可并发的事务对象。（API参考）
标准化数据结构（UDMF）新增内容卡片类型的数据结构（ContentForm）。（API参考）
标准化数据结构（UDMF）新增支持设置应用内拖拽通道数据可使用的范围。（API参考）

文件管理

新增支持获取保存成功后的文件后缀类型。（API参考）

媒体

流媒体播放新增一批错误码以细化流媒体播放可能出现的异常场景。（API参考）
播放控制新增支持投播半模态对象的能力。（API参考）
录屏新增C API支持设置录屏的最大帧率。（API参考）
媒体库新增支持定义配置相册图片后的完成按钮，可显示“完成”、“发送”或“添加”。（API参考）
媒体库Photo Picker组件新增支持视频播放状态的回调videoPlayStateChangedCallback。（API参考）
媒体库Photo Picker组件新增支持大图页视频播放状态改变时的回调onVideoPlayStateChanged。（API参考）
相机新增C API和ArkTS API用于设置录像质量的优先级，提供高质量和功耗平衡两档选择。（C API参考、ArkTS API参考）

图形

新增C API，支持获取系统全局字体集。（API参考）
新增Decoupled VSync（DVSync）的C API能力以提高自绘制动画场景的流畅性。（API参考）
新增一个模糊效果的处理能力，增加着色器效果平铺模式，影响图像边缘的模糊效果。（API参考）
新增C API，使浏览器支持动态帧率。（API参考）

安全

非对称密钥生成和转换、密钥协商、签名验签所使用的ECC算法支持secp256k1曲线。

企业定制

企业应用禁用设备功能的能力新增支持禁用设备相机能力。（API参考）
企业应用安装事件新增一类回调，该回调返回的信息包括安装包名和账号ID。（API参考）
企业应用新增支持委托其他应用来设置设备的管控策略。（API参考）
企业应用新增支持设置禁用/启用设备指纹功能，该能力目前仅限2in1设备使用。（API参考）
企业应用新增支持设置禁用屏幕快照（即截屏）功能，该能力目前仅限2in1设备使用。（API参考）
企业应用新增支持对应用设置水印的能力，该能力目前仅限2in1设备使用。（API参考）
企业应用新增支持“设备管理”应用添加保活的应用，该能力目前仅限2in1设备使用。（API参考）
企业应用新增支持“设备管理”应用添加禁止使用的USB设备类型，该能力目前仅限2in1设备使用。（API参考）

USB

USB管理新增支持检查应用程序是否有权访问USB配件。（API参考）

输入法

输入法框架提供的编辑框属性新增编辑框所属应用的包名。（API参考）

剪贴板

剪贴板新增支持通过MIME定义和使用多种格式的内容对象。（API参考）
剪贴板新增C API和ArkTS API支持获取剪贴板内容的MIME类型。（C API参考、ArkTS API参考）

Web

用户主动收起软键盘时，新增支持设置焦点从输入框转移到Web的body上，使文本框失焦。（API参考）
新增C API，用于获取调用JavaScriptProxy最后一帧的url。（API参考）
新增支持获取默认的用户代理。（API参考）
新增支持为指定url设置cookie的值。（API参考）
新增支持上下左右四种嵌套滚动模式。（API参考）
新增支持根据指定的内存压力等级主动清理Web组件占用的缓存。（API参考）
新增支持网页另存为PDF的能力。（API参考）
新增支持设置滚动动画的持续时间。（API参考-scrollTo、API参考-scrollBy）
新增支持设置滚动条常驻。（API参考）

配套关系

表1 版本软件和工具配套关系

软件	版本	备注
OpenHarmony	5.0.2 Release	NA
Public SDK	Ohos_sdk_public 5.0.2.123 (API Version 14 Release)	面向应用开发者提供，不包含需要使用系统权限的系统接口。通过DevEco Studio默认获取的SDK为Public SDK。
HUAWEI DevEco Studio（可选）	5.0.2 Release	OpenHarmony应用开发推荐使用。
HUAWEI DevEco Device Tool（可选）	4.0 Release	OpenHarmony智能设备集成开发环境推荐使用。

源码获取

前提条件

注册码云gitee帐号。
注册码云SSH公钥，请参考码云帮助中心。

安装git客户端和git-lfs并配置用户信息。

git config --global user.name "yourname"
git config --global user.email "your-email-address"
git config --global credential.helper store

安装码云repo工具，可以执行如下命令。

curl -s https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo  #如果没有权限，可下载至其他目录，并将其配置到环境变量中chmod a+x /usr/local/bin/repo
pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests

通过repo获取

方式一（推荐）

通过repo + ssh 下载（需注册公钥，请参考码云帮助中心）。

从版本分支获取源码。可获取该版本分支的最新源码，包括版本发布后在该分支的合入。

repo init -u git@gitee.com:openharmony/manifest.git -b OpenHarmony-5.0.2-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

从版本发布Tag节点获取源码。可获取与版本发布时完全一致的源码。

repo init -u git@gitee.com:openharmony/manifest.git -b refs/tags/OpenHarmony-v5.0.2-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

方式二

通过repo + https 下载。

从版本分支获取源码。可获取该版本分支的最新源码，包括版本发布后在该分支的合入。

repo init -u https://gitee.com/openharmony/manifest -b OpenHarmony-5.0.2-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

从版本发布Tag节点获取源码。可获取与版本发布时完全一致的源码。

repo init -u https://gitee.com/openharmony/manifest -b refs/tags/OpenHarmony-v5.0.2-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

从镜像站点获取

表2 获取源码路径

版本源码	版本信息	下载站点	SHA256校验码	软件包容量
全量代码（标准、轻量和小型系统）	5.0.2 Release	站点	SHA256校验码	42.5 GB
Hi3861解决方案（二进制）	5.0.2 Release	站点	SHA256校验码	27.2 MB
Hi3516解决方案-LiteOS（二进制）	5.0.2 Release	站点	SHA256校验码	328.4 MB
Hi3516解决方案-Linux（二进制）	5.0.2 Release	站点	SHA256校验码	221.2 MB
RK3568标准系统解决方案（二进制）	5.0.2 Release	站点	SHA256校验码	13.1 GB
标准系统Public SDK包（Mac）	5.0.2.123	站点	SHA256校验码	1.3 GB
标准系统Public SDK包（Mac-M1）	5.0.2.123	站点	SHA256校验码	1.2 GB
标准系统Public SDK包（Windows/Linux）	5.0.2.123	站点	SHA256校验码	4.0 GB

修复缺陷列表

表3 修复缺陷ISSUE列表

ISSUE单	问题描述
I9SXZ8	进程com.ohos.contacts小概率出现因THREAD_BLOCK_6S卡在libark_jsruntime.so导致的appfreez。
IA6RH6	进程com.ohos.settings有较高概率出现因THREAD_BLOCK_6S卡在libbtframework.z.so导致的appfreeze。
IASDWO	通过浏览器访问微博首页的滑动帧率低于规格基线。
IAZYOO	RK3568开发板在执行WuKong整机随机压力测试过程有较高概率出现卡死现象。
IB4L3E	进程com.ohos.camera有较高概率出现因LIFECYCLE_TIMEOUT卡在libcamera_framework.z.so导致的appfreeze。
IAP85P	启动进程优先级过低有小概率会被优先kill掉导致出现sysfreeze。
I9SXZ8	进程com.ohos.contacts小概率因THREAD_BLOCK_6S卡在libark_jsruntime.so出现appfreeze。
IB36B2	进程com.ohos.mms小概率出现jscrash，问题栈为close。

遗留缺陷列表

表4 遗留缺陷列表

ISSUE	问题描述	影响	计划解决日期
IANQF3	在执行WuKong压测过程有较高概率出现重启现象。	问题出现会导致设备重启。该问题暂时无法规避。	2025年2月15日
IBJ6LH	因新引入安全校验机制导致删除多张图片的处理时长可能过长，影响体验。	不影响使用，无需规避。	2025年2月15日
IBBZPS	进程com.ohos.systemui下的OS_IPC_0_1067线程小概率出现cppcrash，崩溃栈：ld-musl-arm.so.1(__libc_free+172)	系统异常，用户无感知。	2025年2月15日
IBE36X	render_service小概率出现因SERVICE_BLOCK导致的的sysfreeze问题。	桌面无响应后黑屏，自动恢复后回到桌面。	2025年2月15日
IBDPFF	进程intell_voice_service下的SaOndemand线程小概率出现cppcrash，崩溃栈：libintell_voice_server.z.so	系统异常，用户无感知。	2025年2月15日