性能打點

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

• 從API Version 8開始，該接口不再維護，推薦使用新接口[@ohos.hiTraceMeter]
• 本模塊首批接口從API version 7開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。

導入模塊

import bytrace from '@ohos.bytrace';

bytrace.startTrace

startTrace(name: string, taskId: number, expectedTime?: number): void

標記一個預追蹤耗時任務的開始，expectedTime是可選參數，標識該任務的期望耗時。

系統能力： SystemCapability.Developtools.Bytrace

參數：

說明： 如果有多個相同name的任務需要追蹤或者對同一個任務要追蹤多次，并且這些會同時被執行，則每次調用startTrace的taskId必須不一致。如果具有相同name的任務是串行執行的，則taskId可以相同。在下面bytrace.finishTrace的示例中會舉例說明。

示例：

bytrace.startTrace("myTestFunc", 1);
bytrace.startTrace("myTestFunc", 1, 5); //從startTrace到finishTrace流程的耗時期望為5ms

bytrace.finishTrace

finishTrace(name: string, taskId: number): void

標記一個預追蹤耗時任務的結束。

系統能力： SystemCapability.Developtools.Bytrace

參數：

說明： finishTrace的name和taskId必須與流程開始的startTrace對應參數值一致。

示例：

bytrace.finishTrace("myTestFunc", 1);

//追蹤并行執行的同名任務
bytrace.startTrace("myTestFunc", 1);
//業務流程...... 
bytrace.startTrace("myTestFunc", 2);  //第二個追蹤的任務開始，同時第一個追蹤的同名任務還沒結束，出現了并行執行，對應接口的taskId需要不同。
//業務流程...... 
bytrace.finishTrace("myTestFunc", 1);
//業務流程...... 
bytrace.finishTrace("myTestFunc", 2);

//追蹤串行執行的同名任務
bytrace.startTrace("myTestFunc", 1);
//業務流程...... 
bytrace.finishTrace("myTestFunc", 1);  //第一個追蹤的任務結束
//業務流程...... 
bytrace.startTrace("myTestFunc", 1);   //第二個追蹤的同名任務開始，同名的待追蹤任務串行執行。
//業務流程...... 
bytrace.finishTrace("myTestFunc", 1);

bytrace.traceByValue

traceByValue(name: string, count: number): void

用來標記一個預追蹤的數值變量，該變量的數值會不斷變化。

系統能力： SystemCapability.Developtools.Bytrace

參數：

示例：

let traceCount = 3;
bytrace.traceByValue("myTestCount", traceCount);
traceCount = 4;
bytrace.traceByValue("myTestCount", traceCount);
//業務流程......

審核編輯 黃宇