HarmonyOS NEXT每次新版本发布均会或多或少引入一些变更,这些变更可能会影响到您的应用。为了使开发者更清晰的感知变更对应用的影响,我们将变更做如下分类:
此类变更可能影响在HarmonyOS最新版本的镜像设备上运行的所有应用,无论您的应用是使用API 12或是更早的API版本进行开发。
此类变更均需应用进行适配。
此类变更仅影响您基于API 12的SDK进行开发和编译的应用。这类变更存在于以下两种场景:
仅对系统提供的UX样式和效果进行变更,开发者可以根据变更说明来判断是否影响应用整体风格或预期效果。
Kit | 变更描述 | 变更引入版本 |
|---|---|---|
Ability Kit | HarmonyOS NEXT Release | |
ArkUI | HarmonyOS NEXT Release | |
Media Library Kit | @ohos.file.photoAccessHelper相册添加资产、移除资产等接口行为变更 * 该变更在10月17日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.906。 | HarmonyOS NEXT Release |
Ability Kit | HarmonyOS NEXT Beta | |
Ability Kit | * 该变更在9月12日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.806。 | HarmonyOS NEXT Beta |
Ability Kit | childProcessManager增加子进程最大数量限制 * 该变更在9月21日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.810。 | HarmonyOS NEXT Beta |
Ability Kit | startAbility从后台发起时,即使应用正在运行长时任务,也不能调用成功。 * 该变更在9月21日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.810。 | HarmonyOS NEXT Beta |
Ability Kit | * 该变更在9月27日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.814。 | HarmonyOS NEXT Beta |
ArkTS | util.TextEncoder模块utf-16le和utf-16be编码数据行为变更 * 该变更在9月12日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.806。 | HarmonyOS NEXT Beta |
ArkTS | Worker模块中RestrictedWorker的接口变更为system API * 该变更在9月27日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.814。 | HarmonyOS NEXT Beta |
ArkUI | * 该变更在9月21日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.810。 | HarmonyOS NEXT Beta |
AVCodec Kit | HarmonyOS NEXT Beta | |
Camera Kit | HarmonyOS NEXT Beta | |
Core File Kit | HarmonyOS NEXT Beta | |
Core File Kit | HarmonyOS NEXT Beta | |
Core File Kit | HarmonyOS NEXT Beta | |
Core File Kit | * 该变更在9月21日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.810。 | HarmonyOS NEXT Beta |
Distributed Service Kit | 使用udid-hash与appid和盐值基于sha256混淆截断后保留前16位值作为deviceid,调用行为变更 * 该变更在9月21日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.810。 | HarmonyOS NEXT Beta |
调试命令 | HarmonyOS NEXT Beta | |
调试命令 | HarmonyOS NEXT Beta | |
调试命令 | * 该变更在9月12日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.806。 | HarmonyOS NEXT Beta |
Ability Kit | HarmonyOS NEXT Developer Beta5 | |
ArkTS | HarmonyOS NEXT Developer Beta5 | |
ArkTS | HarmonyOS NEXT Developer Beta5 | |
Background Tasks Kit | HarmonyOS NEXT Developer Beta5 | |
Media Library Kit | HarmonyOS NEXT Developer Beta5 | |
Ability Kit | HarmonyOS NEXT Developer Beta3 | |
ArkTS | HarmonyOS NEXT Developer Beta3 | |
ArkUI | HarmonyOS NEXT Developer Beta3 | |
Localization Kit | HarmonyOS NEXT Developer Beta3 | |
Localization Kit | HarmonyOS NEXT Developer Beta3 | |
Network Kit | HarmonyOS NEXT Developer Beta3 | |
NDK开发 | HarmonyOS NEXT Developer Beta2 | |
NDK开发 | HarmonyOS NEXT Developer Beta2 | |
NDK开发 | HarmonyOS NEXT Developer Beta2 | |
ArkWeb | HarmonyOS NEXT Developer Beta2 | |
ArkData | HarmonyOS NEXT Developer Beta2 | |
ArkData | HarmonyOS NEXT Developer Beta2 | |
ArkGraphics 2D | OH_Drawing_RegisterFont()、OH_Drawing_RegisterFontBuffer()接口增加报错码 | HarmonyOS NEXT Developer Beta2 |
ArkTS | HarmonyOS NEXT Developer Beta2 | |
ArkTS | HarmonyOS NEXT Developer Beta2 | |
ArkTS | HarmonyOS NEXT Developer Beta2 | |
ArkTS | HarmonyOS NEXT Developer Beta2 | |
ArkTS | HarmonyOS NEXT Developer Beta2 | |
ArkTS | HarmonyOS NEXT Developer Beta2 | |
ArkTS | HarmonyOS NEXT Developer Beta2 | |
ArkUI | @Component和@ComponentV2修饰的自定义组件使用@Observed或者@ObservedV2修饰的类增加相关校验 | HarmonyOS NEXT Developer Beta2 |
ArkUI | HarmonyOS NEXT Developer Beta2 | |
ArkUI | HarmonyOS NEXT Developer Beta2 | |
ArkUI | HarmonyOS NEXT Developer Beta2 | |
ArkUI | HarmonyOS NEXT Developer Beta2 | |
ArkUI | HarmonyOS NEXT Developer Beta2 | |
Media Library Kit | HarmonyOS NEXT Developer Beta2 | |
公共能力 | HarmonyOS NEXT Developer Beta2 |
Kit | 变更描述 | 历史工程适配建议 | 变更引入版本 |
|---|---|---|---|
ArkUI | 建议适配 | HarmonyOS NEXT Release | |
Ability | 禁止BackupExtensionAbility进程拉起启动框架 * 该变更在9月21日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.810。 | 必须适配 | HarmonyOS NEXT Beta |
ArkTS | 必须适配 | HarmonyOS NEXT Beta | |
ArkUI | 状态管理V2版本组件内的@Local,@Param,@Event,@Provider,@Consumer,@BuilderParam,必须声明类型 | 必须适配 | HarmonyOS NEXT Beta |
ArkUI | 必须适配 | HarmonyOS NEXT Beta | |
ArkUI | 必须适配 | HarmonyOS NEXT Beta | |
ArkWeb | CustomDialog内嵌Web组件软键盘避让方式由改变Web高度避让软键盘变更为抬升CustomDialog避让软键盘 | 建议适配 | HarmonyOS NEXT Beta |
Crypto Architecture Kit | * 该变更在9月12日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.806。 | 必须适配 | HarmonyOS NEXT Beta |
Crypto Architecture Kit | @ohos.security.cryptoFramework 接口SysCap变更 * 该变更在9月12日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.806。 | 必须适配 | HarmonyOS NEXT Beta |
IME Kit | 必须适配 | HarmonyOS NEXT Beta | |
ArkData | 必须适配 | HarmonyOS NEXT Developer Beta5 | |
ArkTS | 建议适配 | HarmonyOS NEXT Developer Beta5 | |
ArkUI | 建议适配 | HarmonyOS NEXT Developer Beta5 | |
Device Security Kit | 必须适配 | HarmonyOS NEXT Developer Beta5 | |
ArkTS | 必须适配 | HarmonyOS NEXT Developer Beta3 | |
ArkTS | 必须适配 | HarmonyOS NEXT Developer Beta3 | |
ArkTS | 必须适配 | HarmonyOS NEXT Developer Beta3 | |
ArkUI | 建议适配 | HarmonyOS NEXT Developer Beta3 | |
ArkUI | 使用局部@Builder方法引用传参时,使用bind(this)后,状态管理的父子关系和组件的父子关系不一致,比如使用@ohos.arkui.advanced.ChipGroup高级组件崩溃解决方法 | 必须适配 | HarmonyOS NEXT Developer Beta3 |
ArkUI | 建议适配 | HarmonyOS NEXT Developer Beta3 | |
ArkUI | 建议适配 | HarmonyOS NEXT Developer Beta3 | |
ArkUI | 建议适配 | HarmonyOS NEXT Developer Beta3 | |
ArkUI | 建议适配 | HarmonyOS NEXT Developer Beta3 | |
ArkUI | 建议适配 | HarmonyOS NEXT Developer Beta3 | |
ArkWeb | 无需适配 | HarmonyOS NEXT Developer Beta3 | |
Ability Kit | 建议适配 | HarmonyOS NEXT Developer Beta2 | |
ArkData | 建议适配 | HarmonyOS NEXT Developer Beta2 | |
ArkTS | 必须适配 | HarmonyOS NEXT Developer Beta2 | |
ArkTS | 必须适配 | HarmonyOS NEXT Developer Beta2 | |
ArkTS | 必须适配 | HarmonyOS NEXT Developer Beta2 | |
ArkUI | 建议适配 | HarmonyOS NEXT Developer Beta2 | |
ArkUI | 必须适配 | HarmonyOS NEXT Developer Beta2 | |
ArkUI | @ohos.arkui.advanced.SubHeader删除SymbolRenderingStrategy和SymbolEffectStrategy | 必须适配 | HarmonyOS NEXT Developer Beta2 |
ArkUI | 无需适配 | HarmonyOS NEXT Developer Beta2 | |
User Authentication Kit | 必须适配 | HarmonyOS NEXT Developer Beta2 |
变更描述 | 历史工程适配建议 | 变更引入版本 |
|---|---|---|
建议适配 | HarmonyOS NEXT Release | |
建议适配 | HarmonyOS NEXT Release | |
| * 该变更在10月17日发布的patch版本引入,对应开发工具DevEco Studio版本为5.0.3.906。 | 建议适配 | HarmonyOS NEXT Release |
无需适配 | HarmonyOS NEXT Developer Beta5 | |
无需适配 | HarmonyOS NEXT Developer Beta5 | |
无需适配 | HarmonyOS NEXT Developer Beta5 | |
建议适配 | HarmonyOS NEXT Developer Beta5 | |
无需适配 | HarmonyOS NEXT Developer Beta5 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
高级组件ComposeListItem右边按钮OperateItem类型为arrow或者arrow+text时,在没有配置action的时候,不需要单独响应点击效果,应显示全局的按压效果 | 无需适配 | HarmonyOS NEXT Developer Beta3 |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
MenuItemGroup嵌套MenuItem且MenuItem设置margin top或者bottom时,布局效果变更 | 无需适配 | HarmonyOS NEXT Developer Beta3 |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
无需适配 | HarmonyOS NEXT Developer Beta3 | |
TextInput、TextArea 设置TextAlign.Center且显示PlaceHolder文字时,光标位置的变更 | 无需适配 | HarmonyOS NEXT Developer Beta2 |
建议适配 | HarmonyOS NEXT Developer Beta2 | |
建议适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 | |
建议适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 | |
建议适配 | HarmonyOS NEXT Developer Beta2 | |
建议适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 | |
无需适配 | HarmonyOS NEXT Developer Beta2 |