HarmonyOS Next DevEco Studio 构建配置指南：多目标产物定制

1. 定制 HAR 多目标构建产物

每一个 HAR 模块均支持定制不同的 target，通过在模块中的 build-profile.json5 文件中实现差异化定制，当前支持设备类型 (deviceType)、资源 (resource)、buildOption 配置项 (如 C++ 依赖的.so、混淆配置、abi 类型、cppFlags 等)、源码集 (source) 的定制。

说明

当前版本，在 DevEco Studio 中编译时，仅支持编译 target 为 default 的模块。若需指定其他 target，需通过命令行来指定，并通过命令行来编译。

例如构建指定的自定义 target:free 的 har，可参考执行以下命令：

hvigorw --mode module -p product=default -p module=library@free -p buildMode=debug assembleHar

1.1. 定义产物的 deviceType

每一个 target 均可以指定支持的设备类型 deviceType，也可以不定义。如果不定义，则该 target 默认支持 config.json 或 module.json5 中定义的设备类型。

同时，在定义每个 target 的 deviceType 时，支持的设备类型必须在 config.json 或 module.json5 中已经定义。例如，在上述定义的 2 个 target 中，分别定义 default 默认支持所有设备类型，free 版本只支持 2in1 设备。

{
  "apiType": 'stageMode',
  "buildOption": { },
  "targets": [
    {
      "name": "default"
    },
    {
      "name": "free",
      "config": {
        "deviceType": ["2in1"]
      }
    }
  ]
}

1.2. 定义 C++ 工程依赖的.so 文件

在 C++ 工程中，可以对每个 target 依赖的.so 文件进行定制。例如某模块依赖了 function1.so、function2.so 和 function3.so 三个文件，其中 target 为 default 的产物依赖了 function1.so 和 function2.so；其中 target 为 vip 的产物依赖了 function1.so 和 function3.so，则示例代码如下所示：

{
  "apiType": 'stageMode',
  "buildOption": {
    "externalNativeOptions": {
      "path": "./src/main/cpp/CMakeLists.txt",
      "arguments": [],
      "abiFilters": ["arm64-v8a", "x86_64"],
      "cppFlags": ""
    }
  },
  "targets": [
    {
      "name": "default",
      "config": {
        "buildOption": {
          "nativeLib": {
            "filter": {
              "pickFirsts": ["**/function1.so"],
              "excludes": ["**/function3.so"],
              "enableOverride": true
            }
          }
        }
      }
    },
    {
      "name": "vip",
      "config": {
        "buildOption": {
          "nativeLib": {
            "filter": {
              "pickFirsts": ["**/function1.so"],
              "excludes": ["**/function2.so"],
              "enableOverride": true
            }
          }
        }
      }
    }
  ]
}

1.3. 定义产物的资源

每个 target 使用的资源文件可能存在差异，在开发过程中，开发者可以将每个 target 所使用的资源存放在不同的资源目录下。其中，ArkTS 工程支持对 main 目录下的资源文件目录 (resource) 进行定制；JS 工程支持对 main 目录下的资源文件目录 (resource) 及 Ability 下的资源文件目录 (res) 进行定制。如下为 ArkTS 工程的资源文件目录定制示例：

{
  "apiType": 'stageMode',
  "buildOption": { },
  "targets": [
    {
      "name": "default",
      "resource": {
        "directories": ["./src/main/resources_default"]
      }
    },
    {
      "name": "free",
      "config": {
        "deviceType": ["2in1"]
      },
      "resource": {
        "directories": ["./src/main/resources_default", "./src/main/resources_free"]
      }
    }
  ]
}