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

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