MonitoringInstrumentation

MonitoringInstrumentation

MonitoringInstrumentation ()

callActivityOnCreate

void callActivityOnCreate (Activity activity, 
                Bundle bundle)

callActivityOnDestroy

void callActivityOnDestroy (Activity activity)

callActivityOnPause

void callActivityOnPause (Activity activity)

callActivityOnRestart

void callActivityOnRestart (Activity activity)

callActivityOnResume

void callActivityOnResume (Activity activity)

callActivityOnStart

void callActivityOnStart (Activity activity)

callActivityOnStop

void callActivityOnStop (Activity activity)

callApplicationOnCreate

void callApplicationOnCreate (Application app)

execStartActivities

void execStartActivities (Context who, 
                IBinder contextThread, 
                IBinder token, 
                Activity target, 
                Intent[] intents, 
                Bundle options)

execStartActivity

Instrumentation.ActivityResult execStartActivity (Context who, 
                IBinder contextThread, 
                IBinder token, 
                Fragment target, 
                Intent intent, 
                int requestCode, 
                Bundle options)

execStartActivity

Instrumentation.ActivityResult execStartActivity (Context who, 
                IBinder contextThread, 
                IBinder token, 
                Activity target, 
                Intent intent, 
                int requestCode, 
                Bundle options)

execStartActivity

Instrumentation.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)

execStartActivity

Instrumentation.ActivityResult execStartActivity (Context who, 
                IBinder contextThread, 
                IBinder token, 
                Activity target, 
                Intent intent, 
                int requestCode)

execStartActivity

Instrumentation.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)

finish

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.

interceptActivityUsing

void interceptActivityUsing (InterceptingActivityFactory interceptingActivityFactory)

Use the given InterceptingActivityFactory to create Activity instance in newActivity(ClassLoader, String, Intent). 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.

newActivity

Activity newActivity (Class<?> clazz, 
                Context context, 
                IBinder token, 
                Application application, 
                Intent intent, 
                ActivityInfo info, 
                CharSequence title, 
                Activity parent, 
                String id, 
                Object lastNonConfigurationInstance)

newActivity

Activity newActivity (ClassLoader cl, 
                String className, 
                Intent intent)

onCreate

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.

onDestroy

void onDestroy ()

onException

boolean onException (Object obj, 
                Throwable e)

onStart

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

void runOnMainSync (Runnable runnable)

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

startActivitySync

Activity startActivitySync (Intent intent)

useDefaultInterceptingActivityFactory

void useDefaultInterceptingActivityFactory ()

Use default mechanism of creating activity instance in newActivity(ClassLoader, String, Intent)

dumpThreadStateToOutputs

void dumpThreadStateToOutputs (String outputFileName)

getThreadState

String getThreadState ()

installMultidex

void installMultidex ()

installOldMultiDex

void installOldMultiDex (Class<?> multidexClass)

Perform application MultiDex installation only when instrumentation installation is not available. Called when MultiDex class is available but MultiDex.installInstrumentation is not.

isPrimaryInstrProcess

boolean isPrimaryInstrProcess ()

Checks whether this instance of instrumentation should be considered as a primary instrumentation process.

Prior to API 26, instrumentation could only run in a single process and that would be the primary process. Post API 26, the primary process is the first process listed in android:targetProcesses or the default process of the targetPackage.

isPrimaryInstrProcess

boolean isPrimaryInstrProcess (String argsProcessName)

This method is deprecated.
use isPrimaryInstrProcess()

Checks whether this instance of instrumentation should be considered as a primary instrumentation process.

Prior to API 26, instrumentation could only run in a single process and that would be the primary process. Post API 26, the primary process is the first process listed in android:targetProcesses or the default process of the targetPackage.

restoreUncaughtExceptionHandler

void restoreUncaughtExceptionHandler ()

setJsBridgeClassName

void setJsBridgeClassName (String className)

shouldWaitForActivitiesToComplete

boolean shouldWaitForActivitiesToComplete ()

specifyDexMakerCacheProperty

void specifyDexMakerCacheProperty ()

waitForActivitiesToComplete

void waitForActivitiesToComplete ()

Ensures we've onStopped() all activities which were onStarted().

According to Activity's contract, the process is not killable between onStart and onStop. Breaking this contract (which finish() will if you let it) can cause bad behaviour (including a full restart of system_server).

We give the app 2 seconds to stop all its activities, then we proceed.

This should never be run on the main thread.