使用DevEco Studio高效开发之环境准备

1、环境搭建

在进行本课程的学习之前，首先我们来看一下如何搭建开发环境。你可以参考搭建开发环境这一章节完成环境搭建，也可以参考鸿蒙第一课中DevEco Studio的使用这一课程进行学习。

DevEco Studio支持Windows系统和macOS系统，在开发HarmonyOS应用/服务前，需要配置HarmonyOS应用/服务的开发环境。环境配置流程如下所示：

2、版本更新

对于之前已经安装好了老版本IDE的情况，HUAWEI DevEco Studio提供了版本检查和一键更新的能力，当新版本上线后，老版本的右下角会弹出版本更新的提示，开发者可以按版本更新提示进行IDE的升级更新，以便获取最新的能力。

在更新页面中，开发者可以看到每个版本更新的新功能和增强功能的具体介绍，以便了解新版本IDE带来的优化升级。

3、环境诊断工具

环境搭建完成后，大家最为关心的就是这个环境是否都正确配置好了呢？为了您开发应用/服务的良好体验，DevEco Studio提供了开发环境诊断的功能，帮助您识别开发环境是否完备。您可以在欢迎界面单击Help > Diagnose Development Environment进行诊断。如果您已经打开了工程开发界面，也可以在菜单栏单击Help > Diagnostic Tools > Diagnose Development Environment进行诊断。

如果检查结果都是√，表示环境搭建正常，如下图所示：

DevEco Studio开发环境诊断项包括电脑的配置、网络的连通情况、依赖的工具或SDK等。如果检测结果为未通过，请根据检查项的描述和修复建议进行处理。

4、新老工程迁移

OHPM CLI（OpenHarmony Package Manager Command-line Interface） 作为鸿蒙生态三方库的包管理工具，支持OpenHarmony共享包的发布、安装和依赖管理。在DevEco Studio 3.1 beta2上新建API 9及以上版本的工程将使用ohpm作为默认包管理器。

使用DevEco Studio 3.1 beta2版本打开API 9的历史工程时，需要进行历史工程迁移。开发者可选择自动化工程迁移，或根据提示选择手动迁移。

说明

仅API 9历史工程需进行迁移，API 8及以下版本无需迁移。

自动化迁移

1. 打开API 9历史工程，在右侧Notifications会出现Sync Failed，点击Actions，选择Start automatic configuration migration进入自动化迁移。

   

2. 在弹窗中点击Migrate启动自动化迁移。

   

   若自动化迁移失败，请参考下方手动迁移来完成迁移操作。

   

历史工程手动迁移

历史工程（API ≥9）在DevEco Studio 3.1 Beta2下使用时，需要对工程进行迁移，迁移前对工程进行备份。迁移流程如下：

1. 迁移配置文件

   将工程和模块下npm包管理相关配置文件package.json或.npmrc，迁移为oh-package.json5或.ohpmrc文件。

2. 新增编译构建相关文件

   在工程中新增hvigor相关的wrapper文件，包括hvigorw、hvigorw.bat、hvigor-config.json5、hvigor-wrapper.js配置文件。

3. 删除不再使用的npm包管理文件

   包含package.json、package-lock.json、.npmrc、node_modules，工程和模块级别下均需进行删除处理。

迁移前文件目录	迁移后文件目录

1. 在工程/模块级别中，涉及package.json或.npmrc的配置文件处，创建相同目录层级的oh-package.json5或.ohpmrc文件。

   说明

   若历史工程为C++工程，src>main>cpp目录下包含package.json或.npmrc，需做相同处理。

2. 将历史工程package.json和.npmrc文件中包含的需要迁移的字段，拷贝到对应的oh-package.json5和.ohpmrc文件中。

   表1 oh-package.json5字段及迁移说明

   oh-package.json5包含字段	字段说明	迁移/新增字段	原package.json字段	说明
   name	软件包名称	迁移字段	name	必选字段，若package.json文件中未指明，需在oh-package.json5添加补齐
   version	软件包版本	迁移字段	version	必选字段，若package.json文件中未指明，需在oh-package.json5添加补齐
   description	软件包简介	迁移字段	description	必选字段，若package.json文件中未指明，需在oh-package.json5添加补齐
   keywords	软件包关键字	迁移字段	keywords	-
   homepage	主页链接	迁移字段	homepage	-
   license	开源协议	迁移字段	license	-
   author	软件包作者	迁移字段	author	-
   main	软件包入口	迁移字段	main	-
   repository	仓库地址	迁移字段	repository	-
   dependencies	生产依赖	迁移字段	dependencies	该字段处理方式请参阅下方说明内容
   devDependencies	开发依赖	迁移字段	devDependencies	-
   types	类型定义	迁移字段	types	-
   artifactType	鸿蒙包制品类型	新增字段	-	有三个选项：original、obfuscation、bytecode。 original：源码，即发布源码(.ts/.ets)。 obfuscation：混淆代码，即源码经过混淆之后发布上传。 bytecode：字节码，即源码经过混淆，且把混淆后的代码编译成abc方舟字节码，然后再上传（.abc）

   说明

   • 工程的package.json文件的dependencies字段处理方式如下：
     • @ohos/hypium：测试框架的依赖，迁移时需要放到oh-package.json5文件的devDependencies字段下；
     • 删除@ohos/hvigor和@ohos/hvigor-ohos-plugin字段，无需迁移到oh-package.json5中；
     • 其他依赖可直接复制到oh-package.json5的dependencies字段中。
   • 除表格中呈现的字段外，package.json中其余字段暂不支持迁移。如您在历史工程中使用到其余字段，请反馈您所使用的字段。

   表2 .npmrc文件迁移字段对照及说明

   .npmrc字段	字段释义	.ohpmrc对应字段
   registry	仓库地址	registry
   @${scope}:registry	指定仓库	@${group}:registry
   cache	缓存路径	cache
   noproxy	不使用proxy代理	no_proxy
   proxy	http代理	http_proxy
   https-proxy	https代理	https_proxy
   strict-ssl	ssl校验	strict_ssl
   cafile	ca证书路径	ca_files
   loglevel	日志级别	log_level

3. 工程需要添加ohpm编译构建四件套hvigorw、hvigorw.bat、hvigor-config.json5、hvigor-wrapper.js。可新建一个API 9的新工程，拷贝新工程中hvigorw、hvigorw.bat、hvigor-config.json5、hvigor-wrapper.js四项配置文件，粘贴到历史工程文件夹对应位置。

   

4. 删除工程级别和模块级别下包含的package.json、package-lock.json、.npmrc、node_modules四项配置。

   

5. 点击File>Sync and Refresh Project，完成同步。