HarmonyOS鸿蒙Next中如何将鸿蒙5应用升级到鸿蒙6
HarmonyOS鸿蒙Next中如何将鸿蒙5应用升级到鸿蒙6
设置 targetSdkVersion
点第二项。
build-profile.json5改为了如下:
{
"app": {
"signingConfigs": [],
"products": [
{
"name": "default",
"signingConfig": "default",
"compatibleSdkVersion": "5.0.0(12)",
"runtimeOS": "HarmonyOS",
"buildOption": {
"strictMode": {
"caseSensitiveCheck": true
}
},
"targetSdkVersion": "6.0.0(20)"
}
],
"buildModeSet": [
{
"name": "debug",
},
{
"name": "release"
}
]
},
"modules": [
{
"name": "entry",
"srcPath": "./entry",
"targets": [
{
"name": "default",
"applyToProducts": [
"default"
]
}
]
}
]
}
升级 modelVersion
点击Migrate Assistant,会自动做如下更改:
To start migration, select the version to which you want to migrate this project (in both hvigor and ohpm) and click Migrate.
This migration will lead to the following changes:
- Upgrade hvigor modelVersion from 5.0.0 to 6.0.0
- Upgrade ohpm modelVersion from 5.0.0 to 6.0.0
点击Migrate
oh-package.json5会自动改为了如下:
{
"modelVersion": "6.0.0",
"description": "Please describe the basic information.",
"dependencies": {
},
"devDependencies": {
"@ohos/hypium": "1.0.19",
"@ohos/hamock": "1.0.0"
}
}
代码整改
查看编译情况,关注控制台日志。如果有报错,根据提示进行整改。
常见的问题是,鸿蒙6的ArkTS语言语法规则更加严格, 因此,需要做一些判空处理或者是类型指定等。
视频演示
详见B站:https://www.bilibili.com/video/BV1yBHwzDEkK/
参考引用
• 本文同步至:https://waylau.com/upgrade-harmonyos-app-version-from-5-to-6/
• 源码见《跟老卫学HarmonyOS开发》开源免费教程, https://github.com/waylau/harmonyos-tutorial
• 《跟老卫学AI大模型开发》开源免费教程, https://github.com/waylau/ai-large-model-tutorial/
• 《跟老卫学仓颉编程语言开发》开源免费教程, https://github.com/waylau/cangjie-programming-language-tutorial
• 《鸿蒙HarmonyOS手机应用开发实战》(清华大学出版社)
• 《鸿蒙HarmonyOS应用开发入门》(清华大学出版社)
• “鸿蒙零基础快速实战-仿抖音App开发(ArkTS版)”(https://coding.imooc.com/class/843.html)
• 《鸿蒙HarmonyOS应用开发从入门到精通(第2版)》(北京大学出版社)
• 《鸿蒙之光HarmonyOS NEXT原生应用开发入门》(清华大学出版社)
• “HarmonyOS NEXT+AI大模型打造智能助手APP(仓颉版)”(https://coding.imooc.com/class/927.html)
更多关于HarmonyOS鸿蒙Next中如何将鸿蒙5应用升级到鸿蒙6的实战教程也可以访问 https://www.itying.com/category-93-b0.html
在HarmonyOS Next中,应用从鸿蒙5升级到鸿蒙6需使用DevEco Studio最新版本。打开项目后,更新SDK至鸿蒙6版本,修改项目配置文件中的compileSdkVersion
和compatibleSdkVersion
为对应API级别。检查并替换废弃API,确保依赖库兼容鸿蒙6。重新编译构建即可生成适配版本。
更多关于HarmonyOS鸿蒙Next中如何将鸿蒙5应用升级到鸿蒙6的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html
要将鸿蒙5应用升级到鸿蒙6,主要涉及三个关键步骤:
-
设置targetSdkVersion:在build-profile.json5文件中,将targetSdkVersion从"5.0.0(12)“修改为"6.0.0(20)”,确保compatibleSdkVersion保持为"5.0.0(12)"以维持向下兼容性。
-
升级modelVersion:使用DevEco Studio的Migrate Assistant工具,自动将hvigor和ohpm的modelVersion从5.0.0升级到6.0.0。oh-package.json5文件中的modelVersion也会相应更新。
-
代码整改:升级后需关注编译日志,鸿蒙6的ArkTS语法规则更严格,常见问题包括需要添加判空处理、明确类型指定等。根据控制台报错提示逐一修复。
建议在升级前备份项目,升级后充分测试应用功能。参考提供的视频和文档可获取更详细的操作演示。