1# ArkUI Subsystem ChangeLog
2
3## cl.arkui.1 xcomponent API Change
4
5Changed the following APIs of the **xcomponent** component of the ArkUI subsystem:
6
7 - **getXComponentSurfaceId** and **setXComponentSurfaceSize**: Removed the **@systemapi** tag.
8 - **getXComponentSurfaceId**, **getXComponentContext**, and **setXComponentSurfaceSize**: Specified return value types.
9
10You need to adapt your application based on the following information.
11
12
13**Change Impact**
14
15Released JS APIs are affected. The application needs to adapt these APIs so that it can be properly compiled in the SDK environment of the new version.
16
17**Key API/Component Changes**
18
19 - **getXComponentSurfaceId**: is changed to a public API, with its return value type specified as string.
20 - **setXComponentSurfaceSize**: is changed to a public API, with its return value type specified as void.
21 - **getXComponentContext**: has its return value type specified as object.
22
23**Adaptation Guide**
24
25Startup rules for different scenarios are as follows:
26
27Adaptions to be made:
28
29  - **getXComponentSurfaceId**
30    - In OpenHarmony 3.2 Beta3:
31      - System API
32      - No specified return value
33    - In OpenHarmony 3.2 Beta4:
34      - Public API
35      - Return value type specified as string
36      - You need to process the return value as a string.
37  - **setXComponentSurfaceSize**
38    - In OpenHarmony 3.2 Beta3:
39      - System API
40      - No specified return value
41    - In OpenHarmony 3.2 Beta4:
42      - Public API
43      - Return value type specified as void
44      - You need to process the return value as a void.
45  - **getXComponentContext**
46    - In OpenHarmony 3.2 Beta3:
47      - No specified return value
48    - In OpenHarmony 3.2 Beta4:
49      - Return value type specified as object
50      - You need to process the return value as an object.
51
52## cl.arkui.2 Change of Styles of Popup Component and APIs
53
54The styles of the **alertDialog**, **actionSheet**, and **customDialog** components, as well as the **prompt** and **promptAction** APIs were changed. Specifically speaking:
55
56The popup background blurring effect is added to **promptAction.showDialog**, **promptAction.showActionMenu**, **alertDialog**, **actionSheet**, and **customDialog**.
57
58**Change Impact**
59
60The popup background blurring effect is set by default.
61
62**Key API/Component Changes**
63
64APIs: **promptAction.showDialog** and **promptAction.showActionMenu;**
65Components: **alertDialog**, **actionSheet**, and **customDialog**
66
67**Adaptation Guide**
68
69No adaptation is required.
70
71## cl.arkui.3 Supplementation of the Initialization Mode and Restriction Verification Scenarios of Custom Components' Member Variables
72
73Added verification for scenarios previously left out concerning initialization of custom components' member variables.
74
75
76**Change Impact**
77
78If custom components' member variables are initialized or assigned with values not according to the document specifications, an error will be reported during compilation.
79
80**Key API/Component Changes**
81
82N/A
83
84**Adaptation Guide**
85
86Make modification according to specifications in the above document.
87
88## cl.arkui.4 Supplementation of Verification Scenarios of Value Assignment Restrictions on Member Variables of Custom Parent Components and Child Components
89
90Added verification for scenarios previously left out concerning value assignment of member variables of custom parent components and child components.
91
92
93**Change Impact**
94
95If member variables of the parent component or child component are initialized not according to the document specifications, an error will be reported during compilation.
96
97**Key API/Component Changes**
98
99N/A
100
101**Adaptation Guide**
102
103Make modification according to specifications in the above document, using other decorators or normal member variables for value assignment.
104
105## cl.arkui.5 Supplementation of Verification for a Single Child Component
106
107Added verification for a single child component for the following components: **Button**, **FlowItem**, **GridItem**, **GridCol**, **ListItem**, **Navigator**, **Refresh**, **RichText**, **ScrollBar**, **StepperItem**, and **TabContent**.
108
109**Change Impact**
110
111If one of the preceding components contains more than one child component, an error will be reported during compilation.
112
113**Key API/Component Changes**
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**Adaptation Guide**
125
126Make modification based on the error message. Make sure that the specified component contains only one child component.
127