InstrumentationTestRunner

public class InstrumentationTestRunner
extends Instrumentation implements TestSuiteProvider

java.lang.Object
↳	android.app.Instrumentation
	↳	android.test.InstrumentationTestRunner

Known Direct Subclasses MultiDexTestRunner MultiDexTestRunner InstrumentationTestRunner用于需要multidex支持的测试应用程序。

---

此类在API级别24中已被弃用。
改为使用AndroidJUnitRunner 。 应使用Android Testing Support Library编写新的测试。

一个 Instrumentation运行各种类型的 TestCase针对Android包（应用）秒。

Typical Usage

1. Write TestCases that perform unit, functional, or performance tests against the classes in your package. Typically these are subclassed from:
   • ActivityInstrumentationTestCase2
   • ActivityUnitTestCase
   • AndroidTestCase
   • ApplicationTestCase
   • InstrumentationTestCase
   • ProviderTestCase
   • ServiceTestCase
   • SingleLaunchActivityTestCase
2. Set the android:targetPackage attribute of the <instrumentation> element in the test package's manifest. You should set the attribute value to the package name of the target application under test.
3. Run the instrumentation using "adb shell am instrument -w", with no optional arguments, to run all tests (except performance tests).
4. Run the instrumentation using "adb shell am instrument -w", with the argument '-e func true' to run all functional tests. These are tests that derive from InstrumentationTestCase.
5. Run the instrumentation using "adb shell am instrument -w", with the argument '-e unit true' to run all unit tests. These are tests that do notderive from InstrumentationTestCase (and are not performance tests).
6. Run the instrumentation using "adb shell am instrument -w", with the argument '-e class' set to run an individual TestCase.

Running all tests: adb shell am instrument -w com.android.foo/android.test.InstrumentationTestRunner

Running all small tests: adb shell am instrument -w -e size small com.android.foo/android.test.InstrumentationTestRunner

Running all medium tests: adb shell am instrument -w -e size medium com.android.foo/android.test.InstrumentationTestRunner

Running all large tests: adb shell am instrument -w -e size large com.android.foo/android.test.InstrumentationTestRunner

Filter test run to tests with given annotation: adb shell am instrument -w -e annotation com.android.foo.MyAnnotation com.android.foo/android.test.InstrumentationTestRunner

If used with other options, the resulting test run will contain the union of the two options. e.g. "-e size large -e annotation com.android.foo.MyAnnotation" will run only tests with both the LargeTest and "com.android.foo.MyAnnotation" annotations.

Filter test run to tests without given annotation: adb shell am instrument -w -e notAnnotation com.android.foo.MyAnnotation com.android.foo/android.test.InstrumentationTestRunner

Running a single testcase: adb shell am instrument -w -e class com.android.foo.FooTest com.android.foo/android.test.InstrumentationTestRunner

Running a single test: adb shell am instrument -w -e class com.android.foo.FooTest#testFoo com.android.foo/android.test.InstrumentationTestRunner

Running multiple tests: adb shell am instrument -w -e class com.android.foo.FooTest,com.android.foo.TooTest com.android.foo/android.test.InstrumentationTestRunner

Running all tests in a java package: adb shell am instrument -w -e package com.android.foo.subpkg com.android.foo/android.test.InstrumentationTestRunner

Including performance tests: adb shell am instrument -w -e perf true com.android.foo/android.test.InstrumentationTestRunner

To debug your tests, set a break point in your code and pass: -e debug true

To run in 'log only' mode -e log true This option will load and iterate through all test classes and methods, but will bypass actual test execution. Useful for quickly obtaining info on the tests to be executed by an instrumentation command.

To generate EMMA code coverage: -e coverage true Note: this requires an emma instrumented build. By default, the code coverage results file will be saved in a /data/ /coverage.ec file, unless overridden by coverageFile flag (see below)

To specify EMMA code coverage results file path: -e coverageFile /sdcard/myFile.ec
in addition to the other arguments.

Summary

Constants
String	REPORT_KEY_NAME_CLASS 如果包含在发送到IInstrumentationWatcher的状态或最终包中，则此键标识当前测试类的名称。
String	REPORT_KEY_NAME_TEST 如果包含在发送到IInstrumentationWatcher的状态或最终包中，则此键标识当前测试的名称。
String	REPORT_KEY_NUM_CURRENT 如果包含在发送到IInstrumentationWatcher的状态或最终包中，则此键标识当前测试的序列号。
String	REPORT_KEY_NUM_TOTAL 如果包含在发送到IInstrumentationWatcher的状态或最终包中，则此键标识正在运行的测试的总数。
String	REPORT_KEY_STACK 如果包含在发送到IInstrumentationWatcher的状态包中，则此键标识描述错误或故障的堆栈跟踪。
String	REPORT_VALUE_ID 该值如果与密钥 REPORT_KEY_IDENTIFIER一起存储， REPORT_KEY_IDENTIFIER InstrumentationTestRunner标识为报告的来源。
int	REPORT_VALUE_RESULT_ERROR 测试完成时出现错误。
int	REPORT_VALUE_RESULT_FAILURE 测试以失败告终。
int	REPORT_VALUE_RESULT_OK 测试成功完成。
int	REPORT_VALUE_RESULT_START 测试正在开始。

Inherited constants
From class android.app.Instrumentation String REPORT_KEY_IDENTIFIER 如果包含在发送到IInstrumentationWatcher的状态或最终包中，则此键标识正在编写报告的类。 String REPORT_KEY_STREAMRESULT 如果包含在发送到IInstrumentationWatcher的状态或最终捆绑包中，则此键标识可以简单地打印到输出流的字符串。

Public constructors
InstrumentationTestRunner()

Public methods
TestSuite	getAllTests() 重写此操作以定义要在包中运行的所有测试。
Bundle	getArguments() 获取传递给这个工具的参数。
ClassLoader	getLoader() 覆盖它以提供对包的类加载器的访问。
TestSuite	getTestSuite()
void	onCreate(Bundle arguments) 在仪器启动时调用，在加载任何应用程序代码之前。
void	onStart() 检测线程进入执行的方法。

Protected methods
AndroidTestRunner	getAndroidTestRunner()

Inherited methods
From class android.app.Instrumentation Instrumentation.ActivityMonitor addMonitor(String cls, Instrumentation.ActivityResult result, boolean block) addMonitor(ActivityMonitor)的便利包装，为您创建一个匹配 Instrumentation.ActivityMonitor的类并将其返回。 Instrumentation.ActivityMonitor addMonitor(IntentFilter filter, Instrumentation.ActivityResult result, boolean block) addMonitor(ActivityMonitor)的便捷包装，为您创建一个匹配 Instrumentation.ActivityMonitor的意向过滤器并将其返回。 void addMonitor(Instrumentation.ActivityMonitor monitor) 添加一个新的 Instrumentation.ActivityMonitor ，每当一个活动开始时将被检查。 void callActivityOnCreate(Activity activity, Bundle icicle) 执行一个活动的 onCreate(Bundle)方法的调用。 void callActivityOnCreate(Activity activity, Bundle icicle, PersistableBundle persistentState) 执行一个活动的方法 onCreate(Bundle)调用。 void callActivityOnDestroy(Activity activity) void callActivityOnNewIntent(Activity activity, Intent intent) 执行一个活动的方法 onNewIntent(Intent)调用。 void callActivityOnPause(Activity activity) 执行一项活动的方法 onPause()调用。 void callActivityOnPostCreate(Activity activity, Bundle icicle, PersistableBundle persistentState) 执行一个活动的方法 onPostCreate(Bundle)调用。 void callActivityOnPostCreate(Activity activity, Bundle icicle) 执行调用一个活动的的 onPostCreate(Bundle)方法。 void callActivityOnRestart(Activity activity) 执行一个活动的方法 onRestart()调用。 void callActivityOnRestoreInstanceState(Activity activity, Bundle savedInstanceState) 执行一项活动的方法 onRestoreInstanceState(Bundle)调用。 void callActivityOnRestoreInstanceState(Activity activity, Bundle savedInstanceState, PersistableBundle persistentState) 执行一个活动的方法 onRestoreInstanceState(Bundle)调用。 void callActivityOnResume(Activity activity) 执行调用一个活动的的 onResume()方法。 void callActivityOnSaveInstanceState(Activity activity, Bundle outState, PersistableBundle outPersistentState) 执行一个活动的方法 onSaveInstanceState(Bundle)调用。 void callActivityOnSaveInstanceState(Activity activity, Bundle outState) 执行一个活动的方法 onSaveInstanceState(Bundle)调用。 void callActivityOnStart(Activity activity) 执行一个活动的方法 onStart()调用。 void callActivityOnStop(Activity activity) 执行一个活动的方法 onStop()调用。 void callActivityOnUserLeaving(Activity activity) 执行一个活动的 onUserLeaveHint()方法的调用。 void callApplicationOnCreate(Application app) 执行应用程序的 onCreate()方法的调用。 boolean checkMonitorHit(Instrumentation.ActivityMonitor monitor, int minHits) 测试现有的 Instrumentation.ActivityMonitor是否被击中。 void endPerformanceSnapshot() void finish(int resultCode, Bundle results) 终止应用程序的检测。 Bundle getAllocCounts() 使用分配计数的当前结果返回一个包。 Bundle getBinderCounts() 返回包含此过程的各种绑定程序计数的绑定。 ComponentName getComponentName() 返回此工具的完整组件名称。 Context getContext() 返回这个工具包的上下文。 Context getTargetContext() 为正在检测的目标应用程序返回一个上下文。 UiAutomation getUiAutomation(int flags) 获取设置了标志的 UiAutomation实例。 UiAutomation getUiAutomation() 获取没有设置标志的 UiAutomation实例。 boolean invokeContextMenuAction(Activity targetActivity, int id, int flag) 显示当前焦点视图的上下文菜单并执行特定的上下文菜单项。 boolean invokeMenuActionSync(Activity targetActivity, int id, int flag) 执行特定的菜单项。 boolean isProfiling() 检查此检测是否启用了分析启用。 Activity newActivity(Class<?> clazz, Context context, IBinder token, Application application, Intent intent, ActivityInfo info, CharSequence title, Activity parent, String id, Object lastNonConfigurationInstance) 执行 Activity对象的实例化。 Activity newActivity(ClassLoader cl, String className, Intent intent) 执行进程的 Activity对象的实例化。 Application newApplication(ClassLoader cl, String className, Context context) 执行进程的 Application对象的实例化。 static Application newApplication(Class<?> clazz, Context context) 执行进程的 Application对象的实例化。 void onCreate(Bundle arguments) 在仪器启动时调用，在加载任何应用程序代码之前。 void onDestroy() 在所有正常的应用程序清理发生后，仪表应用程序停止时调用。 boolean onException(Object obj, Throwable e) 只要系统捕获应用程序抛出的未处理的异常，就会调用它。 void onStart() 检测线程进入执行的方法。 void removeMonitor(Instrumentation.ActivityMonitor monitor) 删除 Instrumentation.ActivityMonitor以前添加了 addMonitor(Instrumentation.ActivityMonitor) 。 void runOnMainSync(Runnable runner) 在应用程序的主线程上执行调用，直到完成为止。 void sendCharacterSync(int keyCode) 用于发送特定字符键码的向下和向上键事件的更高级别的方法。 void sendKeyDownUpSync(int key) 将向上和向下键事件同步发送到当前聚焦的窗口。 void sendKeySync(KeyEvent event) 将关键事件发送到当前聚焦的窗口/视图并等待它被处理。 void sendPointerSync(MotionEvent event) 分派指针事件。 void sendStatus(int resultCode, Bundle results) 提供关于应用程序的状态报告。 void sendStringSync(String text) 将与文本相对应的关键事件发送到正在进行检测的应用程序。 void sendTrackballEventSync(MotionEvent event) 发送跟踪球事件。 void setAutomaticPerformanceSnapshots() void setInTouchMode(boolean inTouch) 强制全局系统进入或退出触摸模式。 void start() 创建并启动运行检测的新线程。 Activity startActivitySync(Intent intent) 开始一项新活动并等待它在返回之前开始运行。 void startAllocCounting() void startPerformanceSnapshot() void startProfiling() 如果isProfiling（）返回true，则此方法将开始分析。 void stopAllocCounting() void stopProfiling() 如果isProfiling（）返回true，则停止分析。 void waitForIdle(Runnable recipient) 为应用程序的主线程闲置时安排回调（不再有要处理的事件）。 void waitForIdleSync() 同步等待应用程序闲置。 Activity waitForMonitor(Instrumentation.ActivityMonitor monitor) 等待现有的 Instrumentation.ActivityMonitor被击中。 Activity waitForMonitorWithTimeout(Instrumentation.ActivityMonitor monitor, long timeOut) 等待现有的 Instrumentation.ActivityMonitor被击中，直到超时到期。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为此对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过了一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 使当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。
From interface android.test.TestSuiteProvider abstract TestSuite getTestSuite()

Constants

REPORT_KEY_NAME_CLASS

Added in API level 1

String REPORT_KEY_NAME_CLASS

如果包含在发送到IInstrumentationWatcher的状态或最终包中，则此键标识当前测试类的名称。 这与任何状态消息一起发送，描述正在启动或完成的特定测试。

常数值：“class”

REPORT_KEY_NAME_TEST

Added in API level 1

String REPORT_KEY_NAME_TEST

如果包含在发送到IInstrumentationWatcher的状态或最终包中，则此键标识当前测试的名称。 这与任何状态消息一起发送，描述正在启动或完成的特定测试。

常数值：“测试”

REPORT_KEY_NUM_CURRENT

Added in API level 1

String REPORT_KEY_NUM_CURRENT

如果包含在发送到IInstrumentationWatcher的状态或最终包中，则此键标识当前测试的序列号。 这与任何状态消息一起发送，描述正在启动或完成的特定测试。

常数值：“当前”

REPORT_KEY_NUM_TOTAL

Added in API level 1

String REPORT_KEY_NUM_TOTAL

如果包含在发送到IInstrumentationWatcher的状态或最终包中，则此键标识正在运行的测试的总数。 这是与所有状态消息一起发送的。

常量值：“numtests”

REPORT_KEY_STACK

Added in API level 1

String REPORT_KEY_STACK

如果包含在发送到IInstrumentationWatcher的状态包中，则此键标识描述错误或故障的堆栈跟踪。 这是与任何状态消息一起发送描述正在完成的特定测试。

常量值：“堆栈”

REPORT_VALUE_ID

Added in API level 1

String REPORT_VALUE_ID

该值如果与密钥REPORT_KEY_IDENTIFIER一起存储， REPORT_KEY_IDENTIFIER InstrumentationTestRunner标识为报告的来源。 这是与所有状态消息一起发送的。

常量值：“InstrumentationTestRunner”

REPORT_VALUE_RESULT_ERROR

Added in API level 1

int REPORT_VALUE_RESULT_ERROR

测试完成时出现错误。

常量值：-1（0xffffffff）

REPORT_VALUE_RESULT_FAILURE

Added in API level 1

int REPORT_VALUE_RESULT_FAILURE

测试以失败告终。

常量值：-2（0xfffffffe）

REPORT_VALUE_RESULT_OK

Added in API level 1

int REPORT_VALUE_RESULT_OK

测试成功完成。

常量值：0（0x00000000）

REPORT_VALUE_RESULT_START

Added in API level 1

int REPORT_VALUE_RESULT_START

测试正在开始。

常数值：1（0x00000001）

Public constructors

InstrumentationTestRunner

Added in API level 1

InstrumentationTestRunner ()

Public methods

getAllTests

Added in API level 1

TestSuite getAllTests ()

重写此操作以定义要在包中运行的所有测试。

Returns
TestSuite

getArguments

Added in API level 18

Bundle getArguments ()

获取传递给这个工具的参数。

Returns
Bundle	the Bundle object

getLoader

Added in API level 1

ClassLoader getLoader ()

覆盖它以提供对包的类加载器的访问。

Returns
ClassLoader

getTestSuite

Added in API level 1

TestSuite getTestSuite ()

Returns
TestSuite

onCreate

Added in API level 1

void onCreate (Bundle arguments)

在仪器启动时调用，在加载任何应用程序代码之前。 通常这将被实现，只需调用start()开始检测线程，然后将继续执行onStart() 。

如果你不需要你自己的线程 - 那就是你正在编写你的工具来完全异步（返回到事件循环以便应用程序可以运行），那么你可以简单地在这里开始你的工具，例如调用 startActivity(Intent)开始适当的第一个应用程序的活动。

Parameters
arguments	Bundle: Any additional arguments that were supplied when the instrumentation was started.

onStart

Added in API level 1

void onStart ()

检测线程进入执行的方法。 这使您可以在与应用程序不同的线程中运行检测代码，以便它可以执行阻止操作，例如sendKeySync(KeyEvent)或startActivitySync(Intent) 。

当这个函数完成时，你通常会想调用finish（）来结束你的检测。

Protected methods

getAndroidTestRunner

Added in API level 1

AndroidTestRunner getAndroidTestRunner ()

Returns
AndroidTestRunner