能力说明
====

在编译构建时，Hvigor会生成BuildProfile类，开发者可以通过该类在运行时获取编译构建参数，也可以在build-profile.json5中通过buildProfileFields增加自定义字段，从而在运行时获取自定义的参数。

#### 使用说明

buildProfileFields的优先级：模块级target > 模块级buildOptionSet > 模块级buildOption > 工程级product > 工程级buildModeSet

#### HAP/HSP运行时获取编译构建参数

#### \[h2\]生成BuildProfile类文件

当前有以下几种方式可以生成BuildProfile类文件：

*   选中需要编译的模块，在菜单栏选择“Build > Generate Build Profile ${moduleName}”。
*   在菜单栏选择“Build > Build Hap(s)/APP(s) > Build Hap(s)”或“Build > Build Hap(s)/APP(s) > Build APP(s)”。
*   在Terminal中执行如下命令：
    
    hvigorw GenerateBuildProfile
    

执行完上述操作后，将在“${moduleName} / build / ${productName} / generated / profile / ${targetName} ”目录下生成BuildProfile.ets文件。示例如下所示：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3d/v3/KMHb6r0WS42O5WQ_s7wSAQ/zh-cn_image_0000002594474946.png?HW-CC-KV=V1&HW-CC-Date=20260709T132918Z&HW-CC-Expire=86400&HW-CC-Sign=45568F11B1AF16E448220BE3E450A7C1AC4320C2153EC2FC82B29EF30378B346)

#### \[h2\]在代码中获取构建参数

生成BuildProfile类文件后，在代码中可以通过如下方式引入该文件，其中packageName是模块级oh-package.json5文件中name字段对应的值。

import BuildProfile from '${packageName}/BuildProfile';

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/da/v3/vdhZEyc8T6CRQ47yGfxrEg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132918Z&HW-CC-Expire=86400&HW-CC-Sign=404F82E5398229EF5CC4F56CE5C5C7ADFE3A790758191FCDB14E977AD9401A37)

在HSP中使用import BuildProfile from 'BuildProfile'在跨包集成HSP的时候可能会产生编译错误，推荐使用import BuildProfile from '${packageName}/BuildProfile'。

通过如下方式获取到构建参数：

@State message: string = BuildProfile.BUNDLE\_NAME;

#### \[h2\]默认参数

生成BuildProfile类文件时，Hvigor会根据当前工程构建的配置信息生成一部分默认参数，开发者可以在代码中直接使用。

**表1** 默认参数说明
| 
参数名

 | 

类型

 | 

说明

 |
| :-- | :-- | :-- |
| 

BUNDLE\_NAME

 | 

string

 | 

应用的Bundle名称。

 |
| 

BUNDLE\_TYPE

 | 

string

 | 

应用的Bundle类型。

 |
| 

VERSION\_CODE

 | 

number

 | 

应用的版本号。

 |
| 

VERSION\_NAME

 | 

string

 | 

应用版本号的文字描述。

 |
| 

TARGET\_NAME

 | 

string

 | 

Target名称。

 |
| 

PRODUCT\_NAME

 | 

string

 | 

Product名称。

 |
| 

BUILD\_MODE\_NAME

 | 

string

 | 

编译模式。

 |
| 

DEBUG

 | 

boolean

 | 

应用是否可调试。

 |

#### \[h2\]自定义参数

开发者可以在模块级的build-profile.json5文件中增加自定义参数，在生成BuildProfile类文件后，在代码中使用自定义参数。

自定义参数可以在buildOption、buildOptionSet、targets节点下的arkOptions子节点中通过增加buildProfileFields字段实现，自定义参数通过key-value键值对的方式配置，其中value取值仅支持number、string、boolean类型。

配置示例如下所示：

{
  "apiType": "stageMode",
  "buildOption": {
    "arkOptions": {
      "buildProfileFields": {
        "data": "Data",
      }
    }
  },
  "buildOptionSet": \[
    {
      "name": "release",
      "arkOptions": {
        "buildProfileFields": {
          "buildOptionSetData": "BuildOptionSetDataRelease",
          "data": "DataRelease"
        }
      }
    },
    {
      "name": "debug",
      "arkOptions": {
        "buildProfileFields": {
          "buildOptionSetData": "BuildOptionSetDataDebug",
          "data": "DataDebug"
        }
      }
    }
  \],
  "targets": \[
    {
      "name": "default",
      "config": {
        "buildOption": {
          "arkOptions": {
            "buildProfileFields": {
              "targetData": "TargetData",
              "data": "DataTargetDefault"
            }
          }
        }
      }
    },
    {
      "name": "default1",
      "config": {
        "buildOption": {
          "arkOptions": {
            "buildProfileFields": {
              "targetData": "TargetData1",
              "data": "DataTargetDefault1"
            }
          }
        }
      }
    },
    {
      "name": "ohosTest",
    }
  \]
}

#### HAR运行时获取编译构建参数

#### \[h2\]生成BuildProfile类文件

当前有以下几种方式可以生成BuildProfile类文件：

*   选中需要编译的模块，在菜单栏选择“Build > Generate Build Profile ${moduleName}”。
*   选中需要编译的模块，在菜单栏选择“Build > Make Module ${moduleName}”。
*   在Terminal中执行如下命令：
    
    hvigorw GenerateBuildProfile
    

执行完上述操作后，将在模块根目录下生成BuildProfile.ets文件（该文件可放置在.gitignore文件中进行忽略）。示例如下所示：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d2/v3/vMEbDVB5ShipYbTXTZdleg/zh-cn_image_0000002624994307.png?HW-CC-KV=V1&HW-CC-Date=20260709T132918Z&HW-CC-Expire=86400&HW-CC-Sign=7909CB06E9B37E38A55D0CF615407FE794C2A449AFDFBE63A68952F07D36EFC0)

#### \[h2\]在代码中获取构建参数

生成BuildProfile类文件后，在代码中可以通过相对路径引入该文件，如在HAR模块的Index.ets文件中使用该文件：

import BuildProfile from './BuildProfile';

通过如下方式获取到构建参数：

const HAR\_VERSION: string \= BuildProfile.HAR\_VERSION;

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3f/v3/xFDf7QVXSxSIjpmycH3sFg/zh-cn_image_0000002625074445.png?HW-CC-KV=V1&HW-CC-Date=20260709T132918Z&HW-CC-Expire=86400&HW-CC-Sign=3AC210CE55791F64FB5C9B839973B3A70B6B7F4E082C0091DF9669D2842BEEC7)

#### \[h2\]默认参数

生成BuildProfile类文件时，Hvigor会根据当前工程构建的配置信息生成一部分默认参数，开发者可以在代码中直接使用。

**表2** 默认参数说明
| 
参数名

 | 

类型

 | 

说明

 |
| :-- | :-- | :-- |
| 

HAR\_VERSION

 | 

string

 | 

HAR版本号。

 |
| 

BUILD\_MODE\_NAME

 | 

string

 | 

编译模式。

 |
| 

DEBUG

 | 

boolean

 | 

应用是否可调试。

 |
| 

TARGET\_NAME

 | 

string

 | 

目标名称。

 |

#### \[h2\]自定义参数

开发者可以在模块级的build-profile.json5文件中增加自定义参数，在生成BuildProfile类文件后，在代码中使用自定义参数。

自定义参数可以在buildOption、buildOptionSet节点下的arkOptions子节点中通过增加buildProfileFields字段实现，自定义参数通过key-value键值对的方式配置，其中value取值仅支持number、string、boolean类型。

配置示例如下所示：

{
  "apiType": "stageMode",
  "buildOption": {
    "arkOptions": {
      "buildProfileFields": {
        "data": "Data",
      }
    }
  },
  "buildOptionSet": \[
    {
      "name": "release",
      "arkOptions": {
        "buildProfileFields": {
          "buildOptionSetData": "BuildOptionSetDataRelease",
          "data": "DataRelease"
        }
      }
    },
    {
      "name": "debug",
      "arkOptions": {
        "buildProfileFields": {
          "buildOptionSetData": "BuildOptionSetDataDebug",
          "data": "DataDebug"
        }
      }
    }
  \],
  "targets": \[
    {
      "name": "default",
    }
  \]
}

#### 工程级配置自定义构建参数

开发者可以在工程级的build-profile.json5文件中增加自定义参数，该自定义参数会生成到所有模块的BuildProfile类文件，在代码中使用自定义参数。

自定义参数可以在工程级products、buildModeSet中的buildOption节点下的arkOptions子节点中通过增加buildProfileFields字段实现，自定义参数通过key-value键值对的方式配置，其中value取值仅支持number、string、boolean类型。

配置示例如下所示：

{
  "app": {
    "signingConfigs": \[\],
    "products": \[
      {
        "name": "default",
        "signingConfig": "default",
        "compatibleSdkVersion": "26.0.0",
        "runtimeOS": "HarmonyOS",
        "buildOption": {
          "arkOptions": {
            "buildProfileFields": {
              "productValue": "defaultValue"
            }
          }
        }
      }
    \],
    "buildModeSet": \[
      {
        "name": "debug",
        "buildOption": {
          "arkOptions": {
            "buildProfileFields": {
              "productBuildModeValue": "debugValue"
            }
          }
        }
      },
      {
        "name": "release"
      }
    \]
  },
  "modules": \[
    {
      "name": "entry",
      "srcPath": "./entry",
      "targets": \[
        {
          "name": "default",
          "applyToProducts": \[
            "default"
          \]
        }
      \]
    }
  \]
}