一、核心升级概览

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