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

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

String getAmInstrumentCommand ()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

String getPackageName ()

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

String getRunOptions ()

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

String getRunnerName ()

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

void removeInstrumentationArg (String name)

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

void run ( ITestRunListener... listeners)

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

void run (Collection< ITestRunListener > listeners)

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

void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

void setClassName (String className)

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

void setClassNames (String[] classNames)

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

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)

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

void setRunName (String runName)

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

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

void setRunOptions (String options)

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

void setTestCollection (boolean collect)

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

void setTestPackageName (String packageName)

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

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)

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

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

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

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

отмена 

public void cancel ()

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

createParser 

public IInstrumentationResultParser createParser (String runName, 
                Collection<ITestRunListener> listeners)

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

Параметры
runName String : Название запуска, которое следует использовать.

listeners Collection : Слушатели должны были сообщить о результатах.

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

getAmInstrumentCommand 

public String getAmInstrumentCommand ()

Возвраты
String

getCoverageOutputType 

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

Возвраты
IRemoteAndroidTestRunner.CoverageOutput

getPackageName 

public String getPackageName ()

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

Возвраты
String

getRunOptions 

public String getRunOptions ()

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

Возвраты
String

getRunnerName 

public String getRunnerName ()

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

Возвраты
String

removeInstrumentationArg 

public void removeInstrumentationArg (String name)

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

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

бегать 

public void run (ITestRunListener... listeners)

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

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

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

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

бегать 

public void run (Collection<ITestRunListener> listeners)

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

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

Броски
AdbCommandRejectedException
IOException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation 

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

Параметры
additionalTestDataPath String

setClassName 

public void setClassName (String className)

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

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

setClassNames 

public void setClassNames (String[] classNames)

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

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

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

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

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

setRunName 

public void setRunName (String runName)

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

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

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)

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

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

setTestSize 

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

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

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

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

getArgsCommand 

protected String getArgsCommand ()

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

Возвраты
String

getRunnerPath 

protected String getRunnerPath ()

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

Возвраты
String