Инструментальное тестирование

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

java.lang.Object
↳ com.android.tradefed.testtype.InstrumentationTest

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

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

Константы

String RUN_TESTS_AS_USER_KEY

String RUN_TESTS_ON_SDK_SANDBOX

Поля

protected boolean mDebug

protected boolean mInstrumentInPcc

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

Государственные строители

InstrumentationTest ()

Общедоступные методы

void addDeviceListeners (Set<String> 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 isCollectTestsOnly ()
boolean isOrchestrator ()

Возвращает значение ERROR(InstrumentationTest.mOrchestrator/#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 (List< IMetricCollector > collectors)

Задает список объектов IMetricCollector , определенных для выполнения теста.

void setOrchestrator (boolean useOrchestrator)

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

void setPackageName (String packageName)

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

void setReRunUsingTestFile (boolean reRunUsingTestFile)

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

void setRerunMode (boolean rerun)

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

void setRetryAttemptNumber (int attemptNumber)

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

Устанавливает количество попыток повтора, передавая его в качестве аргумента инструментария "retry_attempt" исполнителю на стороне устройства.

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 (Collection< TestDescription > tests)

Укажите набор тестов, которые должны быть выполнены этим InstrumentationTest.

void setWindowAnimation (boolean windowAnimation)

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

static Set< TestDescription > excludeNonExecuted ( TestRunResult results)

Для отслеживания того, что необходимо повторно запустить, отфильтруйте записи "NOT_EXECUTED" и "Skipped".

String getClassName ()

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

ListInstrumentationParser getListInstrumentationParser ()

Получите объект ListInstrumentationParser , используемый для анализа запросов 'pm list instrumentation'.

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_AS_USER"

RUN_TESTS_ON_SDK_SANDBOX 

public static final String RUN_TESTS_ON_SDK_SANDBOX

Постоянное значение: "RUN_TESTS_ON_SDK_SANDBOX"

Поля

mDebug 

protected boolean mDebug

mInstrumentInPcc 

protected boolean mInstrumentInPcc

mInstrumentSdkInSandbox 

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox 

protected boolean mInstrumentSdkSandbox

Государственные строители

Инструментальное тестирование 

public InstrumentationTest ()

Общедоступные методы

addDeviceListeners 

public void addDeviceListeners (Set<String> extraListeners)

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

Параметры
extraListeners Set

addInstrumentationArg 

public void addInstrumentationArg (String key, 
                String value)

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

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

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

getAbi 

public IAbi getAbi ()

Возвраты
IAbi

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

public IConfiguration getConfiguration ()

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

Возвраты
IConfiguration

getCoverageTarget 

public String getCoverageTarget ()

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

Возвраты
String

getDebug 

public boolean getDebug ()

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

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

getDevice 

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

isCollectTestsOnly 

public boolean isCollectTestsOnly ()

Возвраты
boolean находится ли данный тест в режиме сбора только тестов.

isOrchestrator 

public boolean isOrchestrator ()

Возвращает значение ERROR(InstrumentationTest.mOrchestrator/#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

setCollectTestsOnly 

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)

Установите целевой показатель покрытия этого теста.

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

Параметры
coverageTarget String

setDebug 

public void setDebug (boolean debug)

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

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

setDevice 

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 : устанавливаемый File

setIsolatedStorage 

public void setIsolatedStorage (boolean isolatedStorage)

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

Параметры
isolatedStorage boolean

setMethodName 

public void setMethodName (String testMethodName)

При желании можно указать метод тестирования для выполнения.

Параметры
testMethodName String

setMetricCollectors 

public void setMetricCollectors (List<IMetricCollector> collectors)

Задает список объектов IMetricCollector , определенных для выполнения теста.

Параметры
collectors List

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

setRetryAttemptNumber 

public void setRetryAttemptNumber (int attemptNumber)

Устанавливает количество попыток повтора для теста. По умолчанию ничего не делает.

Устанавливает количество попыток повтора, передавая его в качестве аргумента инструментария "retry_attempt" исполнителю на стороне устройства.

Параметры
attemptNumber int

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 для каждого оставшегося теста через rerun.

Параметры
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 (Collection<TestDescription> tests)

Укажите набор тестов, которые должны быть выполнены этим InstrumentationTest.

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

setWindowAnimation 

public void setWindowAnimation (boolean windowAnimation)

Параметры
windowAnimation boolean

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

excludeNonExecuted 

protected static Set<TestDescription> excludeNonExecuted (TestRunResult results)

Для отслеживания того, что необходимо повторно запустить, отфильтруйте записи "NOT_EXECUTED" и "Skipped".

Параметры
results TestRunResult

Возвраты
Set< TestDescription >

getClassName 

protected String getClassName ()

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

Возвраты
String

getListInstrumentationParser 

protected ListInstrumentationParser getListInstrumentationParser ()

Получите объект ListInstrumentationParser , используемый для анализа запросов 'pm list instrumentation'.

Возвраты
ListInstrumentationParser

getMethodName 

protected String getMethodName ()

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

Возвраты
String

getTestPackageName 

protected String getTestPackageName ()

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

Возвраты
String

queryRunnerName 

protected String queryRunnerName ()

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

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

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

setRunnerArgs 

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Параметры
runner IRemoteAndroidTestRunner