鸿蒙开发模式：多工程构建

原创于 2026-07-17 06:45:00 发布 · 199 阅读

5 ·

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

GEO检测

收录于

鸿蒙

在大型应用开发中，多个团队协作开发是常见场景。鸿蒙提供了多工程开发模式，支持将大型应用拆分为多个模块，每个模块对应一个单独工程，提高协作开发效率。

一、多工程构建

为降低大型应用多个团队协作开发的复杂度，提供多工程开发模式。

特点	说明
拆分方式	将大型应用拆分为多个模块，每个模块对应一个单独工程
编译方式	在每个工程分别编译生成HAP
统一打包	多个HAP统一打包生成一个APP，用于上架应用市场

二、配置步骤

2.1 配置multiProjects

分别在每个工程的工程级build-profile.json5配置文件中，设置multiProjects字段值为true。

{
  "app": {
    "multiProjects": true
  }
}

2.2 准备打包工具

准备好HAP打包工具app_packing_tool.jar，位于：

$DevEco Studio安装目录/sdk/default/openharmony/toolchains/lib

三、打包命令

命令格式

在HAP打包工具目录下，执行以下命令将多个HAP进行打包：

java -jar app_packing_tool.jar --mode multiApp --hap-list <HAP文件列表> --out-path <APP输出路径>

参数说明

参数	说明
`--mode multiApp`	指定打包模式为多应用打包
`--hap-list`	多个HAP文件路径，用逗号隔开
`--out-path`	生成的APP文件路径

使用示例

java -jar app_packing_tool.jar \
  --mode multiApp \
  --hap-list D:\\project\\MyApplication\\1.hap,D:\\project\\MyApplication1\\2.hap \
  --out-path D:\\project\\final.app

四、核心点

要点	说明
配置字段	build-profile.json5中app.multiProjects = true
打包工具	app_packing_tool.jar（位于toolchains/lib）
打包模式	--mode multiApp
参数	--hap-list（逗号分隔多个HAP）、--out-path（APP路径）

多工程构建流程

工程A → 编译 → 1.hap
工程B → 编译 → 2.hap
    ↓
app_packing_tool.jar --mode multiApp
    ↓
统一打包 → final.app
    ↓
上架应用市场

鸿蒙多工程构建通过在build-profile.json5中配置app.multiProjects: true，分别编译各工程生成HAP后，使用app_packing_tool.jar的multiApp模式统一打包生成APP。

标签

#harmonyos #多工程构建 #multiProjects