1# 性能打点跟踪开发指导（Native） 2 3## 概述 4 5hiTraceMeter为开发者提供系统性能打点接口。开发者通过在自己的业务逻辑中的关键代码位置调用HiTraceMeter接口提供的API接口，能够有效跟踪进程轨迹、查看系统性能。 6> **说明：** 7 8> - 仅当开发者使用Native API开发应用时，可参考本开发指导。相关接口的详细说明请查阅[API参考](../reference/native-apis/_hitrace.md)。 9> - 如需使用ArkTS API开发应用，请查阅对应的[开发指导](hitracemeter-guidelines.md)和[API参考](../reference/apis/js-apis-hitracemeter.md)。 10 11## 接口说明 12 13| 方法 | 接口描述 | 14| -------- | -------- | 15| void OH_HiTrace_StartTrace(const char* name) | 开启一个同步时间片跟踪事件 | 16| void OH_HiTrace_FinishTrace() | 结束一个同步时间片跟踪事件 | 17| void OH_HiTrace_StartAsyncTrace(const char* name, int32_t taskId) | 开启一个异步时间片跟踪事件 | 18| void OH_HiTrace_FinishAsyncTrace(const char* name, int32_t taskId) | 结束一个异步时间片跟踪事件 | 19| void OH_HiTrace_CountTrace(const char* name, int64_t count) | 整数跟踪事件 | 20 21**参数解析** 22 23| 参数名 | 类型 | 必填 | 说明 | 24| ------ | ------ | ---- | ------------------------------------------------------------ | 25| name | string | 否 | 要跟踪的数值变量名称。 | 26| taskId | number | 否 | 用来表示关联的ID,如果有多个name相同的任务是并行执行的，则每次调用startTrace的taskId不同。 | 27| count | number | 否 | 变量的值。 | 28 29## 开发示例 30 311. 在CMakeLists.txt中新增libhitrace_ndk.z.so链接。 32 ``` 33 target_link_libraries(entry PUBLIC libhitrace_ndk.z.so) 34 ``` 352. 在源文件中引用hitrace头文件。 36 ```c++ 37 #include "hitrace/trace.h" 38 ``` 393. 打开hdc shell，使能trace，命令是：hitrace --trace_begin app。 40 ```shell 41 capturing trace... 42 ``` 434. 进行性能打点，以异步打点为例。 44 ```c++ 45 OH_HiTrace_StartAsyncTrace("hitraceTest", 123); 46 OH_HiTrace_FinishAsyncTrace("hitraceTest", 123); 47 ``` 485. dump trace查看结果，命令是：hitrace --trace_dump | grep hitraceTest。 49 ```shell 50 <...>-2477 (-------) [001] .... 396.427165: tracing_mark_write: S|2477|H:hitraceTest 123 51 <...>-2477 (-------) [001] .... 396.427196: tracing_mark_write: F|2477|H:hitraceTest 123 52 ```