IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

Интерфейс для удаленного запуска тестовой команды Android и сообщения результатов слушателю.

Краткое содержание

Публичные методы

abstract void addBooleanArg (String name, boolean value)

Добавляет логический аргумент для включения в команду инструментирования.

abstract void addInstrumentationArg (String name, String value)

Добавляет аргумент для включения в команду инструментирования.

abstract void cancel ()

Прошу отменить данный тестовый запуск.

abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Возвращает тип тестового покрытия, создаваемого исполнителем.

abstract String getPackageName ()

Возвращает имя пакета приложения.

abstract String getRunnerName ()

Возвращает имя участника.

abstract void removeInstrumentationArg (String name)

Удаляет ранее добавленный аргумент.

abstract void run ( ITestRunListener... listeners)

Выполните этот тестовый запуск.

abstract void run ( listeners)

Выполните этот тестовый запуск.

abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

Задает расположение дополнительных тестовых выходных данных, которые необходимо скопировать на хост перед удалением тестового приложения.

abstract void setClassName (String className)

Устанавливает запуск только тестов в этом классе. Должен вызываться перед «запуском».

abstract void setClassNames (String[] classNames)

Устанавливает запуск только тестов в предоставленных классах. Должен вызываться перед «запуском».

abstract void setCoverage (boolean coverage)

Устанавливает режим покрытия кода для данного тестового прогона.

abstract void setCoverageReportLocation (String reportPath)

Устанавливает местоположение создаваемых отчетов о покрытии.

abstract void setDebug (boolean debug)

Устанавливает режим отладки данного тестового прогона.

abstract void setLogOnly (boolean logOnly)

Переводит этот тестовый запуск в режим «только журналирование» — пропускает выполнение теста.

abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

Устанавливает максимально допустимое время между выводом команды оболочки и запуском тестов на устройствах.

abstract void setMaxTimeout (long maxTimeout, TimeUnit maxTimeUnits)

Устанавливает максимальное время, отведенное для завершения работы прибора.

abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Этот метод устарел. Используйте ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)) .

abstract void setMethodName (String className, String testName)

Устанавливает запуск только указанного метода теста. Должен быть вызван перед «запуском».

abstract void setRunName (String runName)

Задайте пользовательское имя запуска, которое будет сообщено ITestRunListener при run( )

Если не указано, будет использовано имя пакета

abstract void setTestCollection (boolean collection)

Переводит данный тестовый запуск в режим тестового сбора.

abstract void setTestPackageName (String packageName)

Устанавливает запуск всех тестов в указанном пакете. Должен вызываться перед «запуском».

abstract void setTestSize ( IRemoteAndroidTestRunner.TestSize size)

Устанавливает запуск только тестов заданного размера.

Публичные методы

addBooleanArg 

public abstract void addBooleanArg (String name, 
                boolean value)

Добавляет логический аргумент для включения в команду инструментирования.

Параметры
name String : имя аргумента комплекта инструментов

value boolean : значение аргумента

addInstrumentationArg 

public abstract void addInstrumentationArg (String name, 
                String value)

Добавляет аргумент для включения в команду инструментирования.

Должен быть вызван до выполнения. Если аргумент с указанным именем уже был указан, его значение будет переопределено.

Параметры
name String : имя аргумента комплекта инструментов

value String : значение аргумента

отмена 

public abstract void cancel ()

Прошу отменить данный тестовый запуск.

получитьCoverageOutputType 

public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Возвращает тип тестового покрытия, создаваемого исполнителем. См. CoverageOutput .

Возврат
IRemoteAndroidTestRunner.CoverageOutput

получитьИмяПакета 

public abstract String getPackageName ()

Возвращает имя пакета приложения.

Возврат
String

getRunnerName 

public abstract String getRunnerName ()

Возвращает имя участника.

Возврат
String

removeInstrumentationArg 

public abstract void removeInstrumentationArg (String name)

Удаляет ранее добавленный аргумент.

Параметры
name String : имя аргумента пакета инструментов, который необходимо удалить.

бегать 

public abstract void run (ITestRunListener... listeners)

Выполните этот тестовый запуск.

Удобный метод для ERROR(/#run(Collection)) .

Параметры
listeners ITestRunListener : прослушивает результаты теста

Броски
TimeoutException в случае тайм-аута соединения.
AdbCommandRejectedException если adb отклоняет команду
ShellCommandUnresponsiveException если устройство не выдало никаких результатов теста в течение периода, превышающего максимальное время вывода.
если соединение с устройством было потеряно.

Смотрите также:

бегать 

public abstract void run ( listeners)

Выполните этот тестовый запуск.

Параметры
listeners : сбор слушателей для результатов теста

Броски
TimeoutException в случае тайм-аута соединения.
AdbCommandRejectedException если adb отклоняет команду
ShellCommandUnresponsiveException если устройство не выдало никаких результатов теста в течение периода, превышающего максимальное время вывода.
если соединение с устройством было потеряно.

Смотрите также:

setAdditionalTestOutputLocation 

public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

Задаёт расположение дополнительных тестовых выходных данных, которые будут скопированы на хост перед удалением тестового приложения. Например, сгенерированные отчёты о производительности.

Параметры
additionalTestDataPath String

setClassName 

public abstract void setClassName (String className)

Устанавливает запуск только тестов в этом классе. Должен вызываться перед «запуском».

Параметры
className String : полное имя класса (например, xyz)

setClassNames 

public abstract void setClassNames (String[] classNames)

Устанавливает запуск только тестов в предоставленных классах. Должен вызываться перед «запуском».

При предоставлении более одного класса требуется InstrumentationTestRunner, поддерживающий синтаксис аргументов нескольких классов.

Параметры
classNames String : массив полностью квалифицированных имен классов (например, xyz)

setCoverage 

public abstract void setCoverage (boolean coverage)

Устанавливает режим покрытия кода для данного тестового прогона.

Параметры
coverage boolean

setCoverageReportLocation 

public abstract void setCoverageReportLocation (String reportPath)

Устанавливает местоположение создаваемых отчетов о покрытии.

Параметры
reportPath String

setDebug 

public abstract void setDebug (boolean debug)

Устанавливает режим отладки для данного тестового запуска. Если установлено значение true, программа запуска тестов Android будет ожидать подключения отладчика, прежде чем продолжить выполнение теста.

Параметры
debug boolean

setLogOnly 

public abstract void setLogOnly (boolean logOnly)

Переводит этот тестовый запуск в режим «только журналирование» — пропускает выполнение теста.

Параметры
logOnly boolean

setMaxTimeToOutputResponse 

public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Устанавливает максимально допустимое время между выводом команды оболочки и запуском тестов на устройствах.

Это позволяет установить тайм-аут на случай, если тесты зависнут и не будут завершены. Это отличается от обычного тайм-аута для соединения.

По умолчанию тайм-аут не указан.

Параметры
maxTimeToOutputResponse long : максимальное время, в течение которого команда может не выводить никакого ответа. Значение 0 означает, что метод будет ждать вывода команды бесконечно (пока receiver не отменит выполнение) и никогда не выдаст исключение.

maxTimeUnits TimeUnit : Единицы измерения для ненулевых значений maxTimeToOutputResponse и maxTimeout .

setMaxTimeout 

public abstract void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

Устанавливает максимальное время, отведенное для завершения работы прибора.

Это позволяет установить тайм-аут на случай, если тесты зависнут и не будут завершены. Это отличается от обычного тайм-аута для соединения.

По умолчанию тайм-аут не указан.

Параметры
maxTimeout long : максимальное время, в течение которого команда может не выводить никакого ответа. Значение 0 означает, что метод будет ждать вывода команды бесконечно (пока receiver не отменит выполнение) и никогда не выдаст исключение.

maxTimeUnits TimeUnit : Единицы измерения для ненулевых значений maxTimeToOutputResponse и maxTimeout .

setMaxtimeToOutputResponse 

public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Этот метод устарел.
Используйте ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)) .

Параметры
maxTimeToOutputResponse int

setMethodName 

public abstract void setMethodName (String className, 
                String testName)

Устанавливает запуск только указанного метода теста. Должен быть вызван перед «запуском».

Параметры
className String : полное имя класса (например, xyz)

testName String : имя метода

setRunName 

public abstract void setRunName (String runName)

Задайте пользовательское имя запуска, которое будет сообщено ITestRunListener при run( )

Если не указано, будет использовано имя пакета

setTestCollection 

public abstract void setTestCollection (boolean collection)

Переводит этот тестовый запуск в режим сбора тестов. Если значение равно true, выполнение теста будет пропущено, и будут установлены все соответствующие аргументы запуска, необходимые для успешного сбора тестов.

Параметры
collection boolean

setTestPackageName 

public abstract void setTestPackageName (String packageName)

Устанавливает запуск всех тестов в указанном пакете. Должен вызываться перед «запуском».

Параметры
packageName String : полное имя пакета (например, xyz)

setTestSize 

public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Устанавливает запуск только тестов заданного размера. Должен быть вызван перед «run».

Параметры
size IRemoteAndroidTestRunner.TestSize : TestSize для запуска.