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

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.

Parameters
predefinedCategories int: A list or bitmask of predefined category sets. Value is either 0 or a combination 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, and 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.

Parameters
tracingMode int: The tracing mode to use, one of TracingConfig.RECORD_UNTIL_FULL or TracingConfig.RECORD_CONTINUOUSLY. Value is TracingConfig.RECORD_UNTIL_FULL, or TracingConfig.RECORD_CONTINUOUSLY

Returns
TracingConfig.Builder The builder to facilitate chaining.