MonitoringInstrumentation

Classes

public class

MonitoringInstrumentation

extends Instrumentation

java.lang.Object
↳	android.app.Instrumentation
	↳	android.support.test.runner.MonitoringInstrumentation

Known Direct Subclasses

AndroidJUnitRunner

Class Overview

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.

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 Classes
class	MonitoringInstrumentation.ActivityFinisher	Loops through all the activities that have not yet finished and explicitly calls finish on them.

[Expand]

Inherited Constants

From class android.app.Instrumentation

Public Constructors
	MonitoringInstrumentation()

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(Context who, IBinder contextThread, IBinder token, Activity target, Intent[] intents, Bundle options)
Instrumentation.ActivityResult	execStartActivity(Context who, IBinder contextThread, IBinder token, Activity target, Intent intent, int requestCode, Bundle options)
Instrumentation.ActivityResult	execStartActivity(Context who, IBinder contextThread, IBinder token, Activity target, Intent intent, int requestCode)
Instrumentation.ActivityResult	execStartActivity(Context who, IBinder contextThread, IBinder token, Fragment target, Intent intent, int requestCode, Bundle options)
void	finish(int resultCode, Bundle results) Ensures all activities launched in this instrumentation are finished before the instrumentation exits.
Activity	newActivity(Class<?> clazz, Context context, IBinder token, Application application, Intent intent, ActivityInfo info, CharSequence title, Activity parent, String id, Object lastNonConfigurationInstance)
void	onCreate(Bundle arguments) Sets up lifecycle monitoring, and argument registry.
void	onDestroy()
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.
Activity	startActivitySync(Intent intent)

Protected Methods
void	dumpThreadStateToOutputs(String outputFileName)
String	getThreadState()
void	waitForActivitiesToComplete() Ensures we've onStopped() all activities which were onStarted().

[Expand]

Inherited Methods

From class android.app.Instrumentation

Instrumentation.ActivityMonitor	addMonitor(IntentFilter arg0, Instrumentation.ActivityResult arg1, boolean arg2)
void	addMonitor(Instrumentation.ActivityMonitor arg0)
Instrumentation.ActivityMonitor	addMonitor(String arg0, Instrumentation.ActivityResult arg1, boolean arg2)
void	callActivityOnCreate(Activity arg0, Bundle arg1)
void	callActivityOnCreate(Activity arg0, Bundle arg1, PersistableBundle arg2)
void	callActivityOnDestroy(Activity arg0)
void	callActivityOnNewIntent(Activity arg0, Intent arg1)
void	callActivityOnPause(Activity arg0)
void	callActivityOnPostCreate(Activity arg0, Bundle arg1, PersistableBundle arg2)
void	callActivityOnPostCreate(Activity arg0, Bundle arg1)
void	callActivityOnRestart(Activity arg0)
void	callActivityOnRestoreInstanceState(Activity arg0, Bundle arg1)
void	callActivityOnRestoreInstanceState(Activity arg0, Bundle arg1, PersistableBundle arg2)
void	callActivityOnResume(Activity arg0)
void	callActivityOnSaveInstanceState(Activity arg0, Bundle arg1)
void	callActivityOnSaveInstanceState(Activity arg0, Bundle arg1, PersistableBundle arg2)
void	callActivityOnStart(Activity arg0)
void	callActivityOnStop(Activity arg0)
void	callActivityOnUserLeaving(Activity arg0)
void	callApplicationOnCreate(Application arg0)
boolean	checkMonitorHit(Instrumentation.ActivityMonitor arg0, int arg1)
void	endPerformanceSnapshot()
void	finish(int arg0, Bundle arg1)
Bundle	getAllocCounts()
Bundle	getBinderCounts()
ComponentName	getComponentName()
Context	getContext()
Context	getTargetContext()
UiAutomation	getUiAutomation()
boolean	invokeContextMenuAction(Activity arg0, int arg1, int arg2)
boolean	invokeMenuActionSync(Activity arg0, int arg1, int arg2)
boolean	isProfiling()
Activity	newActivity(ClassLoader arg0, String arg1, Intent arg2)
Activity	newActivity(Class<?> arg0, Context arg1, IBinder arg2, Application arg3, Intent arg4, ActivityInfo arg5, CharSequence arg6, Activity arg7, String arg8, Object arg9)
Application	newApplication(ClassLoader arg0, String arg1, Context arg2)
static Application	newApplication(Class<?> arg0, Context arg1)
void	onCreate(Bundle arg0)
void	onDestroy()
boolean	onException(Object arg0, Throwable arg1)
void	onStart()
void	removeMonitor(Instrumentation.ActivityMonitor arg0)
void	runOnMainSync(Runnable arg0)
void	sendCharacterSync(int arg0)
void	sendKeyDownUpSync(int arg0)
void	sendKeySync(KeyEvent arg0)
void	sendPointerSync(MotionEvent arg0)
void	sendStatus(int arg0, Bundle arg1)
void	sendStringSync(String arg0)
void	sendTrackballEventSync(MotionEvent arg0)
void	setAutomaticPerformanceSnapshots()
void	setInTouchMode(boolean arg0)
void	start()
Activity	startActivitySync(Intent arg0)
void	startAllocCounting()
void	startPerformanceSnapshot()
void	startProfiling()
void	stopAllocCounting()
void	stopProfiling()
void	waitForIdle(Runnable arg0)
void	waitForIdleSync()
Activity	waitForMonitor(Instrumentation.ActivityMonitor arg0)
Activity	waitForMonitorWithTimeout(Instrumentation.ActivityMonitor arg0, long arg1)

From class java.lang.Object

Public Constructors

public MonitoringInstrumentation ()

Public Methods

public void callActivityOnCreate (Activity activity, Bundle bundle)

public void callActivityOnDestroy (Activity activity)

public void callActivityOnPause (Activity activity)

public void callActivityOnRestart (Activity activity)

public void callActivityOnResume (Activity activity)

public void callActivityOnStart (Activity activity)

public void callActivityOnStop (Activity activity)

public void callApplicationOnCreate (Application app)

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

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

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

public Instrumentation.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 Activity newActivity (Class<?> clazz, Context context, IBinder token, Application application, Intent intent, ActivityInfo info, CharSequence title, Activity parent, String id, Object lastNonConfigurationInstance)

Throws

InstantiationException
IllegalAccessException

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 onDestroy ()

public boolean onException (Object obj, Throwable e)

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 Activity startActivitySync (Intent intent)

Protected Methods

protected void dumpThreadStateToOutputs (String outputFileName)

protected String getThreadState ()

protected 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.

Results

Classes