【HarmonyOS NEXT】多目标产物构建实践

2025-05-15
湖南
本文字数：2545 字
阅读完需：约 8 分钟

什么是多产物构建

在鸿蒙应用开发中，一个应用可定义多个 product，每一个 product 对应一个定制的 APP 包，每个 product 中支持对 bundleName、bundleType、输出产物名称、icon 和 label 以及包含的 target 资源文件等内容进行定制。与此同时，也可以将环境配置和签名信息通过 product 进行隔离，通过选项切换环境进行构建，避免频繁的手动修改关键参数而造成打包遗漏的情况。

如何定义多个构建产物

在项目最外层的 build-profile.json5 文件中的 products 字段中新增 product，字段解释可参考文章：工程级build-profile.json5文件。

这里我们针对环境控制做演示，需要用到 buildOption / arkOptions / buildProfileFields 字段，该字段中的参数设置后，切换产物后会重新生成一份 BuildProfile.ets 文件，该文件可被项目导入并使用。

需要注意的是：在定制 product 时，必须存在 "default" 的 product，否则编译时会出现错误。

示例 JSON：

{   "app": {     "signingConfigs": [      {        "name": "default",    // debug类型签名配置        "type": "HarmonyOS",        "material": {          "storePassword": "xxxxxxxxxx",          "certpath": "C:/Users/pc/xxxxxxxxxx.cer",          "keyAlias": "xxxxxxxxxx",          "keyPassword": "xxxxxxxxxx",          "profile": "C:/Users/pc/xxxxxxxxxx.p7b",          "signAlg": "SHA256withECDSA",          "storeFile": "C:/Users/pc/xxxxxxxxxx.p12"        }      },      {        "name": "release",    // release类型签名配置        "type": "HarmonyOS",        "material": {          "storePassword": "xxxxxxxxxx",          "certpath": "C:/Users/pc/xxxxxxxxxx.cer",          "keyAlias": "xxxxxxxxxx",          "keyPassword": "xxxxxxxxxx",          "profile": "C:/Users/pc/xxxxxxxxxx.p7b",          "signAlg": "SHA256withECDSA",          "storeFile": "C:/Users/pc/xxxxxxxxxx.p12"        }      }    ],     "products": [       {        "name": "default",        "signingConfig": "default",        "compatibleSdkVersion": "5.0.1(13)",        "runtimeOS": "HarmonyOS",        "buildOption": {          "strictMode": {            "caseSensitiveCheck": true,            "useNormalizedOHMUrl": true          },          "arkOptions": {            "buildProfileFields": {              // 接口base              "baseApiUrl": "https://default.test.cn"            }          }        }      },       // dev开发产物（测试环境）      {         "name": "start_develop", // 产物名称        "compatibleSdkVersion": "5.0.2(14)",         "runtimeOS": "HarmonyOS",         "signingConfig": "default",        "compatibleSdkVersion": "5.0.1(13)",        "runtimeOS": "HarmonyOS",        "buildOption": {          "strictMode": {            "caseSensitiveCheck": true,            "useNormalizedOHMUrl": true          },          "arkOptions": {            "buildProfileFields": { // 构建配置自定义参数              // 接口base              "baseApiUrl": "https://debug.develop.cn"            }          }        }      },       // release开发产物（生产环境）      {         "name": "start_release", // 产物名称         "compatibleSdkVersion": "5.0.2(14)",         "runtimeOS": "HarmonyOS",         "signingConfig": "default",        "compatibleSdkVersion": "5.0.1(13)",        "runtimeOS": "HarmonyOS",        "buildOption": {          "strictMode": {            "caseSensitiveCheck": true,            "useNormalizedOHMUrl": true          },          "arkOptions": {            "buildProfileFields": { // 构建配置自定义参数              // 接口base              "baseApiUrl": "https://release.produce.cn"            }          }        }      },       // release打包产物（生产环境构建release版本）      {         "name": "start_release_build", // 产物名称         "compatibleSdkVersion": "5.0.2(14)",         "runtimeOS": "HarmonyOS",         "signingConfig": "release",        "compatibleSdkVersion": "5.0.1(13)",        "runtimeOS": "HarmonyOS",        "output": {           "artifactName": "customizedProductOutputNameB" // 自定义打包后的app产物名称        },         "buildOption": {          "strictMode": {            "caseSensitiveCheck": true,            "useNormalizedOHMUrl": true          },          "arkOptions": {            "buildProfileFields": { // 构建配置自定义参数              // 接口base              "baseApiUrl": "https://release.produce.cn"            }          }        }      }     ],     "buildModeSet": [       {         "name": "debug",       },       {         "name": "release"       }     ]   }, }

复制代码

上方 JSON 中配置了 3 个产物与 2 个签名，3 个产物分别为 develop 开发环境产物， release 生产环境产物，release 生产环境构建产物。其中生产构建产物绑定了 "release" 签名，这样做的好处是，当我们切换环境选项时，签名相关配置也将一同被改变，无需手动更换签名。

如何在项目中使用产物

在第一步配置完 product 后，还需在 modules 中的 applyToProducts 字段添加刚才配置的 product 产物，项目中创建的其他 hsp 也需一同配置，不然编译报错。

配置完 products 与 modules 后，重新运行项目后，每个模块下均会生成新的 BuildProfile.ets 文件，在项目中使用相对路径导入即可。

// 导入import BuildProfile from '../../../../BuildProfile'
// 使用let BASE_URL: string = BuildProfile.baseApiUrl

复制代码

参考文章

配置APP多目标构建产物

发布于: 刚刚阅读数: 4

原文链接:【http://xie.infoq.cn/article/220bb3eca844365b46ad709ab】。文章转载请联系作者。

深海的鲸同学 luvi

关注

大哥你这个瓶子还要不要啊 2025-05-06 加入

独立全栈开发者、鸿蒙生态内容创作者、鸿蒙原生应用“上述”作者、鸿蒙生态三方库lv-markdwon-in、html2md作者，优秀三方开源库作者。HarmonyOS应用开发者高级认证，HarmonyOS开发者社区优质问答博主。

发布

暂无评论

创作场景