鸿蒙HarmonyOS NEXT开发（5.0）hiperf命令行工具

 鸿蒙HarmonyOS开发实战往期必看文章：（持续更新......）

HarmonyOS NEXT应用开发性能实践总结（持续更新......）

HarmonyOS NEXT应用开发案例实践总结合集（持续更新......）

一分钟了解”纯血版！鸿蒙HarmonyOS Next应用开发！

最新版！“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

---

hiperf为开发人员提供用于调试的命令行工具，用于抓取特定程序或者系统的性能数据，类似内核的perf工具，该工具支持在 Windows/Linux/Mac 等操作系统上运行。

前置条件

• 根据hdc命令行工具指导，完成环境准备。

• 正常连接设备。

命令格式

hiperf [options] COMMAND [args for command]

• [options]

  • 可选的参数
  • 主要是一些调试命令,如打开log等

• COMMAND

  • 必选参数
  • 子功能的名字,如list,recrod,stat,dump,report 等等

• [args for command]

  • 子功能的参数

命令帮助

可用 --help 查看帮助。

hiperf --help

使用如下命令查看子功能的帮助信息。

hiperf [command] --help

list命令

可列出设备上支持的所有事件名称，事件名称用于 stat 和 record 的 -e 和 -g 参数。

Usage: hiperf list [event type name]

使用help命令查询支持的事件类型。

hiperf list --help

下面列出了设备支持的HW事件，并且会提示哪些事件此设备不支持。

hiperf list hw

record命令

采样指定目标程序，并且将采样数据保存到指定的文件中(默认为/data/local/tmp/perf.data)。

Usage: hiperf record [options] [command [command-args]]

对指定的PID为267的进程采样10秒，并且使用dwarf回栈。

hiperf record -p 267 -d 10 -s dwarf

更多详细信息请参考命令帮助。

hiperf record --help

stat命令

监听指定目标程序，周期性打印性能计数器的值。

Usage: hiperf stat [options] [command [command-args]]

下面展示了一个 stats 监听2349进程在CPU0上3秒的性能计数器命令。

hiperf stat -p 2349 -d 3 -c 0

更多详细信息请参考命令帮助。

hiperf stat --help

dump命令

此命令主要以不加以处理的方式直接读取perf.data的数据，开发和测试人员可核对其中原始采样数据的正确性。

Usage: hiperf dump [option] \<filename\>

使用dump命令将/data/local/tmp/perf.data文件读取出来，输出到/data/local/tmp/perf.dump文件中。

hiperf dump -i /data/local/tmp/perf.data -o /data/local/tmp/perf.dump

更多详细信息请参考命令帮助。

hiperf dump --help

report命令

此命令主要用于展示相关采样数据（从perf.data中读取）并且转换为用户需要的格式（比如Json或者ProtoBuf）。

Usage: hiperf report [option] \<filename\>

范例输出普通报告的命令，限制为占比不超过1%。

hiperf report --limit-percent 1

更多详细信息请参考命令帮助。

hiperf report --help

脚本

一般用户用脚本执行采样操作，可生成可视化的火焰图。工具可在developtools_hiperf仓库中获取。

1. 采样。

   由 command_script.py 完成，它是 report 命令的包装脚本。

   usage: command_script.py [-h]
   (-app PACKAGE_NAME | -lp LOCAL_PROGRAM | -cmd CMD | -p [PID [PID ...]] | -t [TID [TID ...]] | -sw)
   [-a ABILITY] [-r RECORD_OPTIONS] [-lib LOCAL_LIB_DIR]
   [-o OUTPUT_PERF_DATA] [--not_hdc_root]

   对指定包名采样，包名是 com.ohos.launch。

   python command_script.py -app com.ohos.launch

   对特定进程采样，进程名称是 hdcd。

   python command_script.py -lp hdcd

2. 收集符号表。

   由 recv_binary_cache.py 完成，它主要根据 perf.data 里面记录的相关文件和库以及它们的 buildid， 在用户指定的路径中去寻找对应的 ELF 作为符号表文件用于回栈或者打印函数名等。

   usage: recv_binary_cache.py [-h] [-i PERF_DATA] [-l LOCAL_LIB_DIR [LOCAL_LIB_DIR ...]]

   指定了2个符号表路径的位置。

   python recv_binary_cache.py -l Z:\OHOS_MASTER\out\ohos-arm-release\lib.unstripped Z:\OHOS_MASTER\out\ohos-arm-release\exe.unstripped

   对应的符号表文件会复制到 binary_cache 文件夹，优先检查用户给出的符号表位置，如果没有则复制设备中的文件。

3. 生成火焰图。

   由 make_report.py 完成，将采样后的数据导出为HTML展示页面。

   usage: make_report.py [-h] [-i PERF_DATA] [-r REPORT_HTML]

   产生HTML文件，默认的文件名是 hiperf_report.html。

   python make_report.py -i perf.data

最后

小编在之前的鸿蒙系统扫盲中，有很多朋友给我留言，有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）路线图、学习视频、文档用来跟着学习是非常有必要的。 

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员

鸿蒙 NEXT 全栈开发学习笔记  希望这一份鸿蒙学习文档能够给大家带来帮助~

这份鸿蒙（HarmonyOS NEXT）包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、（南向驱动、嵌入式等）鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

---