TracingConfig.Builder


public static class TracingConfig.Builder
extends Object

java.lang.Object
   ↳ android.webkit.TracingConfig.Builder


Builder used to create TracingConfig objects.

Examples:

   // Create a configuration with default options: TracingConfig.CATEGORIES_NONE,
   // TracingConfig.RECORD_CONTINUOUSLY.
   new TracingConfig.Builder().build()

   // Record trace events from the "web developer" predefined category sets.
   // Uses a ring buffer (the default TracingConfig.RECORD_CONTINUOUSLY mode) for
   // internal storage during tracing.
   new TracingConfig.Builder().addCategories(CATEGORIES_WEB_DEVELOPER).build()

   // Record trace events from the "rendering" and "input latency" predefined
   // category sets.
   new TracingConfig.Builder().addCategories(CATEGORIES_RENDERING,
                                     CATEGORIES_INPUT_LATENCY).build()

   // Record only the trace events from the "browser" category.
   new TracingConfig.Builder().addCategories("browser").build()

   // Record only the trace events matching the "blink*" and "renderer*" patterns
   // (e.g. "blink.animations", "renderer_host" and "renderer.scheduler" categories).
   new TracingConfig.Builder().addCategories("blink*","renderer*").build()

   // Record events from the "web developer" predefined category set and events from
   // the "disabled-by-default-v8.gc" category to understand where garbage collection
   // is being triggered. Uses a limited size buffer for internal storage during tracing.
   new TracingConfig.Builder().addCategories(CATEGORIES_WEB_DEVELOPER)
                              .addCategories("disabled-by-default-v8.gc")
                              .setTracingMode(RECORD_UNTIL_FULL).build()
 

Summary

Public constructors

Builder()

Default constructor for Builder.

Public methods

TracingConfig.Builder addCategories(Collection<String> categories)

Adds custom categories to be included in trace output.

TracingConfig.Builder addCategories(int... predefinedCategories)

Adds predefined sets of categories to be included in the trace output.

TracingConfig.Builder addCategories(String... categories)

Adds custom categories to be included in trace output.

TracingConfig build()

Build TracingConfig using the current settings.

TracingConfig.Builder setTracingMode(int tracingMode)

Sets the tracing mode for this configuration.

Inherited methods

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public constructors

Builder

Added in API level 28
public Builder ()

Default constructor for Builder.

Public methods

addCategories

Added in API level 28
public TracingConfig.Builder addCategories (Collection<String> categories)

Adds custom categories to be included in trace output. Same as addCategories(java.lang.String) but allows to pass a Collection as a parameter.

Parameters
categories Collection: A list of category patterns.

Returns
TracingConfig.Builder The builder to facilitate chaining.

addCategories

Added in API level 28
public TracingConfig.Builder addCategories (int... predefinedCategories)

Adds predefined sets of categories to be included in the trace output. A predefined category set can be one of TracingConfig.CATEGORIES_NONE, TracingConfig.CATEGORIES_ALL, TracingConfig.CATEGORIES_ANDROID_WEBVIEW, TracingConfig.CATEGORIES_WEB_DEVELOPER, TracingConfig.CATEGORIES_INPUT_LATENCY, TracingConfig.CATEGORIES_RENDERING, TracingConfig.CATEGORIES_JAVASCRIPT_AND_RENDERING or TracingConfig.CATEGORIES_FRAME_VIEWER.

Returns
TracingConfig.Builder The builder to facilitate chaining.

addCategories

Added in API level 28
public TracingConfig.Builder addCategories (String... categories)

Adds custom categories to be included in trace output. Note that the categories are defined by the currently-in-use version of WebView. They live in chromium code and are not part of the Android API. See chromium documentation on tracing for more details.

Parameters
categories String: A list of category patterns. A category pattern can contain wildcards, e.g. "blink*" or full category name e.g. "renderer.scheduler".

Returns
TracingConfig.Builder The builder to facilitate chaining.

build

Added in API level 28
public TracingConfig build ()

Build TracingConfig using the current settings.

Returns
TracingConfig The TracingConfig with the current settings.

setTracingMode

Added in API level 28
public TracingConfig.Builder setTracingMode (int tracingMode)

Sets the tracing mode for this configuration. When tracingMode is not set explicitly, the default is TracingConfig.RECORD_CONTINUOUSLY.

Returns
TracingConfig.Builder The builder to facilitate chaining.