• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ArkUI子系统Changelog
2
3## cl.arkui.1 半模态SheetMode.EMBEDDED模式支持响应ESC键退出
4
5**访问级别**
6
7公开接口
8
9**变更原因**
10
11半模态SheetMode.EMBEDDED模式不支持ESC键退出，变更后，支持SheetMode.EMBEDDED模式ESC键退出。
12
13**变更影响**
14
15该变更为不兼容变更。
16
17变更前：SheetMode.OVERLAY模式的半模态响应ESC键退出，SheetMode.EMBEDDED模式的半模态不响应ESC键退出。
18
19变更后：两种模式的半模态都响应ESC键，ESC键退出与手机侧滑体验保持一致。
20
21**起始API Level**
22
23API 12
24
25**变更发生版本**
26
27从OpenHarmony SDK 5.0.0.59开始。
28
29**变更的接口/组件**
30
31bindSheet的SheetMode.EMBEDDED属性。
32
33**适配指导**
34
35变更后，若开发者仍不期望ESC键退出半模态，可以通过半模态的[onWillDismiss](../../../application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-sheet-transition.md#sheetoptions)回调控制是否响应ESC和侧滑关闭半模态。
36```ts
37onWillDismiss: ((DismissSheetAction: DismissSheetAction) => {
38    if (DismissSheetAction.reason == DismissReason.PRESS_BACK) {
39    } else {
40        DismissSheetAction.dismiss() //注册dismiss行为会关闭半模态
41    }
42}),
43```
44
45## cl.ArkUI.2 uiExtension的hideNonSecureWindows接口在2in1设备上不阻止全局悬浮窗创建和显示
46
47**访问级别**
48
49系统接口
50
51**变更原因**
52
53hideNonSecureWindows在2in1设备上不允许全局悬浮窗创建和显示，不满足业务需求，导致2in1设备上部分依赖全局悬浮窗应用异常。
54
55**变更影响**
56
57此变更不涉及应用适配。
58
59
60变更前：hideNonSecureWindows在2in1设备上不允许全局悬浮窗创建，且会隐藏已经创建的全局悬浮窗。
61
62
63变更后：hideNonSecureWindows在2in1设备上不阻止全局悬浮窗创建和显示。
64
65
66**起始API Level**
67
68API 12
69
70**变更发生版本**
71
72从OpenHarmony SDK 5.0.0.59开始。
73
74**变更的接口/组件**
75
76hideNonSecureWindows
77
78**适配指导**
79
80默认行为变更，无需适配。
81
82## cl.ArkUI.3 uiExtension下新增properties必选属性
83
84[uiExtension.d.ts](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.arkui.uiExtension.d.ts)中uiExtension命名空间下新增properties必选属性
85
86**访问级别**
87
88公开接口
89
90**变更原因**
91
92[EmbeddedComponent](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-embedded-component.md)所在的应用窗口移动的场景下，无法获取该组件的大小和位置信息，不满足开发者业务诉求。
93
94**变更影响**
95
96此变更涉及应用适配。
97
98变更前：uiExtension命名空间下的WindowProxy无必选属性properties。
99
100变更后：uiExtension命名空间下的WindowProxy有必选属性properties。
101
102**起始API Level**
103
104API 14
105
106**变更发生版本**
107
108从OpenHarmony SDK 5.0.0.59开始。
109
110**变更的接口/组件**
111
112WindowProxy的properties属性
113
114**适配指导**
115
116升级到API14后，如果应用在自己的业务中实现WindowProxy这个Interface，则需要在自定义的实现中新增必选属性properties。