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

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

java.lang.Объект
↳	com.android.tradefed.testtype.InstrumentationTest

Известные прямые подклассы AndroidJUnitTest , CodeCoverageTest AndroidJUnitTest Тест, запускающий тестовый пакет инструментирования на заданном устройстве с помощью android.support.test.runner.AndroidJUnitRunner. CodeCoverageTest Тест, который запускает тестовый пакет инструментовки на заданном устройстве и создает отчет о покрытии кода.

---

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

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

Поля
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