Hvigor支持灵活定制构建模式,当您创建新工程时,DevEco Studio会自动创建debug、release和test构建模式。test模式虽然没有出现在工程级build-profile.json5配置文件中,但是用测试框架开启测试时,会自动使用test构建模式。
DevEco Studio支持界面配置Build Mode配置选项,点击右上角
图标选择构建模式:

内置三个选项:<Default>,debug,release。
如果开发者在build-profile.json5文件中,自定义了其他构建模式,Build Mode配置界面会提供对应选项。
hvigorw --mode module -p product=default -p module=entry@default -p buildMode=release assembleHap
hvigorw --mode module -p product=default -p module=entry@default -p debuggable=false assembleHap
当未指定构建模式时,构建APP包,默认release模式;构建HAP/HSP/HAR包时,默认debug模式。
Hvigor支持定制构建模式,采用buildOption字段声明编译选项,并通过buildModeBinder来绑定target、 buildOption以及buildMode三者之间的组合关系。
工程级build-profile.json5文件:
字段 | 类型 | 是否必填 | 说明 | |
|---|---|---|---|---|
buildModeSet | 对象数组 | 否 | 构建模式合集,可配置多个。 | |
name | 字符串 | 是 | 构建模式名称。 内置三种类型,此三项无需用户显性配置:
| |
buildOption | 对象 | 否 | 构建模式使用的具体配置信息,详情请参见工程级buildOption。 | |
products | 对象数组 | 否 | 产品品类,可配置多个。如需配置多个,相关说明请参见配置多目标产物章节。 | |
buildOption | 对象 | 否 | 产品的编译构建配置,详情请参见工程级buildOption。 说明: product的buildOption会对buildMode的buildOption继承覆写,即相同配置项product的优先级更高。 | |
模块级build-profile.json5文件:
字段 | 类型 | 是否必填 | 说明 | ||
|---|---|---|---|---|---|
buildOption | 对象 | 否 | 构建模式使用的具体配置信息,详情请参见模块级buildOption,其中不支持配置name、debuggable和copyFrom字段。 | ||
buildOptionSet | 对象数组 | 否 | buildOption的集合,定义可用的底层配置选项集。 | ||
name | 字符串 | 是 | buildOption的名称。 当前模块级build-profile.json5中已有顶层独立的buildOption配置,buildOptionSet优先级比buildOption更高。 说明:
| ||
copyFrom | 字符串 | 否 | 配置已定义的buildOption的name,表示从本模块已有的buildOption复制配置,然后再覆写。 说明:
| ||
buildModeBinder | 对象数组 | 否 | 为某一buildMode建立target与buildOption之间的映射关系。 | ||
buildModeName | 字符串 | 是 | 指定待建立映射的buildMode。 说明:
| ||
mappings | 对象数组 | 否 | 绑定target使用的buildOption。 | ||
targetName | 字符串 | 是 | 指定待绑定的target。 说明: 仅在本模块选择。 | ||
buildOptionName | 字符串 | 是 | 指定待绑定的buildOption。 说明: 仅在本模块选择。 | ||
targets | config | buildOption | 对象 | 否 | 构建模式使用的具体配置信息,详情请参见模块级buildOption,其中不支持配置name、debuggable和copyFrom字段,优先级比buildOptionSet更高。 |