ИнструментарийТест
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 () Получает |
String | getCoverageTarget () Получите значение CoverageTarget, ранее установленное с помощью |
boolean | getDebug () Получите настройки отладки инструментария. |
ITestDevice | getDevice () Получите устройство для тестирования. |
String | getForceAbi () |
long | getMaxTimeout () Возвращает максимальный тайм-аут, установленный для инструментария. |
String | getPackageName () Запустите пакет манифеста Android. |
String | getRunName () Получите имя пользовательского запуска теста, которое будет предоставлено прослушивателю. |
String | getRunnerName () Получает средство запуска инструментов Android, которое будет использоваться. |
boolean | isOrchestrator () Возвращает значение |
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) Внедряет используемый |
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) Устанавливает список |
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 () Получите |
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 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 |
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 : логическое значение для установки параметра отладки инструментария. |
УстановитьУстройство
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)
Устанавливает фильтр тестовых пакетов.
Если значение не равно нулю, будут выполняться только тесты внутри данного 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 staticexcludeNonExecuted (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 |