InstrumentationTest

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 mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

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

InstrumentationTest ()

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

void addDeviceListeners ( extraListeners)

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

void addInstrumentationArg (String key, String value)

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

IAbi getAbi ()
IConfiguration getConfiguration ()

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

String getCoverageTarget ()

Получите значение coverTarget, установленное ранее, с помощью 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)

Задает список 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)

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

void setWindowAnimation (boolean windowAnimation)

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

static excludeNonExecuted ( TestRunResult results)

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

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

mInstrumentSdkInSandbox 

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox 

protected boolean mInstrumentSdkSandbox

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

InstrumentationTest 

public InstrumentationTest ()

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

addDeviceListeners 

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

получитьCoverageTarget 

public String getCoverageTarget ()

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

Возврат
String

получитьОтладку 

public boolean getDebug ()

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

Возврат
boolean Булева настройка отладки.

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

public ITestDevice getDevice ()

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

Возврат
ITestDevice ITestDevice

getForceAbi 

public String getForceAbi ()

Возврат
String

getMaxTimeout 

public long getMaxTimeout ()

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

Возврат
long

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

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

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)

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

В настоящее время не используется. Этот метод присутствует только для того, чтобы позже можно было получить значение coverTarget с помощью 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 : устанавливаемая 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 для каждого оставшегося теста через rerun.

Параметры
testFilePathOnDevice String

setTestPackageName 

public void setTestPackageName (String testPackageName)

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

Если не равно нулю, будут выполняться только тесты в пределах указанного пакета 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

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

исключитьНеВыполнено 

protected static  excludeNonExecuted (TestRunResult results)

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

Параметры
results TestRunResult

Возврат

получитьКлассИмя 

protected String getClassName ()

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

Возврат
String

getListInstrumentationParser 

protected ListInstrumentationParser getListInstrumentationParser ()

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

Возврат
ListInstrumentationParser

getMethodName 

protected String getMethodName ()

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

Возврат
String

получитьTestPackageName 

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