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:

  1. Upgrade hvigor modelVersion from 5.0.0 to 6.0.0
  2. 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

2 回复

在HarmonyOS Next中,应用从鸿蒙5升级到鸿蒙6需使用DevEco Studio最新版本。打开项目后,更新SDK至鸿蒙6版本,修改项目配置文件中的compileSdkVersioncompatibleSdkVersion为对应API级别。检查并替换废弃API,确保依赖库兼容鸿蒙6。重新编译构建即可生成适配版本。

更多关于HarmonyOS鸿蒙Next中如何将鸿蒙5应用升级到鸿蒙6的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


要将鸿蒙5应用升级到鸿蒙6,主要涉及三个关键步骤:

  1. 设置targetSdkVersion:在build-profile.json5文件中,将targetSdkVersion从"5.0.0(12)“修改为"6.0.0(20)”,确保compatibleSdkVersion保持为"5.0.0(12)"以维持向下兼容性。

  2. 升级modelVersion:使用DevEco Studio的Migrate Assistant工具,自动将hvigor和ohpm的modelVersion从5.0.0升级到6.0.0。oh-package.json5文件中的modelVersion也会相应更新。

  3. 代码整改:升级后需关注编译日志,鸿蒙6的ArkTS语法规则更严格,常见问题包括需要添加判空处理、明确类型指定等。根据控制台报错提示逐一修复。

建议在升级前备份项目,升级后充分测试应用功能。参考提供的视频和文档可获取更详细的操作演示。

回到顶部