社区编辑申请
注册/登录
无需DevEco Studio就能编译OHOS应用
系统 OpenHarmony
在2022年3月31日发布了最新的IDE工具DevEco Studio 3.0 Beta3,出于好奇,就对着文档一步一步,一个文件一个文件的开始手动建立,最后编译成功,分享一下构建过程。

​想了解更多内容,请访问:​

​51CTO和华为官方合作共建的鸿蒙技术社区​

​https://ost.51cto.com​

在2022年3月31日发布了最新的IDE工具DevEco Studio 3.0 Beta3,仔细阅读文档后发现最新OpenHarmony应用的编译构建过程已经公开,对应官方文档:编译构建概述

出于好奇,就对着文档一步一步,一个文件一个文件的开始手动建立,最后编译成功,分享一下构建过程。

成果

工具准备

Node.js:v14.19.1+

最新OpenHarmonySDK包,并解压到一个文件夹中,​​SDK下载地址​​。

SDK目录结构。

|---ets
| \---3.1.5.5
| +---api
| +---build-tools
| | +---ets-loader
| \---component
\---toolchains
\---3.1.5.5
+---configcheck
+---lib
\---syscapcheck

在创建好该目录结构后还需要在ets/js下的./3.1.5.5/build-tools/ets-loader/目录下执行npm install命令

创建工程

1、创建工程目录

为了演示我重新在E盘创建一个新的工程文件夹 BuildTest,然后借助vscode工具创建build-profile.json5、hvigofile.js、package.json这三个配置文件。

build-profile.json5:

注意SDK版本及srcPath配置,签名信息略想看相应配置参考上述官方文档。

{
"app": {
"signingConfigs": [ //工程的签名信息,可包含多个签名信息
],
"compileSdkVersion": 8, //指定OpenHarmony应用/服务编译时的SDK版本
"compatibleSdkVersion": 8, //指定OpenHarmony应用/服务兼容的最低SDK版本
"products": [ //定义构建的产品品类,如通用默认版、付费版、免费版等
{
"name": "default", //定义产品的名称,由开发者自定义
"signingConfig": "debug", //指定当前产品品类对应的签名信息,签名信息需要在signingConfigs中进行定义
}
]
},
"modules": [
{
"name": "entry", //模块名称
"srcPath": "./entry", //标明src目录相对工程根目录的相对路径
"targets": [ //定义构建的产物,由product和各模块定义的targets共同定义
{
"name": "default", //target名称,由各个模块的build-profile.json5中的targets字段定义
"applyToProducts": [ //产品品类名称,由products字段进行定义
"default"
]
}
]
}
]
}

hvigorfile.js:

module.exports = require('@ohos/hvigor-ohos-plugin').legacyAppTasks

package.json:

熟悉npm框架的都应该了解,package.json是npm依赖相的配置文件,我们看看在工程目录下的配置项。

{
"name": "buildtest", //工程名称
"version": "1.0.0", //版本
"ohos": { //ohos
"org": "huawei",
"buildTool": "hvigor",
"directoryLevel": "project"
},
"description": "example description",
"repository": {},
"license": "ISC",
"dependencies": { //依赖项
"hypium": "^1.0.0",
"@ohos/hvigor": "1.0.6",
"@ohos/hvigor-ohos-plugin": "1.0.6"
}
}

配置完工程后,我们创建我们的第一个模块entry。

2、创建模块

在工程目录创建文件夹entry(于上述build-profile.json5的module配置的srcPath保持一致),并添加模块配置文件:build-profile.json5、hvigorfile.js、package.json以及和HarmonyOS一样的src模块目录。

build-profile.json5:

此处省略了Cpp配置,Cpp相关配置参考官方文档。

{
"apiType": 'faMode', //API类型,API 8为FA模型,API 9为Stage模型,不需要修改
"showInServiceCenter": true, //是否在服务中心露出
"buildOption": {
"arkEnable": true, //是否使用方舟编译器进行编译
},
"targets": [ //模块对应的产物配置
{
"name": "default",
}
]
}

hvigorfile.js:

module.exports = require('@ohos/hvigor-ohos-plugin').legacyHapTasks

大家来找茬,此处配置乍一看和工程下的hvigorfile.js一个样,其实require引入的模块却不相同,工程目录是legacyAppTasks此处是legacyHapTasks(工程是AppTasks模块是HapTasks)。

我就因为此处配置问题浪费了十几分钟。

package.json:

此处的npm配置文件则是模块中引用第三方组件/插件配置处。

{
"license": "ISC",
"name": "entry",
"ohos": {
"org": "huawei",
"directoryLevel": "module",
"buildTool": "hvigor"
},
"description": "example description",
"repository": {},
"version": "1.0.0",
"dependencies": {}
}

再在src目录下建立src/main/config.json、src/main/ets/app.ets、src/main/ets/pages/index.ets、src/resources/…等对应文件。此处省略,具体参考对应文件结构及文件。

3、构建

(1)添加npm源

必须先添加harmonyOS的npm源,否则执行npm install 会报404错误。

npm config set @ohos:registry=https://repo.harmonyos.com/npm/

(2)在工程目录安装依赖

在工程目录(根目录)下安装依赖。

npm install

(3)执行构建命令

在工程目录执行构建命令。

构建是通过node.js调用hvigor工具进行打包构建。

确保node已添加在系统环境变量中。

node ./node_modules/@ohos/hvigor/bin/hvigor.js -m module assembleHap

不出意外会出现以下错误:

PS E:\BuildTest> node ./node_modules/@ohos/hvigor/bin/hvigor.js -m module assembleHap
> hvigor ERROR: A problem occurred in root module:
ERROR: Cause: Can not find sdk.dir or OHOS_SDK_HOME in System Environment Path
at E:\BuildTest\local.properties:1:1
PS E:\BuildTest>

以上原因是我们没有配置SDK路径。

处理方式为:

在项目根路径创建 local.properties文件 或者在系统环境变量中配置OHOS_SDK_HOME,注意是系统环境变量不是用户环境变量。

local.properties:

sdk.dir= //sdk所在文件夹
nodejs.dir=//nodejs所在文件夹

复制配置好后再重新执行构建命令就能看到我们构建成功的结果了。

结语

做了这么多步骤,那么有什么实际意义尼?

1.目前openharmony和HarmonyOS在UI上是共通的,只是API上不同。那么就能将HarmonyOS的UI直接拿到Openharmony上使用,直接打包构建openharmony的HAP

2.再加工一下可以像vue-cli那样直接创建出项目目录,如果能再实现preview功能,就可以实现无需依赖IDE就能开发打包HAP。

3.有机会自己自定义一个IDE出来,将上述过程黑盒化,想自己做IDE的朋友这一步肯定不能少。

​想了解更多内容,请访问:​

​51CTO和华为官方合作共建的鸿蒙技术社区​

​https://ost.51cto.com​


责任编辑:jianghua 来源: 鸿蒙社区
相关推荐

2022-04-18 10:37:01

鸿蒙操作系统开发工具

2022-06-16 07:32:38

VSCodePython插件

2022-05-30 15:21:27

Hi3861TCP通信

2022-05-11 15:08:52

驱动开发系统移植

2022-06-14 07:22:53

MakefileConfigKconfig

2022-06-09 09:20:40

Linux语言编写代码

2022-06-09 14:40:14

系统移植鸿蒙

2022-04-02 20:45:04

Hi3516开发板操作系统鸿蒙

2022-06-06 00:25:09

Golangpanic死锁

2022-06-06 15:18:41

开源GiteaDrone

2022-06-07 14:15:44

Vue开发工具

2022-05-23 10:26:50

Node.jsJavaScrip

2022-04-07 15:28:16

HarmonyOS鸿蒙操作系统

2022-04-20 10:56:06

JavaJVM参数

2022-02-24 16:15:16

OpenHarmon鸿蒙OpenEuler

2022-04-12 12:06:49

智能小车Wi-Fi IoT鸿蒙

2022-01-05 08:00:00

框架Golang开源

2022-04-22 09:05:12

蔚来汽车Flink实时数仓

2022-04-25 09:10:50

RK3568鸿蒙

2022-01-14 09:57:14

同话题下的热门内容

HarmonyOS - HDC命令与ADB命令使用对比OHOS构建自定义服务实战啃论文俱乐部—数据密集型应用内存压缩HarmonyOS - 自定义组件之计时器基于OpenHarmony3.1的购物车应用的实现HarmonyOS - 方舟开发框架ArkUI 流光按钮效果OpenHarmony3.1-Ace-Formcomponent源码解析OpenHarmony HiSysEvent打点调用实践(L2)

编辑推荐

HarmonyOS 2.0鸿蒙第二期开发者Beta公测申请指南HarmonyOS LYEVK-3861开发板播放《蜜雪冰城》鸿蒙HarmonyOS分布式软总线:构建低时延、高带宽的多设备虚拟网络华为HarmonyOS的强势突围: 直面物联网迷宫的蓄力进击鸿蒙HarmonyOS2.0发布会现场回忆录
我收藏的内容
点赞
收藏

51CTO技术栈公众号