!19543 hitraceMeter Native接口样例添加

Merge pull request !19543 from cw/master

zh-cn/application-dev/dfx/Readme-CN.md

@@ -4,6 +4,7 @@
 - [性能打点跟踪开发指导](hitracemeter-guidelines.md)
 - [分布式跟踪开发指导](hitracechain-guidelines.md)
 - [HiLog开发指导（Native）](hilog-guidelines.md)
+- [HitraceMeter开发指导（Native）](hitracemeter-native-guidelines.md)
 - 错误管理
   - [错误管理开发指导](errormanager-guidelines.md)
   - [应用恢复开发指导](apprecovery-guidelines.md)

zh-cn/application-dev/dfx/hitracemeter-native-guidelines.md

+# 性能打点跟踪开发指导（Native）
+## 概述
+hiTraceMeter为开发者提供系统性能打点接口。开发者通过在自己的业务逻辑中的关键代码位置调用HiTraceMeter接口提供的API接口，能够有效跟踪进程轨迹、查看系统性能。
+> **说明：**
+
+> - 仅当开发者使用Native API开发应用时，可参考本开发指导。
+> - 如需使用ArkTS API开发应用，请参考对应的[开发指导](hitracemeter-guidelines.md)和[API参考](../reference/apis/js-apis-hitracemeter.md)。
+## 接口说明
+| 方法 | 接口描述 |
+| -------- | -------- |
+| void OH_HiTrace_StartTrace(const char* name) | 开启一个同步时间片跟踪事件 |
+| void OH_HiTrace_FinishTrace() | 结束一个同步时间片跟踪事件 |
+| void OH_HiTrace_StartAsyncTrace(const char* name, int32_t taskId) | 开启一个异步时间片跟踪事件 |
+| void OH_HiTrace_FinishAsyncTrace(const char* name, int32_t taskId) | 结束一个异步时间片跟踪事件 |
+| 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++
+  #include "hitrace/trace.h"
+```
+3. 打开hdc shell，使能trace，命令是：hitrace --trace_begin app。
+```shell
+  capturing trace...
+```
+4. 进行性能打点，以异步打点为例。
+```c++
+  OH_HiTrace_StartAsyncTrace("hitraceTest", 123);
+  OH_HiTrace_FinishAsyncTrace("hitraceTest", 123);
+```
+5. dump trace查看结果，命令是：hitrace --trace_dump | grep hitraceTest。
+```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