未验证 提交 d867487a 编写于 作者: Z zengyawen 提交者: Gitee

add 相关说明

Signed-off-by: Nzengyawen <zengyawen1@huawei.com>
上级 24ef3ebb
# DFX
- [应用事件打点开发指导](hiappevent-guidelines.md)
- [性能打点跟踪开发指导](hitracemeter-guidelines.md)
- [分布式跟踪开发指导](hitracechain-guidelines.md)
- [HiLog开发指导(Native)](hilog-guidelines.md)
- [HitraceMeter开发指导(Native)](hitracemeter-native-guidelines.md)
- 性能打点跟踪
- [性能打点跟踪开发指导(ArkTS)](hitracemeter-guidelines.md)
- [性能打点跟踪开发指导(Native)](hitracemeter-native-guidelines.md)
- 错误管理
- [错误管理开发指导](errormanager-guidelines.md)
- [应用恢复开发指导](apprecovery-guidelines.md)
......
# 性能打点跟踪开发指导
# 性能打点跟踪开发指导(ArkTS)
## 简介
......
# 性能打点跟踪开发指导(Native)
## 概述
hiTraceMeter为开发者提供系统性能打点接口。开发者通过在自己的业务逻辑中的关键代码位置调用HiTraceMeter接口提供的API接口,能够有效跟踪进程轨迹、查看系统性能。
> **说明:**
> - 仅当开发者使用Native API开发应用时,可参考本开发指导。
> - 如需使用ArkTS API开发应用,请参考对应的[开发指导](hitracemeter-guidelines.md)和[API参考](../reference/apis/js-apis-hitracemeter.md)。
> - 仅当开发者使用Native API开发应用时,可参考本开发指导。相关接口的详细说明请查阅[API参考](../reference/native-apis/_hitrace.md)。
> - 如需使用ArkTS API开发应用,请查阅对应的[开发指导](hitracemeter-guidelines.md)和[API参考](../reference/apis/js-apis-hitracemeter.md)。
## 接口说明
| 方法 | 接口描述 |
| -------- | -------- |
| void OH_HiTrace_StartTrace(const char* name) | 开启一个同步时间片跟踪事件 |
......@@ -15,31 +19,34 @@ hiTraceMeter为开发者提供系统性能打点接口。开发者通过在自
| void OH_HiTrace_CountTrace(const char* name, int64_t count) | 整数跟踪事件 |
**参数解析**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------------------------------ |
| name | string | 否 | 要跟踪的数值变量名称。 |
| taskId | number | 否 | 用来表示关联的ID,如果有多个name相同的任务是并行执行的,则每次调用startTrace的taskId不同。 |
| count | number | 否 | 变量的值。 |
## 开发示例
1. 在CMakeLists.txt中新增libhitrace_ndk.z.so链接。
```
```
target_link_libraries(entry PUBLIC libhitrace_ndk.z.so)
```
```
2. 在源文件中引用hitrace头文件。
```c++
```c++
#include "hitrace/trace.h"
```
```
3. 打开hdc shell,使能trace,命令是:hitrace --trace_begin app。
```shell
```shell
capturing trace...
```
```
4. 进行性能打点,以异步打点为例。
```c++
```c++
OH_HiTrace_StartAsyncTrace("hitraceTest", 123);
OH_HiTrace_FinishAsyncTrace("hitraceTest", 123);
```
```
5. dump trace查看结果,命令是:hitrace --trace_dump | grep hitraceTest。
```shell
```shell
<...>-2477 (-------) [001] .... 396.427165: tracing_mark_write: S|2477|H:hitraceTest 123
<...>-2477 (-------) [001] .... 396.427196: tracing_mark_write: F|2477|H:hitraceTest 123
```
\ No newline at end of file
```
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册