• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# arkui子系统ChangeLog
2
3## cl.arkui.1 xcomponent组件接口变更
4
5arkui子系统xcomponent组件接口存在变更：
6
7 - 去除getXComponentSurfaceId和setXComponentSurfaceSize接口的@systemapi标签
8 - 指定getXComponentSurfaceId，getXComponentContext和setXComponentSurfaceSize接口的返回值类型
9
10开发者需要根据以下说明对应用进行适配。
11
12
13**变更影响**
14
15影响已发布的JS接口，应用需要进行适配才可以在新版本SDK环境正常编译通过。
16
17**关键的接口/组件变更**
18
19 - getXComponentSurfaceId：改为public接口，指定返回值类型为string
20 - setXComponentSurfaceSize：改为public接口，指定返回值类型为void
21 - getXComponentContext：指定返回值类型为Object
22
23**适配指导**
24
25不同场景下的启动规则说明如下：
26开发者适配内容：
27
28  - **getXComponentSurfaceId**
29    - OpenHarmony 3.2-beta3 版本规则：
30      - 系统接口systemapi。
31      - 未指定返回值
32    - OpenHarmony 3.2-Beta4 版本新规则：
33      - 公共接口。
34      - 指定返回值类型为string
35      - 开发者需要按照string类型处理返回值
36  - **setXComponentSurfaceSize**
37    - OpenHarmony 3.2-beta3 版本规则：
38      - 系统接口systemapi。
39      - 未指定返回值
40    - OpenHarmony 3.2-Beta4 版本新规则：
41      - 公共接口。
42      - 指定返回值类型为void
43      - 开发者需要按照void类型处理返回值
44  - **getXComponentContext**
45    - OpenHarmony 3.2-beta3 版本规则：
46      - 未指定返回值
47    - OpenHarmony 3.2-Beta4 版本新规则：
48      - 指定返回值类型为Object
49      - 开发者需要按照Object类型处理返回值
50
51## cl.arkui.2 弹窗类组件接口样式变更
52
53ArkUI子系统alertDialog, actionSheet, customDialog组件及prompt, promptAction接口存在样式变更：
54
55 - promptAction.showDialog, promptAction.showActionMenu, alertDialog, actionSheet, customDialog更新弹窗底板模糊效果
56
57**变更影响**
58
59默认弹窗底板模糊效果
60
61**关键的接口/组件变更**
62
63涉及接口: promptAction.showDialog, promptAction.showActionMenu;
64涉及组件: alertDialog, actionSheet, customDialog
65
66**适配指导**
67
68无需适配
69
70## cl.arkui.3 自定义组件成员变量初始化的方式与约束校验场景补全
71
72[自定义组件成员变量初始化规则](../../../application-dev/quick-start/arkts-restrictions-and-extensions.md#自定义组件成员变量初始化的方式与约束)请参考文档，此版本修复了某些遗漏场景的校验。
73
74
75**变更影响**
76
77如果未按照文档规范，进行自定义组件成员变量初始化赋值，编译报错。
78
79**关键的接口/组件变更**
80
81不涉及。
82
83**适配指导**
84
85按文档提示修改。
86
87## cl.arkui.4 自定义父子组件成员变量赋值约束校验场景补全
88
89[自定义父子组件成员变量赋值规则](../../../application-dev/quick-start/arkts-restrictions-and-extensions.md#自定义组件成员变量初始化的方式与约束)请参考文档，此版本修复了某些遗漏场景的校验。
90
91
92**变更影响**
93
94如果自定义父子组件成员变量初始化未按照文档规范，编译报错。
95
96**关键的接口/组件变更**
97
98不涉及。
99
100**适配指导**
101
102按文档提示修改，使用其它装饰器变量或常规变量赋值。
103
104## cl.arkui.5 单一子组件校验补全
105
106对 'Button', 'FlowItem'，'GridItem'，'GridCol'，'ListItem'，'Navigator'，'Refresh'，'RichText'，'ScrollBar'，'StepperItem'，'TabContent'等只支持一个子组件的开启校验。
107
108
109**变更影响**
110
111如果上述组件内有超过一个子组件，编译报错。
112
113**关键的接口/组件变更**
114
115```js
116RichText('RichText') {
117    Text('Text1')
118    Text('Text2')
119}
120/* ArkTS:ERROR File: /root/newOH/developtools/ace-ets2bundle/compiler/sample/pages/home.ets:25:7
121 The component 'RichText' can only have a single child component. */
122```
123
124**适配指导**
125
126按报错提示修改，指定组件内只能有一个子组件。
127