From d867487a54bb46b215d5b8975c42c3d5c3b7bd7e Mon Sep 17 00:00:00 2001 From: zengyawen Date: Tue, 13 Jun 2023 07:59:32 +0000 Subject: [PATCH] =?UTF-8?q?add=20=E7=9B=B8=E5=85=B3=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: zengyawen --- zh-cn/application-dev/dfx/Readme-CN.md | 5 +-- .../dfx/hitracemeter-guidelines.md | 2 +- .../dfx/hitracemeter-native-guidelines.md | 31 ++++++++++++------- 3 files changed, 23 insertions(+), 15 deletions(-) diff --git a/zh-cn/application-dev/dfx/Readme-CN.md b/zh-cn/application-dev/dfx/Readme-CN.md index 588bef395c..b8e844d554 100644 --- a/zh-cn/application-dev/dfx/Readme-CN.md +++ b/zh-cn/application-dev/dfx/Readme-CN.md @@ -1,10 +1,11 @@ # 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) diff --git a/zh-cn/application-dev/dfx/hitracemeter-guidelines.md b/zh-cn/application-dev/dfx/hitracemeter-guidelines.md index 9fe91ccc68..8f336658ca 100644 --- a/zh-cn/application-dev/dfx/hitracemeter-guidelines.md +++ b/zh-cn/application-dev/dfx/hitracemeter-guidelines.md @@ -1,4 +1,4 @@ -# 性能打点跟踪开发指导 +# 性能打点跟踪开发指导（ArkTS） ## 简介 diff --git a/zh-cn/application-dev/dfx/hitracemeter-native-guidelines.md b/zh-cn/application-dev/dfx/hitracemeter-native-guidelines.md index c7c857dc95..2e12ec691f 100644 --- a/zh-cn/application-dev/dfx/hitracemeter-native-guidelines.md +++ b/zh-cn/application-dev/dfx/hitracemeter-native-guidelines.md @@ -1,11 +1,15 @@ # 性能打点跟踪开发指导（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 -- GitLab