# ProfilingTrigger.Builder

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Summary:[Ctors](https://developer.android.com/reference/android/os/ProfilingTrigger.Builder#pubctors)\|[Methods](https://developer.android.com/reference/android/os/ProfilingTrigger.Builder#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/os/ProfilingTrigger.Builder#inhmethods)  

# ProfilingTrigger.Builder

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/os/ProfilingTrigger.Builder "View this page in Kotlin")\|Java

`
public
static
final

class
ProfilingTrigger.Builder
`  
`

extends `[Object](https://developer.android.com/reference/java/lang/Object)`


``


`

|---|-------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.os.ProfilingTrigger.Builder |

<br />

*** ** * ** ***

Builder class to create a[ProfilingTrigger](https://developer.android.com/reference/android/os/ProfilingTrigger)object.

## Summary

|                                                                                                                        ### Public constructors                                                                                                                        ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[Builder](https://developer.android.com/reference/android/os/ProfilingTrigger.Builder#Builder(int))`(int triggerType) ` Create a new builder instance to create a[ProfilingTrigger](https://developer.android.com/reference/android/os/ProfilingTrigger)object. |

|                                                                                                                                                      ### Public methods                                                                                                                                                       ||
|------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` `[ProfilingTrigger](https://developer.android.com/reference/android/os/ProfilingTrigger)                 | ` `[build](https://developer.android.com/reference/android/os/ProfilingTrigger.Builder#build())`() ` Build the[ProfilingTrigger](https://developer.android.com/reference/android/os/ProfilingTrigger)object.      |
| ` `[ProfilingTrigger.Builder](https://developer.android.com/reference/android/os/ProfilingTrigger.Builder) | ` `[setRateLimitingPeriodHours](https://developer.android.com/reference/android/os/ProfilingTrigger.Builder#setRateLimitingPeriodHours(int))`(int rateLimitingPeriodHours) ` Set a rate limiting period in hours. |

| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object)          | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object.                                                                                                                                                      | | ` boolean`                                                                     | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one.                                           | | ` void`                                                                        | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.                                                          | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`<?>` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`.                                                                                                                                                | | ` int`                                                                         | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object.                                                                                                                                                 | | ` final void`                                                                  | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor.                                                                                                                            | | ` final void`                                                                  | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor.                                                                                                                         | | ` `[String](https://developer.android.com/reference/java/lang/String)          | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object.                                                                                                                                            | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(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](https://developer.android.com/reference/java/lang/Object#wait(long))`(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](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*.                                                                                             | ||

## Public constructors

### Builder

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public Builder (int triggerType)
```

Create a new builder instance to create a[ProfilingTrigger](https://developer.android.com/reference/android/os/ProfilingTrigger)object.

Requires a trigger type. An app can only have one registered trigger per trigger type. Adding a new trigger with the same type will override the previously set one.

<br />

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ||
|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `triggerType` | `int`: Value is[ProfilingTrigger.TRIGGER_TYPE_NONE](https://developer.android.com/reference/android/os/ProfilingTrigger#TRIGGER_TYPE_NONE),[ProfilingTrigger.TRIGGER_TYPE_APP_FULLY_DRAWN](https://developer.android.com/reference/android/os/ProfilingTrigger#TRIGGER_TYPE_APP_FULLY_DRAWN),[ProfilingTrigger.TRIGGER_TYPE_ANR](https://developer.android.com/reference/android/os/ProfilingTrigger#TRIGGER_TYPE_ANR),[ProfilingTrigger.TRIGGER_TYPE_APP_REQUEST_RUNNING_TRACE](https://developer.android.com/reference/android/os/ProfilingTrigger#TRIGGER_TYPE_APP_REQUEST_RUNNING_TRACE),[ProfilingTrigger.TRIGGER_TYPE_KILL_FORCE_STOP](https://developer.android.com/reference/android/os/ProfilingTrigger#TRIGGER_TYPE_KILL_FORCE_STOP),[ProfilingTrigger.TRIGGER_TYPE_KILL_RECENTS](https://developer.android.com/reference/android/os/ProfilingTrigger#TRIGGER_TYPE_KILL_RECENTS), or[ProfilingTrigger.TRIGGER_TYPE_KILL_TASK_MANAGER](https://developer.android.com/reference/android/os/ProfilingTrigger#TRIGGER_TYPE_KILL_TASK_MANAGER) <br /> |

|                                                                  Throws                                                                   ||
|--------------------------------------------------------------------------------------------------------|-----------------------------------|
| [IllegalArgumentException](https://developer.android.com/reference/java/lang/IllegalArgumentException) | if the trigger type is not valid. |

## Public methods

### build

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public ProfilingTrigger build ()
```

Build the[ProfilingTrigger](https://developer.android.com/reference/android/os/ProfilingTrigger)object.

<br />

|                                                           Returns                                                           ||
|-----------------------------------------------------------------------------------------|------------------------------------|
| [ProfilingTrigger](https://developer.android.com/reference/android/os/ProfilingTrigger) | This value cannot be`null`. <br /> |

### setRateLimitingPeriodHours

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public ProfilingTrigger.Builder setRateLimitingPeriodHours (int rateLimitingPeriodHours)
```

Set a rate limiting period in hours.

The period is the minimum time the system should wait before providing another profiling result for the same trigger; actual time between events may be longer.

If the rate limiting period is not provided or set to 0, no app-provided rate limiting will be used.

This rate limiting is in addition to any system level rate limiting that may be applied.

<br />

|               Parameters                ||
|---------------------------|--------------|
| `rateLimitingPeriodHours` | `int` <br /> |

|                                                                   Returns                                                                   ||
|---------------------------------------------------------------------------------------------------------|------------------------------------|
| [ProfilingTrigger.Builder](https://developer.android.com/reference/android/os/ProfilingTrigger.Builder) | This value cannot be`null`. <br /> |

|                                                                Throws                                                                ||
|--------------------------------------------------------------------------------------------------------|------------------------------|
| [IllegalArgumentException](https://developer.android.com/reference/java/lang/IllegalArgumentException) | if the value is less than 0. |