{% setvar book_path %}/reference/androidx/_book.yaml{% endsetvar %} {% include "_shared/_reference-head-tags.html" %}
public 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:
Nested types |
|
|---|---|
MonitoringInstrumentation.ActivityFinisher |
Loops through all the activities that have not yet finished and explicitly calls finish on them. |
Public constructors |
|
|---|---|
Public methods |
|
|---|---|
void |
callActivityOnCreate(Activity activity, Bundle bundle) |
void |
callActivityOnDestroy(Activity activity) |
void |
callActivityOnPause(Activity activity) |
void |
callActivityOnRestart(Activity activity) |
void |
callActivityOnResume(Activity activity) |
void |
callActivityOnStart(Activity activity) |
void |
callActivityOnStop(Activity activity) |
void |
callApplicationOnCreate(Application app) |
void |
execStartActivities( |
ActivityResult |
execStartActivity( |
ActivityResult |
execStartActivity( |
ActivityResult |
execStartActivity(This API was added in Android API 23 (M) |
ActivityResult |
execStartActivity(This API was added in Android API 17 (JELLY_BEAN_MR1) |
ActivityResult |
execStartActivity( |
void |
finish(int resultCode, Bundle results)Ensures all activities launched in this instrumentation are finished before the instrumentation exits. |
void |
interceptActivityUsing(Use the given InterceptingActivityFactory to create Activity instance in |
Activity |
newActivity( |
Activity |
newActivity(ClassLoader cl, String className, Intent intent) |
Application |
newApplication(ClassLoader cl, String className, Context context)Does initialization before creating the application. |
void |
onCreate(Bundle arguments)Sets up lifecycle monitoring, and argument registry. |
void |
|
boolean |
onException(Object obj, Throwable e) |
void |
onStart()This implementation of onStart() will guarantee that the Application's onCreate method has completed when it returns. |
void |
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) |
void |
Use default mechanism of creating activity instance in |
public void execStartActivities(
Context who,
IBinder contextThread,
IBinder token,
Activity target,
Intent[] intents,
Bundle options
)
public ActivityResult execStartActivity(
Context who,
IBinder contextThread,
IBinder token,
Activity target,
Intent intent,
int requestCode
)
public ActivityResult execStartActivity(
Context who,
IBinder contextThread,
IBinder token,
Activity target,
Intent intent,
int requestCode,
Bundle options
)
public ActivityResult execStartActivity(
Context who,
IBinder contextThread,
IBinder token,
String target,
Intent intent,
int requestCode,
Bundle options
)
This API was added in Android API 23 (M)
public ActivityResult execStartActivity(
Context who,
IBinder contextThread,
IBinder token,
Activity target,
Intent intent,
int requestCode,
Bundle options,
UserHandle user
)
This API was added in Android API 17 (JELLY_BEAN_MR1)
public ActivityResult execStartActivity(
Context who,
IBinder contextThread,
IBinder token,
Fragment target,
Intent intent,
int requestCode,
Bundle options
)
public void finish(int resultCode, Bundle results)
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.
public void interceptActivityUsing(
InterceptingActivityFactory interceptingActivityFactory
)
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 |
public Activity newActivity(
Class<Object> clazz,
Context context,
IBinder token,
Application application,
Intent intent,
ActivityInfo info,
CharSequence title,
Activity parent,
String id,
Object lastNonConfigurationInstance
)
| Throws | |
|---|---|
java.lang.IllegalAccessException java.lang.IllegalAccessException |
|
java.lang.InstantiationException java.lang.InstantiationException |
|
public Activity newActivity(ClassLoader cl, String className, Intent intent)
| Throws | |
|---|---|
java.lang.ClassNotFoundException java.lang.ClassNotFoundException |
|
java.lang.IllegalAccessException java.lang.IllegalAccessException |
|
java.lang.InstantiationException java.lang.InstantiationException |
|
public Application newApplication(ClassLoader cl, String className, Context context)
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 |
|
public void onCreate(Bundle arguments)
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.
public void onStart()
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.
public void runOnMainSync(Runnable runnable)
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 |
public void useDefaultInterceptingActivityFactory()
Use default mechanism of creating activity instance in newActivity