| Methods Summary |
|---|
| public void | addMonitor(android.app.Instrumentation$ActivityMonitor monitor)Add a new {@link ActivityMonitor} that will be checked whenever an
activity is started. The monitor is added
after any existing ones; the monitor will be hit only if none of the
existing monitors can themselves handle the Intent.
synchronized (mSync) {
if (mActivityMonitors == null) {
mActivityMonitors = new ArrayList();
}
mActivityMonitors.add(monitor);
}
|
| public android.app.Instrumentation$ActivityMonitor | addMonitor(android.content.IntentFilter filter, android.app.Instrumentation$ActivityResult result, boolean block)A convenience wrapper for {@link #addMonitor(ActivityMonitor)} that
creates an intent filter matching {@link ActivityMonitor} for you and
returns it.
ActivityMonitor am = new ActivityMonitor(filter, result, block);
addMonitor(am);
return am;
|
| public android.app.Instrumentation$ActivityMonitor | addMonitor(java.lang.String cls, android.app.Instrumentation$ActivityResult result, boolean block)A convenience wrapper for {@link #addMonitor(ActivityMonitor)} that
creates a class matching {@link ActivityMonitor} for you and returns it.
ActivityMonitor am = new ActivityMonitor(cls, result, block);
addMonitor(am);
return am;
|
| private void | addValue(java.lang.String key, int value, android.os.Bundle results)If Results already contains Key, it appends Value to the key's ArrayList
associated with the key. If the key doesn't already exist in results, it
adds the key/value pair to results.
if (results.containsKey(key)) {
List<Integer> list = results.getIntegerArrayList(key);
if (list != null) {
list.add(value);
}
} else {
ArrayList<Integer> list = new ArrayList<Integer>();
list.add(value);
results.putIntegerArrayList(key, list);
}
|
| public void | callActivityOnCreate(Activity activity, android.os.Bundle icicle)Perform calling of an activity's {@link Activity#onCreate}
method. The default implementation simply calls through to that method.
prePerformCreate(activity);
activity.performCreate(icicle);
postPerformCreate(activity);
|
| public void | callActivityOnCreate(Activity activity, android.os.Bundle icicle, android.os.PersistableBundle persistentState)Perform calling of an activity's {@link Activity#onCreate}
method. The default implementation simply calls through to that method.
prePerformCreate(activity);
activity.performCreate(icicle, persistentState);
postPerformCreate(activity);
|
| public void | callActivityOnDestroy(Activity activity)
// TODO: the following block causes intermittent hangs when using startActivity
// temporarily comment out until root cause is fixed (bug 2630683)
// if (mWaitingActivities != null) {
// synchronized (mSync) {
// final int N = mWaitingActivities.size();
// for (int i=0; i<N; i++) {
// final ActivityWaiter aw = mWaitingActivities.get(i);
// final Intent intent = aw.intent;
// if (intent.filterEquals(activity.getIntent())) {
// aw.activity = activity;
// mMessageQueue.addIdleHandler(new ActivityGoing(aw));
// }
// }
// }
// }
activity.performDestroy();
if (mActivityMonitors != null) {
synchronized (mSync) {
final int N = mActivityMonitors.size();
for (int i=0; i<N; i++) {
final ActivityMonitor am = mActivityMonitors.get(i);
am.match(activity, activity, activity.getIntent());
}
}
}
|
| public void | callActivityOnNewIntent(Activity activity, android.content.Intent intent)Perform calling of an activity's {@link Activity#onNewIntent}
method. The default implementation simply calls through to that method.
activity.onNewIntent(intent);
|
| public void | callActivityOnNewIntent(Activity activity, com.android.internal.content.ReferrerIntent intent)
final String oldReferrer = activity.mReferrer;
try {
if (intent != null) {
activity.mReferrer = intent.mReferrer;
}
callActivityOnNewIntent(activity, intent != null ? new Intent(intent) : null);
} finally {
activity.mReferrer = oldReferrer;
}
|
| public void | callActivityOnPause(Activity activity)Perform calling of an activity's {@link Activity#onPause} method. The
default implementation simply calls through to that method.
activity.performPause();
|
| public void | callActivityOnPostCreate(Activity activity, android.os.Bundle icicle)Perform calling of an activity's {@link Activity#onPostCreate} method.
The default implementation simply calls through to that method.
activity.onPostCreate(icicle);
|
| public void | callActivityOnPostCreate(Activity activity, android.os.Bundle icicle, android.os.PersistableBundle persistentState)Perform calling of an activity's {@link Activity#onPostCreate} method.
The default implementation simply calls through to that method.
activity.onPostCreate(icicle, persistentState);
|
| public void | callActivityOnRestart(Activity activity)Perform calling of an activity's {@link Activity#onRestart}
method. The default implementation simply calls through to that method.
activity.onRestart();
|
| public void | callActivityOnRestoreInstanceState(Activity activity, android.os.Bundle savedInstanceState)Perform calling of an activity's {@link Activity#onRestoreInstanceState}
method. The default implementation simply calls through to that method.
activity.performRestoreInstanceState(savedInstanceState);
|
| public void | callActivityOnRestoreInstanceState(Activity activity, android.os.Bundle savedInstanceState, android.os.PersistableBundle persistentState)Perform calling of an activity's {@link Activity#onRestoreInstanceState}
method. The default implementation simply calls through to that method.
activity.performRestoreInstanceState(savedInstanceState, persistentState);
|
| public void | callActivityOnResume(Activity activity)Perform calling of an activity's {@link Activity#onResume} method. The
default implementation simply calls through to that method.
activity.mResumed = true;
activity.onResume();
if (mActivityMonitors != null) {
synchronized (mSync) {
final int N = mActivityMonitors.size();
for (int i=0; i<N; i++) {
final ActivityMonitor am = mActivityMonitors.get(i);
am.match(activity, activity, activity.getIntent());
}
}
}
|
| public void | callActivityOnSaveInstanceState(Activity activity, android.os.Bundle outState)Perform calling of an activity's {@link Activity#onSaveInstanceState}
method. The default implementation simply calls through to that method.
activity.performSaveInstanceState(outState);
|
| public void | callActivityOnSaveInstanceState(Activity activity, android.os.Bundle outState, android.os.PersistableBundle outPersistentState)Perform calling of an activity's {@link Activity#onSaveInstanceState}
method. The default implementation simply calls through to that method.
activity.performSaveInstanceState(outState, outPersistentState);
|
| public void | callActivityOnStart(Activity activity)Perform calling of an activity's {@link Activity#onStart}
method. The default implementation simply calls through to that method.
activity.onStart();
|
| public void | callActivityOnStop(Activity activity)Perform calling of an activity's {@link Activity#onStop}
method. The default implementation simply calls through to that method.
activity.onStop();
|
| public void | callActivityOnUserLeaving(Activity activity)Perform calling of an activity's {@link Activity#onUserLeaveHint} method.
The default implementation simply calls through to that method.
activity.performUserLeaving();
|
| public void | callApplicationOnCreate(Application app)Perform calling of the application's {@link Application#onCreate}
method. The default implementation simply calls through to that method.
Note: This method will be called immediately after {@link #onCreate(Bundle)}.
Often instrumentation tests start their test thread in onCreate(); you
need to be careful of races between these. (Well between it and
everything else, but let's start here.)
app.onCreate();
|
| public boolean | checkMonitorHit(android.app.Instrumentation$ActivityMonitor monitor, int minHits)Test whether an existing {@link ActivityMonitor} has been hit. If the
monitor has been hit at least minHits times, then it will be
removed from the activity monitor list and true returned. Otherwise it
is left as-is and false is returned.
waitForIdleSync();
synchronized (mSync) {
if (monitor.getHits() < minHits) {
return false;
}
mActivityMonitors.remove(monitor);
}
return true;
|
| public static void | checkStartActivityResult(int res, java.lang.Object intent)
if (res >= ActivityManager.START_SUCCESS) {
return;
}
switch (res) {
case ActivityManager.START_INTENT_NOT_RESOLVED:
case ActivityManager.START_CLASS_NOT_FOUND:
if (intent instanceof Intent && ((Intent)intent).getComponent() != null)
throw new ActivityNotFoundException(
"Unable to find explicit activity class "
+ ((Intent)intent).getComponent().toShortString()
+ "; have you declared this activity in your AndroidManifest.xml?");
throw new ActivityNotFoundException(
"No Activity found to handle " + intent);
case ActivityManager.START_PERMISSION_DENIED:
throw new SecurityException("Not allowed to start activity "
+ intent);
case ActivityManager.START_FORWARD_AND_REQUEST_CONFLICT:
throw new AndroidRuntimeException(
"FORWARD_RESULT_FLAG used while also requesting a result");
case ActivityManager.START_NOT_ACTIVITY:
throw new IllegalArgumentException(
"PendingIntent is not an activity");
case ActivityManager.START_NOT_VOICE_COMPATIBLE:
throw new SecurityException(
"Starting under voice control not allowed for: " + intent);
default:
throw new AndroidRuntimeException("Unknown error code "
+ res + " when starting " + intent);
}
|
| public void | endPerformanceSnapshot()
if (!isProfiling()) {
mPerfMetrics = mPerformanceCollector.endSnapshot();
}
|
| public void | execStartActivities(android.content.Context who, android.os.IBinder contextThread, android.os.IBinder token, Activity target, android.content.Intent[] intents, android.os.Bundle options)Like {@link #execStartActivity(Context, IBinder, IBinder, Activity, Intent, int, Bundle)},
but accepts an array of activities to be started. Note that active
{@link ActivityMonitor} objects only match against the first activity in
the array.
{@hide}
execStartActivitiesAsUser(who, contextThread, token, target, intents, options,
UserHandle.myUserId());
|
| public void | execStartActivitiesAsUser(android.content.Context who, android.os.IBinder contextThread, android.os.IBinder token, Activity target, android.content.Intent[] intents, android.os.Bundle options, int userId)Like {@link #execStartActivity(Context, IBinder, IBinder, Activity, Intent, int, Bundle)},
but accepts an array of activities to be started. Note that active
{@link ActivityMonitor} objects only match against the first activity in
the array.
{@hide}
IApplicationThread whoThread = (IApplicationThread) contextThread;
if (mActivityMonitors != null) {
synchronized (mSync) {
final int N = mActivityMonitors.size();
for (int i=0; i<N; i++) {
final ActivityMonitor am = mActivityMonitors.get(i);
if (am.match(who, null, intents[0])) {
am.mHits++;
if (am.isBlocking()) {
return;
}
break;
}
}
}
}
try {
String[] resolvedTypes = new String[intents.length];
for (int i=0; i<intents.length; i++) {
intents[i].migrateExtraStreamToClipData();
intents[i].prepareToLeaveProcess();
resolvedTypes[i] = intents[i].resolveTypeIfNeeded(who.getContentResolver());
}
int result = ActivityManagerNative.getDefault()
.startActivities(whoThread, who.getBasePackageName(), intents, resolvedTypes,
token, options, userId);
checkStartActivityResult(result, intents[0]);
} catch (RemoteException e) {
}
|
| public android.app.Instrumentation$ActivityResult | execStartActivity(android.content.Context who, android.os.IBinder contextThread, android.os.IBinder token, Activity target, android.content.Intent intent, int requestCode, android.os.Bundle options)Execute a startActivity call made by the application. The default
implementation takes care of updating any active {@link ActivityMonitor}
objects and dispatches this call to the system activity manager; you can
override this to watch for the application to start an activity, and
modify what happens when it does.
This method returns an {@link ActivityResult} object, which you can
use when intercepting application calls to avoid performing the start
activity action but still return the result the application is
expecting. To do this, override this method to catch the call to start
activity so that it returns a new ActivityResult containing the results
you would like the application to see, and don't call up to the super
class. Note that an application is only expecting a result if
requestCode is >= 0.
This method throws {@link android.content.ActivityNotFoundException}
if there was no Activity found to run the given Intent.
IApplicationThread whoThread = (IApplicationThread) contextThread;
if (mActivityMonitors != null) {
synchronized (mSync) {
final int N = mActivityMonitors.size();
for (int i=0; i<N; i++) {
final ActivityMonitor am = mActivityMonitors.get(i);
if (am.match(who, null, intent)) {
am.mHits++;
if (am.isBlocking()) {
return requestCode >= 0 ? am.getResult() : null;
}
break;
}
}
}
}
try {
intent.migrateExtraStreamToClipData();
intent.prepareToLeaveProcess();
int result = ActivityManagerNative.getDefault()
.startActivity(whoThread, who.getBasePackageName(), intent,
intent.resolveTypeIfNeeded(who.getContentResolver()),
token, target != null ? target.mEmbeddedID : null,
requestCode, 0, null, options);
checkStartActivityResult(result, intent);
} catch (RemoteException e) {
}
return null;
|
| public android.app.Instrumentation$ActivityResult | execStartActivity(android.content.Context who, android.os.IBinder contextThread, android.os.IBinder token, Fragment target, android.content.Intent intent, int requestCode, android.os.Bundle options)Like {@link #execStartActivity(android.content.Context, android.os.IBinder,
android.os.IBinder, Fragment, android.content.Intent, int, android.os.Bundle)},
but for calls from a {#link Fragment}.
IApplicationThread whoThread = (IApplicationThread) contextThread;
if (mActivityMonitors != null) {
synchronized (mSync) {
final int N = mActivityMonitors.size();
for (int i=0; i<N; i++) {
final ActivityMonitor am = mActivityMonitors.get(i);
if (am.match(who, null, intent)) {
am.mHits++;
if (am.isBlocking()) {
return requestCode >= 0 ? am.getResult() : null;
}
break;
}
}
}
}
try {
intent.migrateExtraStreamToClipData();
intent.prepareToLeaveProcess();
int result = ActivityManagerNative.getDefault()
.startActivity(whoThread, who.getBasePackageName(), intent,
intent.resolveTypeIfNeeded(who.getContentResolver()),
token, target != null ? target.mWho : null,
requestCode, 0, null, options);
checkStartActivityResult(result, intent);
} catch (RemoteException e) {
}
return null;
|
| public android.app.Instrumentation$ActivityResult | execStartActivity(android.content.Context who, android.os.IBinder contextThread, android.os.IBinder token, Activity target, android.content.Intent intent, int requestCode, android.os.Bundle options, android.os.UserHandle user)Like {@link #execStartActivity(Context, IBinder, IBinder, Activity, Intent, int, Bundle)},
but for starting as a particular user.
IApplicationThread whoThread = (IApplicationThread) contextThread;
if (mActivityMonitors != null) {
synchronized (mSync) {
final int N = mActivityMonitors.size();
for (int i=0; i<N; i++) {
final ActivityMonitor am = mActivityMonitors.get(i);
if (am.match(who, null, intent)) {
am.mHits++;
if (am.isBlocking()) {
return requestCode >= 0 ? am.getResult() : null;
}
break;
}
}
}
}
try {
intent.migrateExtraStreamToClipData();
intent.prepareToLeaveProcess();
int result = ActivityManagerNative.getDefault()
.startActivityAsUser(whoThread, who.getBasePackageName(), intent,
intent.resolveTypeIfNeeded(who.getContentResolver()),
token, target != null ? target.mEmbeddedID : null,
requestCode, 0, null, options, user.getIdentifier());
checkStartActivityResult(result, intent);
} catch (RemoteException e) {
}
return null;
|
| public android.app.Instrumentation$ActivityResult | execStartActivityAsCaller(android.content.Context who, android.os.IBinder contextThread, android.os.IBinder token, Activity target, android.content.Intent intent, int requestCode, android.os.Bundle options, int userId)Special version!
IApplicationThread whoThread = (IApplicationThread) contextThread;
if (mActivityMonitors != null) {
synchronized (mSync) {
final int N = mActivityMonitors.size();
for (int i=0; i<N; i++) {
final ActivityMonitor am = mActivityMonitors.get(i);
if (am.match(who, null, intent)) {
am.mHits++;
if (am.isBlocking()) {
return requestCode >= 0 ? am.getResult() : null;
}
break;
}
}
}
}
try {
intent.migrateExtraStreamToClipData();
intent.prepareToLeaveProcess();
int result = ActivityManagerNative.getDefault()
.startActivityAsCaller(whoThread, who.getBasePackageName(), intent,
intent.resolveTypeIfNeeded(who.getContentResolver()),
token, target != null ? target.mEmbeddedID : null,
requestCode, 0, null, options, userId);
checkStartActivityResult(result, intent);
} catch (RemoteException e) {
}
return null;
|
| public void | execStartActivityFromAppTask(android.content.Context who, android.os.IBinder contextThread, IAppTask appTask, android.content.Intent intent, android.os.Bundle options)Special version!
IApplicationThread whoThread = (IApplicationThread) contextThread;
if (mActivityMonitors != null) {
synchronized (mSync) {
final int N = mActivityMonitors.size();
for (int i=0; i<N; i++) {
final ActivityMonitor am = mActivityMonitors.get(i);
if (am.match(who, null, intent)) {
am.mHits++;
if (am.isBlocking()) {
return;
}
break;
}
}
}
}
try {
intent.migrateExtraStreamToClipData();
intent.prepareToLeaveProcess();
int result = appTask.startActivity(whoThread.asBinder(), who.getBasePackageName(),
intent, intent.resolveTypeIfNeeded(who.getContentResolver()), options);
checkStartActivityResult(result, intent);
} catch (RemoteException e) {
}
return;
|
| public void | finish(int resultCode, android.os.Bundle results)Terminate instrumentation of the application. This will cause the
application process to exit, removing this instrumentation from the next
time the application is started.
if (mAutomaticPerformanceSnapshots) {
endPerformanceSnapshot();
}
if (mPerfMetrics != null) {
if (results == null) {
results = new Bundle();
}
results.putAll(mPerfMetrics);
}
if (mUiAutomation != null) {
mUiAutomation.disconnect();
mUiAutomation = null;
}
mThread.finishInstrumentation(resultCode, results);
|
| public android.os.Bundle | getAllocCounts()Returns a bundle with the current results from the allocation counting.
Bundle results = new Bundle();
results.putLong("global_alloc_count", Debug.getGlobalAllocCount());
results.putLong("global_alloc_size", Debug.getGlobalAllocSize());
results.putLong("global_freed_count", Debug.getGlobalFreedCount());
results.putLong("global_freed_size", Debug.getGlobalFreedSize());
results.putLong("gc_invocation_count", Debug.getGlobalGcInvocationCount());
return results;
|
| public android.os.Bundle | getBinderCounts()Returns a bundle with the counts for various binder counts for this process. Currently the only two that are
reported are the number of send and the number of received transactions.
Bundle results = new Bundle();
results.putLong("sent_transactions", Debug.getBinderSentTransactions());
results.putLong("received_transactions", Debug.getBinderReceivedTransactions());
return results;
|
| public android.content.ComponentName | getComponentName()Returns complete component name of this instrumentation.
return mComponent;
|
| public android.content.Context | getContext()Return the Context of this instrumentation's package. Note that this is
often different than the Context of the application being
instrumentated, since the instrumentation code often lives is a
different package than that of the application it is running against.
See {@link #getTargetContext} to retrieve a Context for the target
application.
return mInstrContext;
|
| public android.content.Context | getTargetContext()Return a Context for the target application being instrumented. Note
that this is often different than the Context of the instrumentation
code, since the instrumentation code often lives is a different package
than that of the application it is running against. See
{@link #getContext} to retrieve a Context for the instrumentation code.
return mAppContext;
|
| public UiAutomation | getUiAutomation()Gets the {@link UiAutomation} instance.
Note: The APIs exposed via the returned {@link UiAutomation}
work across application boundaries while the APIs exposed by the instrumentation
do not. For example, {@link Instrumentation#sendPointerSync(MotionEvent)} will
not allow you to inject the event in an app different from the instrumentation
target, while {@link UiAutomation#injectInputEvent(android.view.InputEvent, boolean)}
will work regardless of the current application.
A typical test case should be using either the {@link UiAutomation} or
{@link Instrumentation} APIs. Using both APIs at the same time is not
a mistake by itself but a client has to be aware of the APIs limitations.
if (mUiAutomationConnection != null) {
if (mUiAutomation == null) {
mUiAutomation = new UiAutomation(getTargetContext().getMainLooper(),
mUiAutomationConnection);
mUiAutomation.connect();
}
return mUiAutomation;
}
return null;
|
| final void | init(ActivityThread thread, android.content.Context instrContext, android.content.Context appContext, android.content.ComponentName component, IInstrumentationWatcher watcher, IUiAutomationConnection uiAutomationConnection)
mThread = thread;
mMessageQueue = mThread.getLooper().myQueue();
mInstrContext = instrContext;
mAppContext = appContext;
mComponent = component;
mWatcher = watcher;
mUiAutomationConnection = uiAutomationConnection;
|
| public boolean | invokeContextMenuAction(Activity targetActivity, int id, int flag)Show the context menu for the currently focused view and executes a
particular context menu item.
validateNotAppThread();
// Bring up context menu for current focus.
// It'd be nice to do this through code, but currently ListView depends on
// long press to set metadata for its selected child
final KeyEvent downEvent = new KeyEvent(KeyEvent.ACTION_DOWN, KeyEvent.KEYCODE_DPAD_CENTER);
sendKeySync(downEvent);
// Need to wait for long press
waitForIdleSync();
try {
Thread.sleep(ViewConfiguration.getLongPressTimeout());
} catch (InterruptedException e) {
Log.e(TAG, "Could not sleep for long press timeout", e);
return false;
}
final KeyEvent upEvent = new KeyEvent(KeyEvent.ACTION_UP, KeyEvent.KEYCODE_DPAD_CENTER);
sendKeySync(upEvent);
// Wait for context menu to appear
waitForIdleSync();
class ContextMenuRunnable implements Runnable {
private final Activity activity;
private final int identifier;
private final int flags;
boolean returnValue;
public ContextMenuRunnable(Activity _activity, int _identifier,
int _flags) {
activity = _activity;
identifier = _identifier;
flags = _flags;
}
public void run() {
Window win = activity.getWindow();
returnValue = win.performContextMenuIdentifierAction(
identifier,
flags);
}
}
ContextMenuRunnable cmr = new ContextMenuRunnable(targetActivity, id, flag);
runOnMainSync(cmr);
return cmr.returnValue;
|
| public boolean | invokeMenuActionSync(Activity targetActivity, int id, int flag)Execute a particular menu item.
class MenuRunnable implements Runnable {
private final Activity activity;
private final int identifier;
private final int flags;
boolean returnValue;
public MenuRunnable(Activity _activity, int _identifier,
int _flags) {
activity = _activity;
identifier = _identifier;
flags = _flags;
}
public void run() {
Window win = activity.getWindow();
returnValue = win.performPanelIdentifierAction(
Window.FEATURE_OPTIONS_PANEL,
identifier,
flags);
}
}
MenuRunnable mr = new MenuRunnable(targetActivity, id, flag);
runOnMainSync(mr);
return mr.returnValue;
|
| public boolean | isProfiling()Check whether this instrumentation was started with profiling enabled.
return mThread.isProfiling();
|
| public Activity | newActivity(java.lang.Class clazz, android.content.Context context, android.os.IBinder token, Application application, android.content.Intent intent, android.content.pm.ActivityInfo info, java.lang.CharSequence title, Activity parent, java.lang.String id, java.lang.Object lastNonConfigurationInstance)Perform instantiation of an {@link Activity} object. This method is intended for use with
unit tests, such as android.test.ActivityUnitTestCase. The activity will be useable
locally but will be missing some of the linkages necessary for use within the sytem.
Activity activity = (Activity)clazz.newInstance();
ActivityThread aThread = null;
activity.attach(context, aThread, this, token, 0, application, intent,
info, title, parent, id,
(Activity.NonConfigurationInstances)lastNonConfigurationInstance,
new Configuration(), null, null);
return activity;
|
| public Activity | newActivity(java.lang.ClassLoader cl, java.lang.String className, android.content.Intent intent)Perform instantiation of the process's {@link Activity} object. The
default implementation provides the normal system behavior.
return (Activity)cl.loadClass(className).newInstance();
|
| public Application | newApplication(java.lang.ClassLoader cl, java.lang.String className, android.content.Context context)Perform instantiation of the process's {@link Application} object. The
default implementation provides the normal system behavior.
return newApplication(cl.loadClass(className), context);
|
| public static Application | newApplication(java.lang.Class clazz, android.content.Context context)Perform instantiation of the process's {@link Application} object. The
default implementation provides the normal system behavior.
Application app = (Application)clazz.newInstance();
app.attach(context);
return app;
|
| public void | onCreate(android.os.Bundle arguments)Called when the instrumentation is starting, before any application code
has been loaded. Usually this will be implemented to simply call
{@link #start} to begin the instrumentation thread, which will then
continue execution in {@link #onStart}.
If you do not need your own thread -- that is you are writing your
instrumentation to be completely asynchronous (returning to the event
loop so that the application can run), you can simply begin your
instrumentation here, for example call {@link Context#startActivity} to
begin the appropriate first activity of the application.
|
| public void | onDestroy()Called when the instrumented application is stopping, after all of the
normal application cleanup has occurred.
|
| public boolean | onException(java.lang.Object obj, java.lang.Throwable e)This is called whenever the system captures an unhandled exception that
was thrown by the application. The default implementation simply
returns false, allowing normal system handling of the exception to take
place.
return false;
|
| public void | onStart()Method where the instrumentation thread enters execution. This allows
you to run your instrumentation code in a separate thread than the
application, so that it can perform blocking operation such as
{@link #sendKeySync} or {@link #startActivitySync}.
You will typically want to call finish() when this function is done,
to end your instrumentation.
|
| private void | postPerformCreate(Activity activity)
if (mActivityMonitors != null) {
synchronized (mSync) {
final int N = mActivityMonitors.size();
for (int i=0; i<N; i++) {
final ActivityMonitor am = mActivityMonitors.get(i);
am.match(activity, activity, activity.getIntent());
}
}
}
|
| private void | prePerformCreate(Activity activity)
if (mWaitingActivities != null) {
synchronized (mSync) {
final int N = mWaitingActivities.size();
for (int i=0; i<N; i++) {
final ActivityWaiter aw = mWaitingActivities.get(i);
final Intent intent = aw.intent;
if (intent.filterEquals(activity.getIntent())) {
aw.activity = activity;
mMessageQueue.addIdleHandler(new ActivityGoing(aw));
}
}
}
}
|
| public void | removeMonitor(android.app.Instrumentation$ActivityMonitor monitor)Remove an {@link ActivityMonitor} that was previously added with
{@link #addMonitor}.
synchronized (mSync) {
mActivityMonitors.remove(monitor);
}
|
| public void | runOnMainSync(java.lang.Runnable runner)Execute a call on the application's main thread, blocking until it is
complete. Useful for doing things that are not thread-safe, such as
looking at or modifying the view hierarchy.
validateNotAppThread();
SyncRunnable sr = new SyncRunnable(runner);
mThread.getHandler().post(sr);
sr.waitForComplete();
|
| public void | sendCharacterSync(int keyCode)Higher-level method for sending both the down and up key events for a
particular character key code. Equivalent to creating both KeyEvent
objects by hand and calling {@link #sendKeySync}. The event appears
as if it came from keyboard 0, the built in one.
sendKeySync(new KeyEvent(KeyEvent.ACTION_DOWN, keyCode));
sendKeySync(new KeyEvent(KeyEvent.ACTION_UP, keyCode));
|
| public void | sendKeyDownUpSync(int key)Sends an up and down key event sync to the currently focused window.
sendKeySync(new KeyEvent(KeyEvent.ACTION_DOWN, key));
sendKeySync(new KeyEvent(KeyEvent.ACTION_UP, key));
|
| public void | sendKeySync(android.view.KeyEvent event)Send a key event to the currently focused window/view and wait for it to
be processed. Finished at some point after the recipient has returned
from its event processing, though it may not have completely
finished reacting from the event -- for example, if it needs to update
its display as a result, it may still be in the process of doing that.
validateNotAppThread();
long downTime = event.getDownTime();
long eventTime = event.getEventTime();
int action = event.getAction();
int code = event.getKeyCode();
int repeatCount = event.getRepeatCount();
int metaState = event.getMetaState();
int deviceId = event.getDeviceId();
int scancode = event.getScanCode();
int source = event.getSource();
int flags = event.getFlags();
if (source == InputDevice.SOURCE_UNKNOWN) {
source = InputDevice.SOURCE_KEYBOARD;
}
if (eventTime == 0) {
eventTime = SystemClock.uptimeMillis();
}
if (downTime == 0) {
downTime = eventTime;
}
KeyEvent newEvent = new KeyEvent(downTime, eventTime, action, code, repeatCount, metaState,
deviceId, scancode, flags | KeyEvent.FLAG_FROM_SYSTEM, source);
InputManager.getInstance().injectInputEvent(newEvent,
InputManager.INJECT_INPUT_EVENT_MODE_WAIT_FOR_FINISH);
|
| public void | sendPointerSync(android.view.MotionEvent event)Dispatch a pointer event. Finished at some point after the recipient has
returned from its event processing, though it may not have
completely finished reacting from the event -- for example, if it needs
to update its display as a result, it may still be in the process of
doing that.
validateNotAppThread();
if ((event.getSource() & InputDevice.SOURCE_CLASS_POINTER) == 0) {
event.setSource(InputDevice.SOURCE_TOUCHSCREEN);
}
InputManager.getInstance().injectInputEvent(event,
InputManager.INJECT_INPUT_EVENT_MODE_WAIT_FOR_FINISH);
|
| public void | sendStatus(int resultCode, android.os.Bundle results)Provide a status report about the application.
if (mWatcher != null) {
try {
mWatcher.instrumentationStatus(mComponent, resultCode, results);
}
catch (RemoteException e) {
mWatcher = null;
}
}
|
| public void | sendStringSync(java.lang.String text)Sends the key events corresponding to the text to the app being
instrumented.
if (text == null) {
return;
}
KeyCharacterMap keyCharacterMap = KeyCharacterMap.load(KeyCharacterMap.VIRTUAL_KEYBOARD);
KeyEvent[] events = keyCharacterMap.getEvents(text.toCharArray());
if (events != null) {
for (int i = 0; i < events.length; i++) {
// We have to change the time of an event before injecting it because
// all KeyEvents returned by KeyCharacterMap.getEvents() have the same
// time stamp and the system rejects too old events. Hence, it is
// possible for an event to become stale before it is injected if it
// takes too long to inject the preceding ones.
sendKeySync(KeyEvent.changeTimeRepeat(events[i], SystemClock.uptimeMillis(), 0));
}
}
|
| public void | sendTrackballEventSync(android.view.MotionEvent event)Dispatch a trackball event. Finished at some point after the recipient has
returned from its event processing, though it may not have
completely finished reacting from the event -- for example, if it needs
to update its display as a result, it may still be in the process of
doing that.
validateNotAppThread();
if ((event.getSource() & InputDevice.SOURCE_CLASS_TRACKBALL) == 0) {
event.setSource(InputDevice.SOURCE_TRACKBALL);
}
InputManager.getInstance().injectInputEvent(event,
InputManager.INJECT_INPUT_EVENT_MODE_WAIT_FOR_FINISH);
|
| public void | setAutomaticPerformanceSnapshots()
mAutomaticPerformanceSnapshots = true;
mPerformanceCollector = new PerformanceCollector();
|
| public void | setInTouchMode(boolean inTouch)Force the global system in or out of touch mode. This can be used if
your instrumentation relies on the UI being in one more or the other
when it starts.
try {
IWindowManager.Stub.asInterface(
ServiceManager.getService("window")).setInTouchMode(inTouch);
} catch (RemoteException e) {
// Shouldn't happen!
}
|
| public void | start()Create and start a new thread in which to run instrumentation. This new
thread will call to {@link #onStart} where you can implement the
instrumentation.
if (mRunner != null) {
throw new RuntimeException("Instrumentation already started");
}
mRunner = new InstrumentationThread("Instr: " + getClass().getName());
mRunner.start();
|
| public Activity | startActivitySync(android.content.Intent intent)Start a new activity and wait for it to begin running before returning.
In addition to being synchronous, this method as some semantic
differences from the standard {@link Context#startActivity} call: the
activity component is resolved before talking with the activity manager
(its class name is specified in the Intent that this method ultimately
starts), and it does not allow you to start activities that run in a
different process. In addition, if the given Intent resolves to
multiple activities, instead of displaying a dialog for the user to
select an activity, an exception will be thrown.
The function returns as soon as the activity goes idle following the
call to its {@link Activity#onCreate}. Generally this means it has gone
through the full initialization including {@link Activity#onResume} and
drawn and displayed its initial window.
validateNotAppThread();
synchronized (mSync) {
intent = new Intent(intent);
ActivityInfo ai = intent.resolveActivityInfo(
getTargetContext().getPackageManager(), 0);
if (ai == null) {
throw new RuntimeException("Unable to resolve activity for: " + intent);
}
String myProc = mThread.getProcessName();
if (!ai.processName.equals(myProc)) {
// todo: if this intent is ambiguous, look here to see if
// there is a single match that is in our package.
throw new RuntimeException("Intent in process "
+ myProc + " resolved to different process "
+ ai.processName + ": " + intent);
}
intent.setComponent(new ComponentName(
ai.applicationInfo.packageName, ai.name));
final ActivityWaiter aw = new ActivityWaiter(intent);
if (mWaitingActivities == null) {
mWaitingActivities = new ArrayList();
}
mWaitingActivities.add(aw);
getTargetContext().startActivity(intent);
do {
try {
mSync.wait();
} catch (InterruptedException e) {
}
} while (mWaitingActivities.contains(aw));
return aw.activity;
}
|
| public void | startAllocCounting()
// Before we start trigger a GC and reset the debug counts. Run the
// finalizers and another GC before starting and stopping the alloc
// counts. This will free up any objects that were just sitting around
// waiting for their finalizers to be run.
Runtime.getRuntime().gc();
Runtime.getRuntime().runFinalization();
Runtime.getRuntime().gc();
Debug.resetAllCounts();
// start the counts
Debug.startAllocCounting();
|
| public void | startPerformanceSnapshot()
if (!isProfiling()) {
mPerformanceCollector.beginSnapshot(null);
}
|
| public void | startProfiling()This method will start profiling if isProfiling() returns true. You should
only call this method if you set the handleProfiling attribute in the
manifest file for this Instrumentation to true.
if (mThread.isProfiling()) {
File file = new File(mThread.getProfileFilePath());
file.getParentFile().mkdirs();
Debug.startMethodTracing(file.toString(), 8 * 1024 * 1024);
}
|
| public void | stopAllocCounting()
Runtime.getRuntime().gc();
Runtime.getRuntime().runFinalization();
Runtime.getRuntime().gc();
Debug.stopAllocCounting();
|
| public void | stopProfiling()Stops profiling if isProfiling() returns true.
if (mThread.isProfiling()) {
Debug.stopMethodTracing();
}
|
| private final void | validateNotAppThread()
if (Looper.myLooper() == Looper.getMainLooper()) {
throw new RuntimeException(
"This method can not be called from the main application thread");
}
|
| public void | waitForIdle(java.lang.Runnable recipient)Schedule a callback for when the application's main thread goes idle
(has no more events to process).
mMessageQueue.addIdleHandler(new Idler(recipient));
mThread.getHandler().post(new EmptyRunnable());
|
| public void | waitForIdleSync()Synchronously wait for the application to be idle. Can not be called
from the main application thread -- use {@link #start} to execute
instrumentation in its own thread.
validateNotAppThread();
Idler idler = new Idler(null);
mMessageQueue.addIdleHandler(idler);
mThread.getHandler().post(new EmptyRunnable());
idler.waitForIdle();
|
| public Activity | waitForMonitor(android.app.Instrumentation$ActivityMonitor monitor)Wait for an existing {@link ActivityMonitor} to be hit. Once the
monitor has been hit, it is removed from the activity monitor list and
the first created Activity object that matched it is returned.
Activity activity = monitor.waitForActivity();
synchronized (mSync) {
mActivityMonitors.remove(monitor);
}
return activity;
|
| public Activity | waitForMonitorWithTimeout(android.app.Instrumentation$ActivityMonitor monitor, long timeOut)Wait for an existing {@link ActivityMonitor} to be hit till the timeout
expires. Once the monitor has been hit, it is removed from the activity
monitor list and the first created Activity object that matched it is
returned. If the timeout expires, a null object is returned.
Activity activity = monitor.waitForActivityWithTimeout(timeOut);
synchronized (mSync) {
mActivityMonitors.remove(monitor);
}
return activity;
|
