{% setvar book_path %}/reference/kotlin/androidx/_book.yaml{% endsetvar %} {% include "_shared/_reference-head-tags.html" %}

MonitoringInstrumentation

class MonitoringInstrumentation

An instrumentation that enables several advanced features and makes some hard guarantees about the state of the application under instrumentation.

A short list of these capabilities:

This Instrumentation is *NOT* a test instrumentation (some of its subclasses are). It makes no assumptions about what the subclass wants to do.

Summary

Nested types
MonitoringInstrumentation.ActivityFinisher

Loops through all the activities that have not yet finished and explicitly calls finish on them.

Public constructors

Public functions
Unit
callActivityOnCreate(activity: Activity!, bundle: Bundle!)
Unit
callActivityOnDestroy(activity: Activity!)
Unit
callActivityOnPause(activity: Activity!)
Unit
callActivityOnRestart(activity: Activity!)
Unit
callActivityOnResume(activity: Activity!)
Unit
callActivityOnStart(activity: Activity!)
Unit
callActivityOnStop(activity: Activity!)
Unit
callApplicationOnCreate(app: Application!)
Unit
execStartActivities(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: Activity!,
    intents: Array<Intent!>!,
    options: Bundle!
)
ActivityResult!
execStartActivity(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: Activity!,
    intent: Intent!,
    requestCode: Int
)
ActivityResult!
execStartActivity(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: Activity!,
    intent: Intent!,
    requestCode: Int,
    options: Bundle!
)
ActivityResult!
execStartActivity(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: String!,
    intent: Intent!,
    requestCode: Int,
    options: Bundle!
)

This API was added in Android API 23 (M)
ActivityResult!
execStartActivity(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: Activity!,
    intent: Intent!,
    requestCode: Int,
    options: Bundle!,
    user: UserHandle!
)

This API was added in Android API 17 (JELLY_BEAN_MR1)
ActivityResult!
execStartActivity(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: Fragment!,
    intent: Intent!,
    requestCode: Int,
    options: Bundle!
)
Unit
finish(resultCode: Int, results: Bundle!)

Ensures all activities launched in this instrumentation are finished before the instrumentation exits.
Unit
interceptActivityUsing(
    interceptingActivityFactory: InterceptingActivityFactory!
)

Use the given InterceptingActivityFactory to create Activity instance in newActivity.
Activity!
newActivity(
    clazz: Class<Any!>!,
    context: Context!,
    token: IBinder!,
    application: Application!,
    intent: Intent!,
    info: ActivityInfo!,
    title: CharSequence!,
    parent: Activity!,
    id: String!,
    lastNonConfigurationInstance: Any!
)
Activity!
newActivity(cl: ClassLoader!, className: String!, intent: Intent!)
Application!
newApplication(cl: ClassLoader!, className: String!, context: Context!)

Does initialization before creating the application.
Unit
onCreate(arguments: Bundle!)

Sets up lifecycle monitoring, and argument registry.
Unit
Boolean
onException(obj: Any!, e: Throwable!)
Unit

This implementation of onStart() will guarantee that the Application's onCreate method has completed when it returns.
Unit
runOnMainSync(runnable: Runnable!)

Posts a runnable to the main thread and blocks the caller's thread until the runnable is executed.
Activity!
startActivitySync(intent: Intent!)
Unit

Use default mechanism of creating activity instance in newActivity

Public constructors

MonitoringInstrumentation

MonitoringInstrumentation()

Public functions

callActivityOnCreate

fun callActivityOnCreate(activity: Activity!, bundle: Bundle!): Unit

callActivityOnDestroy

fun callActivityOnDestroy(activity: Activity!): Unit

callActivityOnPause

fun callActivityOnPause(activity: Activity!): Unit

callActivityOnRestart

fun callActivityOnRestart(activity: Activity!): Unit

callActivityOnResume

fun callActivityOnResume(activity: Activity!): Unit

callActivityOnStart

fun callActivityOnStart(activity: Activity!): Unit

callActivityOnStop

fun callActivityOnStop(activity: Activity!): Unit

callApplicationOnCreate

fun callApplicationOnCreate(app: Application!): Unit

execStartActivities

fun execStartActivities(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: Activity!,
    intents: Array<Intent!>!,
    options: Bundle!
): Unit

execStartActivity

fun execStartActivity(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: Activity!,
    intent: Intent!,
    requestCode: Int
): ActivityResult!

execStartActivity

fun execStartActivity(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: Activity!,
    intent: Intent!,
    requestCode: Int,
    options: Bundle!
): ActivityResult!

execStartActivity

fun execStartActivity(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: String!,
    intent: Intent!,
    requestCode: Int,
    options: Bundle!
): ActivityResult!

This API was added in Android API 23 (M)

execStartActivity

fun execStartActivity(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: Activity!,
    intent: Intent!,
    requestCode: Int,
    options: Bundle!,
    user: UserHandle!
): ActivityResult!

This API was added in Android API 17 (JELLY_BEAN_MR1)

execStartActivity

fun execStartActivity(
    who: Context!,
    contextThread: IBinder!,
    token: IBinder!,
    target: Fragment!,
    intent: Intent!,
    requestCode: Int,
    options: Bundle!
): ActivityResult!

finish

fun finish(resultCode: Int, results: Bundle!): Unit

Ensures all activities launched in this instrumentation are finished before the instrumentation exits.

Subclasses who override this method should do their finish processing and then call super.finish to invoke this logic. Not waiting for all activities to finish() before exiting can cause device wide instability.

interceptActivityUsing

fun interceptActivityUsing(
    interceptingActivityFactory: InterceptingActivityFactory!
): Unit

Use the given InterceptingActivityFactory to create Activity instance in newActivity. This can be used to override default behavior of activity in tests e.g. mocking startService() method in Activity under test, to avoid starting the real service and instead verifying that a particular service was started.

Parameters
interceptingActivityFactory: InterceptingActivityFactory!

InterceptingActivityFactory to be used for creating activity instance in newActivity

newActivity

fun newActivity(
    clazz: Class<Any!>!,
    context: Context!,
    token: IBinder!,
    application: Application!,
    intent: Intent!,
    info: ActivityInfo!,
    title: CharSequence!,
    parent: Activity!,
    id: String!,
    lastNonConfigurationInstance: Any!
): Activity!
Throws
java.lang.IllegalAccessException: java.lang.IllegalAccessException
java.lang.InstantiationException: java.lang.InstantiationException

newActivity

fun newActivity(cl: ClassLoader!, className: String!, intent: Intent!): Activity!
Throws
java.lang.ClassNotFoundException: java.lang.ClassNotFoundException
java.lang.IllegalAccessException: java.lang.IllegalAccessException
java.lang.InstantiationException: java.lang.InstantiationException

newApplication

fun newApplication(cl: ClassLoader!, className: String!, context: Context!): Application!

Does initialization before creating the application.

Note, newApplication is called before onCreate on API >15. For API <= 15, onCreate is called first.

Throws
java.lang.ClassNotFoundException: java.lang.ClassNotFoundException
java.lang.IllegalAccessException: java.lang.IllegalAccessException
java.lang.InstantiationException: java.lang.InstantiationException

onCreate

fun onCreate(arguments: Bundle!): Unit

Sets up lifecycle monitoring, and argument registry.

Subclasses must call up to onCreate(). This onCreate method does not call start() it is the subclasses responsibility to call start if it desires.

onDestroy

fun onDestroy(): Unit

onException

fun onException(obj: Any!, e: Throwable!): Boolean

onStart

fun onStart(): Unit

This implementation of onStart() will guarantee that the Application's onCreate method has completed when it returns.

Subclasses should call super.onStart() before executing any code that touches the application and it's state.

runOnMainSync

fun runOnMainSync(runnable: Runnable!): Unit

Posts a runnable to the main thread and blocks the caller's thread until the runnable is executed. When a Throwable is thrown in the runnable, the exception is propagated back to the caller's thread. If it is an unchecked throwable, it will be rethrown as is. If it is a checked exception, it will be rethrown as a RuntimeException.

Parameters
runnable: Runnable!

a runnable to be executed on the main thread

startActivitySync

fun startActivitySync(intent: Intent!): Activity!

useDefaultInterceptingActivityFactory

fun useDefaultInterceptingActivityFactory(): Unit

Use default mechanism of creating activity instance in newActivity