RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

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

Удаленно запускает тестовую команду Android и сообщает результаты.

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

Публичные конструкторы

RemoteAndroidTestRunner (String packageName, IShellEnabledDevice remoteDevice)

Альтернативный конструктор.

RemoteAndroidTestRunner (String packageName, String runnerName, IShellEnabledDevice remoteDevice)

Альтернативный конструктор.

RemoteAndroidTestRunner (String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Создает удаленный запуск Android-тестов.

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

void addBooleanArg (String name, boolean value)

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

void addInstrumentationArg (String name, String value)

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

void cancel ()

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

IInstrumentationResultParser createParser (String runName, listeners)

Создайте InstrumentationResultParser , который будет использоваться для анализа выходных данных инструментирования.

String getAmInstrumentCommand ()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

String getPackageName ()

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

String getRunOptions ()

Возвращает параметры для команды am instrument.

String getRunnerName ()

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

void removeInstrumentationArg (String name)

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

void run ( ITestRunListener... listeners)

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

void run ( listeners)

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

void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

void setClassName (String className)

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

void setClassNames (String[] classNames)

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

void setCoverage (boolean coverage)

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

void setCoverageReportLocation (String reportPath)

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

void setDebug (boolean debug)

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

void setLogOnly (boolean logOnly)

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

void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

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

void setMaxTimeout (long maxTimeout, TimeUnit maxTimeUnits)

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

void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)
void setMethodName (String className, String testName)

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

void setRunName (String runName)

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

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

void setRunOptions (String options)

Задает параметры для команды am instrument.

void setTestCollection (boolean collect)

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

void setTestPackageName (String packageName)

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

void setTestSize ( IRemoteAndroidTestRunner.TestSize size)

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

Защищенные методы

String getArgsCommand ()

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

String getRunnerPath ()

Возвращает полный путь к компоненту инструментария.

Публичные конструкторы

RemoteAndroidTestRunner 

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Альтернативный конструктор. Использует инструментарий по умолчанию.

Параметры
packageName String : пакет приложения Android, содержащий тесты для запуска.

remoteDevice IShellEnabledDevice : устройство Android для выполнения тестов

RemoteAndroidTestRunner 

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

Альтернативный конструктор. Использует statusReporterMode по умолчанию.

Параметры
packageName String : пакет приложения Android, содержащий тесты для запуска.

runnerName String : инструментарий для запуска тестов. Если значение равно null, будет использоваться инструментарий по умолчанию.

remoteDevice IShellEnabledDevice : устройство Android для выполнения тестов

RemoteAndroidTestRunner 

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Создает удаленный запуск Android-тестов.

Параметры
packageName String : пакет приложения Android, содержащий тесты для запуска.

runnerName String : инструментарий для запуска тестов. Если значение равно null, будет использоваться инструментарий по умолчанию.

remoteDevice IShellEnabledDevice : устройство Android для выполнения тестов

statusReporterMode RemoteAndroidTestRunner.StatusReporterMode : режим отчета о состоянии, который будет использоваться для команды инструмента.

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

addBooleanArg 

public void addBooleanArg (String name, 
                boolean value)

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

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

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

addInstrumentationArg 

public void addInstrumentationArg (String name, 
                String value)

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

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

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

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

отмена 

public void cancel ()

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

createParser 

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

Создайте InstrumentationResultParser , который будет использоваться для анализа выходных данных инструментирования.

Параметры
runName String : Имя используемого прогона.

listeners : Слушателям следует сообщить о результатах.

Возврат
IInstrumentationResultParser Экземпляр InstrumentationResultParser .

getAmInstrumentCommand 

public String getAmInstrumentCommand ()

Возврат
String

получитьCoverageOutputType 

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

Возврат
IRemoteAndroidTestRunner.CoverageOutput

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

public String getPackageName ()

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

Возврат
String

getRunOptions 

public String getRunOptions ()

Возвращает параметры для команды am instrument.

Возврат
String

getRunnerName 

public String getRunnerName ()

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

Возврат
String

removeInstrumentationArg 

public void removeInstrumentationArg (String name)

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

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

бегать 

public void run (ITestRunListener... listeners)

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

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

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

Броски
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

бегать 

public void run ( listeners)

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

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

Броски
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation 

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

Параметры
additionalTestDataPath String

setClassName 

public void setClassName (String className)

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

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

setClassNames 

public void setClassNames (String[] classNames)

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

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

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

setCoverage 

public void setCoverage (boolean coverage)

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

Параметры
coverage boolean

setCoverageReportLocation 

public void setCoverageReportLocation (String reportPath)

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

Параметры
reportPath String

setDebug 

public void setDebug (boolean debug)

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

Параметры
debug boolean

setLogOnly 

public void setLogOnly (boolean logOnly)

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

Параметры
logOnly boolean

setMaxTimeToOutputResponse 

public void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

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

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

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

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

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

setMaxTimeout 

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

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

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

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

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

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

setMaxtimeToOutputResponse 

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Параметры
maxTimeToOutputResponse int

setMethodName 

public void setMethodName (String className, 
                String testName)

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

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

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

setRunName 

public void setRunName (String runName)

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

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

setRunOptions 

public void setRunOptions (String options)

Задаёт параметры для команды инструмента am. Полный список параметров см. на странице com/android/commands/am/Am.java.

Параметры
options String

setTestCollection 

public void setTestCollection (boolean collect)

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

Параметры
collect boolean

setTestPackageName 

public void setTestPackageName (String packageName)

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

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

setTestSize 

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

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

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

Защищенные методы

получитьArgsCommand 

protected String getArgsCommand ()

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

Возврат
String

getRunnerPath 

protected String getRunnerPath ()

Возвращает полный путь к компоненту инструментария.

Возврат
String