5.0.3.800 版本更新说明:
SDK路径变更
升级到DevEco Studio NEXT Beta1(5.0.3.800)版本,SDK路径发生变化,hdc环境变量失效,需根据新的sdk路径重新配置hdc环境变量。
变更影响
旧版本hdc工具路径:DevEco Studio安装目录/sdk/HarmonyOS-NEXT-DBx/openharmony/toolchains
新版本hdc工具路径:DevEco Studio安装目录/sdk/default/openharmony/toolchains
适配指导
请根据新的sdk路径重新配置hdc环境变量。
@security/specified-interface-call-chain-check配置字段变更
Code Linter检查安全规则@security/specified-interface-call-chain-check中,namespace字段配置类型从字符串变更为数组。
适配指导
若应用代码工程根目录code-linter.json5文件中存在该规则时,需要将namespace字段配置类型修改为数组。具体请参考@security/specified-interface-call-chain-check。
编译构建校验增强
升级到DevEco Studio NEXT Beta1(5.0.3.800)版本后,编辑器、编译构建针对上架检测的部分规则增强校验。
变更影响
可能会导致部分历史工程在编辑器报错,编译构建失败。增强校验的检测规则如下:
- module.json5中type为form的ExtensionAbility中的metadata字段不能缺省,也不能是空数组。
- module.json5中type为form的ExtensionAbility中的metadata必须要存在一个name为‘ohos.extension.form’的对象值,且对应的resource值不能缺省。
- module.json5中的requestPermissions字段使用的权限必须为系统已定义好的权限或者definePermissions字段中定义的权限。
适配指导
- 在module.json5中type为form的ExtensionAbility中增加metadata字段,补充一个name为‘ohos.extension.form’的对象值,并配置对应的resource值,具体配置方式参考metadata标签。
- 将module.json5中的requestPermissions字段使用的权限修改为系统已定义好的权限或者definePermissions字段中定义的权限。
默认构建字节码HAR
升级到DevEco Studio NEXT Beta1(5.0.3.800)版本后,默认构建的HAR包产物由源码格式变更为字节码格式。
变更影响
可能导致历史工程编译构建失败:
- 如果工程级build-profile.json5文件的useNormalizedOHMUrl字段为true,则默认将noExternalImportByPath设置为true,即通过相对路径跨模块引用文件时,由warning报错改为error报错。
- 如果工程级build-profile.json5文件的useNormalizedOHMUrl字段为true,当oh-package.json5中依赖的包使用的别名和依赖包的oh-package.json5的name不一致时,由warning报错改为error报错。
适配指导
- 在工程级build-profile.json5文件中添加noExternalImportByPath字段并设置为false。
"buildOption": { "strictMode": { "noExternalImportByPath": false } }
- 将oh-package.json5中依赖的包使用的别名,修改为依赖包的oh-package.json5中的name。