Package org.robolectric.shadows

Class ShadowTrace

java.lang.Object

org.robolectric.shadows.ShadowTrace

@Implements(value=android.os.Trace.class)
public class ShadowTrace
extends Object

Shadow implementation for Trace, which stores the traces locally in arrays (unlike the real implementation) and allows reading them.

The shadow doesn’t enforce the constrains by default (e.g., null section names, or incorrect ShadowTrace.beginSection(String) / ShadowTrace.endSection() sequences), but can be configured to do so by calling ShadowTrace.setCrashOnIncorrectUsage(boolean).

Constructor Summary

Constructors

Constructor and Description
ShadowTrace()

Method Summary

Modifier and Type	Method and Description
protected static void	beginSection(String sectionName) Starts a new trace section with given name.
static void	doNotUseSetCrashOnIncorrectUsage(boolean crashOnIncorrectUsage) Do not use this method unless absolutely necessary.
protected static void	endSection() Ends the most recent active trace section.
static Deque<String>	getCurrentSections() Returns a stack of the currently active trace sections.
static Queue<String>	getPreviousSections() Returns a queue of all the previously active trace sections.
protected static boolean	isTagEnabled(long traceTag)
static void	reset() Resets internal lists of active trace sections.
protected static void	setAppTracingAllowed(boolean appTracingAllowed)

Methods inherited from class java.lang.Object

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

Constructor Detail

ShadowTrace

public ShadowTrace()

Method Detail

beginSection

@Implementation(minSdk=18)
protected static void beginSection(String sectionName)

Starts a new trace section with given name.

endSection

@Implementation(minSdk=18)
protected static void endSection()

Ends the most recent active trace section.

Throws:

{@link - AssertionError} if called without any active trace section.

isTagEnabled

@Implementation(minSdk=18)
protected static boolean isTagEnabled(long traceTag)

setAppTracingAllowed

@Implementation(minSdk=18)
protected static void setAppTracingAllowed(boolean appTracingAllowed)

getCurrentSections

public static Deque<String> getCurrentSections()

Returns a stack of the currently active trace sections.

getPreviousSections

public static Queue<String> getPreviousSections()

Returns a queue of all the previously active trace sections.

doNotUseSetCrashOnIncorrectUsage

public static void doNotUseSetCrashOnIncorrectUsage(boolean crashOnIncorrectUsage)

Do not use this method unless absolutely necessary. Prefer fixing the tests instead.

Sets whether to crash on incorrect usage (e.g., calling endSection() before beginSection(String). Default value - false.

reset

@Resetter
public static void reset()

Resets internal lists of active trace sections.