使用Build Analyzer可以显示编译构建过程的重要信息，开发者可以可视化分析排查构建过程中的性能、内存问题。

## 进入Build Analyzer

Build Analyzer会在每次构建应用时默认生成一份报告，并在Build Analyzer窗口进行展示。

可以在构建完成后通过以下方式打开Build Analyzer窗口：

* 点击菜单栏**Build > Build Analyzer**进行查看。
* 在Build窗口中的Build Output页签，点击左侧边栏![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/67/v3/616xZWZiR9qVAJ9zAmZzKg/zh-cn_image_0000002532749757.png?HW-CC-KV=V1&HW-CC-Date=20260414T054957Z&HW-CC-Expire=86400&HW-CC-Sign=AD31E7F0387ABA87299D54FBD350263151F340C58546D3D081D7200AC09A9408)，打开Build Analyzer页签。
* 构建成功且使用构建分析能力时，在Build窗口Build Output页签下的日志下方点击链接，跳转至Build Analyzer页签。

## 查看构建历史记录

Build Analyzer左侧的Build History窗口中按时间顺序显示构建历史记录，包括本工程的构建历史数据和[导入的日志数据](/consumer/cn/doc/harmonyos-guides/ide-hvigor-build-analyzer#section26761217305)。点击构建历史记录可以显示对应概览和可视化图谱界面。

说明

本工程的构建历史数据保存在./hvigor/report目录下，超过10条记录后，最久的历史数据将会被自动清理。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5c/v3/WiSOt4Q-RUCFqdsBzS6V6g/zh-cn_image_0000002501069750.png?HW-CC-KV=V1&HW-CC-Date=20260414T054957Z&HW-CC-Expire=86400&HW-CC-Sign=D84F2C3A42B103D5C4324E4FC85E1DA8C785DBFDB0AAB5B6C9C37E65614C7E67)

## 查看构建任务时间图谱

完成构建后首次打开Build Analyzer 时，窗口会显示构建分析概览，如下图所示：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c9/v3/Kxp6-In8SHipwSMJ8fyNiA/zh-cn_image_0000002532669807.png?HW-CC-KV=V1&HW-CC-Date=20260414T054957Z&HW-CC-Expire=86400&HW-CC-Sign=428D71D606222B616AE114F5D3A8C9D969D8282E2AE6BD105B4927DA8DCD1713)

如需查看构建任务时间图谱，请从下拉菜单中点击Tasks，默认进入时间图谱界面。该界面会分块显示构建历史记录、构建任务时长图谱、构建日志以及对应的日志详情信息，如下图所示：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/35/v3/PBDuESovRAGRm8Cw_lh-oA/zh-cn_image_0000002501069738.png?HW-CC-KV=V1&HW-CC-Date=20260414T054957Z&HW-CC-Expire=86400&HW-CC-Sign=D679878A48C4EEEFC17BE40FF73FC8F02A7DA7C744ABE6C7D243161433191DB9)

图谱中的构建任务展示按照各个任务总时长占比，以相对长度进行展示。可以对时间块进行缩小放大，查看具体的任务名称及耗时信息。

图谱中构建子任务默认是折叠的，可点击Build TimeLine的节点信息，展开查看子任务的构建时长图谱。

图谱与日志信息是联动的，可点击图谱中的任务信息，即可联动对应的日志以及日志详情；相同的，点击日志时，也可联动对应的上方图谱信息。

说明

Build Analyzer不会全部显示构建操作中的所有任务，而是重点显示决定构建总时长的任务。

图谱下方日志模块，展示每次构建的所有日志信息，并按日志级别（Info、Debug、Warn、Error）进行区分，并提供日志搜索功能。

点击日志，可与上方图谱和右侧Details模块，进行联动显示。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/41/v3/RN8TKWLWS_mzX2ihuqGkaA/zh-cn_image_0000002532749763.png?HW-CC-KV=V1&HW-CC-Date=20260414T054957Z&HW-CC-Expire=86400&HW-CC-Sign=63A10F0664FF2B355EBDF85C53F99D2EBBF7DA6388161A91452531B404B12B25)

## 查看构建任务占比图谱

如需查看决定构建时长的任务的占比细分数据，请点击概览页面上的**Common views into this build**下方链接 ，您也可以从下拉菜单中选择**Tasks**并确认您要的任务分组类别。任务以模块、业务类别、Target以及同一模块下的Target、同一模块下的业务类别和同一Target下的业务类别进行分组。图表中任务按照时间占比从大到小排列，点击子任务可详细了解其执行情况。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7e/v3/lZsbJ0NPTpOH7EXlVeWWNA/zh-cn_image_0000002500909898.png?HW-CC-KV=V1&HW-CC-Date=20260414T054957Z&HW-CC-Expire=86400&HW-CC-Sign=8C97945436984087CB0CD5409DA89D1C7745A0138AA86A1B7B9F02F989CBD373)

说明

1. 由于并行线程的存在，分类任务计算时间可能会比实际总时间长；

2. 饼图中Configuration代表未记录的任务占比。

## 查看构建过程内存消耗曲线图

如果要分析构建过程的内存消耗情况，需要先[设置构建分析模式为Advanced](/consumer/cn/doc/harmonyos-guides/ide-hvigor-build-analyzer#section207890565217)，启用内存监测，构建后会生成内存消耗曲线图。从DevEco Studio 5.1.1 Beta1版本开始支持。

点击概览页面上**Common views into this build**下方的链接**Memory Usage During Build**，也可以从下拉菜单中选择**Tasks**和**Memory Usage**分组，查看内存消耗曲线图。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/27/v3/xAmKVyg7QxWRtGHlpF6pMQ/zh-cn_image_0000002501069740.png?HW-CC-KV=V1&HW-CC-Date=20260414T054957Z&HW-CC-Expire=86400&HW-CC-Sign=1A237F5190F9C0C1F2418EDA2FF8F7995C1CDE722BB815158E24562466B51EA5)

## 导出日志

如需查看本次构建日志，您可以点击导出按钮进行日志导出。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a7/v3/v8TeuwWeTpOaci81_WPiKQ/zh-cn_image_0000002500909890.png?HW-CC-KV=V1&HW-CC-Date=20260414T054957Z&HW-CC-Expire=86400&HW-CC-Sign=5EDBAB6E4EAF4786787E46E30BCAB116CDC07538BB8D7067928B7166FF1134C9)

导出内容有：

* 分析统计本次构建的html文件。
* 记录构建日志的build.log文件。
* 记录构建daemon日志的daemon.log文件。
* 记录构建任务耗时的report.json文件。
* 记录构建过程内存消耗的report-monitor.json文件。

## 导入日志

如需查看历史或其他工程的构建日志，您可以点击导入按钮导入report.json文件，导入的文件保存在工程./hvigor/report/upload目录下，导入后可在Build Analyzer左侧的Build History窗口中查看。upload目录下最多保存10条记录，超过10条记录后，最久的历史数据将会被自动清理。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/53/v3/gD0aJfDzQ_GsJToYrHxIyw/zh-cn_image_0000002532749761.png?HW-CC-KV=V1&HW-CC-Date=20260414T054957Z&HW-CC-Expire=86400&HW-CC-Sign=482001E7050DD8C460CFD730EA52D724155878287190758E248AF4A2EBEDFABD)

## 设置构建分析模式

进入**File > Settings**（macOS为**DevEco Studio > Preferences/Settings**） **> Build, Execution, Deployment > Build Tools > Hvigor**下，查看**Use build analysis mode**选项：

* 勾选此项：
  + 模式选择为Normal，即为普通模式（默认选项），记录简单打点数据进行分析。
  + 模式选择为Advanced，即为高级模式，记录详细打点数据进行分析（此模式下，建议搭配使用node 18版本）。
  + 模式选择为Ultrafine，即超精细化模式，与Advanced模式相比，在ArkTS编译阶段记录更详细的打点数据，但开启后可能导致编译构建时间更长。从DevEco Studio 6.0.0 Beta1版本开始支持。
* 取消勾选，即为不记录该次构建数据，不进行分析。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e9/v3/6hpcCtYfRLWsNl5CDwjhnA/zh-cn_image_0000002532669815.png?HW-CC-KV=V1&HW-CC-Date=20260414T054957Z&HW-CC-Expire=86400&HW-CC-Sign=CBE074F35DDD1A47682ED6D2F256282DD7680AE5317261449CABEA0C6AB33F13)

## 生成构建可视化html文件

* 通过命令行方式生成构建可视化html文件。如生成HAP模块的构建可视化html文件，命令如下：

  收起

  自动换行

  深色代码主题

  复制

  ```
  1. hvigorw assembleHap --analyze=normal --config properties.hvigor.analyzeHtml=true
  ```

* 通过[hvigor-config.json5](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-set-options)配置文件中properties.hvigor.analyzeHtml字段生成构建可视化html文件：

  收起

  自动换行

  深色代码主题

  复制

  ```
  1. {
  2. "modelVersion": "6.0.2",
  3. "dependencies": {
  4. },
  5. "execution": {
  6. },
  7. "logging": {
  8. },
  9. "debugging": {
  10. },
  11. "nodeOptions": {
  12. },
  13. "properties": {
  14. "hvigor.analyzeHtml": true  // 生成构建可视化html文件
  15. }
  16. }
  ```

  再执行构建，例如执行以下命令：

  收起

  自动换行

  深色代码主题

  复制

  ```
  1. hvigorw assembleHap --analyze=normal
  ```

执行以上命令后，在工程的.hvigor/report目录下生成对应的html文件，该文件可直接在浏览器中打开。