HarmonyOS5.0.2(14) Beta1 发布

DevEco Studio 新增特性

• DevEco Studio 支持开发 API 14 工程。
• 端云一体化工程默认提供云对象的调用接口类存放目录，具体请参考在端侧调用云对象[1]。
• DevEco Studio 新增混淆助手工具 ObfuscationHelper，支持对源码进行扫描，快速识别需要配置的保留选项和白名单字段，开发者可以一键生成白名单混淆规则文件；部分场景需要开发者根据业务进一步排查识别白名单后进行配置。具体请参考通过混淆助手配置保留选项[2]。

下载地址：https://developer.huawei.com/consumer/cn/download/

image-20250124100753041

OS 系统能力

Ability Kit

• HSP 支持在配置文件中声明除入口 Ability 以外的 UIAbility 组件。（指南[3]）
• 针对 2in1 与平板设备，新增支持自定义应用启动时的启动页。（API 参考[4]）
• 通过 Want 传递对象间信息时支持在 parameters 参数中携带应用分身的索引（ohos.param.callerAppCloneIndex）。（API 参考[5]）
• 新增支持获取应用级上下文的能力。（API 参考[6]）
• 开放包管理能力供三方应用调用。（API 参考[7]）
• 新增支持 UIAbility 备份恢复的能力。（API 参考[8]，指南[9]） 等

ArkUI

• 文本输入时的键盘避让模式支持光标避让。（指南[10]）
• 新增支持将有属性的字符串转换成 HTML 格式字符串的能力。（API 参考[11]）
• 新增支持设置子窗的模态类型。（API 参考[12]）
• 新增支持对容器设置组件级的安全区域。（API 参考[13]）
• 新增支持获取文本组件中指定字符的绘制区域信息。（API 参考[14]）
• Navigation(NavDestination)的 title 和 menus 属性新增支持 Resource 资源类型。（API 参考-title 属性[15]、API 参考-menus 属性[16]）
• Navigation 自定义转场动画能力增强，支持分别设置系统标题栏动画和内容动画。（API 参考[17]）
• TextArea、Search 组件新增新的 onSubmit 事件用于在事件提交时保持组件的编辑状态。（API 参考-TextArea 组件[18]、API 参考-Search 组件[19]）
• 按键时间新增 unicode 对象，支持返回当前 keyEvent 对应按键的 unicode 码值。（API 参考[20]）
• 半模态转场的 SheetOptions 新增 enableHoverMode 和 hoverModeArea 属性用于支持悬停。（API 参考[21]）
• 文本选择器组件（TextPicker）新增支持滑动停止时的事件回调。（API 参考[22]）
• 新增 C API，支持为 OH_NativeXComponent 实例注册带有返回值的按键事件回调。（API 参考[23]）
• ArkUI 的 NodeAttributeType 新增获取滚动类组件及所有子组件全展开尺寸的 C API 属性定义。（API 参考[24]）
• List 组件新增支持设置列表中 ListItem/ListItemGroup 的预加载数量，并支持配置是否显示预加载节点。（API 参考[25]）
• 滚动组件新增支持设置滚动容器的内容层裁剪区域。（API 参考[26]）
• 滚动组件新增支持设置边缘渐隐效果及设置边缘渐隐长度。（API 参考[27]）
• Grid、WaterFlow 组件新增支持设置预加载的 GridItem、FlowItem 数量，并配置是否显示预加载节点。（API 参考-Grid[28]、API 参考-WaterFlow[29]）
• ImageSpan 组件新增支持为图像设置颜色滤镜效果。（API 参考[30]）
• SegmentButton 组件新增支持适老化大字体。（API 参考[31]）
• 属性字符串新增支持设置文字背景色。（API 参考[32]）
• 属性字符串新增支持设置为超链接。（API 参考[33]）
• Chip 和 ChipGroup 组件新增支持多种类型的无障碍朗读能力。（API 参考-Chip[34]、API 参考-ChipGroup[35]）
• 日期滑动选择器弹窗（DatePickerDialog）新增支持设置切换农历开关的样式。（API 参考[36]）
• Tabs 组件新增支持对底部页签适配组件级布局安全区。（API 参考[37]）
• Text 组件新增支持设置选中文本的手柄颜色和底板颜色。（API 参考[38]）
• 新增支持设置跑马灯（Marquee）的动态帧率。（API 参考[39]）
• 手势处理的能力涉及到的六类手势事件新增支持设置允许的事件输入源。（API 参考[40]）
• 组件的位置设置新增支持对形成链的组件进行重新布局（仅当父容器为 RelativeContainer 时生效）。（API 参考[41]）
• 组件的背景设置新增支持设置窗口失焦后窗口内控件模糊效果会被移除。（API 参考[42]）
• 路由跳转新增支持设置页面是否可恢复。（API 参考[43]）
• 新增 C API，支持获取节点的各种自定义属性。（API 参考[44]）
• FrameNode 新增支持手势事件。（API 参考[45]）
• Image 组件新增支持设置图片的显示方向。（API 参考[46]）
• RichEditor 新增支持鼠标悬停事件回调（OnHoverCallback）和用户双击事件（onDoubleClick）。（API 参考[47]）
• Navigation 页面栈新增支持配置可在异常退出时恢复。（API 参考[48]）
• 新增支持绑定 NavDestination 组件和可滚动容器组件，当滑动可滚动容器组件时，会触发所有与其绑定的 NavDestination 组件的标题栏和工具栏的显示和隐藏动效。（API 参考[49]）
• 新增支持设置窗口使用效果模板，比如使用有透视的背景模糊效果。（API 参考[50]）
• 以及 2in1 设备窗口管理的更新。

ArkWeb

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

ArkData

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

欢迎大家下载体验！

参考资料

[1]

在端侧调用云对象: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V14/agc-harmonyos-clouddev-invokecloudobj-V14

[2]

通过混淆助手配置保留选项: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V14/ide-build-obfuscation-V14#section19439175917123

[3]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V14/in-app-hsp-V14#约束限制

[4]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-app-ability-startoptions-V14#属性

[5]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-app-ability-want-V14#属性

[6]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-app-ability-application-V14#applicationgetapplicationcontext14

[7]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-bundlemanager-V14

[8]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-inner-application-uiabilitycontext-V14#uiabilitycontextsetrestoreenabled14

[9]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V14/ability-recover-guideline-V14

[10]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V14/arkts-common-components-text-input-V14#光标避让

[11]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-universal-styled-string-V14#tohtml14

[12]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-window-V14#setsubwindowmodal14

[13]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-universal-attributes-size-V14#safeareapadding14

[14]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/arkui-ts/ts-text-common-V14#getrectsforrange14

[15]

API 参考-title 属性: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-navdestination-V14#title

[16]

API 参考-menus 属性: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-navigation-V14#navigationmenuitem

[17]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-navdestination-V14#systemtransition14

[18]

API 参考-TextArea 组件: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-textarea-V14#onsubmit14

[19]

API 参考-Search 组件: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-search-V14#onsubmit14

[20]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-universal-events-key-V14#keyevent对象说明

[21]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-universal-attributes-sheet-transition-V14#sheetoptions

[22]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/arkui-ts/ts-basic-components-textpicker-V14#onscrollstop14

[23]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/_o_h___native_x_component-V14#oh_nativexcomponent_registerkeyeventcallbackwithresult

[24]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/_ark_u_i___native_module-V14#arkui_nodeattributetype

[25]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-container-list-V14#cachedcount14

[26]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-container-scrollable-common-V14#clipcontent14

[27]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-container-scrollable-common-V14#fadingedge14

[28]

API 参考-Grid: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-container-grid-V14#cachedcount14

[29]

API 参考-WaterFlow: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-container-waterflow-V14#cachedcount14

[30]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-imagespan-V14#colorfilter14

[31]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ohos-arkui-advanced-segmentbutton-V14#segmentbutton-1

[32]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-universal-styled-string-V14#backgroundcolorstyle14

[33]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-universal-styled-string-V14#urlstyle14

[34]

API 参考-Chip: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ohos-arkui-advanced-chip-V14

[35]

API 参考-ChipGroup: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ohos-arkui-advanced-chipgroup-V14

[36]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-methods-datepicker-dialog-V14#lunarswitchstyle14类型说明

[37]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-container-tabs-V14#barheight

[38]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-text-V14#caretcolor14

[39]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-arkui-uicontext-V14#marqueedynamicsyncscene14

[40]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-uigestureevent-V14#allowedtypes14

[41]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-universal-attributes-location-V14#chainweight14

[42]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-universal-attributes-background-V14#backgroundeffectoptions11

[43]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-router-V14#routeroptions

[44]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/_ark_u_i___native_module-V14#oh_arkui_nodeutils_getnodetype

[45]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-arkui-framenode-V14#gestureevent14

[46]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-image-V14#orientation14

[47]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-richeditor-V14#onhovercallback14

[48]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-navigation-V14#recoverable14

[49]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-navdestination-V14#bindtoscrollable14

[50]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-universal-attributes-use-effect-V14#useeffect14

[51]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-web-V14#bluronkeyboardhidemode14

[52]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/_ark_web___controller_a_p_i-V14#getlastjavascriptproxycallingframeurl

[53]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-webview-V14#getdefaultuseragent14

[54]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-webview-V14#configcookiesync14

[55]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-web-V14#nestedscroll11

[56]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-webview-V14#trimmemorybypressurelevel14

[57]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-webview-V14#createpdf14

[58]

API 参考-scrollTo: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-webview-V14#scrollto

[59]

API 参考-scrollBy: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-webview-V14#scrollby

[60]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/ts-basic-components-web-V14#forcedisplayscrollbar14

[61]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-data-sendablepreferences-V14#flushsync14

[62]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-data-relationalstore-V14#storeconfig

[63]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-data-relationalstore-V14

[64]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-data-uniformdatastruct-V14#contentform14

[65]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V14/js-apis-data-unifieddatachannel-V14#unifieddatachannelsetappshareoptions14