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)

说明

1.工程的package.json文件的dependencies字段处理方式如下:
        1.@ohos/hypium:测试框架的依赖,迁移时需要放到oh-package.json5文件的                 devDependencies字段下;
        2.删除@ohos/hvigor和@ohos/hvigor-ohos-plugin字段,无需迁移到oh-package.json5中;
        3.其他依赖可直接复制到oh-package.json5的dependencies字段中。
2.除表格中呈现的字段外,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,完成同步。

原文:使用DevEco Studio高效开发之环境准备_deveco studio怎么配置环境-CSDN博客

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐