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

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

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

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

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, которое будет использоваться.

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)

Устанавливает опцию форс-аби.

void setInstallFile (File installFile)

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

void setIsolatedStorage (boolean isolatedStorage)

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

void setMethodName (String testMethodName)

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

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

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

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

мОтладка

protected boolean mDebug

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

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

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

getCoverageTarget

public String getCoverageTarget ()

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

Возвращает
String

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

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

бегать

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

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

Броски
DeviceNotAvailableException

сетАби

public void setAbi (IAbi abi)

Параметры
abi IAbi

setClassName

public void setClassName (String testClassName)

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

Параметры
testClassName String

сетколлектестсонли

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)

Устанавливает опцию форс-аби.

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

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)

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

Если он не нулевой, будут выполняться только тесты в данном пакете 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

Возвращает

getClassName

protected String getClassName ()

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

Возвращает
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

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

Возвращает
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