com.android.ddmlib.testrunner
Class RemoteAndroidTestRunner

java.lang.Object
  com.android.ddmlib.testrunner.RemoteAndroidTestRunner

All Implemented Interfaces:

IRemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends java.lang.Object
implements IRemoteAndroidTestRunner

Runs a Android test command remotely and reports results.

Nested Class Summary

Nested classes/interfaces inherited from interface com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

IRemoteAndroidTestRunner.TestSize

Constructor Summary

RemoteAndroidTestRunner(java.lang.String packageName, IDevice remoteDevice)
Alternate constructor.

RemoteAndroidTestRunner(java.lang.String packageName, java.lang.String runnerName, IDevice remoteDevice)
Creates a remote Android test runner.

Method Summary

void	addBooleanArg(java.lang.String name, boolean value) Adds a boolean argument to include in instrumentation command.
void	addInstrumentationArg(java.lang.String name, java.lang.String value) Adds a argument to include in instrumentation command.
void	cancel() Requests cancellation of this test run.
java.lang.String	getPackageName() Returns the application package name.
java.lang.String	getRunnerName() Returns the runnerName.
void	removeInstrumentationArg(java.lang.String name) Removes a previously added argument.
void	run(java.util.Collection<ITestRunListener> listeners) Execute this test run.
void	run(ITestRunListener... listeners) Execute this test run.
void	setClassName(java.lang.String className) Sets to run only tests in this class Must be called before 'run'.
void	setClassNames(java.lang.String[] classNames) Sets to run only tests in the provided classes Must be called before 'run'.
void	setCoverage(boolean coverage) Sets this code coverage mode of this test run.
void	setDebug(boolean debug) Sets this debug mode of this test run.
void	setLogOnly(boolean logOnly) Sets this test run to log only mode - skips test execution.
void	setMaxtimeToOutputResponse(int maxTimeToOutputResponse) Sets the maximum time allowed between output of the shell command running the tests on the devices.
void	setMethodName(java.lang.String className, java.lang.String testName) Sets to run only specified test method Must be called before 'run'.
void	setTestPackageName(java.lang.String packageName) Sets to run all tests in specified package Must be called before 'run'.
void	setTestSize(IRemoteAndroidTestRunner.TestSize size) Sets to run only tests of given size.

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteAndroidTestRunner

public RemoteAndroidTestRunner(java.lang.String packageName,
                               java.lang.String runnerName,
                               IDevice remoteDevice)

Creates a remote Android test runner.

Parameters:

packageName - the Android application package that contains the tests to run

runnerName - the instrumentation test runner to execute. If null, will use default runner

remoteDevice - the Android device to execute tests on

RemoteAndroidTestRunner

public RemoteAndroidTestRunner(java.lang.String packageName,
                               IDevice remoteDevice)

Alternate constructor. Uses default instrumentation runner.

Parameters:

packageName - the Android application package that contains the tests to run

remoteDevice - the Android device to execute tests on

Method Detail

getPackageName

public java.lang.String getPackageName()

Returns the application package name.

Specified by:

getPackageName in interface IRemoteAndroidTestRunner

getRunnerName

public java.lang.String getRunnerName()

Returns the runnerName.

Specified by:

getRunnerName in interface IRemoteAndroidTestRunner

setClassName

public void setClassName(java.lang.String className)

Sets to run only tests in this class Must be called before 'run'.

Specified by:

setClassName in interface IRemoteAndroidTestRunner

Parameters:

className - fully qualified class name (eg x.y.z)

setClassNames

public void setClassNames(java.lang.String[] classNames)

Sets to run only tests in the provided classes Must be called before 'run'.

If providing more than one class, requires a InstrumentationTestRunner that supports the multiple class argument syntax.

Specified by:

setClassNames in interface IRemoteAndroidTestRunner

Parameters:

classNames - array of fully qualified class names (eg x.y.z)

setMethodName

public void setMethodName(java.lang.String className,
                          java.lang.String testName)

Sets to run only specified test method Must be called before 'run'.

Specified by:

setMethodName in interface IRemoteAndroidTestRunner

Parameters:

className - fully qualified class name (eg x.y.z)

testName - method name

setTestPackageName

public void setTestPackageName(java.lang.String packageName)

Sets to run all tests in specified package Must be called before 'run'.

Specified by:

setTestPackageName in interface IRemoteAndroidTestRunner

Parameters:

packageName - fully qualified package name (eg x.y.z)

addInstrumentationArg

public void addInstrumentationArg(java.lang.String name,
                                  java.lang.String value)

Adds a argument to include in instrumentation command.

Must be called before 'run'. If an argument with given name has already been provided, it's value will be overridden.

Specified by:

addInstrumentationArg in interface IRemoteAndroidTestRunner

Parameters:

name - the name of the instrumentation bundle argument

value - the value of the argument

removeInstrumentationArg

public void removeInstrumentationArg(java.lang.String name)

Removes a previously added argument.

Specified by:

removeInstrumentationArg in interface IRemoteAndroidTestRunner

Parameters:

name - the name of the instrumentation bundle argument to remove

addBooleanArg

public void addBooleanArg(java.lang.String name,
                          boolean value)

Adds a boolean argument to include in instrumentation command.

Specified by:

addBooleanArg in interface IRemoteAndroidTestRunner

Parameters:

name - the name of the instrumentation bundle argument

value - the value of the argument

See Also:

addInstrumentationArg(java.lang.String, java.lang.String)

setLogOnly

public void setLogOnly(boolean logOnly)

Sets this test run to log only mode - skips test execution.

Specified by:

setLogOnly in interface IRemoteAndroidTestRunner

setDebug

public void setDebug(boolean debug)

Sets this debug mode of this test run. If true, the Android test runner will wait for a debugger to attach before proceeding with test execution.

Specified by:

setDebug in interface IRemoteAndroidTestRunner

setCoverage

public void setCoverage(boolean coverage)

Sets this code coverage mode of this test run.

Specified by:

setCoverage in interface IRemoteAndroidTestRunner

setTestSize

public void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Sets to run only tests of given size. Must be called before 'run'.

Specified by:

setTestSize in interface IRemoteAndroidTestRunner

Parameters:

size - the IRemoteAndroidTestRunner.TestSize to run.

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)

Sets the maximum time allowed between output of the shell command running the tests on the devices.

This allows setting a timeout in case the tests can become stuck and never finish. This is different from the normal timeout on the connection.

By default no timeout will be specified.

Specified by:

setMaxtimeToOutputResponse in interface IRemoteAndroidTestRunner

See Also:

IDevice#executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, int)}

run

public void run(ITestRunListener... listeners)
         throws TimeoutException,
                AdbCommandRejectedException,
                ShellCommandUnresponsiveException,
                java.io.IOException

Execute this test run.

Convenience method for IRemoteAndroidTestRunner.run(Collection).

Specified by:

run in interface IRemoteAndroidTestRunner

Parameters:

listeners - listens for test results

Throws:

TimeoutException - in case of a timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

ShellCommandUnresponsiveException - if the device did not output any test result for a period longer than the max time to output.

java.io.IOException - if connection to device was lost.

See Also:

IRemoteAndroidTestRunner.setMaxtimeToOutputResponse(int)

run

public void run(java.util.Collection<ITestRunListener> listeners)
         throws TimeoutException,
                AdbCommandRejectedException,
                ShellCommandUnresponsiveException,
                java.io.IOException

Execute this test run.

Specified by:

run in interface IRemoteAndroidTestRunner

Parameters:

listeners - collection of listeners for test results

Throws:

TimeoutException - in case of a timeout on the connection.

AdbCommandRejectedException - if adb rejects the command

ShellCommandUnresponsiveException - if the device did not output any test result for a period longer than the max time to output.

java.io.IOException - if connection to device was lost.

See Also:

IRemoteAndroidTestRunner.setMaxtimeToOutputResponse(int)

cancel

public void cancel()

Requests cancellation of this test run.

Specified by:

cancel in interface IRemoteAndroidTestRunner