鸿蒙构建系统：多模块管理

最新推荐文章于 2026-07-18 12:58:41 发布

原创最新推荐文章于 2026-07-18 12:58:41 发布 · 323 阅读

4 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

鸿蒙

一、多模块

模块是应用/元服务的基本功能单元，包含了源代码、资源文件、第三方库及应用/元服务配置文件。Hvigor支持工程多模块管理，可在build-profile.json5配置文件中增加对应模块信息，即可对模块进行工程绑定和管理，或在hvigorconfig.ts脚本中动态添加或排除某个模块。

二、多模块配置

2.1 静态配置模块

工程级build-profile.json5配置文件中的modules字段，用于记录工程下的模块信息。

字段	说明
name	模块名称，需与module.json5中的module.name保持一致
srcPath	模块源码路径（相对工程根目录的相对路径）
targets	模块的target信息，用于定制多目标构建产物

2.2 工程结构示例

工程根目录
├── .hvigor目录                // 构建缓存文件目录
├── hvigor-config.json5        // 构建引擎配置文件
├── build-profile.json5        // 工程级构建配置文件
├── hvigorfile.ts              // 工程级构建动态自定义脚本
├── module1/
│   ├── 模块源码文件
│   ├── build-profile.json5    // 模块级构建配置文件
│   └── hvigorfile.ts          // 模块级构建动态自定义脚本
├── module2/
│   ├── 模块源码文件
│   ├── build-profile.json5
│   └── hvigorfile.ts
└── 其他配置文件
    ├── oh-package.json5       // 三方包依赖配置文件
    ├── local.properties       // 本地环境配置文件
    ├── obfuscation-rules.txt  // 模块混淆规则配置文件
    └── consumer-rules.txt     // HAR/HSP模块导出混淆规则文件

2.3 静态配置示例

{
  "modules": [
    {
      "name": "module1",
      "srcPath": "./module1"
    },
    {
      "name": "module2",
      "srcPath": "./module2"
    }
  ]
}

2.4 动态配置模块

Hvigor支持在hvigorconfig.ts脚本中动态添加或排除某个模块，具体API及示例可参考官方HvigorConfig配置。

三、分模块编译

Hvigor支持分模块编译和打包，可通过以下两种方式进行：

方式	操作
DevEco Studio菜单	选中需构建的模块目录，点击Build → "Make module 'module1'"
命令行	在Terminal中执行命令：`hvigorw --mode module -p product=default -p module=entry@default assembleHap`

命令行参数说明

参数	说明
`--mode module`	指定模块构建模式
`-p product=default`	指定产品名称
`-p module=entry@default`	指定模块名@target名
`assembleHap`	构建HAP包（构建HAR使用`assembleHar`，构建HSP使用`assembleHsp`）

四、其他

4.1 文件说明

文件	作用
工程级build-profile.json5	定义模块信息、应用信息、App构建行为
模块级build-profile.json5	定义当前模块的构建信息、构建行为
hvigorfile.ts	定义和扩展构建流程
oh-package.json5	三方包依赖配置

4.2 分模块构建命令

产物类型	命令
HAP	`hvigorw --mode module -p product=default -p module=entry@default assembleHap`
HAR	`hvigorw --mode module -p product=default -p module=library@default assembleHar`
HSP	`hvigorw --mode module -p product=default -p module=library@default assembleHsp`