华为鸿蒙新版本特性发布 窗口管理与组件能力升级

华为开发者官网公布了鸿蒙 HarmonyOS 5.0.5 (17) Beta1 的新增和增强特性，这是 API 17 的首个版本。新版本在之前发布的 HarmonyOS 5.0.4 Release 基础上，进一步丰富了 ArkUI 的组件能力，并完善了应用在窗口化场景下的管理能力。

新增和增强特性包括：

Ability 部分新增支持通过 startAbility 的属性 StartOptions 来指定创建新窗口的大小（如 minWindowWidth、minWindowHeight、maxWindowWidth、maxWindowHeight）。C API 新增支持启动 Ability 时传递 StartOptions，获取子进程启动参数，设置启动 Ability 时窗口和 dock 栏图标的显示模式。

ArkUI 方面新增鼠标轴事件相关接口，NavDestination 新增 onActive 和 onInactive 生命周期。C API 的事件能力增强，新增支持获取事件命中的组件的宽度、高度、X 坐标、Y 坐标等能力。基础类型定义新增支持清除当前的预上屏文本内容。UIContext 新增支持创建不依赖窗口的 UI 实例。组件可见区域变化事件新增支持设置事件的回调参数，限制其执行间隔。ImageAnimator 组件支持设置是否通过系统 onVisibleAreaChange 的可见性来判断组件的暂停和播放。画中画窗口支持通过创建参数 LocalStorage 实现页面级别的 UI 状态存储单元，在多实例下可用来跟踪主窗实例。针对 PC/2in1 设备的窗口管理新增支持主窗的尺寸记忆功能。针对 PC/2in1 设备和平板设备的窗口管理新增支持设置子窗或悬浮窗窗口边缘阴影的模糊半径，以及设置子窗口在其父窗口处于拖拽移动或拖拽缩放过程时是否支持跨多个屏幕同时显示。

此外，HarmonyOS 5.0.5 Beta1 的完整配套信息也已公布，包括系统、DevEco Studio 和 SDK 的具体版本号和发布日期。系统版本为 HarmonyOS 5.0.5 Beta1，软件版本 5.0.0.160，API 版本 5.0.5 (17)，发布日期为 2025 年 4 月 24 日。DevEco Studio 版本为 5.0.5 Beta1，版本号 5.0.13.100，同样于 2025 年 4 月 24 日发布。SDK 版本基于 OpenHarmony SDK Ohos_sdk_public 5.0.5.160 (API 17 Beta1)，发布日期也为 2025 年 4 月 24 日。

文章还列出了 HarmonyOS 已发布版本的映射关系对照表，涵盖从 HarmonyOS 5.0.5 到 HarmonyOS 3.1/4.0 的各个版本及其对应的 OpenHarmony API 版本。