npm配置

npm config set @ohos:registry=https://repo.harmonyos.com/npm/

也可手动修改C:\Users\Enlin\.npmrc

+ @ohos:registry=https://repo.harmonyos.com/npm/

项目级

• oh-package.json5

  新增

  {
      "modelVersion": "5.0.0",
  }
  

• 如果报错

  考虑将依赖hypium改为@ohos/hypium

• hvigorfile.ts

  import { appTasks } from '@ohos/hvigor-ohos-plugin';
  
  export default {
      system: appTasks,  /* Built-in plugin of Hvigor. It cannot be modified. */
      plugins:[]         /* Custom plugin to extend the functionality of Hvigor. */
  }
  

• build-profile.json5

  将原本app下面的compileSdkVersion和compatibleSdkVersion移入到app.products下，并将number值改为string类型；SDK版本

  {
      "app": {
  -    	"compileSdkVersion": 9,
  -		"compatibleSdkVersion": 9,
      "signingConfigs": [],
      "products": [
        {
  +        "name": "default",						// 对应ide编辑区域上方的product（准星标志）里的名称Product名称
  +        "signingConfig": "default",
  +        "compileSdkVersion": "5.0.0(12)",       // 指定HarmonyOS应用/服务编译时的版本
  +        "compatibleSdkVersion": "4.0.0(10)",    // 指定HarmonyOS应用/服务兼容的最低版本
  +        "targetSdkVersion": "5.0.0(12)",        // 指定HarmonyOS应用/服务目标版本。若没有设置，默认为compatibleSdkVersion
  +        "runtimeOS": "HarmonyOS",               // 指定为HarmonyOS/OpenHarmony
        }
      ]
    },
    // ...
  }
  

  同时删掉所有模块级build-profile.json5文件中target字段下的runtimeOS属性

• hvigorfile.ts

  import { hapTasks } from '@ohos/hvigor-ohos-plugin';
  
  export default {
      system: hapTasks,  /* Built-in plugin of Hvigor. It cannot be modified. */
      plugins:[]         /* Custom plugin to extend the functionality of Hvigor. */
  }
  

• hvigor/hvigor-config.json5

  将内容覆盖为如下，原本的依赖放到dependencies下面

  {
    "modelVersion": "5.0.0",
    "dependencies": {
    },
    "execution": {
      // "analyze": "normal",                     /* Define the build analyze mode. Value: [ "normal" | "advanced" | false ]. Default: "normal" */
      // "daemon": true,                          /* Enable daemon compilation. Value: [ true | false ]. Default: true */
      // "incremental": true,                     /* Enable incremental compilation. Value: [ true | false ]. Default: true */
      // "parallel": true,                        /* Enable parallel compilation. Value: [ true | false ]. Default: true */
      // "typeCheck": false,                      /* Enable typeCheck. Value: [ true | false ]. Default: false */
    },
    "logging": {
      // "level": "info"                          /* Define the log level. Value: [ "debug" | "info" | "warn" | "error" ]. Default: "info" */
    },
    "debugging": {
      // "stacktrace": false                      /* Disable stacktrace compilation. Value: [ true | false ]. Default: false */
    },
    "nodeOptions": {
      // "maxOldSpaceSize": 8192                  /* Enable nodeOptions maxOldSpaceSize compilation. Unit M. Used for the daemon process. Default: 8192*/
      // "exposeGC": true                         /* Enable to trigger garbage collection explicitly. Default: true*/
    }
  }
  
  

模块级

• 新增 ``reason和usedScene`

  "requestPermissions": [
    {
      "name": "ohos.permission.READ_IMAGEVIDEO",
      "reason": "$string:module_desc",
      "usedScene": {
        "abilities": [
          "EntryAbility"
        ],
        "when": "inuse"
      }
    }
  ]
  

build-profile.json5

oh-package.json5

可以鼠标左键单击某个属性查看解释

module.json5

需要查看官方文档

SDK版本

5.0.0(12)

4.1.0(11)

4.0.0(10)

一体化工程迁移

更新时间: 2024-06-25 10:42

一体化工程迁移-工程转换及迁移-工程管理-DevEco Studio | 华为开发者联盟 (huawei.com)

DevEco Studio从NEXT Developer Beta1版本开始，提供开箱即用的开发体验，将SDK、Node.js、Hvigor、OHPM等工具链进行合一打包，简化DevEco Studio安装配置流程；并提供一体化的历史工程迁移能力，帮助开发者快速完成工程转换。

注意

为了避免数据丢失，迁移前请对工程进行备份。

本次一体化变更点如下：

自动迁移

1. 打开历史工程，Notifications通知栏将出现“Sync failed.”同步失败提示，点击Migrate Assistant，进入迁移助手页面。

   说明

   可以通过菜单栏Tools > Migrate Assistant，进入迁移助手页面。

2. 在页面下方的Migrate Assistant页签中选择迁移到5.0.0，并点击Migrate按钮，此时将出现弹窗提示开发者进行数据备份。若确认已完成备份，请点击弹窗中Migrate，启动迁移任务。

3. 待工程重新完成同步，并无其他报错提示，即为迁移成功。

说明

若您的工程是NPM管理的API 8/9工程，请先按照适配OHPM包管理完成升级，再通过菜单栏Tools > Migrate Assistant，进入迁移助手页面，完成一体化工程自动迁移。

手动迁移

API 10及以上历史工程迁移

如自动化迁移不成功或希望进行手动迁移，迁移前同样需对工程进行备份。手动迁移流程如下：

1. 进入工程级build-profile.json5文件，删除compileSdkVersion配置。若工程为Openharmony工程，则无需删除compileSdkVersion字段。

2. 删除并修改Hvigor相关文件：

   1. 在左侧工程目录中删除

      hvigorw、hvigorw.bat

      文件，并删除hvigor目录下的

      hvigor-wrapper.js

      文件。

   2. 进入

      hvigor > hvigor-config.json5

      文件中，新增

      modelVersion

      字段，其值为"5.0.0"。并删除

      hvigorVersion

      字段、dependencies中的

      @ohos/hvigor-ohos-plugin

      和

      rollup

      字段（如有）

      。

3. 在工程级oh-package.json5文件中同样也需新增modelVersion字段，其值为"5.0.0"。

4. 在local.properties文件中，删除HarmonyOS SDK配置。若工程为Openharmony工程，则无需执行此步骤。

5. 点击编辑界面上方Sync now或进入菜单栏点击File > Sync and Refresh Project，重新进行工程同步。若无其他报错，至此历史工程手动迁移完成。

API 9历史工程迁移

1. 将工程级build-profile.json5文件中compileSdkVersion字段删除，并将compatibleSdkVersion字段从app字段下迁移到当前选中的product中。当前生效的product可以通过点击编辑区域右上方图标进行查看。

2. 请将compatibleSdkVersion和targetSdkVersion（若已配置）从9改为4.0.0(10)，并配置runtimeOS。版本号需满足M.S.F(X)规则的字符串类型，使用英文.和()。

   {
     "app":
     {
       "signingConfigs": [],
       "products": [
         {
           "name": "default",
           "signingConfig": "default",
           "compatibleSdkVersion": "4.0.0(10)", //指定HarmonyOS应用/服务兼容的最低版本。  
           "targetSdkVersion": "4.0.0(10)", //指定HarmonyOS应用/服务目标版本。若没有设置，默认为compatibleSdkVersion
           "runtimeOS": "HarmonyOS",//指定为HarmonyOS    
         }  
       ],  
       // ...
     }
   }
   

3. 将其他各模块级别的build-profile.json5文件中target字段下配置的runtimeOS删除。

4. 继续参考步骤二，完成余下手动迁移步骤。

说明

• 一键升级只针对当前选择的product生效。
• 如有多个product，需要分别切换不同product后，按照手动升级的方式对工程进行升级。每一个product下都需要配置相应的compatibleSdkVersion和runtimeOS。
• 针对API 8/9 NPM工程，请先按照适配OHPM包管理完成升级，再按照API 9历史工程迁移完成手动迁移配置。
• 从DevEco Studio 4.0 Release版本开始，代码编辑器及编译构建过程增强了对ArkTS语法规范的检查，如果历史工程中存在不符合ArkTS语法规范的代码，在迁移完成后可能会报错，需根据具体报错信息修正不符合ArkTS语法规范的代码。
• 如果历史工程包含低代码方式开发的界面，在迁移完成后，需要将这部分低代码开发的界面转换为ArkTS代码，并修正相关报错后才可以正常编译。代码转换操作会删除visual文件及其父目录，且为不可逆过程，代码转换后不能通过ets文件反向生成visual文件。