Package org.robolectric.android.internal

Class RoboMonitoringInstrumentation

java.lang.Object

android.app.Instrumentation

org.robolectric.android.internal.RoboMonitoringInstrumentation

public class RoboMonitoringInstrumentation
extends Instrumentation

A Robolectric instrumentation that acts like a slimmed down MonitoringInstrumentation with only the parts needed for Robolectric.

Nested Class Summary

Nested classes/interfaces inherited from class android.app.Instrumentation

Instrumentation.ActivityMonitor, Instrumentation.ActivityResult, Instrumentation.UiAutomationFlags

Field Summary

Fields inherited from class android.app.Instrumentation

REPORT_KEY_IDENTIFIER, REPORT_KEY_STREAMRESULT

Constructor Summary

Constructors

Constructor	Description
RoboMonitoringInstrumentation()

Method Summary

Modifier and Type	Method	Description
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, String target, Intent intent, int requestCode, Bundle options)	This API was added in Android API 23 (M)
Instrumentation.ActivityResult	execStartActivity(Context who, IBinder contextThread, IBinder token, String target, Intent intent, int requestCode, Bundle options, UserHandle user)	This API was added in Android API 17 (JELLY_BEAN_MR1)
void	finish(int resultCode, Bundle bundle)
Context	getContext()
Context	getTargetContext()
protected String	getThreadState()
void	onCreate(Bundle arguments)	Sets up lifecycle monitoring, and argument registry.
boolean	onException(Object obj, Throwable e)
void	runOnMainSync(Runnable runnable)	Executes a runnable on the main thread, blocking until it is complete.
Activity	startActivitySync(Intent intent)
ActivityController<? extends Activity>	startActivitySyncInternal(Intent intent)
ActivityController<? extends Activity>	startActivitySyncInternal(Intent intent, Bundle activityOptions)
void	waitForIdleSync()

Methods inherited from class android.app.Instrumentation

acquireLooperManager, addMonitor, addMonitor, addMonitor, addResults, callActivityOnCreate, callActivityOnNewIntent, callActivityOnNewIntent, callActivityOnPictureInPictureRequested, callActivityOnPostCreate, callActivityOnPostCreate, callActivityOnRestoreInstanceState, callActivityOnRestoreInstanceState, callActivityOnSaveInstanceState, callActivityOnSaveInstanceState, callActivityOnUserLeaving, checkMonitorHit, checkStartActivityResult, endPerformanceSnapshot, execStartActivitiesAsUser, execStartActivityAsCaller, execStartActivityFromAppTask, getAllocCounts, getBinderCounts, getComponentName, getProcessName, getUiAutomation, getUiAutomation, invokeContextMenuAction, invokeMenuActionSync, isInstrumenting, isProfiling, newActivity, newActivity, newApplication, newApplication, onDestroy, onEnterAnimationComplete, onStart, removeMonitor, resetInTouchMode, sendCharacterSync, sendKeyDownUpSync, sendKeySync, sendPointerSync, sendStatus, sendStringSync, sendTrackballEventSync, setAutomaticPerformanceSnapshots, setInTouchMode, start, startActivitySync, startAllocCounting, startPerformanceSnapshot, startProfiling, stopAllocCounting, stopProfiling, waitForIdle, waitForMonitor, waitForMonitorWithTimeout

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

RoboMonitoringInstrumentation

public RoboMonitoringInstrumentation()

Method Details

onCreate

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.

Overrides:

onCreate in class Instrumentation

waitForIdleSync

public void waitForIdleSync()

Overrides:

waitForIdleSync in class Instrumentation

startActivitySync

public Activity startActivitySync(Intent intent)

Overrides:

startActivitySync in class Instrumentation

startActivitySyncInternal

public ActivityController<? extends Activity> startActivitySyncInternal(Intent intent)

startActivitySyncInternal

public ActivityController<? extends Activity> startActivitySyncInternal(Intent intent,
 @Nullable
 Bundle activityOptions)

callApplicationOnCreate

public void callApplicationOnCreate(Application app)

Overrides:

callApplicationOnCreate in class Instrumentation

runOnMainSync

public void runOnMainSync(Runnable runnable)

Executes a runnable on the main thread, blocking until it is complete.

When in INSTUMENTATION_TEST Looper mode, the runnable is posted to the main handler and the caller's thread blocks until that runnable has finished. 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.

For other Looper modes, the main looper is idled and then the runnable is executed in the caller's thread.

Overrides:

runOnMainSync in class Instrumentation

Parameters:

runnable - a runnable to be executed on the main thread

execStartActivity

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

Overrides:

execStartActivity in class Instrumentation

execStartActivity

public 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)

Overrides:

execStartActivity in class Instrumentation

execStartActivity

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

This API was added in Android API 17 (JELLY_BEAN_MR1)

Overrides:

execStartActivity in class Instrumentation

execStartActivities

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

Overrides:

execStartActivities in class Instrumentation

onException

public boolean onException(Object obj,
 Throwable e)

Overrides:

onException in class Instrumentation

getThreadState

protected String getThreadState()

callActivityOnDestroy

public void callActivityOnDestroy(Activity activity)

Overrides:

callActivityOnDestroy in class Instrumentation

callActivityOnRestart

public void callActivityOnRestart(Activity activity)

Overrides:

callActivityOnRestart in class Instrumentation

callActivityOnCreate

public void callActivityOnCreate(Activity activity,
 Bundle bundle)

Overrides:

callActivityOnCreate in class Instrumentation

callActivityOnStart

public void callActivityOnStart(Activity activity)

Overrides:

callActivityOnStart in class Instrumentation

callActivityOnStop

public void callActivityOnStop(Activity activity)

Overrides:

callActivityOnStop in class Instrumentation

callActivityOnResume

public void callActivityOnResume(Activity activity)

Overrides:

callActivityOnResume in class Instrumentation

callActivityOnPause

public void callActivityOnPause(Activity activity)

Overrides:

callActivityOnPause in class Instrumentation

finish

public void finish(int resultCode,
 Bundle bundle)

Overrides:

finish in class Instrumentation

getTargetContext

public Context getTargetContext()

Overrides:

getTargetContext in class Instrumentation

getContext

public Context getContext()

Overrides:

getContext in class Instrumentation