ArkUI子系统Changelog

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

访问级别

公开接口

变更原因

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

变更影响

该变更为不兼容变更。

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

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

不兼容场景： 当用户存在指定数据类型赋值场景时，会出现不兼容情况; 例如：

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类型；

适配指导

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。

变更前	变更后

变更前	变更后

变更前	变更后

起始API Level

11

变更发生版本

从OpenHarmony SDK 5.0.0.43 版本开始。

变更的接口/组件

showToast接口

适配指导

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

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

访问级别

公开接口

变更原因

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

变更影响

该变更为兼容性变更。

起始API Level

11

变更发生版本

从OpenHarmony 5.0.0.43 版本开始。

变更的接口/组件

bindSheet属性。

适配指导

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

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

访问级别

公开接口

变更原因

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

变更影响

该变更为不兼容变更。

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

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

起始API Level

12

变更发生版本

从OpenHarmony 5.0.0.43 版本开始。

变更的接口/组件

onShown生命周期。

适配指导

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

你可能感兴趣的鸿蒙文章

harmony 鸿蒙元能力子系统Changelog

harmony 鸿蒙ArkTS子系统Changelog

harmony 鸿蒙文件系统CoreFileKitChangelog

harmony 鸿蒙Media Library Kit子系统Changelog

harmony 鸿蒙NetManager系统Changelog