# AndroidTestRunner Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary:[Ctors](https://developer.android.com/reference/android/test/AndroidTestRunner#pubctors)\|[Methods](https://developer.android.com/reference/android/test/AndroidTestRunner#pubmethods)\|[Protected Methods](https://developer.android.com/reference/android/test/AndroidTestRunner#promethods)\|[Inherited Methods](https://developer.android.com/reference/android/test/AndroidTestRunner#inhmethods) # AndroidTestRunner *** ** * ** *** [Kotlin](https://developer.android.com/reference/kotlin/android/test/AndroidTestRunner "View this page in Kotlin")\|Java ` public class AndroidTestRunner ` ` extends `[Object](https://developer.android.com/reference/java/lang/Object)` `` ` |---|--------------------------------| | [java.lang.Object](https://developer.android.com/reference/java/lang/Object) || | ↳ | android.test.AndroidTestRunner |
*** ** * ** ***
**This class was deprecated in API level 24.** Use[AndroidJUnitRunner](https://developer.android.com/reference/android/support/test/runner/AndroidJUnitRunner)instead. New tests should be written using the[Android Testing Support Library](https://developer.android.com/tools/testing-support-library). ## Summary | ### Public constructors || |-------------------------------------------------------------------------------------------------------------------------|---| | ` `[AndroidTestRunner](https://developer.android.com/reference/android/test/AndroidTestRunner#AndroidTestRunner())`() ` | | ### Public methods || |-------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` void` | ` `[addTestListener](https://developer.android.com/reference/android/test/AndroidTestRunner#addTestListener(TestListener))`(TestListener testListener) ` | | ` void` | ` `[clearTestListeners](https://developer.android.com/reference/android/test/AndroidTestRunner#clearTestListeners())`() ` | | ` `[List](https://developer.android.com/reference/java/util/List)`` | ` `[getTestCases](https://developer.android.com/reference/android/test/AndroidTestRunner#getTestCases())`() ` | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[getTestClassName](https://developer.android.com/reference/android/test/AndroidTestRunner#getTestClassName())`() ` | | ` TestResult` | ` `[getTestResult](https://developer.android.com/reference/android/test/AndroidTestRunner#getTestResult())`() ` | | ` void` | ` `[runTest](https://developer.android.com/reference/android/test/AndroidTestRunner#runTest(TestResult))`(TestResult testResult) ` | | ` void` | ` `[runTest](https://developer.android.com/reference/android/test/AndroidTestRunner#runTest())`() ` | | ` void` | ` `[setContext](https://developer.android.com/reference/android/test/AndroidTestRunner#setContext(android.content.Context))`(`[Context](https://developer.android.com/reference/android/content/Context)` context) ` | | ` void` | ` `[setInstrumentaiton](https://developer.android.com/reference/android/test/AndroidTestRunner#setInstrumentaiton(android.app.Instrumentation))`(`[Instrumentation](https://developer.android.com/reference/android/app/Instrumentation)` instrumentation) ` *This method was deprecated in API level 15. Incorrect spelling, use[setInstrumentation(android.app.Instrumentation)](https://developer.android.com/reference/android/test/AndroidTestRunner#setInstrumentation(android.app.Instrumentation))instead.* | | ` void` | ` `[setInstrumentation](https://developer.android.com/reference/android/test/AndroidTestRunner#setInstrumentation(android.app.Instrumentation))`(`[Instrumentation](https://developer.android.com/reference/android/app/Instrumentation)` instrumentation) ` | | ` void` | ` `[setTest](https://developer.android.com/reference/android/test/AndroidTestRunner#setTest(Test))`(Test test) ` | | ` void` | ` `[setTestClassName](https://developer.android.com/reference/android/test/AndroidTestRunner#setTestClassName(java.lang.String,%20java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` testClassName, `[String](https://developer.android.com/reference/java/lang/String)` testMethodName) ` | | ` void` | ` `[testEnded](https://developer.android.com/reference/android/test/AndroidTestRunner#testEnded(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` testName) ` | | ` void` | ` `[testFailed](https://developer.android.com/reference/android/test/AndroidTestRunner#testFailed(int,%20Test,%20java.lang.Throwable))`(int status, Test test, `[Throwable](https://developer.android.com/reference/java/lang/Throwable)` t) ` | | ` void` | ` `[testStarted](https://developer.android.com/reference/android/test/AndroidTestRunner#testStarted(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` testName) ` | | ### Protected methods || |--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` TestResult` | ` `[createTestResult](https://developer.android.com/reference/android/test/AndroidTestRunner#createTestResult())`() ` | | ` `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[loadSuiteClass](https://developer.android.com/reference/android/test/AndroidTestRunner#loadSuiteClass(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` suiteClassName) ` | | ` void` | ` `[runFailed](https://developer.android.com/reference/android/test/AndroidTestRunner#runFailed(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` message) ` | | ### Inherited methods | |-----------------------|---| | From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | || ## Public constructors ### AndroidTestRunner ``` public AndroidTestRunner () ```

## Public methods ### addTestListener Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void addTestListener (TestListener testListener) ```

| Parameters || |----------------|-----------------------| | `testListener` | `TestListener`
| ### clearTestListeners Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void clearTestListeners () ```

### getTestCases Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public List getTestCases () ```

| Returns || |----------------------------------------------------------------------------|--------| | [List](https://developer.android.com/reference/java/util/List)`` |
| ### getTestClassName Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public String getTestClassName () ```

| Returns || |--------------------------------------------------------------------|--------| | [String](https://developer.android.com/reference/java/lang/String) |
| ### getTestResult Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public TestResult getTestResult () ```

| Returns || |--------------|--------| | `TestResult` |
| ### runTest Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void runTest (TestResult testResult) ```

| Parameters || |--------------|---------------------| | `testResult` | `TestResult`
| ### runTest Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void runTest () ```

### setContext Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void setContext (Context context) ```

| Parameters || |-----------|------------------| | `context` | `Context`
| ### setInstrumentaiton Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 15](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void setInstrumentaiton (Instrumentation instrumentation) ```
**This method was deprecated in API level 15.** Incorrect spelling, use[setInstrumentation(android.app.Instrumentation)](https://developer.android.com/reference/android/test/AndroidTestRunner#setInstrumentation(android.app.Instrumentation))instead.

| Parameters || |-------------------|--------------------------| | `instrumentation` | `Instrumentation`
| ### setInstrumentation Added in[API level 5](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Deprecated in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void setInstrumentation (Instrumentation instrumentation) ```

| Parameters || |-------------------|--------------------------| | `instrumentation` | `Instrumentation`
| ### setTest Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void setTest (Test test) ```

| Parameters || |--------|---------------| | `test` | `Test`
| ### setTestClassName Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void setTestClassName (String testClassName, String testMethodName) ```

| Parameters || |------------------|-----------------| | `testClassName` | `String`
| | `testMethodName` | `String`
| ### testEnded Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void testEnded (String testName) ```

| Parameters || |------------|-----------------| | `testName` | `String`
| ### testFailed Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void testFailed (int status, Test test, Throwable t) ```

| Parameters || |----------|--------------------| | `status` | `int`
| | `test` | `Test`
| | `t` | `Throwable`
| ### testStarted Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` public void testStarted (String testName) ```

| Parameters || |------------|-----------------| | `testName` | `String`
| ## Protected methods ### createTestResult Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` protected TestResult createTestResult () ```

| Returns || |--------------|--------| | `TestResult` |
| ### loadSuiteClass Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` protected Class loadSuiteClass (String suiteClassName) ```

| Parameters || |------------------|-----------------| | `suiteClassName` | `String`
| | Returns || |-----------------------------------------------------------------------|--------| | [Class](https://developer.android.com/reference/java/lang/Class)`` |
| | Throws || |----------------------------------------------------------------------------------------------------|---| | [ClassNotFoundException](https://developer.android.com/reference/java/lang/ClassNotFoundException) | | ### runFailed Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) ``` protected void runFailed (String message) ```

| Parameters || |-----------|-----------------| | `message` | `String`
|