# ArkUI子系统Changelog

## cl.arkui.1 component3d获取资源的路径格式由Resource类型不兼容变更到ResourceStr类型

**访问级别**

公开接口

**变更原因**

扩展component3D组件获取系统路径资源能力，目前只支持从应用沙箱路径获取资源。

**变更影响**

该变更为不兼容变更。

变更前：component3D资源获取通过Resource方式，只支持从rawfile路径读取。

变更后：component3D资源获取修改为通过ResourceStr方式，既支持从rawfile路径读取也支持从磁盘路径读取。

不兼容场景：
当用户存在指定数据类型赋值场景时，会出现不兼容情况; 例如：
```ts
const params1: SceneResourceParameters = { name: "name1", uri: $rawfile("default_path") }
const test_uri: Resource | undefined = params1.uri;
```

**起始API Level**

API 12

**变更发生版本**

从OpenHarmony SDK 5.0.0.43开始

**变更的接口/组件**

1、 Component3D初始化资源接口SceneOptions中sence变量数据类型由Resource变更为ResourceStr；

2、 Scene中uri变量数据类型由Resource变更为ResourceStr；

3、 SceneResources中uri变量数据类型由Resource变更为ResourceStr；

4、 component3d中environment、customRender、shader和shaderImageTexture接口的入参由Resource类型变更为ResourceStr类型；

5、 Scene中load接口的入参由Resource类型变更为ResourceStr类型；

**适配指导**

```ts
import { Scene, Image, SceneResourceParameters, SceneResourceFactory } from '@kit.ArkGraphics3D'

const params1: SceneResourceParameters = { name: "name1", uri: $rawfile("default_path") }
// 变更前
// const test_uri: Resource | undefined = params1.uri;
// 变更后适配为
const test_uri: ResourceStr | undefined = params1.uri;

@Entry
@Component
struct node_geometry {
    scene: Scene | null = null;
    @State sceneOpt: SceneOptions | null = null; 
    envImg: Image | null = null;

    onPageShow(): void {
        this.Init();
    }

    onPageHide(): void {
        if (this.scene) {
            this.scene.destroy();
        }
    }

    Init(): void {
        if (this.scene == null) {
            Scene.load($rawfile("default_path"))
            .then(async (result: Scene) => {
                this.scene = result;
                this.sceneOpt = { scene: this.scene, modelType: ModelType.SURFACE } as SceneOptions;
                let rf: SceneResourceFactory = this.scene.getResourceFactory();

                this.envImg = await rf.createImage({ name: "image1", uri: test_uri });
            });
        }
    }

    build() {
        Column() {
            Component3D(this.sceneOpt)
                .renderWidth('100%')
                .renderHeight('100%')
                .width('100%')
                .height('100%')
        }
    }
}
```

## cl.arkui.2 showToast接口TOP_MOST模式行为变更

**访问级别**

公开接口

**变更原因**

toast层级过高，会挡住权限弹窗等敏感内容，存在安全隐患。

**变更影响**

该变更为不兼容变更。

API version 12及以后，TOP_MOST模式弹出的Toast的层级发生改变，即：

变更前：Toast层级较高，可以悬浮显示在输入法、系统授权弹窗之上。输入法弹出后不避让，保持在原来的位置。

变更后：

1. Toast不能悬浮显示在输入法之上，如果Toast与输入法有重叠，则将Toast避让到输入法上方固定80vp处。
2. Toast在系统敏感内容显示时不显示或被覆盖。
3. 在画中画窗口和悬浮窗中不支持创建TOP_MOST模式的Toast。

| 变更前                                   | 变更后                                   |
| ---------------------------------------- | ---------------------------------------- |
| ![zh-cn_image_alert](figures/41.1.6.png) | ![zh-cn_image_alert](figures/41.1.7.png) |



| 变更前                                   | 变更后                                   |
| ---------------------------------------- | ---------------------------------------- |
| ![zh-cn_image_alert](figures/41.1.8.png) | ![zh-cn_image_alert](figures/41.1.9.png) |



| 变更前                                   | 变更后                                   |
| ---------------------------------------- | ---------------------------------------- |
| ![zh-cn_image_alert](figures/41.1.10.png) | ![zh-cn_image_alert](figures/41.1.11.png) |

**起始API Level**

11

**变更发生版本**

从OpenHarmony SDK 5.0.0.43 版本开始。

**变更的接口/组件**

showToast接口

**适配指导**

1. 对于输入法的场景，开发者可以设置高度将Toast放到合适的位置，主动避开输入法。
2. 对于敏感内容的场景，开发者无法适配。
3. 对于画中画和悬浮窗的场景，开发者可以改为使用DEFAULT模式。

## cl.arkui.3 在2in1设备上bindsheet视觉效果变更

**访问级别**

公开接口

**变更原因**

2in1设备上，半模态样式优化。

**变更影响**

该变更为兼容性变更。

| 变更前 | 变更后 |
|------ |--------|
|默认圆角为32vp|2in1设备中，默认圆角为16vp|
|关闭按钮默认有底板|2in1设备中，关闭按钮默认没有底板|
|默认没有阴影|2in1设备中，默认有阴影|
|默认没有内外描边|2in1设备中，默认有内外描边|

**起始API Level**

11

**变更发生版本**

从OpenHarmony 5.0.0.43 版本开始。

**变更的接口/组件**

bindSheet属性。

**适配指导**

默认行为变更，无需适配。

## cl.arkui.4 修复Popup高级组件宽度限制计算错误的问题

**访问级别**

公开接口

**变更原因**

目前宽度最大限制不符合ux规范，在手机屏幕场景下，会出现Popup高级组件无法撑满屏幕的情况，影响体验。

**变更影响**

该变更为不兼容变更。

变更前：屏幕宽度小于400vp时，Popup高级组件最大宽度为当前屏幕宽度-80vp。

变更后：屏幕宽度小于400vp时，Popup高级组件最大宽度为当前屏幕宽度。

| 变更前                                   | 变更后                                   |
| ---------------------------------------- | ---------------------------------------- |
| ![popup_before](figures/popup_before.png) | ![popup_after](figures/popup_after.png) |

**起始API Level**

11

**变更发生版本**

从OpenHarmony 5.0.0.43 版本开始。

**变更的接口/组件**

Popup高级组件。

**适配指导**

如果用户原来没有自定义Popup高级组件的宽度，且内容宽度大于320vp，变更前按320vp显示，变更后，Popup高级组件会变宽；如不符合预期，可以手动修改为想要的宽度。

## cl.arkui.5 Navigation嵌套使用时的生命周期行为优化

**访问级别**

公开接口

**变更原因**

在嵌套使用Navigation的场景下,如果内层Navigation处于不可见的状态，不应该触发对应的onShown生命周期。

**变更影响**

该变更为不兼容变更。

变更前：在嵌套Navigation的场景下如果内层的Navigation不可见，此时如果应用对不可见的Navigation进行栈操作，会触发对应的onShown生命周期。

变更后：在嵌套Navigation的场景下如果内层的Navigation不可见，此时如果应用对不可见的Navigation进行栈操作，不会触发对应的onShown生命周期。

**起始API Level**

12

**变更发生版本**

从OpenHarmony 5.0.0.43 版本开始。

**变更的接口/组件**

onShown生命周期。

**适配指导**

默认行为变更，无需适配，但应注意变更后的行为是否对整体应用逻辑产生影响。