ArkUI子系统Changelog

cl.arkui.1 当使用双向绑定范式并给对应的@Event赋值时编译报错变更

访问级别

公开接口

变更原因

双向绑定语法和@Event接口不兼容，需要增加编译器校验。

变更影响

该变更为不兼容变更。

举例说明，执行以下用例：

@Entry
@ComponentV2
struct EventExample {
  @Local value: string = 'Hi !';

  build() {
    Column() {
      Text(this.value)
        .fontSize(50)
        .fontColor(Color.Red)
      Star({ value: this.value!!, $value: (val: string) => { this.value += val; }})
    }
  }
}

@ComponentV2
struct Star {
  @Param value: string = 'Hi !';
  @Event $value: (val: string) => void = (val: string) => {};

  build() {
    Column() {
      Text(this.value)
        .fontSize(50)
      Button('click me to change value')
        .onClick(() => {
          this.$value('hello');
        })
    }
  }
}

变更前：编译运行不报错，点击Button，父子组件的Text组件文本内容均变为”hello”，开发者传入的对应的@Event方法不生效。

变更后：检测到开发者使用了双向绑定范式并且给对应的@Event方法赋值，编译拦截报错。

起始API Level

API 12

变更发生版本

从OpenHarmony SDK 5.1.0.43开始。

变更的接口/组件

!!双向绑定语法，@Event装饰器。

适配指导

当使用双向绑定范式并给对应的@Event方法赋值时，编译报错，删掉给对应的@Event方法的传参即可解决。

修改前：

使用双向绑定范式this.value!!，同时给对应的$value方法传递参数$value: (val: string) => { this.value += val; }。

@Entry
@ComponentV2
struct EventExample {
  @Local value: string = 'Hi !';

  build() {
    Column() {
      Text(this.value)
        .fontSize(50)
        .fontColor(Color.Red)
      Star({ value: this.value!!, $value: (val: string) => { this.value += val; }})
    }
  }
}

@ComponentV2
struct Star {
  @Param value: string = 'Hi !';
  @Event $value: (val: string) => void = (val: string) => {};

  build() {
    Column() {
      Text(this.value)
        .fontSize(50)
      Button('click me to change value')
        .onClick(() => {
          this.$value('hello');
        })
    }
  }
}

修改后：

删除给对应的$value方法传递的参数。

@Entry
@ComponentV2
struct EventExample {
  @Local value: string = 'Hi !';

  build() {
    Column() {
      Text(this.value)
        .fontSize(50)
        .fontColor(Color.Red)
      Star({ value: this.value!! })
    }
  }
}

@ComponentV2
struct Star {
  @Param value: string = 'Hi !';
  @Event $value: (val: string) => void = (val: string) => {};

  build() {
    Column() {
      Text(this.value)
        .fontSize(50)
      Button('click me to change value')
        .onClick(() => {
          this.$value('hello');
        })
    }
  }
}

cl.arkui.2 装饰器@Computed编译在特定场景下新增两个ERROR报错提示

访问级别

公开接口

变更原因

@Computed不能和双向绑定!!连用，@Computed装饰的是getter访问器，不会被子组件同步，也不能被赋值。开发者自己实现的计算属性的setter不生效，且产生编译时报错。

变更影响

此变更不涉及应用适配。

1. 当@Computed装饰的属性和双向绑定范式一起使用时，编译时ERROR报错提示

@Entry
@ComponentV2
struct TestComputed {
    @Local str: string = 'hello,world'

    @Computed
    get strFun() {
        return this.str
    }

    build() {
        Scroll() {
            Column() {
                Text(this.str)
                Child({ childStr: this.strFun!! })
            }
        }
    }
}

@ComponentV2
struct Child {
    @Param childStr: string = 'childStr'
    @Event $childStr: (val: string) => void

    build() {
        Column() {
            Button('ChildChange')
                .onClick(() => {
                    this.$childStr('newStr')
                })
        }
    }
}

变更前：编译时不报错

变更后：编译时报错

A property decorated by '@Computed' cannot be used with two-bind syntax.

1. @Computed装饰的get属性方法，不能写set方法，编译进行ERROR报错提示

@Entry
@ComponentV2
struct TestComputed {
    @Local str: string = 'hello,world'

    @Computed
    get strFun() {
        return this.str
    }

    set strFun(value: string) {
        this.str = value
    }

    build() {
        Scroll() {
            Column() {
                Text(this.str)
            }
        }
    }
}

变更前：编译时不报错

变更后：编译时报错

A property decorated by '@Computed' cannot define a set method.

起始API Level

API 12

变更发生版本

从OpenHarmony SDK 5.1.0.43开始。

变更的接口/组件

@Computed

适配指导

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

你可能感兴趣的鸿蒙文章

harmony 鸿蒙1.0.0 （2022/03/09）

harmony 鸿蒙1.0.0 (2022/03/09)

harmony 鸿蒙OpenHarmony Docker镜像

harmony 鸿蒙OpenHarmony Docker Image

harmony 鸿蒙Legal Notices

harmony 鸿蒙OpenHarmony Project

harmony 鸿蒙IDL Specifications and User Guide (for System Applications Only)

harmony 鸿蒙Application Development

harmony 鸿蒙Accessibility Kit

harmony 鸿蒙Introduction to Accessibility Kit