5.1.0(18)的行为变更汇总
================

#### OS平台API行为的变更

| 
Kit

 | 

变更描述

 | 

变更引入版本

 | 

变更影响

 | 

影响设备类型

 | 

变更生效规则

 |
| :-- | :-- | :-- | :-- | :-- | :-- |
| 

ArkTS

 | 

[默认不合并依赖混淆规则变更说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section339)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

DevEco Studio 5.1.0(18) Release版本生效

 |
| 

ArkUI

 | 

[getKeyboardAvoidMode接口返回值变更](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#ch2025040743551)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

[XComponent组件上使用renderFit接口显示效果变更](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section392)

 | 

5.1.0(18) Release

 | 

中

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

[当使用自定义组件名和内置属性重名时编译报错变更](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section407)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

使用DevEco Studio 5.1.0 Release及以上版本时生效

 |
| 

[CanvasRenderingContext2D方法传NaN和Infinity值后执行的其他绘制方法由不绘制变更为正常绘制](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section159)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

[CanvasRenderingContext2D的drawImage接口默认单位变更](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section155)

 | 

5.1.0(18) Release

 | 

中

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

[修复blendMode接口离屏模式会影响组件设置的不透明度的问题](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section373)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

[XComponent设置为Texture模式使用blendMode接口的行为由不生效变更为正常生效](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section372)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

[setSpecificSystemBarEnabled接口在横屏的行为变更](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section150)

 | 

5.1.0(18) Release

 | 

小

 | 

phone

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

[滚动组件通用接口backToTop属性默认值变更](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#ch2025041542754)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

[页面退出场景自定义组件删除前移](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section337)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

[V1和V2组件冻结能力增强](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section208)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

Audio Kit

 | 

[音频框架识别USB音频设备类型行为变更](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#ch2025041189292)

 | 

5.1.0(18) Release

 | 

小

 | 

2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

Basic Services Kit

 | 

[osAccount.distributedAccount.DistributedAccountAbility.getOsAccountDistributedInfo接口返回值生成规则变更](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section419)

 | 

5.1.0(18) Release

 | 

中

 | 

phone, tablet, 2in1

 | 

全部生效

 |
| 

CANN Kit（原HiAI Foundation Kit）

 | 

[原hiai\_foundation目录下的头文件废弃，替换为CANNKit下的头文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#原hiai_foundation目录下的头文件废弃替换为cannkit下的头文件)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

使用DevEco Studio 5.1.0 Release及以上版本时生效

 |
| 

Device Security Kit

 | 

[Device Security Kit优化错误码上报](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section355)

 | 

5.1.0(18) Release

 | 

中

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

Form Kit

 | 

[卡片支持能力增加安全校验](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#ch2025040702014)

 | 

5.1.0(18) Release

 | 

中

 | 

phone, tablet, 2in1

 | 

全部生效

 |
| 

Media Kit

 | 

[应用创建SoundPool时调用media.createSoundPool接口变更](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#ch2025041671497)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

Performance Analysis Kit

 | 

[用户态trace打点格式变更](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section403)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

全部生效

 |
| 

Remote Communication Kit

 | 

[fetch接口新增错误码返回](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section258)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

NDK开发

 | 

[JIT功能默认关闭，需申请权限证书并通过审核后启用](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section398)

 | 

5.1.0(18) Release

 | 

大

 | 

phone, tablet, 2in1

 | 

全部生效

 |

#### UX样式或效果的变更

| 
变更描述

 | 

变更引入版本

 | 

变更影响

 | 

影响设备类型

 | 

变更生效规则

 |
| :-- | :-- | :-- | :-- | :-- |
| 

[按钮默认值变更为新增圆角矩形类型](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-ux-5101#section174)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |
| 

[修复Popup高级组件宽度限制计算错误的问题](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-ux-5101#section173)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

全部生效

 |
| 

[半模态底部样式最大高度默认避让状态栏安全区](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-ux-5101#section394)

 | 

5.1.0(18) Release

 | 

小

 | 

phone

 | 

targetSdkVersion ≥ 5.1.0(18)变更生效

 |

#### 开发工具的变更

| 
工具分类

 | 

变更描述

 | 

变更引入版本

 | 

变更影响

 | 

影响设备类型

 | 

变更生效规则

 |
| :-- | :-- | :-- | :-- | :-- | :-- |
| 

命令行工具

 | 

[hiperf命令行调试工具使用权限缩小](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101#section410)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

使用DevEco Studio 5.1.0 Release及以上版本时生效

 |
| 

DevEco Studio

 | 

[DevEco Studio中fastjson版本升级](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/change-description-510-release#section9210175019116)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

使用DevEco Studio 5.1.0 Release及以上版本时生效

 |
| 

DevEco Studio

 | 

[堆栈格式变化](https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/change-description-510-release#section94051310171216)

 | 

5.1.0(18) Release

 | 

小

 | 

phone, tablet, 2in1

 | 

使用DevEco Studio 5.1.0 Release及以上版本时生效

 |