华为鸿蒙 HarmonyOS 5.0.3 Beta2 版本发布:附更新日志

华为开发者官网上周（3 月 7 日）公布了鸿蒙 harmonyos 5.0.3 beta2 新增和增强特性，新版本是 api 15 的第二个 beta 版本，官方称相比 harmonyos 5.0.3 beta1，进一步丰富开发场景，例如 arkui 进一步丰富了组件可定义的属性、可调用的能力、可识别的手势等；新增了对游戏手柄的识别和事件响应能力；增强了地图服务的细节功能等。

附 harmonyos 5.0.3 beta2 新增和增强特性如下：

ability kit

• 新增支持根据指定的物理屏幕 id 创建应用上下文的能力，以便于获取和使用其他带有屏幕信息。
• 新增支持通过 c api 拉起 uiability 的能力。仅支持 2in1 设备。
• 新增支持应用预关闭的回调方法，可用于询问用户选择立即执行操作还是取消操作。仅支持 2in1 设备。

arkdata

• 新增智慧数据平台，提供端侧的数据智慧化能力，完成数据和 ai 智能在端侧闭环。仅支持 2in1 设备。
• udmf 新增支持获取进度信息和数据的能力。

arkgraphics 2d

• nativebuffer 支持的格式新增 blob 格式（nativebuffer_pixel_fmt_blob）和 rgba16 float 格式（nativebuffer_pixel_fmt_rgba16_float）。

arkts

• 【规格更新】一个进程最多创建的运行时环境数量从 16 个增加到 64 个，并且需要满足同时运行的 worker 子线程数量和进程创建的运行时的总数不超过 80 个。

arkui

• 基础组件新增支持在已编辑文本的指定位置插入文本和删除指定区域内容的能力。
• 通用事件新增焦点轴事件，支持对游戏手柄轴事件的响应；c api 额外支持获取当前轴事件的操作类型的值。
• 图案密码锁组件新增支持设置未选中的宫格圆点在密码路径经过时是否自动选中。
• 窗口管理新增定义窗口管理的 c api，主要用于设置和获取指定窗口的属性，以及设置指定窗口的状态栏样式、导航栏样式。
• image 组件新增支持可覆盖原有颜色的颜色填充能力，仅针对 svg 格式的图源生效。
• image 组件新增支持按图片矩阵做自动变换，在类似图库的场景呈现宫格型缩略图时提供自动的变换优化。
• tabs 组件和 swiper 组件新增支持设置鼠标滚轮翻页模式。
• navdestination 新增支持事件返回时的回调，用于在事件返回时传参。
• textpicker 组件新增支持配置各个选择项文本样式。
• progress 组件新增 c api，支持线性进度条样式的设置。
• 屏幕属性模块折叠屏状态枚举新增多个针对折轴二的状态定义。
• c api 的 node 属性样式新增背景模糊效果属性 node_backdrop_blur。
• framenode 新增支持跨语言能力。
• framenode 新增支持选择遍历节点时子节点的展开模式。
• 尺寸设置新增支持设置宽度、高度适应父组件布局。
• 文本组件在 textmenuitem 中新增支持快捷键提示（labelinfo）。
• 三类弹窗组件新增支持设置弹窗显示层级及相关的属性和效果（levelmode、leveluniqueid、immersivemode）。
• bindsheet 新增支持圆角（radius）属性，用于设置半模态页面圆角半径；新增支持非手势切换挡位（detentselection）属性。
• 新增导航点组件，提供圆点导航点以及数字导航点两种导航点样式。
• swiper 和 tabs 组件新增支持带动画跳转的模式。
• swiper 组件新增支持滑动行为拦截事件，可判断是否允许滑动行为。其中，c api 通过属性控制，属性名 node_swiper_event_on_content_will_scroll。
• 三方平台接入 arkui 无障碍框架新增支持查找上一个或下一个焦点（arkui_accessibility_native_action_type_next_html_item、arkui_accessibility_native_action_type_previous_html_item）。
• 三方平台接入 arkui 无障碍框架新增支持多实例场景。
• ohos.arkui.observer 模块 navdestination 组件信息新增 navdestination 类型和 uniqueid。
• 新增支持 c api 的截图能力。
• uicontext 新增支持通过 uniqueid 获取已加载的组件的截图。
• uicontext 新增支持获取元服务 menubar 相对窗口的布局信息的能力。
• 通用事件新增 c api 支持获取当前触摸事件触发的 id。
• 窗口新增一个针对 2in1 设备用于设置应用窗口尺寸限制的同名接口。
• 窗口新增一个用于指定鼠标在窗口内的位置并移动窗口的同名接口。
• 窗口新增针对 2in1 设备的窗口关闭事件监听的异步回调。
• 窗口新增支持开启画中画窗口尺寸变化事件的监听。
• 窗口新增支持动态设置窗口标题栏的标题。
• 窗口新增设置主窗的窗口支持模式（全屏、悬浮窗、分屏等模式）。
• navdestination 新增支持设置是否隐藏标题栏中的返回键。
• 新增 c api 支持控制焦点以及处理焦点事件的能力。
• 新增 c api 支持克隆事件的转发。
• popup 组件新增 keyboardavoidmode 属性用于设置 popup 气泡是否避让软键盘。
• 弹窗新增支持设置避让键盘的距离。其中 arkts api 均以属性方式提供，可在链接指向的表格中搜索关键词 keyboardavoiddistance。
• 属性字符串新增支持 resourcestr 类型图片的设置。
• 属性字符串的图片对象新增支持获取属性字符串的图片颜色滤镜效果（colorfilter）。
• 拖拽能力新增支持获取拖拽进度条拖拽数据的能力。
• 组件截图能力新增支持定义组件截图区域。
• tabs 组件新增组件参数，支持设置 tabs 的页签位置。
• 文本类组件新增支持在文本内容将要发生变化时触发回调。
• 新增支持获取触摸相关的事件来自左手还是右手，涉及多个模块：事件模块新增相关 c api、绑定手势方法 fingerinfo 对象新增 hand 属性、触摸事件 touchobject 对象新增 hand 属性、点击事件 clickevent 对象新增 hand 属性。
• 新增支持检查触摸屏幕的手指数量，涉及多个模块：ndk 新增相关 c api、组件新增设置是否检查触摸屏幕的手指数量的属性 isfingercountlimited。可在各组件参考页面中查看该属性。
• 新增支持设置按键事件处理的优先级和重新派发的能力。涉及：ndk 新增设置按键事件处理优先级的 c api、ndk 中 arkui_nodeeventtype 枚举新增 node_dispatch_key_event，表示组件按键事件重新派发事件（c api）、uicontext 新增设置按键事件处理优先级的 arkts api、uicontext 新增分发按键事件给指定组件的 arkts api。
• c api 新增支持 node_checkbox_group 相关能力。可在 api 参考中搜索该关键字。

appgallery kit

• 新增应用元数据管理服务，支持管理动态图标。

arkweb

• 新增支持对 cookie 进行持久化的能力。

basic service kit

• 上传下载新增支持使用单个上传请求上传多文件，该能力通过 config 的 multipart 参数配置。
• 剪贴板新增支持设置进度指示条。

camera kit

• 新增支持获取分布式相机设备的类型。
• 新增支持镜像录像的能力。

connectivity kit

• 面向企业应用开放 wifimanager 模块的 wi-fi 管理能力。

core file kit

• 文件选择器新增支持批量授权文件的能力。

device security kit

• 新增支持反诈类应用获取诈 骗 消息。
• 新增支持反诈类应用获取诈 骗 通话记录。

enterprise data guard kit

• 新增支持在 kia 文件打开时进行水印保护。
• 新增支持企业恢复密钥的管理能力。

iap kit

• purchaseparameter 新增购买参数 quantity，支持单次购买多个商品。
• 新增支持非游戏应用订单退款。

ime kit

• 新增支持移动输入法窗口的能力。

input kit

• 新增支持游戏手柄设备的按键事件的识别和分发。

localization kit

• 新增支持获取语言的简化表示的能力，例如将 "en-latn-us" 的简化表示为 "en"。

map kit

• 新增支持设置和查看 logo 缩放比例。
• 新增支持在地图上显示 3d 地球。
• 新增支持设置自定义瓦片图层。
• 新增支持通过贴图的方式实现折线纹理。
• 新增支持 marker 能力碰撞检测。
• 新增支持折线分段设置纹理和动态设置纹理。
• 新增 petalmaps 模块，支持拉起花瓣地图。
• 新增地图 picker 支持设置主题色。
• 区划查询控件新增支持拉起子窗。
• 新增支持地图 picker 关闭回调。
• 新增支持聚合展开图标点击回调。

mdm kit

• 新增支持为指定的浏览器设置浏览器托管策略。

media kit

• 屏幕录制新增支持获取录屏的屏幕 id 的回调。

media library kit

• 新增支持通过 photopicker 预览并替换相册中图片的能力。

multimodal awareness kit

• 新增支持动作感知能力，可对用户行为、动作进行感知。

preview kit

• 新增 c api，支持文件打开加速功能。

remote communication kit

• 新增 ontimeinfo 接口，在 http 请求成功 / 失败时的回调，用于监听 http 请求的成功 / 失败。

speech kit

• textreader 新增支持注销拉到播放列表底端且带用户自定义参数的回调函数。

鸿蒙 harmonyos 5.0.3 beta2 完整配套信息如下：

软件包	发布类型	版本号	build version	发布时间
系统	beta	harmonyos 5.0.3 beta2	5.0.0.131	2025/03/06
deveco studio	beta	deveco studio 5.0.3 beta2	5.0.9.200	2025/03/06
sdk	beta	harmonyos 5.0.3 beta1 sdk	基于 openharmony sdk ohos_sdk_public 5.0.3.131 (api 15 beta2)	2025/03/06

harmonyos 已发布版本映射关系对照表：

新规则版本号	版本类型	openharmony api version
harmonyos 5.0.3	beta2	15 beta2
harmonyos 5.0.3	beta1	15 beta1
harmonyos 5.0.2	release	14 release
harmonyos 5.0.2	beta1	14 beta1
harmonyos 5.0.1	release	13 release
harmonyos 5.0.1	beta3	13 beta3
harmonyos 5.0.0	release	12 release
harmonyos next	beta1 / release	12 release
harmonyos next	developer beta1/2/3/5/6	12 beta1/2/3/5/6
harmonyos 3.1/4.0	release	9 release