DevEco Studio从NEXT Developer Beta3版本开始,提供开箱即用的开发体验,将SDK、Node.js、Hvigor、OHPM等工具链进行合一打包,简化DevEco Studio安装配置流程;并提供一体化的历史工程迁移能力,帮助开发者快速完成工程转换。
注意
为了避免数据丢失,迁移前请对工程进行备份。
本次一体化变更点如下:
变更点 | 详细说明 |
---|---|
删除compileSdkVersion字段 | 删除工程级build-profile.json5中的compileSdkVersion配置。编译所用的SDK版本即为配套的SDK版本。 说明
|
删除部分hvigor文件 & 删除冗余hvigor配置 |
|
删除HarmonyOS SDK配置 | 删除local.properties中的HarmonyOS SDK配置。若工程为Openharmony工程,则忽略此步骤。 |
增加开发态配置 |
|
自动迁移
- 打开历史工程,Notifications通知栏将出现“Sync failed.”同步失败提示,点击Migrate Assistant,进入迁移助手页面。
说明
可以通过菜单栏Tools > Migrate Assistant,进入迁移助手页面。
- 在页面下方的Migrate Assistant页签中选择迁移到5.0.0,并点击Migrate按钮,此时将出现弹窗提示开发者进行数据备份。若确认已完成备份,请点击弹窗中Migrate,启动迁移任务。
- 待工程重新完成同步,并无其他报错提示,即为迁移成功。
说明
若您的工程是NPM管理的API 8/9工程,请先按照适配OHPM包管理完成升级,再通过菜单栏Tools > Migrate Assistant,进入迁移助手页面,完成一体化工程自动迁移。
手动迁移
API 10及以上历史工程迁移
如自动化迁移不成功或希望进行手动迁移,迁移前同样需对工程进行备份。手动迁移流程如下:
- 进入工程级build-profile.json5文件,删除compileSdkVersion配置。若工程为Openharmony工程,则无需删除compileSdkVersion字段。
- 删除并修改Hvigor相关文件:
- 在左侧工程目录中删除hvigorw、hvigorw.bat文件,并删除hvigor目录下的hvigor-wrapper.js文件。
- 进入hvigor > hvigor-config.json5文件中,新增modelVersion字段,其值为"5.0.0"。并删除hvigorVersion字段、dependencies中的@ohos/hvigor-ohos-plugin和rollup字段(如有)。
- 在左侧工程目录中删除hvigorw、hvigorw.bat文件,并删除hvigor目录下的hvigor-wrapper.js文件。
- 在工程级oh-package.json5文件中同样也需新增modelVersion字段,其值为"5.0.0"。
- 在local.properties文件中,删除HarmonyOS SDK配置。若工程为Openharmony工程,则无需执行此步骤。
- 点击编辑界面上方Sync now或进入菜单栏点击File > Sync and Refresh Project,重新进行工程同步。若无其他报错,至此历史工程手动迁移完成。
API 9历史工程迁移
- 将工程级build-profile.json5文件中compileSdkVersion字段删除,并将compatibleSdkVersion字段从app字段下迁移到当前选中的product中。当前生效的product可以通过点击编辑区域右上方图标进行查看。
- 请将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 } ], ... }
- 将其他各模块级别的build-profile.json5文件中target字段下配置的runtimeOS删除。
- 继续参考步骤二,完成余下手动迁移步骤。
说明
- 一键升级只针对当前选择的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文件。
最后呢
很多开发朋友不知道需要学习那些鸿蒙技术?鸿蒙开发岗位需要掌握那些核心技术点?为此鸿蒙的开发学习必须要系统性的进行。
而网上有关鸿蒙的开发资料非常的少,假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料,少走很多弯路,节省没必要的麻烦。
如果你是一名Android、Java、前端等等开发人员,想要转入鸿蒙方向发展。可以点击→【纯血版鸿蒙全套最新学习资料】希望这一份鸿蒙学习资料能够给大家带来帮助~
鸿蒙(HarmonyOS NEXT)最新学习路线
该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发,不仅补充了华为官网未涉及的解决方案
路线图适合人群:
IT开发人员:想要拓展职业边界
零基础小白:鸿蒙爱好者,希望从0到1学习,增加一项技能。
技术提升/进阶跳槽:发展瓶颈期,提升职场竞争力,快速掌握鸿蒙技术
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
2.视频学习资料+学习PDF文档
这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、(南向驱动、嵌入式等)鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
HarmonyOS Next 最新全套视频教程
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
《鸿蒙开发进阶》
《鸿蒙进阶实战》
大厂面试必问面试题
鸿蒙南向开发技术
鸿蒙APP开发必备
请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结
总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,才能在这个变革的时代中立于不败之地。