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

目次
什么是多产物构建
如何定义多个构建产物
如安在项目中使用
参考文章

---

什么是多产物构建

在鸿蒙应用开发中，一个应用可定义多个 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：

1. {
2.   "app": {
3.     "signingConfigs": [
4.       {
5.         "name": "default",    // debug类型签名配置
6.         "type": "HarmonyOS",
7.         "material": {
8.           "storePassword": "xxxxxxxxxx",
9.           "certpath": "C:/Users/pc/xxxxxxxxxx.cer",
10.           "keyAlias": "xxxxxxxxxx",
11.           "keyPassword": "xxxxxxxxxx",
12.           "profile": "C:/Users/pc/xxxxxxxxxx.p7b",
13.           "signAlg": "SHA256withECDSA",
14.           "storeFile": "C:/Users/pc/xxxxxxxxxx.p12"
15.         }
16.       },
17.       {
18.         "name": "release",    // release类型签名配置
19.         "type": "HarmonyOS",
20.         "material": {
21.           "storePassword": "xxxxxxxxxx",
22.           "certpath": "C:/Users/pc/xxxxxxxxxx.cer",
23.           "keyAlias": "xxxxxxxxxx",
24.           "keyPassword": "xxxxxxxxxx",
25.           "profile": "C:/Users/pc/xxxxxxxxxx.p7b",
26.           "signAlg": "SHA256withECDSA",
27.           "storeFile": "C:/Users/pc/xxxxxxxxxx.p12"
28.         }
29.       }
30.     ],
31.     "products": [
32.       {
33.         "name": "default",
34.         "signingConfig": "default",
35.         "compatibleSdkVersion": "5.0.1(13)",
36.         "runtimeOS": "HarmonyOS",
37.         "buildOption": {
38.           "strictMode": {
39.             "caseSensitiveCheck": true,
40.             "useNormalizedOHMUrl": true
41.           },
42.           "arkOptions": {
43.             "buildProfileFields": {
44.               // 接口base
45.               "baseApiUrl": "https://default.test.cn"
46.             }
47.           }
48.         }
49.       },
50.       // dev开发产物（测试环境）
51.       {
52.         "name": "start_develop", // 产物名称
53.         "compatibleSdkVersion": "5.0.2(14)",
54.         "runtimeOS": "HarmonyOS",
55.         "signingConfig": "default",
56.         "compatibleSdkVersion": "5.0.1(13)",
57.         "runtimeOS": "HarmonyOS",
58.         "buildOption": {
59.           "strictMode": {
60.             "caseSensitiveCheck": true,
61.             "useNormalizedOHMUrl": true
62.           },
63.           "arkOptions": {
64.             "buildProfileFields": { // 构建配置自定义参数
65.               // 接口base
66.               "baseApiUrl": "https://debug.develop.cn"
67.             }
68.           }
69.         }
70.       },
71.       // release开发产物（生产环境）
72.       {
73.         "name": "start_release", // 产物名称
74.         "compatibleSdkVersion": "5.0.2(14)",
75.         "runtimeOS": "HarmonyOS",
76.         "signingConfig": "default",
77.         "compatibleSdkVersion": "5.0.1(13)",
78.         "runtimeOS": "HarmonyOS",
79.         "buildOption": {
80.           "strictMode": {
81.             "caseSensitiveCheck": true,
82.             "useNormalizedOHMUrl": true
83.           },
84.           "arkOptions": {
85.             "buildProfileFields": { // 构建配置自定义参数
86.               // 接口base
87.               "baseApiUrl": "https://release.produce.cn"
88.             }
89.           }
90.         }
91.       },
92.       // release打包产物（生产环境构建release版本）
93.       {
94.         "name": "start_release_build", // 产物名称
95.         "compatibleSdkVersion": "5.0.2(14)",
96.         "runtimeOS": "HarmonyOS",
97.         "signingConfig": "release",
98.         "compatibleSdkVersion": "5.0.1(13)",
99.         "runtimeOS": "HarmonyOS",
100.         "output": {
101.           "artifactName": "customizedProductOutputNameB" // 自定义打包后的app产物名称
102.         },
103.         "buildOption": {
104.           "strictMode": {
105.             "caseSensitiveCheck": true,
106.             "useNormalizedOHMUrl": true
107.           },
108.           "arkOptions": {
109.             "buildProfileFields": { // 构建配置自定义参数
110.               // 接口base
111.               "baseApiUrl": "https://release.produce.cn"
112.             }
113.           }
114.         }
115.       }
116.     ],
117.     "buildModeSet": [
118.       {
119.         "name": "debug",
120.       },
121.       {
122.         "name": "release"
123.       }
124.     ]
125.   },
126. }

复制代码

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

如安在项目中使用产物

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

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

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

复制代码

参考文章

设置APP多目标构建产物

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。