程序包 ohos.tools

类 ByTrace

java.lang.Object

ohos.tools.ByTrace

public final class ByTrace
extends Object

Provides interfaces to generate ByTrace logs.

This class traces the start, end, and value changes of key processes that last for at least 3 ms.

Example: To trace a name verification that is expected to complete within 5 ms:

 ByTrace.startTrace("checkName", "5");
 Bytrace.finishTrace("checkName");
 

To trace the number of layers, which is 3:

 Bytrace.count("curLayer", 3);
 

Each startTrace matches one finishTrace, and they must have the same value.

从以下版本开始:

1

SystemCapability

SystemCapability.Developtools.Bytrace

字段概要

字段

限定符和类型	字段	说明
static long	BYTRACE_TAG_APP	Indicates a tag used by third parties.

构造器概要

构造器

构造器	说明
ByTrace()

方法概要

限定符和类型	方法	说明
static void	countTrace(String name, int count)	Records a trace for generating a count, such as clock pulse and the number of layers.
static void	finishTrace(String value)	Records a trace and marks it as the end of a task.
static void	startTrace(String value)	Records a trace and marks it as the start of a task.
static void	startTrace(String value, float limit)	Records a trace with the expected completion time and marks it as the start of a task.
static void	updateTraceLabel()	Updates the trace label when your process has started.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

BYTRACE_TAG_APP

public static final long BYTRACE_TAG_APP

Indicates a tag used by third parties.

另请参阅:

常量字段值

构造器详细资料

ByTrace

public ByTrace()

方法详细资料

updateTraceLabel

public static void updateTraceLabel()

Updates the trace label when your process has started.

startTrace

public static void startTrace(String value,
                              float limit)

Records a trace with the expected completion time and marks it as the start of a task. This method is invoked at the start of a transaction to indicate that a task whose name is specified by value has started. The finishTrace(java.lang.String) method using the same value must be invoked at the end of the transaction.

参数:

value - Indicates the operation name.

limit - Indicates the expected time required for completing the operation, in milliseconds.

从以下版本开始:

1

startTrace

public static void startTrace(String value)

Records a trace and marks it as the start of a task. This method is invoked at the start of a transaction to indicate that a task whose name is specified by value has started. The finishTrace(java.lang.String) method using the same value must be invoked at the end of the transaction.

参数:

value - Indicates the operation name.

从以下版本开始:

1

finishTrace

public static void finishTrace(String value)

Records a trace and marks it as the end of a task. This method is invoked at the end of a transaction to indicate that a task whose name is specified by value has ended. This method must be invoked after the startTrace(java.lang.String,float) or startTrace(java.lang.String) method is invoked.

参数:

value - Indicates the operation name. It must be the same as the value of startTrace(java.lang.String,float) or startTrace(java.lang.String).

从以下版本开始:

1

countTrace

public static void countTrace(String name,
                              int count)

Records a trace for generating a count, such as clock pulse and the number of layers.

参数:

name - Indicates the operation name.

count - Indicates the count of the operation.

从以下版本开始:

1