HarmonyOS NEXT Developer Beta3 版本发布

HarmonyOS NEXT Developer Beta3 版本发布啦

千呼万唤始出来，HarmonyOS NEXT Developer Beta3 发布啦，同步发布的有 IDE、文档以及 OS 平台能力的增强。

HarmonyOS NEXT Developer Beta3 在 Beta2 的基础上，进一步增强了 ArkUI 的基础能力，丰富了 ArkTS API 和 C API 上文本控件的自定义能力；新增位图处理的 C API 能力，等等。

本次更新内容

HarmonyOS SDK 作为面向鸿蒙原生应用和元服务开发的开放能力合集，提供包括应用框架、应用服务、系统、媒体、AI、图形在内的六大领域丰富完备的开放能力，助您构建焕然一新的鸿蒙原生应用和元服务，带来创新易用的全场景体验。这次更新增加了许多新能力。

OS 平台能力

Ability Kit

• 程序访问控制支持拉起设备设置页面的应用权限管理界面。（API 参考[1]）
• 在 release 模式下打包 APP 时可以选择对 APP 内的 HAP、HSP 包进行压缩。（指南[2]）

Account Kit

新增华为账号登录按钮拓展参数，支持开发者自定义按钮样式、自定义Style[3]类型按钮多态样式、设置图文混合样式按钮的图文间距和纯图标按钮的图标半径。（API 参考[4]）

ArkTS

• 支持 Sendable 类型的 Function。（指南[5]）
• JSON 支持对 BigInt 的解析。（API 参考[6]）

ArkUI

• 普通文本控件支持文本菜单自定义。（API 参考[7]）
• 富文本控件支持文本菜单自定义。（API 参考[8]）
• 组件内转场（transition）提供动画结束回调的监听。（API 参考[9]）
• TextInput[10]/TextArea[11]/Search[12]支持 URL 格式的输入模式。
• 滚动控制器 ScrollToIndex 支持设置额外偏移量。（API 参考[13]）
• 属性字符串支持存储自定义扩展信息。（API 参考[14]）
• 支持创建并弹出以 bindSheetContent 作为内容的半模态页面。（API 参考[15]）
• Image 组件支持更多图片内容的对齐方式。（API 参考[16]）
• RenderNode 支持设置裁剪形状。（API 参考[17]）
• 分组瀑布流支持移动窗口布局模式。（API 参考[18]）
• 组件截图接口 ComponentSnapshot 支持自定义参数 SnapshotOptions。（API 参考[19]）
• Tabs 支持设置边缘回弹效果。（API 参考[20]）
• Navigation 支持一种新的创建 NavDestination 示例的模式——NEW_INSTANCE。与 STANDARD 模式相比，该方法不会复用栈中同名实例。（API 参考[21]）
• C API 通用属性支持设置、重置和获取 Refresh/Swiper/List 相关接口，包括 List 分割线样式（NODE_LIST_DIVIDER）、Swiper 组件前边距（NODE_SWIPER_PREV_MARGIN）/后边距（NODE_SWIPER_NEXT_MARGIN）、Refresh 组件下拉偏移量等（NODE_REFRESH_OFFSET）。（API 参考[22]）
• TextInput/TextArea 组件 C API 支持设置和重置输入文本（API 参考）。包括：
  • NODE_TEXT_INPUT_ON_WILL_INSERT
  • NODE_TEXT_INPUT_ON_DID_INSERT
  • NODE_TEXT_INPUT_ON_WILL_DELETE
  • NODE_TEXT_INPUT_ON_DID_DELETE
  • NODE_TEXT_AREA_ON_WILL_INSERT
  • NODE_TEXT_AREA_ON_DID_INSERT
  • NODE_TEXT_AREA_ON_WILL_DELETE
  • NODE_TEXT_AREA_ON_DID_DELETE
• 组件 C API 通用能力增强。包括： 支持通过NODE_CLIP_SHAPE[23]设置组件四边圆角、NODE_EXPAND_SAFE_AREA[24]扩展组件安全区域。 通用 onTouch 事件支持阻止事件冒泡[25]。通用手势事件提供手势识别器句柄[26]类型对象，返回触发该事件的组件对象。 通过OH_ArkUI_GetContextByNode[27]获取当前节前所在页面的 UI 上下文实例对象指针。
• 通过 C API 提供定义帧动画对象的能力，可获取、销毁、设置关键帧动画相关参数。（API 参考[28]）
• XComponent 支持通过 C API 获取触摸点相对于屏幕或应用窗口的坐标。（API 参考[29]）
• FrameNode 支持数据懒加载能力。（API 参考[30]）
• FrameNode 支持创建具体类型的 FrameNode，类型覆盖中高频组件。（API 参考[31]）
• 向三方应用提供屏幕截图的接口能力。（API 参考[32]）

ArkWeb

Web 组件支持自定义软件键盘避让模式。（API 参考[33]）

Basic Services Kit

Emitter 支持传递 sendable 类型的对象，详见API 参考[34]的示例用法。

Graphics Accelerate Kit

新增超帧相机扩展信息接口，提升大地图游戏场景超帧预测精度。（API 参考[35]）

Image Kit

新增用于处理位图的 C API。（API 参考[36]）

Intents Kit

新增本地搜索方案，开发者将应用内的功能和内容通过意图框架共享到 HarmonyOS，即可实现“一步搜索，内容直达”。（指南[37]）

Map Kit

• 支持在地图上绘制弧线。（指南[38]）
• 新增 getEventManager()接口，支持地图组件的事件监听。（API 参考[39]）
• 以动画形式更新相机状态时，支持传入多个 marker。（API 参考[40]）
• 支持设置是否始终显示比例尺。（API 参考[41]）

Network Boost Kit

新增网络场景识别订阅功能。（指南[42]）

PDF Kit

支持通过 PdfView 组件实现：打开 PDF 文档、PDF 文档与图片格式互转、添加页眉页脚、添加水印、添加背景、添加批注、添加书签。（指南[43]）

Ringtone Kit

【新增 Kit】Ringtone Kit（铃声服务）是一个用于设置铃声的工具库。通过使用 Ringtone Kit，开发者可以在鸿蒙应用中提供铃声设置的功能，为用户提供简单一致、安全高品质的铃声设置体验。（指南[44]、API 参考[45]）

Vision Kit

• 活体检测支持配置隐私模式。（API 参考[46]）
• 新增 AI 识图控件。（指南[47]、API 参考[48]）
• 新增卡证识别新增配置接口，支持自定义拍摄模式、图库按钮以及卡证内容配置。（API 参考[49]）

调试命令

cem 工具已支持在 USER 版本的镜像中使用。

IDE 新增特性

DevEco Studio NEXT Developer Beta3 配套支持 HarmonyOS NEXT Developer Beta3 版本的应用及服务开发，新提供了引入工程外模块代码支持编码、构建、调试能力、支持构建字节码 har 包、支持 webview 场景调优、支持 ArkTS 内存泄漏自动检测等功能，持续提升应用及服务开发效率。后面也有获取链接。

• API12 的云开发工程模板支持元服务。具体请参考创建元服务工程[50]。
• DevEco Profiler 新增 Network 模板。具体请参考网络诊断：Network 分析[51]。
• 新增方舟 native 模块加载异常信息增强功能。具体请参考方舟 native 模块加载异常信息增强[52]。
• ArkTs 调试新增支持 extension 调试。具体请参考extension 调试[53]。
• ArkTs 调试新增支持 worker/taskpool 调试。具体请参考worker/taskpool 调试[54]。
• 新增支持多进程调试。具体请参考多进程调试[55]。
• ArkTs 调试支持在代码执行到断点时打印开发者指定的表达式。具体请参考Evaluate and log[56]。
• ArkTs 调试支持 smart step into 函数。具体请参考smart step into[57]。
• ArkTs 调试新增支持反向调试。具体请参考反向调试[58]。
• hvigor-config.json5 新增以下字段。具体可参考 hvigor-config.json5
  • properties 下新增 ohos.fallback.target 字段，当找不到指定 target 时，如果模块中存在该 fallback target，则使用 fallback target 进行构建。
  • properties 下新增 hvigor.memoryThreshold 字段，当编译构建占用内存超过此阈值时，新加入的编译任务会等待，直到正在进行的编译任务结束，新的编译任务才能开始。
• 模块级 build-profile.json5 新增以下字段。具体可参考 build-profile.json5
  • buildOption/nativeLib 下新增 librariesInfo 字段，用于声明 so 的透传依赖信息。
  • buildOption/arkOptions 新增 bundledDependencies 字段，用于指定是否支持将多个源码 HAR 打包成一个字节码 HAR。
• 工程级和模块级 build-profile.json5 新增 compression 字段，用于对图片资源进行纹理压缩。具体请参考build-profile.json5[59]。
• 工程级 build-profile.json5 新增 compatibleSdkVersionStage 字段，用于控制不同版本的兼容。具体可参考build-profile.json5[60]。
• 支持在无网络环境下搭建流水线。具体请参考无网络流水线搭建[61]。
• ARM 版本模拟器预置应用新增浏览器。
• 新增支持本地计算机复制的文本在模拟器内粘贴。具体请参考操控屏幕[62]。
• 应用与服务体检新增 3 条快速性能检测规则。具体请参考评分方法及规则[63]。
• 应用与服务体检支持查看历史体检报告。具体请参考查看历史报告[64]。

文档地址

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/application-dev-guide-V5

IDE 获取地址

https://developer.huawei.com/consumer/cn/download/

image-20240809082854057

参考资料

[1]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-abilityaccessctrl-V5#requestpermissiononsetting12

[2]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/packing-tool-V5#app打包指令

[3]

Style: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/account-api-component-manager-V5#section19823216112610

[4]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/account-api-component-manager-V5#section87572031102713

[5]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-sendable-V5#sendable-function

[6]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-json-V5#bigintmode

[7]

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

[8]

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

[9]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/ts-transition-animation-component-V5#transitionfinishcallback12

[10]

TextInput: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/ts-basic-components-textinput-V5#inputtype枚举说明

[11]

TextArea: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/ts-basic-components-textarea-V5#textareatype11枚举说明

[12]

Search: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/ts-basic-components-search-V5#searchtype11枚举说明

[13]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/ts-container-scroll-V5#scrolltoindex

[14]

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

[15]

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

[16]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/ts-appendix-enums-V5#imagefit

[17]

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

[18]

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

[19]

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

[20]

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

[21]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/ts-basic-components-navigation-V5#launchmode12枚举说明

[22]

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

[23]

NODE_CLIP_SHAPE: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/_ark_u_i___native_module-V5#arkui_nodeattributetype

[24]

NODE_EXPAND_SAFE_AREA: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/_ark_u_i___native_module-V5#arkui_nodeattributetype

[25]

阻止事件冒泡: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/ui__input__event_8h-V5

[26]

手势识别器句柄: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/native__gesture_8h-V5#汇总

[27]

OH_ArkUI_GetContextByNode: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/_ark_u_i___native_module-V5#oh_arkui_getcontextbynode

[28]

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

[29]

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

[30]

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

[31]

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

[32]

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

[33]

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

[34]

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

[35]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/_graphics_accelerate-V5#section1450921818712

[36]

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

[37]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/intents-search-rec-V5

[38]

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

[39]

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

[40]

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

[41]

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

[42]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/networkboost-scenecallback-V5

[43]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/pdf-pdfservice-implements-V5

[44]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ringtone-kit-guide-V5

[45]

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

[46]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/vision-interactive-liveness-V5#section16532153115517

[47]

指南: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/vision-imageanalyzer-V5

[48]

API 参考: https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/vision-image-analyzer-V5

[49]

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

[50]

创建元服务工程: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/agc-harmonyos-create-faproject-0000001983405525-V5

[51]

网络诊断：Network 分析: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-profiler-network-0000001956238392-V5

[52]

方舟 native 模块加载异常信息增强: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-multi-thread-check-0000001919872114-V5#section12424161546

[53]

extension 调试: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-debug-arkts-extension-0000001954659874-V5

[54]

worker/taskpool 调试: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-debug-arkts-worker-taskpool-0000001990139037-V5

[55]

多进程调试: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-debug-multi-process-0000001990139041-V5

[56]

Evaluate and log: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-debug-arkts-evaluate-log-0000001990019201-V5

[57]

smart step into: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-debug-arkts-smart-step-into-0000001954659878-V5

[58]

反向调试: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-debug-arkts-reverse-0000001990019197-V5

[59]

build-profile.json5: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-hvigor-build-profile-0000001778834297-V5

[60]

build-profile.json5: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-hvigor-build-profile-0000001778834297-V5

[61]

无网络流水线搭建: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-no-network-0000001615511316-V5#section15767113454814

[62]

操控屏幕: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-emulator-control-screen-0000001886036889-V5

[63]

评分方法及规则: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-app-analyzer-0000001575691289-V5#section7155192511196

[64]

查看历史报告: https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-app-analyzer-0000001575691289-V5#section52734271806