ИнструментарийТест

public class InstrumentationTest
extends Object implements IAbiReceiver , IConfigurationReceiver , IDeviceTest , IMetricCollectorReceiver , IRemoteTest , ITestCollector

java.lang.Объект
↳ com.android.tradefed.testtype.InstrumentationTest

Тест, который запускает пакет инструментального тестирования на данном устройстве.

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

Поля

public static final String RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_ON_SDK_SANDBOX

protected boolean mDebug

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

Общественные конструкторы

InstrumentationTest ()

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

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

Позволяет добавлять в бегун больше пользовательских прослушивателей.

void addInstrumentationArg (String key, String value)

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

IAbi getAbi ()
IConfiguration getConfiguration ()

Получает IConfiguration для этого теста.

String getCoverageTarget ()

Получите значение CoverageTarget, ранее установленное с помощью setCoverageTarget(String) .

boolean getDebug ()

Получите настройки отладки инструментария.

ITestDevice getDevice ()

Получите устройство для тестирования.

String getForceAbi ()
long getMaxTimeout ()

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

String getPackageName ()

Запустите пакет манифеста Android.

String getRunName ()

Получите имя пользовательского запуска теста, которое будет предоставлено прослушивателю.

String getRunnerName ()

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

boolean isOrchestrator ()

Возвращает значение ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)

void run ( TestInformation testInfo, ITestInvocationListener listener)

Запускает тесты и сообщает результат прослушивателю.

void setAbi ( IAbi abi)
void setClassName (String testClassName)

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

void setCollectTestsOnly (boolean shouldCollectTest)

Включает или отключает режим сбора тестов.

void setCollectsTestsShellTimeout (int timeout)

Этот метод устарел. Этот метод является безоперационным

void setConfiguration ( IConfiguration config)

Внедряет используемый IConfiguration .

void setCoverageTarget (String coverageTarget)

Установите целевой охват этого теста.

void setDebug (boolean debug)

Установите настройки отладки инструментов.

void setDevice ( ITestDevice device)

Введите тестируемое устройство.

void setEnforceFormat (boolean enforce)

Установите True, если мы применяем формат вывода инструментов AJUR.

void setForceAbi (String abi)

Устанавливает опцию Force-Abi.

void setInstallFile (File installFile)

Установите дополнительный файл для установки, содержащий тесты.

void setIsolatedStorage (boolean isolatedStorage)

Установите, следует ли использовать изолированное хранилище.

void setMethodName (String testMethodName)

При необходимости установите метод тестирования для запуска.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

Устанавливает список IMetricCollector , определенных для тестового запуска.

void setOrchestrator (boolean useOrchestrator)

Устанавливает параметр --orchestrator

void setPackageName (String packageName)

Настройте пакет манифеста Android для запуска.

void setReRunUsingTestFile (boolean reRunUsingTestFile)

Устанавливает параметр --rerun-from-file.

void setRerunMode (boolean rerun)

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

void setRunName (String runName)

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

void setRunnerName (String runnerName)

При необходимости установите используемый инструментарий Android.

void setShellTimeout (long timeout)

При желании установите максимальное время (в миллисекундах) ожидания вывода оболочки с устройства.

void setTestFilePathOnDevice (String testFilePathOnDevice)

При необходимости укажите путь к файлу, расположенному на устройстве, который должен содержать список разделенных строками тестовых классов и методов (формат: com.foo.Class#method), которые необходимо запустить.

void setTestPackageName (String testPackageName)

Устанавливает фильтр тестовых пакетов.

void setTestSize (String size)

При необходимости установите размер теста для запуска.

void setTestTimeout (long timeout)

При необходимости установите максимальное время (в миллисекундах) для каждого отдельного запуска теста.

void setTestsToRun ( tests) setTestsToRun ( tests)

Задайте набор тестов, которые должен выполнять этот InstrumentationTest.

void setWindowAnimation (boolean windowAnimation)

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

static excludeNonExecuted ( TestRunResult results)

Отфильтруйте «NOT_EXECUTED» и «Пропущено», чтобы отслеживать, что необходимо выполнить повторно.

String getClassName ()

Получите имя класса для запуска.

ListInstrumentationParser getListInstrumentationParser ()

Получите ListInstrumentationParser , используемый для анализа запросов «инструментарий списка pm».

String getMethodName ()

Запустите тестовый метод.

String getTestPackageName ()

Запустите тестовый пакет Java.

String queryRunnerName ()

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

void setRunnerArgs (IRemoteAndroidTestRunner runner)

Поля

RUN_TESTS_AS_USER_KEY 

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX 

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug 

protected boolean mDebug

mInstrumentSdkInSandbox 

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox 

protected boolean mInstrumentSdkSandbox

Общественные конструкторы

ИнструментарийТест 

public InstrumentationTest ()

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

добавитьDeviceListeners 

public void addDeviceListeners ( extraListeners)

Позволяет добавлять в бегун больше пользовательских прослушивателей.

Параметры
extraListeners

addInstrumentationArg 

public void addInstrumentationArg (String key, 
                String value)

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

Параметры
key String : имя аргумента.

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

получитьАби 

public IAbi getAbi ()

Возврат
IAbi

получить конфигурацию 

public IConfiguration getConfiguration ()

Получает IConfiguration для этого теста.

Возврат
IConfiguration

getCoverageTarget 

public String getCoverageTarget ()

Получите значение CoverageTarget, ранее установленное с помощью setCoverageTarget(String) .

Возврат
String

getDebug 

public boolean getDebug ()

Получите настройки отладки инструментария.

Возврат
boolean Логический параметр отладки.

получитьустройство 

public ITestDevice getDevice ()

Получите устройство для тестирования.

Возврат
ITestDevice ITestDevice

getForceAbi 

public String getForceAbi ()

Возврат
String

getMaxTimeout 

public long getMaxTimeout ()

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

Возврат
long

getPackageName 

public String getPackageName ()

Запустите пакет манифеста Android.

Возврат
String

getRunName 

public String getRunName ()

Получите имя пользовательского запуска теста, которое будет предоставлено прослушивателю.

Возврат
String

getRunnerName 

public String getRunnerName ()

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

Возврат
String

isOrchestrator 

public boolean isOrchestrator ()

Возвращает значение ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)

Возврат
boolean

бегать 

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Запускает тесты и сообщает результат прослушивателю.

Параметры
testInfo TestInformation : объект TestInformation , содержащий полезную информацию для запуска тестов.

listener ITestInvocationListener : ITestInvocationListener результатов теста.

Броски
DeviceNotAvailableException

setAbi 

public void setAbi (IAbi abi)

Параметры
abi IAbi

setClassName 

public void setClassName (String testClassName)

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

Параметры
testClassName String

setCollectTestOnly 

public void setCollectTestsOnly (boolean shouldCollectTest)

Включает или отключает режим сбора тестов.

setCollectsTestsShellTimeout 

public void setCollectsTestsShellTimeout (int timeout)

Этот метод устарел.
Этот метод является безоперационным

Установите максимальное время в мс, чтобы учесть «максимальное время вывода ответа оболочки» при сборе тестов.

Параметры
timeout int

setConfiguration 

public void setConfiguration (IConfiguration config)

Внедряет используемый IConfiguration .

Параметры
config IConfiguration

setCoverageTarget 

public void setCoverageTarget (String coverageTarget)

Установите целевой охват этого теста.

В настоящее время не используется. Этот метод просто присутствует, поэтому покрытие CoverTarget можно позже получить с помощью getCoverageTarget()

Параметры
coverageTarget String

setDebug 

public void setDebug (boolean debug)

Установите настройки отладки инструментов.

Параметры
debug boolean : логическое значение для установки параметра отладки инструментария.

УстановитьУстройство 

public void setDevice (ITestDevice device)

Введите тестируемое устройство.

Параметры
device ITestDevice : используемый ITestDevice .

setEnforceFormat 

public void setEnforceFormat (boolean enforce)

Установите True, если мы применяем формат вывода инструментов AJUR.

Параметры
enforce boolean

setForceAbi 

public void setForceAbi (String abi)

Устанавливает опцию Force-Abi.

setInstallFile 

public void setInstallFile (File installFile)

Установите дополнительный файл для установки, содержащий тесты.

Параметры
installFile File : устанавливаемая ERROR(/File)

setIsolatedStorage 

public void setIsolatedStorage (boolean isolatedStorage)

Установите, следует ли использовать изолированное хранилище.

Параметры
isolatedStorage boolean

setMethodName 

public void setMethodName (String testMethodName)

При необходимости установите метод тестирования для запуска.

Параметры
testMethodName String

setMetricCollectors 

public void setMetricCollectors ( collectors)

Устанавливает список IMetricCollector , определенных для тестового запуска.

Параметры
collectors

setOrchestrator 

public void setOrchestrator (boolean useOrchestrator)

Устанавливает параметр --orchestrator

Параметры
useOrchestrator boolean

setPackageName 

public void setPackageName (String packageName)

Настройте пакет манифеста Android для запуска.

Параметры
packageName String

setReRunUsingTestFile 

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

Устанавливает параметр --rerun-from-file.

Параметры
reRunUsingTestFile boolean

setRerunMode 

public void setRerunMode (boolean rerun)

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

Параметры
rerun boolean

setRunName 

public void setRunName (String runName)

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

Параметры
runName String

setRunnerName 

public void setRunnerName (String runnerName)

При необходимости установите используемый инструментарий Android.

Параметры
runnerName String

setShellTimeout 

public void setShellTimeout (long timeout)

При желании установите максимальное время (в миллисекундах) ожидания вывода оболочки с устройства.

Параметры
timeout long

SetTestFilePathOnDevice 

public void setTestFilePathOnDevice (String testFilePathOnDevice)

При необходимости укажите путь к файлу, расположенному на устройстве, который должен содержать список разделенных строками тестовых классов и методов (формат: com.foo.Class#method), которые необходимо запустить. Если установлено, будет автоматически предпринята попытка перезапустить тесты с использованием этого тестового файла через InstrumentationFileTest вместо выполнения отдельных команд adb для каждого оставшегося теста посредством повторного запуска.

Параметры
testFilePathOnDevice String

setTestPackageName 

public void setTestPackageName (String testPackageName)

Устанавливает фильтр тестовых пакетов.

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

Будет игнорироваться, если для setClassName(String) было предоставлено ненулевое значение.

Параметры
testPackageName String

setTestSize 

public void setTestSize (String size)

При необходимости установите размер теста для запуска.

Параметры
size String

setTestTimeout 

public void setTestTimeout (long timeout)

При необходимости установите максимальное время (в миллисекундах) для каждого отдельного запуска теста.

Параметры
timeout long

setTestsToRun 

public void setTestsToRun ( tests)

Задайте набор тестов, которые должен выполнять этот InstrumentationTest.

Параметры
tests : тесты для запуска

setWindowAnimation 

public void setWindowAnimation (boolean windowAnimation)

Параметры
windowAnimation boolean

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

исключитьNonExecuted 

protected static  excludeNonExecuted (TestRunResult results)

Отфильтруйте «NOT_EXECUTED» и «Пропущено», чтобы отслеживать, что необходимо выполнить повторно.

Параметры
results TestRunResult

Возврат

getClassName 

protected String getClassName ()

Получите имя класса для запуска.

Возврат
String

getListInstrumentationParser 

protected ListInstrumentationParser getListInstrumentationParser ()

Получите ListInstrumentationParser , используемый для анализа запросов «инструментарий списка pm».

Возврат
ListInstrumentationParser

getMethodName 

protected String getMethodName ()

Запустите тестовый метод.

Возврат
String

getTestPackageName 

protected String getTestPackageName ()

Запустите тестовый пакет Java.

Возврат
String

имя_запроса_бегуна 

protected String queryRunnerName ()

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

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

Броски
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs 

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Параметры
runner IRemoteAndroidTestRunner