【HarmonyOS NEXT】多目标产物构建实践
目次什么是多产物构建
如何定义多个构建产物
如安在项目中使用
参考文章
什么是多产物构建
在鸿蒙应用开发中，一个应用可定义多个 product，每一个 product 对应一个定制的 APP 包，每个 product 中支持对 bundleName、bundleType、输生产物名称、icon 和 label 以及包含的 target 资源文件等内容进行定制。与此同时，也可以将环境设置和签名信息通过 product 进行隔离，通过选项切换环境进行构建，制止频仍的手动修改关键参数而造成打包遗漏的情况。
https://i-blog.csdnimg.cn/direct/59e6abb5fe6d4f698f631e2848633e77.png
如何定义多个构建产物
在项目最外层的 build-profile.json5 文件中的 products 字段中新增 product，字段表明可参考文章：工程级build-profile.json5文件。
这里我们针对环境控制做演示，须要用到 buildOption / arkOptions / buildProfileFields 字段，该字段中的参数设置后，切换产物后会重新生成一份 BuildProfile.ets 文件，该文件可被项目导入并使用。
须要留意的是：在定制 product 时，必须存在 "default" 的 product，否则编译时会出现错误。
https://i-blog.csdnimg.cn/direct/29dac7af5fdf45bda4e3f94b1d037684.png
示例 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" 签名，这样做的好处是，当我们切换环境选项时，签名相干设置也将一同被改变，无需手动更换签名。
如安在项目中使用产物
1. 在第一步设置完 product 后，还需在 modules 中的 applyToProducts 字段添加刚才设置的 product 产物，项目中创建的其他 hsp 也需一同设置，否则编译报错。
https://i-blog.csdnimg.cn/direct/c5a906fcca2147cb8d2b76d93a5e0c4b.png
2. 设置完 products 与 modules 后，重新运行项目后，每个模块下均会生成新的 BuildProfile.ets 文件，在项目中使用相对路径导入即可。
https://i-blog.csdnimg.cn/direct/bc43ed4e38e24b22adc05c7ec5f54189.png
// 导入
import BuildProfile from '../../../../BuildProfile'
// 使用
let BASE_URL: string = BuildProfile.baseApiUrl
参考文章
设置APP多目标构建产物
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]