HarmonyOS 5.1.1 Release 正式发布：多维度能力升级助力开发者高效创新

一、核心升级概览

HarmonyOS 5.1.1 Release 在 ArkUI 组件能力、地图服务、性能分析工具等维度实现关键突破，同步更新开发者套件配套工具，为应用开发与优化提供更强支撑。

二、开发者套件配套信息

三、OS 系统能力升级详解

ArkUI

• 弹窗能力增强。包括：
  • 进一步丰富弹窗在 Native 侧的能力，包括：设置自定义弹窗显示的顺序、边框宽度和边框颜色等。（API 参考[1]）
  • 支持通过侧滑手势关闭 OverlayManager 下的ComponentContent[2]。（API 参考[3]）
  • 支持设置弹窗内容和蒙层显示的过渡效果。（API 参考[4]）
  • 支持设置弹窗是否获取焦点。（API 参考[5]）
• XComponent 支持在 Native 侧获取 XComponent 节点实例、注册 XComponent 持有的 Surface 的生命周期回调和触摸、鼠标、按键等组件事件回调。（API 参考[6]）
• 新增 LazyVGridLayout 组件，用于实现懒加载的网格布局。（API 参考[7]）
• Tabs 支持设置子组件的最大缓存个数和缓存模式。（API 参考[8]）
• List 组件支持从末尾开始布局。（API 参考[9]）
• 丰富 Swiper 组件在 Native 侧的能力，包括：创建并设置数字导航指示器的样式、创建并设置导航箭头的样式等。（API 参考[10]）
• Swiper 组件支持设置圆点导航点间距和导航点底部相对于 Swiper 的位置。（API 参考[11]）
• Navigation 支持获取当前路由栈中的路由页面信息数组，并将数组更新为指定内容，实现路由转场。（API 参考[12]）
• 新增 onNewParam 回调，当栈中存在的 NavDestination 页面通过单实例方式移动到栈顶时，触发对应的生命周期。（API 参考[13]）
• 属性字符串和 RichEditor 支持设置段落间距。（API 参考-属性字符串[14]、API 参考-RichEditor[15]）
• 支持设置关键帧动画（keyframeAnimateTo）的期望帧率。（API 参考-ArkTS[16]、API 参考-C[17]）
• 支持在按键事件发生时获取 NumLock/CapsLock/ScrollLock 的状态。（API 参考-ArkTS[18]、API 参考-C[19]）
• 拖拽释放时，支持应用延迟返回处理结果。（API 参考[20]）
• 支持监听 Pan 手势的onActionStart[21]事件，可获取触发 Pan 手势事件的相关信息。（API 参考[22]）
• 背景图支持通过 NODE_BACKGROUND_IMAGE_RESIZABLE_WITH_SLICE 属性，在拉伸时可调整大小。（API 参考[23]）
• 针对 PC/2in1 设备的窗口能力新增支持更改子窗口所属的父窗口。（API 参考[24]）
• 屏幕属性新增屏幕显示内容的显示模式枚举。该枚举在屏幕实例中传递。（API 参考[25]）

Performance Analysis Kit

• HiTraceMeter 新增一批 API，增强了 HiTraceMeter 的打点能力和日志能力。（指南[26]）
• hitrace 命令新增支持“--trace_level”参数，用于设置 trace 输出级别的阈值。（指南[27]）

Camera Kit

新增支持查询和使用相机微距的能力。（API 参考[28]）

CANN Kit

支持 AscendC 算子开发，可实现对 NPU 的编程。（指南[29]）

Core Speech Kit

文本转语音能力新增支持音色下载。（API 参考[30]）

Device Security Kit

新增支持获取诈骗应用信息。（指南[31]、API 参考[32]）

Enterprise Data Guard Kit

• 新增支持只写模式打开用户数据目录[33]下的文件。（API 参考[34]）
• 新增支持设置文件自定义属性标签，方便应用对管控文件进行标识、分类。（API 参考[35]）

Graphics Accelerate Kit

新增支持应用通过自身下载器下载资源包。（指南[36]、API 参考[37]）

Map Kit

• 新增控制 mark 文字显隐能力。（指南[38]、API 参考[39]）
• 新增支持地图 logo 顶部居中和底部居中两个布局位置。（API 参考[40]）
• 新增公交交通规划能力。（指南[41]、API 参考[42]）
• 新增地图比例尺支持公英制切换能力。（指南[43]、API 参考[44]）
• 新增室内图功能，提供室内地图和楼层选择的能力。（指南[45]、API 参考[46]）

MDM Kit

新增支持设置 Wi-Fi 黑名单、白名单能力。（API 参考[47]）

Payment Kit

• 新增支持实名信息验证、实名信息授权。（指南[48]）
• 新增支持人脸核身实人验证。（指南[49]）

Pen kit

新增支持应用监听手写笔双击/轻捏事件。（API 参考[50]）

Vision Kit

新增支持在未完成卡证识别退出的场景下，返回结果码信息。（API 参考[51]）

UI Design Kit

• 新增支持应用注册加载自定义 Symbol 能力。（指南[52]、API 参考[53]）

四、DevEco Studio 5.1.1 Release 亮点

• 支持对 C API 的变更情况进行查询，提供跨版本查询能力。具体请参考API 变更查询[54]。
• hvigor-config.json5 文件的 execution 下新增 optimizationStrategy 字段，用于指定构建模式。同时命令行参数支持--optimization-strategy=performance/memory。具体请参考hvigor-config.json5 文件[55]和hvigorw[56]。
• 新建 Native C++工程默认使用毕昇编译器，打开历史工程会弹窗提示，点击立即体验可以切换使用毕昇编译器。

五、立即体验最新能力

点击下载最新版 DevEco Studio 及配套 SDK： https://developer.huawei.com/consumer/cn/download/all

如需了解更多 API 细节与开发指南，可访问 HarmonyOS 开发者文档中心获取完整技术支持。

参考资料

[1]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/_ark_u_i___native_dialog_a_p_i__3

[2]

ComponentContent: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-arkui-componentcontent

[3]

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

[4]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-promptaction#basedialogoptions11

[5]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-promptaction#basedialogoptions11

[6]

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

[7]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-lazyvgridlayout

[8]

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

[9]

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

[10]

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

[11]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-swiper#space19

[12]

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

[13]

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

[14]

API参考-属性字符串: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-styled-string#属性-8

[15]

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

[16]

API参考-ArkTS: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-keyframeanimateto#keyframeanimateparam对象说明

[17]

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

[18]

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

[19]

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

[20]

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

[21]

onActionStart: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-gestures-pangesture#事件

[22]

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

[23]

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

[24]

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

[25]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-display#displaysourcemode19

[26]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hitracemeter

[27]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hitrace

[28]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-camera#macroquery19

[29]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cannkit-ascendc-operator-development

[30]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/hms-ai-texttospeech#section376811290229

[31]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/devicesecurity-selectfraudapp

[32]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/devicesecurity-antifraudpicker-api#section1817011732511

[33]

用户数据目录: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/dataguard-introduction#section11951837111615

[34]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/dataguard-fileguard#section779510429368

[35]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/dataguard-fileguard#section379716351208

[36]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/graphics-accelerate-assetdownload-back-self

[37]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/graphics-accelerate-assetdownloadmanager#section2335333617

[38]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/map-marker#section6138183716918

[39]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map#section6403556152318

[40]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-common#section892653673414

[41]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/map-navi-bus

[42]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-navi-api#section5970105744912

[43]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/map-presenting#section13857164985115

[44]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-common#section2230143218276

[45]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/map-presenting#section75910919918

[46]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map#section12159164214612

[47]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-enterprise-wifimanager#wifimanageraddallowedwifilist19

[48]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/payment-real-name-verification

[49]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/payment-real-name-face-verification

[50]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/pen-stylusinteraction

[51]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/vision-card-recognition#section143611912403

[52]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ui-design-custom-symbol-res-register

[53]

API参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ui-design-symbolregister

[54]

API变更查询: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-editer-overview#section234174215231

[55]

hvigor-config.json5文件: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-set-options

[56]

hvigorw: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-commandline