API 14 首个 Beta 版本，华为鸿蒙 HarmonyOS 5.0.2 Beta 1 新增和增强特性公布

感谢本站网友 王二狗蛋32、CMCC 的线索投递！

本站 1 月 19 日消息，华为开发者官网昨日公布了鸿蒙 HarmonyOS 5.0.2 Beta 1 新增和增强特性，新版本是 API 14 的首个 Beta 版本，官方称相比 HarmonyOS 5.0.1 Release，以快速迭代的方式新增了一批开发者关注度较高的接口能力，同时 DevEco Studio 进一步优化增强开发能力，完善规则。

本站附 HarmonyOS 5.0.2 Beta 1 新增和增强特性如下：

Ability Kit

HSP 支持在配置文件中声明除入口 Ability 以外的 UIAbility 组件。

针对 2in1 与平板设备，新增支持自定义应用启动时的启动页。

通过 Want 传递对象间信息时支持在 parameters 参数中携带应用分身的索引（ohos.param.callerAppCloneIndex）。

新增支持获取应用级上下文的能力。

开放包管理能力供三方应用调用。

新增支持 UIAbility 备份恢复的能力。

新增支持获取当前应用多实例的唯一实例标识。

环境变化信息的定义中新增当前系统字体的唯一 ID 的定义 fontId。

新增 C API，支持获取当前应用适用的设备类型。适用于在将手机应用分发到平板 / 2in1 设备时，合理适配布局和字体大小。

ArkData

新增 flushSync 接口支持将缓存的 Preferences 实例中的数据存储到共享用户首选项的持久化文件中。

关系型数据库（RDB）的配置属性 StoreConfig 新增参数 cryptoParam，用于自定义加密参数。

关系型数据库（RDB）新增支持创建可并发的事务对象。

标准化数据结构（UDMF）新增内容卡片类型的数据结构（ContentForm）。

标准化数据结构（UDMF）新增支持设置应用内拖拽通道数据可使用的范围。

ArkGraphics 2D

新增 C API，支持获取系统全局字体集。

新增 Decoupled VSync（DVSync）的 C API 能力以提高自绘制动画场景的流畅性。

新增一个模糊效果的处理能力，增加着色器效果平铺模式，影响图像边缘的模糊效果。

新增 C API，使浏览器支持动态帧率。

ArkUI

文本输入时的键盘避让模式支持光标避让。

新增支持将有属性的字符串转换成 HTML 格式字符串的能力。

新增支持设置子窗的模态类型。

新增支持对容器设置组件级的安全区域。

新增支持获取文本组件中指定字符的绘制区域信息。

Navigation (NavDestination) 的 title 和 menus 属性新增支持 Resource 资源类型。

Navigation 自定义转场动画能力增强，支持分别设置系统标题栏动画和内容动画。

TextArea、Search 组件新增新的 onSubmit 事件用于在事件提交时保持组件的编辑状态。

按键时间新增 unicode 对象，支持返回当前 keyEvent 对应按键的 unicode 码值。

半模态转场的 SheetOptions 新增 enableHoverMode 和 hoverModeArea 属性用于支持悬停。

文本选择器组件（TextPicker）新增支持滑动停止时的事件回调。

新增 C API，支持为 OH_NativeXComponent 实例注册带有返回值的按键事件回调。

ArkUI 的 NodeAttributeType 新增获取滚动类组件及所有子组件全展开尺寸的 C API 属性定义。

List 组件新增支持设置列表中 ListItem / ListItemGroup 的预加载数量，并支持配置是否显示预加载节点。

滚动组件新增支持设置滚动容器的内容层裁剪区域。

滚动组件新增支持设置边缘渐隐效果及设置边缘渐隐长度。

Grid、WaterFlow 组件新增支持设置预加载的 GridItem、FlowItem 数量，并配置是否显示预加载节点。（API 参考-Grid、API 参考-WaterFlow）

ImageSpan 组件新增支持为图像设置颜色滤镜效果。

SegmentButton 组件新增支持适老化大字体。

属性字符串新增支持设置文字背景色。

属性字符串新增支持设置为超链接。

Chip 和 ChipGroup 组件新增支持多种类型的无障碍朗读能力。

日期滑动选择器弹窗（DatePickerDialog）新增支持设置切换农历开关的样式。

Tabs 组件新增支持对底部页签适配组件级布局安全区。

Text 组件新增支持设置选中文本的手柄颜色和底板颜色。

新增支持设置跑马灯（Marquee）的动态帧率。

手势处理的能力涉及到的六类手势事件新增支持设置允许的事件输入源。

组件的位置设置新增支持对形成链的组件进行重新布局（仅当父容器为 RelativeContainer 时生效）。

组件的背景设置新增支持设置窗口失焦后窗口内控件模糊效果会被移除。

路由跳转新增支持设置页面是否可恢复。

新增 C API，支持获取节点的各种自定义属性。

FreamNode 新增支持手势事件。

Image 组件新增支持设置图片的显示方向。

RichEditor 新增支持鼠标悬停事件回调（OnHoverCallback）和用户双击事件（onDoubleClick）。

Navigation 页面栈新增支持配置可在异常退出时恢复。

新增支持绑定 NavDestination 组件和可滚动容器组件，当滑动可滚动容器组件时，会触发所有与其绑定的 NavDestination 组件的标题栏和工具栏的显示和隐藏动效。

新增支持设置窗口使用效果模板，比如使用有透视的背景模糊效果。

针对 2in1 设备的应用的窗口管理，新增通过应用窗口关闭按钮关闭应用的监听，使用该 API 可忽略已设置的预关闭开关的回调。

针对 2in1 设备的应用的窗口管理，新增自定义应用主窗口大小和位置的能力，通过配置文件 module.json5 进行配置。

针对 2in1 设备的应用的窗口管理，新增支持将应用从最小化恢复到前台显示的能力。

针对 2in1 设备的应用的窗口管理，新增支持查询本应用内指定坐标下的可见窗口的能力。

针对 2in1 设备的应用的窗口管理，新增支持使能 / 禁用通过拖拽方式缩放主窗口或子窗口。

针对 2in1 设备的应用的窗口管理，新增支持设置主窗口为模态窗口。

针对 2in1 设备的应用的窗口管理，新增支持应用控制启动页消失时机。

针对 2in1 设备的应用的窗口管理，新增支持设置主窗的尺寸记忆是否启用。

针对 2in1 设备的应用的窗口管理，新增支持设置主窗口进入全屏沉浸式时鼠标 Hover 到热区上隐藏窗口标题栏和 dock 栏。

针对 2in1 设备的应用的窗口管理，新增支持设置主窗标题栏上的最大化、最小化、关闭按钮是否可见。

针对 2in1 设备的应用的窗口管理，新增支持设置主窗口置于其他应用窗口之上而不被遮挡。

针对 2in1 设备的应用的窗口管理，新增支持对窗口所在屏幕进行事件监听，例如当前窗口移动到其他屏幕时，可以从此接口监听到这个行为。

针对 2in1 设备的应用的窗口管理，新增支持应用窗口无系统标题栏场景下拖拽移动窗口的能力。

ArkWeb

用户主动收起软键盘时，新增支持设置焦点从输入框转移到 Web 的 body 上，使文本框失焦。

新增 C API，用于获取调用 JavaScriptProxy 最后一帧的 url。

新增支持获取默认的用户代理。

新增支持为指定 url 设置 cookie 的值。

新增支持上下左右四种嵌套滚动模式。

新增支持根据指定的内存压力等级主动清理 Web 组件占用的缓存。

新增支持网页另存为 PDF 的能力。

新增支持设置滚动动画的持续时间。

新增支持设置滚动条常驻。

AVCodec Kit

音视频编解码的 C API 新增支持 HE-AAC 编解码能力，该能力仅在 HarmonyOS 支持。

AVSession Kit

新增支持投播半模态对象的能力。

Basic Service Kit

设备信息（Device Info）模块新增 productModelAlias 属性用于支持查询设备认证型号的别名。

剪贴板新增支持通过 MIME 定义和使用多种格式的内容对象。

剪贴板新增 C API 和 ArkTS API 支持获取剪贴板内容的 MIME 类型。（C API 参考、ArkTS API 参考）

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

Call Service Kit

kit 名称修改，导致 kit 文件名称变更。

支持企业联系人来去电显示功能。

Camera Kit

新增 C API 和 ArkTS API 用于设置录像质量的优先级，提供高质量和功耗平衡两档选择。（C API 参考、ArkTS API 参考）

Core File Kit

新增支持获取保存成功后的文件后缀类型。

Crypto Architecture Kit

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

Data Protection Kit

新增数据防泄漏（DLP）解决方案，通过 C API 提供对应能力的调用。

Game Service Kit

游戏场景感知模块提供 C API。

支持订阅或查询 GPU 信息时，返回 GPU 当前频点。

IAP Kit

支持非续期订阅类型商品的购买。

IME Kit

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

Live View Kit

支持设置左右文本模板扩展区文本子样式类型、右侧标题和内容的右上角展示内容、中间间隔文本、扩展区底部内容等。

Location Kit

新增地理围栏类型的 ExtensionAbility，提供基于位置的地理围栏的能力。（指南、API 参考）

MDM Kit

企业应用禁用设备功能的能力新增支持禁用设备相机能力。

企业应用安装事件新增一类回调，该回调返回的信息包括安装包名和账号 ID。

企业应用新增支持委托其他应用来设置设备的管控策略。

企业应用新增支持设置禁用 / 启用设备指纹功能，该能力目前仅限 2in1 设备使用。

企业应用新增支持设置禁用屏幕快照（即截屏）功能，该能力目前仅限 2in1 设备使用。

企业应用新增支持对应用设置水印的能力，该能力目前仅限 2in1 设备使用。

企业应用新增支持“设备管理”应用添加保活的应用，该能力目前仅限 2in1 设备使用。

企业应用新增支持“设备管理”应用添加禁止使用的 USB 设备类型，该能力目前仅限 2in1 设备使用。

Media Kit

新增 C API 支持设置录屏的最大帧率。

流媒体新增一批错误码以细化流媒体播放可能出现的异常场景。

Media Library Kit

新增支持定义配置相册图片后的完成按钮，可显示“完成”、“发送”或“添加”。

Photo Picker 组件新增支持大图页视频播放状态的回调 videoPlayStateChangedCallback。

Payment Kit

新增通用收银台，支持多种支付方式。

Push Kit

支持场景化消息类型为通知消息场景（DEFAULT 类型）。

Scenario Fusion Kit

支持文件路径转换，即可实现将源文件路径转换为目标文件路径。

支持权限设置 button，实现二次拉起权限设置弹框。

Speech Kit

朗读控件支持在线预录制播报场景。

朗读控件支持朗读起播以及起播参数、朗读参数的定制。

Status Bar Extension Kit

支持监听状态栏图标点击事件、右键菜单点击事件。

Store Kit

支持应用市场推荐场景下，应用内快捷方式加桌。

应用详情页展示和元服务卡片加桌场景下，支持成功打开和关闭回调函数。

应用详情页展示场景下，支持设置登记归因来源的广告曝光数据属性参数。

产品特性按需分发新增 C 接口，支持用户按需动态下载所需的增强特性。

支持拉起标准化隐私弹框。

Vision Kit

支持对身份证图片质量检测，包括检测身份证图片是否完整、是否反光。

支持获取当前图片分析界面状态。

Weather Service Kit

支持根据调用方提供的上下文信息获取天气数据。

XEngine Kit

新增支持平板和 2in1 设备。

公共

配置文件 module.json5 中 abilities 标签的 orientation 属性新增支持通过资源索引方式（$string）进行配置。

配置文件 module.json5 中 extensionAbilities 标签的 extensionProcessMode 属性新增支持配置 runWithMainProcess 类型，表示该 ExtensionAbility 和应用主进程共进程。

配置文件 module.json5 中 extensionAbilities 标签新增 process 属性，type 为 embeddedUI 的 ExtensionAbility 可通过该属性的配置使 ExtensionAbility 和 Ability 运行在同一进程。

工具

使用打包工具打包 App 时，支持打包加密配置文件。本特性不涉及命令、接口的新增，仍可参照原有工具指导进行打包操作。

mediatool 工具查询媒体库资源的命令新增返回资源源文件真实路径或媒体资源 uri 的参数。

HarmonyOS 5.0.2 Beta1 完整配套信息如下：

软件包发布类型版本号Build Version发布时间系统BetaHarmonyOS 5.0.2 Beta15.0.0.123(SP16)2025/01/16DevEco StudioBetaDevEco Studio 5.0.2 Beta15.0.7.1002025/01/16SDKBetaHarmonyOS 5.0.2 Beta1 SDK基于 OpenHarmony SDK Ohos_sdk_public 5.0.2.123 (API 14 Beta1)2025/01/16

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

新规则版本号版本类型OpenHarmony API VersionHarmonyOS 5.0.2Beta114 Beta1HarmonyOS 5.0.1Release13 ReleaseHarmonyOS 5.0.1Beta313 Beta3HarmonyOS 5.0.0Release12 ReleaseHarmonyOS NEXTBeta1 / Release12 ReleaseHarmonyOS NEXTDeveloper Beta1/2/3/5/612 Beta1/2/3/5/6HarmonyOS 3.1/4.0Release9 Release