当前位置：首页 > news >正文

鸿蒙开发：hvigorw，编译构建，实现命令打包

news 来源：原创 2025/6/6 8:13:36

前言

本文基于DevEco Studio 5.0.5 Release

上篇文章，我们简单的了解了hvigorw，知道了hvigorw是鸿蒙开发中一个不可缺少的构建利器，除了正常的帮我们执行一些流程化操作之外，hvigorw还担负着一个非常重要的角色，那就是搭建流水线时的编译各个hap、hsp、har以及app的重任，少了它，那么流水线就无法正常运行。

什么是流水线？正常情况下，我们构建一个应用或者元服务，都是通过DevEco Studio开发工具进行操作，常见的就是通过顶部导航栏中Build选项，打出我们最终的上架包，或者hap、har、hsp包。

流水线，就是可以让我们使用命令行工具来调用Hvigor任务进行构建，通过命令行的方式构建应用或元服务，这样做的好处就是，不用再依赖DevEco Studio开发工具，便于我们构筑CI（Continuous Integration）流水线，按照自己的计划时间，自动化的构建HAP/APP、签名、安装运行等操作。

一句话简明扼要，就是可以不用人工再去打包了，可以使用工具进行自动化签名打包。

而且，有了hvigorw，我们可以自建自己的应用下载平台，可以和蒲公英等三方平台一样，进而和Android类似，直接打包给到测试同学，再也不用在测试阶段提交到华为应用市场了。就凭这一点，hvigorw，对于我们而言，就不得不去重视，毕竟华为应用市场有一个审核机制，提交的测试包，因为审核时间，交到测试人员手里，往往没有那么及时，有一个时间差存在，就导致了功能迟迟无法验证，浪费了很多的时间。

如何搭建自己的应用测试平台，后续会给大家一一讲解，这都是后话了，本篇文章，我们还是继续了解hvigorw，重点知晓它的几个命令，方便后续的流水线搭建。

hvigorw常见命令

hvigorw在执行相关命令的时候，需要注意，那就是需要结合品类来去执行，否则会执行失败，那么什么是品类呢？

在根项目中的build-profile.json5文件下的products字段就是品类信息。

clean

clean命令主要是负责清理构建产物build目录，在日后的自动化打包中，我们第一个命令就是执行的它。

执行命令如下：

如果你采用的是DevEco Studio开发工具自带的，那么命令如下：

node + hvigorw.js路径 + -p product=品类名字 clear

首先，node如果你配置了环境变量，就可以这么用，没有，还请补全路径，比如。

如果你采用的是Command Line Tools，并且配置了环境变量，可以直接省去node。

hvigorw + -p product=品类名字 clear

举例如下，这样就完成了clean命令执行。

assembleHar

assembleHar命令主要是构建一个Har包，执行这个命令的时候，你需要指定要构建哪个模块，执行格式如下：

命令操作

DevEco Studio开发工具中：

node + hvigorw.js + --mode module -p product=品类信息 -p module=模块 assembleHar

Command Line Tools

hvigorw + --mode module -p product=品类信息 -p module=模块名 assembleHar

举例如下，这样就完成了Har包生成。

同样的，在针对模块时，无论是静态共享包还是动态共享包，也需要携带上品类信息，也就是模块名@品类信息。

开启Build Analyzer构建分析

如果说你要在构建包的时候，要对静态包进行开启Build Analyzer构建分析，那么我们追加命令，通过--analyze=normal，来实现简单打点数据进行分析。

执行命令如下，在后面追加即可：

在Build中，你就可以进行数据分析了：

执行完命令后，最终会在静态共享包中，生成一个har包，目录如下：

assembleHsp

assembleHsp命令主要是构建一个Hsp包，和静态包一致，无非就是把assembleHar换成assembleHsp，还有就是模块名和品类信息需要切换。

执行完命令后，最终会在动态共享包中，生成一个hsp包，目录如下：

assembleHap

hap类型一般是我们的主模块，也就是type为entry类型的模块，执行assembleHap的命令和上面一致，也是更改为assembleHap即可，但是模块名和品类信息需要切换。

执行完命令后，最终会在主模块中，生成一个hap包，目录如下：

assembleApp

assembleApp和上面的命令有一点区别，上面的命令只是单独生成某一种类型的包，但并不最终的上架包，而最终的上架包都是以.app结尾的；执行assembleApp命令，不用在指定模块，只指定品类信息即可。

执行完之后，就会在项目下产生一个build目录，里面的.app就是我们最终的上架或者测试包。