DevEco Studio 一体化工程迁移指南

1. 一体化工程迁移

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

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

一体化变更点如下：

变更点	详细说明
删除 compileSdkVersion 字段	删除工程级 build-profile.json5 中的 compileSdkVersion 配置。 说明： - 由于 targetSdkVersion 未配置时值默认与 compileSdkVersion 的值一致，如果之前未配置 targetSdkVersion，targetSdkVersion 的值将与配套的 SDK 版本保持一致；如果之前配置过 targetSdkVersion，targetSdkVersion 的值不变。 - 若工程为 OpenHarmony 工程，则无需执行此步骤。
删除部分 hvigor 文件 & 删除冗余 hvigor 配置	1. 删除 hvigor-wrapper.json。 2. 删除 hvigorw、hvigorw.bat。 3. 删除 hvigor-config.json5 中的 hvigorVersion 字段，并删除 dependencies 中 @ohos/hvigor-ohos-plugin 及 rollup 字段。
删除 HarmonyOS SDK 配置	删除 local.properties 中的 HarmonyOS SDK 配置。若工程为 OpenHarmony 工程，则忽略此步骤。
增加开发态配置	1. 在 hvigor-config.json5 中增加开发态配置版本号 modelVersion。 2. 在工程级的 oh-package.json5 中增加开发态配置版本号 modelVersion。

1.1 自动迁移

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

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

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

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