2026年4月20日,HarmonyOS 6.1.0 Release正式发布,同时,DevEco Studio 6.1.0 Release版本也同步发布,标志着以API 23为核心的HarmonyOS全套开发套件(含SDK及开发工具DevEco Studio)均达到Release状态并正式发布。开发者可基于Release状态的开发套件进行HarmonyOS 6应用开发。HarmonyOS 6.1.0 Release版本操作系统也将陆续推送到各型号手机。

本文总结从HarmonyOS 6.0升级至6.1改动点。

鸿蒙生态现状

鸿蒙生态也在加速演进。2026年3月,华为终端BG首席执行官何刚宣布,HarmonyOS系统日均新增设备数突破15万,可获取应用、服务突破35万,注册开发者超过1000万,鸿蒙原生应用已经有3万多个。

截至2026年4月20日,华为宣布支持HarmonyOS 6终端设备数量突破5500万,华为Pura双旗舰登场,首发搭载HarmonyOS 6.1。

可以预见,鸿蒙生态正在高速发展期,希望各位开发者把握时代红利,加入鸿蒙生态,共建万物互联。以下是鸿蒙应用开发常用教程。

升级至6.1改动点

如果之前是用HarmonyOS 6.0开发的鸿蒙应用,那么升级至6.1可以说是无缝迁移。主要改动点如下:

1. AppScope/app.json5

新增了buildVersion配置。配置示例如下:

{
  "app": {
    "bundleName": "com.waylau.hmos.arktshelloworld",
    "vendor": "example",
    "versionCode": 1000000,
    "versionName": "1.0.0",
    "buildVersion": "1",
    "icon": "$media:layered_image",
    "label": "$string:app_name"
  }
}

2. build-profile.json5

"targetSdkVersion": "6.0.0(20)",
"compatibleSdkVersion": "6.0.0(20)",

改为了

"targetSdkVersion": "6.1.0(23)",
"compatibleSdkVersion": "6.1.0(23)",

3. entry/obfuscation-rules.txt

#   https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/source-obfuscation-V5

改为了

#   https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/source-obfuscation

4. entry/src/main/ets/pages/Index.ets

去除了23行的空行。

5. hvigor/hvigor-config.json5

"modelVersion": "6.0.0",

改为了

"modelVersion": "6.1.0",

6. oh-package-lock.json5

{
  "meta": {
    "stableOrder": true,
    "enableUnifiedLockfile": false
  },
  "lockfileVersion": 3,
  "ATTENTION": "THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.",
  "specifiers": {
    "@ohos/[email protected]": "@ohos/[email protected]",
    "@ohos/[email protected]": "@ohos/[email protected]"
  },
  "packages": {
    "@ohos/[email protected]": {
      "name": "",
      "version": "1.0.0",
      "integrity": "sha512-K6lDPYc6VkKe6ZBNQa9aoG+ZZMiwqfcR/7yAVFSUGIuOAhPvCJAo9+t1fZnpe0dBRBPxj2bxPPbKh69VuyAtDg==",
      "resolved": "https://ohpm.openharmony.cn/ohpm/@ohos/hamock/-/hamock-1.0.0.har",
      "registryType": "ohpm"
    },
    "@ohos/[email protected]": {
      "name": "@ohos/hypium",
      "version": "1.0.24",
      "integrity": "sha512-3dCqc+BAR5LqEGG2Vtzi8O3r7ci/3fYU+FWjwvUobbfko7DUnXGOccaror0yYuUhJfXzFK0aZNMGSnXaTwEnbw==",
      "resolved": "https://ohpm.openharmony.cn/ohpm/@ohos/hypium/-/hypium-1.0.24.har",
      "registryType": "ohpm"
    }
  }
}

改为了

{
  "meta": {
    "stableOrder": true,
    "enableUnifiedLockfile": false
  },
  "lockfileVersion": 3,
  "ATTENTION": "THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.",
  "specifiers": {
    "@ohos/[email protected]": "@ohos/[email protected]",
    "@ohos/[email protected]": "@ohos/[email protected]"
  },
  "packages": {
    "@ohos/[email protected]": {
      "name": "@ohos/hamock",
      "version": "1.0.0",
      "integrity": "sha512-K6lDPYc6VkKe6ZBNQa9aoG+ZZMiwqfcR/7yAVFSUGIuOAhPvCJAo9+t1fZnpe0dBRBPxj2bxPPbKh69VuyAtDg==",
      "resolved": "https://ohpm.openharmony.cn/ohpm/@ohos/hamock/-/hamock-1.0.0.har",
      "registryType": "ohpm"
    },
    "@ohos/[email protected]": {
      "name": "@ohos/hypium",
      "version": "1.0.25",
      "integrity": "sha512-l6uO2pjl8HyEKdekLqQt7tUpWbDqX/42zoAzkagtUVZAW9jT6lMvbe54MVjoLxq/RwQGygRvi6j4GpypSMFSHw==",
      "resolved": "https://ohpm.openharmony.cn/ohpm/@ohos/hypium/-/hypium-1.0.25.har",
      "registryType": "ohpm"
    }
  }
}

7. oh-package.json5

{
  "modelVersion": "6.0.0",
  "description": "Please describe the basic information.",
  "dependencies": {
  },
  "devDependencies": {
    "@ohos/hypium": "1.0.24",
    "@ohos/hamock": "1.0.0"
  }
}

改为了

{
  "modelVersion": "6.1.0",
  "description": "Please describe the basic information.",
  "dependencies": {
  },
  "devDependencies": {
    "@ohos/hypium": "1.0.25",
    "@ohos/hamock": "1.0.0"
  }
}

参考引用