ArkUI子系统Changelog

cl.arkui.1 线性DataPanel组件默认圆角尺寸变更并可以自定义圆角尺寸

访问级别

公开接口

变更原因

线性DataPanel组件的圆角尺寸不能改变，导致开发者无法自定义线性DataPanel组件的圆角尺寸。新增支持自定义线性DataPanel组件的圆角尺寸，增强开发者自定义能力。

变更影响

该变更为非兼容性变更。

变更前： 线性DataPanel组件默认是胶囊形状。不能自定义线性DataPanel组件的圆角。

变更后： 线性DataPanel组件默认圆角的是小圆角。可以自定义线性DataPanel组件的圆角尺寸，调用borderRadius设置圆角尺寸。

API Level

12

变更发生版本

从OpenHarmony SDK 5.0.0.26开始。

适配指导

默认圆角效果变更，无需适配，如不接受变更后的默认圆角效果，可以调用borderRadius自定义修改圆角尺寸以达到预期。

cl.arkui.2 ScrollBar组件没有子节点时，支持显示默认样式的滚动条

访问级别

公开接口

变更原因 从API version 12开始，ScrollBar组件没有子节点时，支持显示默认样式的滚动条。

变更影响

该变更为非兼容性变更。

API version 11及以前，ScrollBar组件没有子节点时，不显示滚动条。

API version 12及以后，ScrollBar组件没有子节点时，支持显示默认样式的滚动条。

API Level

12

变更发生版本

从OpenHarmony SDK 5.0.0.26 版本开始。

变更的接口/组件

ScrollBar组件

适配指导

请查阅ScrollBar组件文档进行适配。

cl.arkui.3 UIExtensionComponent异常处理废弃onRelease和onResult，使用onTerminated和onError替代

访问级别

公开接口

变更原因 UIExtensionComponent异常处理回调分散

变更影响

该变更为非兼容性变更。

API version 11及以前，被拉起的UIExtensionAbility意外Crash或被kill时，触发onRelease回调（错误码为1）；被拉起的UIExtensionAbility调用terminateSelf时会触发onRelease回调（错误码为0）；被拉起的UIExtensionAbility调用terminateSelfWithResult时会触发onRelease回调（错误码为0）和onResult回调。

API version 12及以后，被拉起的UIExtensionAbility意外Crash或被kill时，触发onError回调（错误码为100014）；被拉起的UIExtensionAbility调用terminateSelf时会触发onTerminated回调，其入参”code”取默认值”0”，”want”为”undefined”；被拉起的UIExtensionAbility调用terminateSelfWithResult时会触发onTerminated回调，其携带的信息会传给回调函数的入参。

API Level

12

变更发生版本

从OpenHarmony SDK 5.0.0.26 版本开始。

变更的接口/组件

UIExtensionComponent组件

适配指导

请查阅UIExtensionComponent组件文档进行适配。

cl.arkui.4 手势菜单复制，粘贴，全选，剪切按钮扩大选中区域的高度至40vp

访问级别

公开接口

变更原因 手势菜单复制、粘贴、全选、剪切按钮选中区域高度不符合简单易用标准

变更影响

该变更为非兼容性变更。

API version 11及以前，手势菜单复制、粘贴、全选、剪切按钮扩中区域的高度为28vp。

API version 12及以后，手势菜单复制、粘贴、全选、剪切按钮扩中区域的高度为40vp，且保持长按时视觉效果一致。

起始API Level

10

变更发生版本

从OpenHarmony SDK 5.0.0.26 版本开始。

变更的接口/组件

涉及菜单的组件：TextInput、TextArea、Search、RichEditor。

适配指导

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

cl.arkui.5 pickerDialog操作区按钮大小及间距调整

访问级别

公开接口

变更原因

修正视觉效果以获得更好的用户体验。

变更影响

该变更为非兼容性变更。

起始API Level

12

变更发生版本

从OpenHarmony SDK 5.0.0.26 版本开始。

变更的接口/组件

涉及菜单的组件：CalendarPickerDialog、TextPickerDialog、DatePickerDialog、TimePickerDialog。

适配指导

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

cl.arkui.6 使用Path2D复制构造Path2D不生效

访问级别

公开接口

变更原因

变更前效果未达预期

变更影响

该变更为非兼容性变更。

变更前：使用Path2D复制构造Path2D不生效

变更后：使用Path2D复制构造Path2D可以创建出一个与原来的Path2D相同路径的Path2D

起始 API Level

8

变更发生版本

从OpenHarmony SDK 5.0.0.26 版本开始。

变更的接口/组件

Path2D

适配指导

默认效果变更，无需适配。但应注意变更后的效果是否符合预期。

@Entry
@Component
struct Demo {
  private settings: RenderingContextSettings = new RenderingContextSettings(true)
  private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)
  private path2Da: Path2D = new Path2D()

  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Canvas(this.context)
        .width('100%')
        .height('50%')
        .onReady(() => {
          this.path2Da.rect(20, 20, 100, 100)
          let path2Db = new Path2D(this.path2Da)
          this.context.stroke(path2Db)
        })
    }
    .width('100%')
    .height('100%')
  }
}

cl.arkui.7 使用PixelMap构造ImageBitmap不生效

访问级别

公开接口

变更原因

变更前效果未达预期

变更影响

该变更为非兼容性变更。

变更前：使用PixelMap构造ImageBitmap不生效

变更后：使用PixelMap构造ImageBitmap可以创建出ImageBitmap

起始 API Level

8

变更发生版本

从OpenHarmony SDK 5.0.0.26 版本开始。

变更的接口/组件

ImageBitmap

适配指导

默认效果变更，无需适配。但应注意变更后的效果是否符合预期。

@Entry
@Component
struct Demo {
  private settings: RenderingContextSettings = new RenderingContextSettings(true)
  private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)

  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Canvas(this.context)
        .width('100%')
        .height('50%')
        .backgroundColor('#ffff00')
        .onReady(() => {
          this.context.fillStyle = "#00ff00"
          this.context.fillRect(0, 0, 100, 100)
          let pixel = this.context.getPixelMap(0, 0, 100, 100)
          let image = new ImageBitmap(pixel)
          this.context.drawImage(image, 100, 100)
        })
    }
    .width('100%')
    .height('100%')
  }
}

cl.arkui.8 ImageSpanAlignment BASELINE 效果调整

访问级别

公开接口

变更原因

ImageSpanAlignment BASELINE 原先显示效果与文档解释不符

变更影响

该变更为不兼容性变更。

1. ImageSpan 组件的 ImageSpanAlignment BASELINE 效果调整，将图片底部与 baseline 进行对齐

起始API Level

12

变更发生版本

从OpenHarmony SDK 5.0.0.31开始。

适配指导

默认行为变更，无需适配，但应注意变更后的默认效果是否符合开发者预期，如不符合则自定义修改效果以达到预期。

cl.arkui.9 bindSheet半模态弹窗支持开发者设置底部弹窗样式

访问级别

公开接口

变更原因

半模态视觉增强

变更影响

该变更为不兼容变更。

bindSheet的Option属性preferType，从枚举值变成了枚举，会影响开发者将preferType属性作为函数形参的场景。

代码举例如:

// 函数foo，形参为SheetType的枚举值
function foo(goog: SheetType.CENTER|SheetType.POPUP|undefined) {
  // 函数内容
};

// 声明一个参数 = SheetOptions
let op : SheetOptions = {
  preferType : SheetType.CENTER
};

// foo函数调用op.preferType
foo(op.preferType)

变更前：foo函数可以调用该变量

变更后：foo函数调用该变量会报错，需要将foo函数的形参变更为SheetType枚举

// 函数foo，形参为SheetType枚举
function foo(goog: SheetType|undefined) {
  // 函数内容
};

起始API Level

11

变更发生版本

从OpenHarmony SDK 5.0.0.26开始。

适配指导

默认行为无变更，但需要处理上述函数传参场景。

需要将函数foo的形参类型改成SheetType枚举，而不是枚举值。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkCompiler子系统变更说明

harmony 鸿蒙全球化变更说明

harmony 鸿蒙方舟编译运行时子系统变更说明