HarmonyOS 鸿蒙Next中多product的情况如何配置

【背景知识】

• 配置文件说明build-profile.json5配置文件。
• 配置文件说明module.json5配置文件。
• 配置多目标产物。

【修改建议】

若想对不同的外发版本进行差异化定制，在进行多目标产物配置时，可以在工程级build-profile.json5->app{}->products[]中进行相关配置。下述方案提供了针对normal和vip版本的icon和label两个标签的差异化定制，具体方案参考如下：

（1）在工程级build-profile.json5中配置好products，此处除默认default之外，增加vip_product和normal_product配置；

"products": [{
  "name": "default",
  "signingConfig": "default",
  "compatibleSdkVersion": "5.0.0(12)",
  "runtimeOS": "HarmonyOS",
      "buildOption": {
        "strictMode": {
        "caseSensitiveCheck": true,
        "useNormalizedOHMUrl": true
        }
      }
    },
    {
      "name": "vip_product",
      "signingConfig": "vipSign",
      "compatibleSdkVersion": "5.0.0(12)",
      "runtimeOS": "HarmonyOS",
      "buildOption": {
        "strictMode": {
          "caseSensitiveCheck": true,
          "useNormalizedOHMUrl": true
        }
      }
    },
    {
      "name": "normal_product",
      "signingConfig": "normalSign",
      "compatibleSdkVersion": "5.0.0(12)",
      "runtimeOS": "HarmonyOS",
      "buildOption": {
        "strictMode": {
        "caseSensitiveCheck": true,
        "useNormalizedOHMUrl": true
        }
      }
    }
]

（2）在工程级build-profile.json5中的modules标签下配置targets，并且限制每个target可以在哪个product下使用。以下限制vip的配置可以被product为default和vip_product使用，normal的配置可以被product为default和normal_product使用；

"modules": [
     {
       "name": "entry",
       "srcPath": "./entry",
       "targets": [
         {
           "name": "default",
           "applyToProducts": [
             "default",
             "normal_product",
             "vip_product"
           ]
         },
         {
           "name": "vip", // target为vip时可以选择的product为default和vip_product
           "applyToProducts": [
             "default",
             "vip_product"
           ]
         },
         {
           "name": "normal", // target为normal时可以选择的product为default和normal_product
           "applyToProducts": [
             "default",
             "normal_product"
           ]
         }
       ]
     }
 ]

（3）对于模块级的build-profile.json5，在target标签下的normal、vip字段中增加abilities配置如下：

"targets": [
    {
      "name": "default"
    },
    {
      "name": "normal", // 当target为normal时，使用normal作为label
      "source": {
        "abilities": [
          {
            "name": "EntryAbility",
            "icon":"$media:layered_image",
            "label":"normal", // 实际配置中请用变量形式定义在string.json文件中
            "launchType": "singleton"
          }
        ]
      }
    },
    {
      "name": "vip", // 当target为vip时，使用vip作为label
      "source": {
        "abilities": [
          {
            "name": "EntryAbility",
            "icon":"$media:layered_image", 
            "label":"vip", // 实际配置中请用变量形式定义在string.json文件中
            "launchType": "singleton"
          }
        ]
      }
    },
    {
      "name": "ohosTest",
    }
  ]

【总结】

• 构建多目标产物时，控制应用icon和label需要在模块级的build-profile.json5中根据不同target在abilities标签下设置，默认模块级build-profile.json5中abilities优先级高于module.json5中abilities优先级，若模块级build-profile.json5中abilities未配置，则默认使用module.json5中配置内容。
• 工程级build-profile.json5配置中products中的label、icon、versionCode、versionName、resource字段配置，编译构建时会替换app.json5中的相关配置。
• DevEco Studio从5.0.3.800版本开始，不再对module.json5中的icon和label做强制校验，因此module.json5与app.json5只需要选择其一配置。module.json5的配置优先级更高。
• 应用icon/label优先级：模块级build-profile.json5 > 模块级module.json5 > 工程级build-profile.json5>app.json5。