鸿蒙应用开发之环境搭建
一、环境搭建
正所谓“工欲善其事，必先利其器”。在正式学习一门课程之前，我们首先需要做的就是搭建开发环境。首先，我们需要下载DevEco Studio，DevEco Studio支持Windows系统和macOS系统，在开发HarmonyOS应用/服务前，需要配置HarmonyOS应用/服务的开发环境。环境配置流程如下所示：
二、版本更新
对于之前已经安装好了老版本IDE的情况，HUAWEI DevEco Studio提供了版本检查和一键更新的能力，当新版本上线后，老版本的右下角会弹出版本更新的提示，开发者可以按版本更新提示进行IDE的升级更新，以便获取最新的能力。
在更新页面中，开发者可以看到每个版本更新的新功能和增强功能的具体介绍，以便了解新版本IDE带来的优化升级。
三、环境诊断工具
环境搭建完成后，大家最为关心的就是这个环境是否都正确配置好了呢？为了您开发应用/服务的良好体验，DevEco Studio提供了开发环境诊断的功能，帮助您识别开发环境是否完备。您可以在欢迎界面单击【Help】 > 【Diagnose Development Environment】 进行诊断。如果您已经打开了工程开发界面，也可以在菜单栏单击【Help】 > 【Diagnostic Tools】 >【Diagnose Development Environment进 】 行诊断。
如果检查结果都是√，表示环境搭建正常，如下图所示：
DevEco Studio开发环境诊断项包括电脑的配置、网络的连通情况、依赖的工具或SDK等。如果检测结果为未通过，请根据检查项的描述和修复建议进行处理。
四、新老工程迁移
OHPM CLI（OpenHarmony Package Manager Command-line Interface） 作为鸿蒙生态三方库的包管理工具，支持OpenHarmony共享包的发布、安装和依赖管理。在DevEco Studio 3.1 beta2上新建API 9及以上版本的工程将使用ohpm作为默认包管理器。
使用DevEco Studio 3.1 beta2版本打开API 9的历史工程时，需要进行历史工程迁移。开发者可选择自动化工程迁移，或根据提示选择手动迁移。
4.1 自动化迁移
1，打开API 9历史工程，在右侧Notifications会出现Sync Failed，点击Actions，选择Start automatic configuration migration进入自动化迁移。
2，在弹窗中点击Migrate启动自动化迁移。
若自动化迁移失败，请参考下方手动迁移来完成迁移操作。
4.2 手动迁移
历史工程（API ≥9）在DevEco Studio 3.1 Beta2下使用时，需要对工程进行迁移，迁移前对工程进行备份。迁移流程如下：
- 迁移配置文件将工程和模块下npm包管理相关配置文件package.json或.npmrc，迁移为oh-package.json5或.ohpmrc文件。
- 新增编译构建相关文件在工程中新增hvigor相关的wrapper文件，包括hvigorw、hvigorw.bat、hvigor-config.json5、hvigor-wrapper.js配置文件。
- 删除不再使用的npm包管理文件包含package.json、package-lock.json、.npmrc、node_modules，工程和模块级别下均需进行删除处理。
迁移过程中需要注意以下几点：
1，在工程/模块级别中，涉及package.json或.npmrc的配置文件处，创建相同目录层级的oh-package.json5或.ohpmrc文件。
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） |
表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，完成同步。
