MonitoringInstrumentation
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:
- Forces Application.onCreate() to happen before Instrumentation.onStart() runs (ensuring your code always runs in a sane state).
- Logs application death due to exceptions.
- Allows tracking of activity lifecycle states.
- Registers instrumentation arguments in an easy to access place.
- Ensures your activities are creating themselves in reasonable amounts of time.
- Provides facilities to dump current app threads to test outputs.
- Ensures all activities finish before instrumentation exits.
Summary
Nested types |
|
---|---|
MonitoringInstrumentation.ActivityFinisher |
Loops through all the activities that have not yet finished and explicitly calls finish on them. |
Public constructors |
|
---|---|
Public methods |
|
---|---|
@NonNull void |
callActivityOnCreate(@NonNull Activity activity, @NonNull Bundle bundle) |
@NonNull void |
callActivityOnDestroy(@NonNull Activity activity) |
@NonNull void |
callActivityOnPause(@NonNull Activity activity) |
@NonNull void |
callActivityOnRestart(@NonNull Activity activity) |
@NonNull void |
callActivityOnResume(@NonNull Activity activity) |
@NonNull void |
callActivityOnStart(@NonNull Activity activity) |
@NonNull void |
callActivityOnStop(@NonNull Activity activity) |
@NonNull void |
callApplicationOnCreate(@NonNull Application app) |
@NonNull void |
|
@NonNull ActivityResult |
|
@NonNull ActivityResult |
|
@NonNull ActivityResult |
execStartActivity( This API was added in Android API 23 (M) |
@NonNull ActivityResult |
execStartActivity( This API was added in Android API 17 (JELLY_BEAN_MR1) |
@NonNull ActivityResult |
|
@NonNull void |
Ensures all activities launched in this instrumentation are finished before the instrumentation exits. |
@NonNull void |
interceptActivityUsing( Use the given InterceptingActivityFactory to create Activity instance in |
@NonNull Activity |
newActivity( |
@NonNull Activity |
newActivity( |
@NonNull Application |
newApplication( Does initialization before creating the application. |
@NonNull void |
Sets up lifecycle monitoring, and argument registry. |
@NonNull void |
|
@NonNull boolean |
onException(@NonNull Object obj, @NonNull Throwable e) |
@NonNull void |
onStart() This implementation of onStart() will guarantee that the Application's onCreate method has completed when it returns. |
@NonNull void |
runOnMainSync(@NonNull Runnable runnable) Posts a runnable to the main thread and blocks the caller's thread until the runnable is executed. |
@NonNull Activity |
startActivitySync(@NonNull Intent intent) |
@NonNull void |
Use default mechanism of creating activity instance in |
Public constructors
Public methods
callActivityOnCreate
@NonNull
public void callActivityOnCreate(@NonNull Activity activity, @NonNull Bundle bundle)
execStartActivities
@NonNull
public void execStartActivities(
@NonNull Context who,
@NonNull IBinder contextThread,
@NonNull IBinder token,
@NonNull Activity target,
@NonNull Array<@NonNull Intent> intents,
@NonNull Bundle options
)
execStartActivity
@NonNull
public ActivityResult execStartActivity(
@NonNull Context who,
@NonNull IBinder contextThread,
@NonNull IBinder token,
@NonNull Activity target,
@NonNull Intent intent,
@NonNull int requestCode
)
execStartActivity
@NonNull
public ActivityResult execStartActivity(
@NonNull Context who,
@NonNull IBinder contextThread,
@NonNull IBinder token,
@NonNull Activity target,
@NonNull Intent intent,
@NonNull int requestCode,
@NonNull Bundle options
)
execStartActivity
@NonNull
public ActivityResult execStartActivity(
@NonNull Context who,
@NonNull IBinder contextThread,
@NonNull IBinder token,
@NonNull String target,
@NonNull Intent intent,
@NonNull int requestCode,
@NonNull Bundle options
)
This API was added in Android API 23 (M)
execStartActivity
@NonNull
public ActivityResult execStartActivity(
@NonNull Context who,
@NonNull IBinder contextThread,
@NonNull IBinder token,
@NonNull Activity target,
@NonNull Intent intent,
@NonNull int requestCode,
@NonNull Bundle options,
@NonNull UserHandle user
)
This API was added in Android API 17 (JELLY_BEAN_MR1)
execStartActivity
@NonNull
public ActivityResult execStartActivity(
@NonNull Context who,
@NonNull IBinder contextThread,
@NonNull IBinder token,
@NonNull Fragment target,
@NonNull Intent intent,
@NonNull int requestCode,
@NonNull Bundle options
)
finish
@NonNull
public void finish(@NonNull int resultCode, @NonNull 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.
interceptActivityUsing
@NonNull
public void interceptActivityUsing(
@NonNull InterceptingActivityFactory interceptingActivityFactory
)
Use the given InterceptingActivityFactory to create Activity instance in . 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 | |
---|---|
@NonNull InterceptingActivityFactory interceptingActivityFactory |
InterceptingActivityFactory to be used for creating activity instance in |
newActivity
@NonNull
public Activity newActivity(
@NonNull Class<@NonNull Object> clazz,
@NonNull Context context,
@NonNull IBinder token,
@NonNull Application application,
@NonNull Intent intent,
@NonNull ActivityInfo info,
@NonNull CharSequence title,
@NonNull Activity parent,
@NonNull String id,
@NonNull Object lastNonConfigurationInstance
)
newActivity
@NonNull
public Activity newActivity(
@NonNull ClassLoader cl,
@NonNull String className,
@NonNull Intent intent
)
newApplication
@NonNull
public Application newApplication(
@NonNull ClassLoader cl,
@NonNull String className,
@NonNull Context context
)
Does initialization before creating the application.
Note, newApplication
is called before on API >15. For API <= 15,
onCreate
is called first.
onCreate
@NonNull
public void onCreate(@NonNull 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.
onStart
@NonNull
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.
runOnMainSync
@NonNull
public void runOnMainSync(@NonNull 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
.
useDefaultInterceptingActivityFactory
@NonNull
public void useDefaultInterceptingActivityFactory()
Use default mechanism of creating activity instance in newActivity