实践说明
====

应用正式对外发布版本前，需要对应用进行代码调试。调试和正式发布版本，两者编译行为可能不同。此时，可以利用buildMode能力，来定制两个版本的编译差异性。

假设其中构建产物均为default，但编译行为不同：release模式下使能混淆，debug模式下使能debug调试。

示例工程中包含一个模块entry，将entry模块交付到构建产物default中，模块定制两种不同的编译模式debug、release，将两种构建模式均绑定到构建产物default中。工程示例图如下（模块）：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/81/v3/smL4k0cFSPqA1TruxTJq6w/zh-cn_image_0000002594474260.png?HW-CC-KV=V1&HW-CC-Date=20260709T132917Z&HW-CC-Expire=86400&HW-CC-Sign=3ABC7C2048ECE0B880C717550B253D9AC3E62580558ACF0A0E4051107EF08AE4)

#### 工程级build-profile.json5示例

{
  "app": {
    "signingConfigs": \[\],
    "products": \[
      {
        "name": "default",
        "signingConfig": "default",
        "compatibleSdkVersion": "26.0.0",
        "runtimeOS": "HarmonyOS",
        "buildOption": {
          "strictMode": {
            "caseSensitiveCheck": true,
            "useNormalizedOHMUrl": true
          }
        }
      }
    \],
    "buildModeSet": \[
      {
        "name": "debug"
      },
      {
        "name": "release"
      }
    \]
  },
  "modules": \[
    {
      "name": "entry",
      "srcPath": "./entry",
      "targets": \[
        {
          "name": "default",
          "applyToProducts": \[
            "default"
          \]
        }
      \]
    }
  \]
}

#### 模块级build-profile.json5示例

#### \[h2\]entry模块

{
  "apiType": "stageMode",
  "buildOption": {
  },
  "buildOptionSet": \[
    {
      "name": "release",
      "arkOptions": {
        "obfuscation": {
          "ruleOptions": {
            "enable": true,
            "files": \[
              "./obfuscation-rules.txt"
            \]
          }
        }
      }
    },
    {
      "name": "debug",
      "debuggable": true,
      "arkOptions": {
        "obfuscation": {
          "ruleOptions": {
            "enable": false
          }
        }
      }
    }
  \],
  "buildModeBinder": \[
    {
      "buildModeName": "release",
      "mappings": \[
        {
          "buildOptionName": "release",
          "targetName": "default"
        }
      \]
    },
    {
      "buildModeName": "debug",
      "mappings": \[
        {
          "buildOptionName": "debug",
          "targetName": "default"
        }
      \]
    }
  \],
  "targets": \[
    {
      "name": "default",
    },
    {
      "name": "ohosTest",
    }
  \]
}

#### 指定构建模式

#### \[h2\]命令行

示例1：构建APP时，构建产物为default，指定构建模式为debug，可执行如下命令：

hvigorw --mode project -p product=default -p buildMode=debug assembleApp

编译产物示例如下：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f1/v3/Ix_xlsXqTECHTWVsHA8n3w/zh-cn_image_0000002624993617.png?HW-CC-KV=V1&HW-CC-Date=20260709T132917Z&HW-CC-Expire=86400&HW-CC-Sign=7E4905E7081CE9716CDF3406659E42FCFAB37F043D0485EAF18E0534EA4767CE)

示例2：构建APP时，构建产物为default，指定构建模式为release，可执行如下命令：

hvigorw --mode project -p product=default -p buildMode=release assembleApp

编译产物示例如下：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9/v3/NDfNFyWDTEi5WhWRH7mWnw/zh-cn_image_0000002624993613.png?HW-CC-KV=V1&HW-CC-Date=20260709T132917Z&HW-CC-Expire=86400&HW-CC-Sign=4D076E1072B09C9DEF0C276625C7769311ACC8F9C1D704E1D34DCEDB96BC0A04)

#### \[h2\]DevEco Studio界面

在DevEco Studio界面进行可视化配置，Build Mode下拉选择对应配置选项debug后，点击Build -> Build Hap(s)/APP(s) -> Build APP(s) ，构建编译模式为debug，构建产物为default的APP包。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fb/v3/8jf2foYQRRqBocWatcIBBg/zh-cn_image_0000002625073759.png?HW-CC-KV=V1&HW-CC-Date=20260709T132917Z&HW-CC-Expire=86400&HW-CC-Sign=35A2E9E84AE4AEB8F4E5FF1A28C902118758D3BA6C37E6C0591CE76CE0C7B094)