ArkUI Subsystem ChangeLog

cl.arkui.1 xcomponent API Change

Changed the following APIs of the xcomponent component of the ArkUI subsystem:

• getXComponentSurfaceId and setXComponentSurfaceSize: Removed the @systemapi tag.
• getXComponentSurfaceId, getXComponentContext, and setXComponentSurfaceSize: Specified the return value type.

You need to adapt your application based on the following information.

Change Impact

Released 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.

Key API/Component Changes

• getXComponentSurfaceId: is changed to a public API, with its return value type specified as string.
• setXComponentSurfaceSize: is changed to a public API, with its return value type specified as void.
• getXComponentContext: has its return value type specified as object.

Adaptation Guide

Startup rules for different scenarios are as follows: Adaptions to be made:

• getXComponentSurfaceId
  • Rule in OpenHarmony 3.2 Beta3:
    • System API
    • No specified return value
  • OpenHarmony 3.2 Beta4 rules:
    • Public API
    • Return value type specified as string
    • You need to process the return value as a string.
• setXComponentSurfaceSize
  • Rule in OpenHarmony 3.2 Beta3:
    • System API
    • No specified return value
  • OpenHarmony 3.2 Beta4 rules:
    • Public API
    • Return value type specified as void
    • You need to process the return value as a void.
• getXComponentContext
  • Rule in OpenHarmony 3.2 Beta3:
    • No specified return value
  • OpenHarmony 3.2 Beta4 rules:
    • Return value type specified as object
    • You need to process the return value as an object.

cl.arkui.2 Change of Styles of Popup Component and APIs

Changed the styles of the alertDialog, actionSheet, and customDialog components, as well as the prompt and promptAction APIs. Specifically speaking:

• Added the popup background blur effect to promptAction.showDialog, promptAction.showActionMenu, alertDialog, actionSheet, and customDialog.

Change Impact

The popup background blur effect is set by default.

Key API/Component Changes

APIs: promptAction.showDialog and promptAction.showActionMenu; Components: alertDialog, actionSheet, and customDialog

Adaptation Guide

No adaptation is required.

cl.arkui.3 Supplementation of the Initialization Mode and Restriction Verification Scenarios of Custom Components' Member Variables

Change Impact

If custom components' member variables are initialized or assigned with values not according to the document specifications, an error will be reported during compilation.

Key API/Component Changes

N/A.

Adaptation Guide

Make modification according to specifications in the above document.

cl.arkui.4 Supplementation of Verification Scenarios of Value Assignment Restrictions on Member Variables of Custom Parent Components and Child Components

Change Impact

If member variables of the parent component or child component are initialized not according to the document specifications, an error will be reported during compilation.

Key API/Component Changes

N/A.

Adaptation Guide

Make modification according to specifications in the above document, using other decorators or normal member variables for value assignment.

cl.arkui.5 Supplementation of Verification for a Single Subcomponent

Added 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.

Change Impact

If one of the preceding components contains more than one child component, an error will be reported during compilation.

Key API/Component Changes

RichText('RichText') {
    Text('Text1')
    Text('Text2')
}
/* ArkTS:ERROR File: /root/newOH/developtools/ace-ets2bundle/compiler/sample/pages/home.ets:25:7
 The component 'RichText' can only have a single child component. */

Adaptation Guide

Make modification based on the error message. Make sure that the specified component contains only one child component.