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 (Collection< ITestRunListener > listeners)

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

abstract void run ( ITestRunListener... listeners)

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

abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

abstract void setClassName (String className)

Этот параметр запускает только тесты в данном классе. Его необходимо вызвать перед вызовом функции 'run'.

abstract void setClassNames (String[] classNames)

Настраивает запуск только тестов в предоставленных классах. Необходимо вызвать перед вызовом функции 'run'.

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)

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

abstract void setMethodName (String className, String testName)

Задает выполнение только указанного метода тестирования. Должен быть вызван перед вызовом функции 'run'.

abstract void setRunName (String runName)

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

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

abstract void setTestCollection (boolean collection)

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

abstract void setTestPackageName (String packageName)

Задает запуск всех тестов в указанном пакете. Должен быть вызван перед вызовом функции 'run'.

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)

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

Необходимо вызвать перед вызовом функции 'run'. Если аргумент с заданным именем уже был предоставлен, его значение будет перезаписано.

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

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

отмена 

public abstract void cancel ()

Запрос на отмену данного тестового запуска.

getCoverageOutputType 

public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

Возвраты
IRemoteAndroidTestRunner.CoverageOutput

getPackageName 

public abstract String getPackageName ()

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

Возвраты
String

getRunnerName 

public abstract String getRunnerName ()

Возвращает имя бегуна.

Возвраты
String

removeInstrumentationArg 

public abstract void removeInstrumentationArg (String name)

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

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

бегать 

public abstract void run (Collection<ITestRunListener> listeners)

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

Параметры
listeners Collection : набор слушателей для получения результатов тестирования.

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

бегать 

public abstract void run (ITestRunListener... listeners)

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

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

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

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

setAdditionalTestOutputLocation 

public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

Параметры
additionalTestDataPath String

setClassName 

public abstract void setClassName (String className)

Этот параметр запускает только тесты в данном классе. Его необходимо вызвать перед вызовом функции 'run'.

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

setClassNames 

public abstract void setClassNames (String[] classNames)

Настраивает запуск только тестов в предоставленных классах. Необходимо вызвать перед вызовом функции 'run'.

Если указано более одного класса, требуется объект 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)

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

Параметры
maxTimeToOutputResponse int

setMethodName 

public abstract void setMethodName (String className, 
                String testName)

Задает выполнение только указанного метода тестирования. Должен быть вызван перед вызовом функции 'run'.

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

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

setRunName 

public abstract void setRunName (String runName)

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

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

setTestCollection 

public abstract void setTestCollection (boolean collection)

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

Параметры
collection boolean

setTestPackageName 

public abstract void setTestPackageName (String packageName)

Задает запуск всех тестов в указанном пакете. Должен быть вызван перед вызовом функции 'run'.

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

setTestSize 

public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Настраивает запуск только тестов заданного размера. Должен быть вызван перед вызовом функции 'run'.

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