Test runner request

1. Required parameters
2. Runner class
3. No hidden api checks
4. No window animation
5. User ID
6. ABI
7. Profiling output
8. Output log path
9. Instrument options
   1. pkg
   2. clazz
   3. functional
   4. unit
   5. filterSize
   6. performance
   7. debug
   8. log
   9. emma
   10. coverageFile

Optionally uses Feature.SHELL_V2

Executing tests can be done using the TestRunnerRequest:

val channel: ReceiveChannel<List<TestEvents>> = adb.execute(
 request = TestRunnerRequest(
  testPackage = "com.example.test",
  instrumentOptions = InstrumentOptions(
   clazz = listOf("com.example.MyTest")
  ),
  supportedFeatures = emptyList(),
  coroutineScope = GlobalScope,
 ),
 serial = "emulator-5554"
)

The result is a channel ReadChannel<List<TestEvents>> that contains parsed and converted output of the am instrument command.

Required parameters

To execute tests you have to provide the testPackage, default InstrumentOptions(), coroutineScope and supportedFeatures for the target device. Caution: you have to provide the supportedFeatures because newer Android devices write information into the stderr for some reason. The textual am instrument parser doesn’t support this and needs to read only stdout.

Runner class

Default test runner class is android.support.test.runner.AndroidJUnitRunner but can be changed using the runnerClass option.

For all the options check the source of the am command

No hidden api checks

Disables restrictions on the use of hidden APIs

No window animation

Turn off window animations while running

User ID

Specify user instrumentation runs in. Defaults to current user if not specified”

ABI

Profiling output

Write profiling data to specified path on the device

Output log path

Write test log to specified path

Instrument options

pkg

The fully-qualified Java package name for one of the packages in the test application. Any test case class that uses this package name is executed. Notice that this is not an Android package name; a test package has a single Android package name but may have several Java packages within it.

clazz

The fully-qualified Java class name for one of the test case classes. Only this test case class is executed.

or

<class_name>#method name. A fully-qualified test case class name, and one of its methods. Only this method is executed. Note the hash mark (#) between the class name and the method name.

functional

Runs all test classes that extend InstrumentationTestCase.

unit

Runs all test classes that do not extend either InstrumentationTestCase or PerformanceTestCase.

filterSize

Runs a test method annotated by size. The annotations are @SmallTest, @MediumTest, and @LargeTest.

performance

Runs all test classes that implement PerformanceTestCase.

debug

Runs tests in debug mode.

log

Loads and logs all specified tests, but does not run them.

The test information appears in STDOUT. Use this to verify combinations of other filters and test specifications.

emma

Runs an EMMA code coverage analysis and writes the output to /data//coverage.ec on the device.

To override the file location, use the [coverageFile] key that is described in the following entry.

coverageFile

Overrides the default location of the EMMA coverage file on the device. Specify this value as a path and filename in UNIX format. The default filename is described in the entry for the [emma] key.