• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 the return value type.
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:
26Adaptions to be made:
27
28  - **getXComponentSurfaceId**
29    - Rule in OpenHarmony 3.2 Beta3:
30      - System API
31      - No specified return value
32    - OpenHarmony 3.2 Beta4 rules:
33      - Public API
34      - Return value type specified as string
35      - You need to process the return value as a string.
36  - **setXComponentSurfaceSize**
37    - Rule in OpenHarmony 3.2 Beta3:
38      - System API
39      - No specified return value
40    - OpenHarmony 3.2 Beta4 rules:
41      - Public API
42      - Return value type specified as void
43      - You need to process the return value as a void.
44  - **getXComponentContext**
45    - Rule in OpenHarmony 3.2 Beta3:
46      - No specified return value
47    - OpenHarmony 3.2 Beta4 rules:
48      - Return value type specified as object
49      - You need to process the return value as an object.
50
51## cl.arkui.2 Change of Styles of Popup Component and APIs
52
53Changed the styles of the **alertDialog**, **actionSheet**, and **customDialog** components, as well as the **prompt** and **promptAction** APIs. Specifically speaking:
54
55 - Added the popup background blur effect to **promptAction.showDialog**, **promptAction.showActionMenu**, **alertDialog**, **actionSheet**, and **customDialog**.
56
57**Change Impact**
58
59The popup background blur effect is set by default.
60
61**Key API/Component Changes**
62
63APIs: **promptAction.showDialog** and **promptAction.showActionMenu;**
64Components: **alertDialog**, **actionSheet**, and **customDialog**
65
66**Adaptation Guide**
67
68No adaptation is required.
69
70## cl.arkui.3 Supplementation of the Initialization Mode and Restriction Verification Scenarios of Custom Components' Member Variables
71
72For details, see [Restrictions and Extensions](https://gitee.com/openharmony/docs/blob/master/en/application-dev/quick-start/arkts-restrictions-and-extensions.md).
73
74
75**Change Impact**
76
77If custom components' member variables are initialized or assigned with values not according to the document specifications, an error will be reported during compilation.
78
79**Key API/Component Changes**
80
81N/A.
82
83**Adaptation Guide**
84
85Make modification according to specifications in the above document.
86
87## cl.arkui.4 Supplementation of Verification Scenarios of Value Assignment Restrictions on Member Variables of Custom Parent Components and Child Components
88
89For details, see [Restrictions and Extensions](../../../application-dev/quick-start/arkts-restrictions-and-extensions.md).
90
91
92**Change Impact**
93
94If member variables of the parent component or child component are initialized not according to the document specifications, an error will be reported during compilation.
95
96**Key API/Component Changes**
97
98N/A.
99
100**Adaptation Guide**
101
102Make modification according to specifications in the above document, using other decorators or normal member variables for value assignment.
103
104## cl.arkui.5 Supplementation of Verification for a Single Subcomponent
105
106Added the check rule that allows only one child component to be enabled for the following components: **Button**, **FlowItem**, **GridItem**, **GridCol**, **ListItem**, **Navigator**, **Refresh**, **RichText**, **ScrollBar**, **StepperItem**, and **TabContent**.
107
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