ИзолированныйHostTest

public class IsolatedHostTest
extends Object implements IBuildReceiver , IConfigurationReceiver , IRemoteTest , IShardableTest , ITestAnnotationFilterReceiver , ITestCollector , ITestFilterReceiver

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

---

Реализует исполнитель TradeFed, который использует подпроцесс для выполнения тестов в среде с низким уровнем зависимости вместо их выполнения в основном процессе.

Этот исполнитель предполагает, что все настроенные jar-файлы находятся в одном тестовом каталоге, и запускает подпроцесс в этом каталоге. Поскольку он должен выбрать рабочий каталог для подпроцесса, а многим тестам выгодно, чтобы этот каталог был тестовым, это был наилучший из возможных компромиссов.

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

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

Публичные методы
void	addAllExcludeAnnotation ( notAnnotations) Добавляет ERROR(/Set) аннотаций для исключения, если тесты помечены ею.
void	addAllExcludeFilters ( filters) Добавляет ERROR(/Set) фильтров, тесты которых следует исключить.
void	addAllIncludeAnnotation ( annotations) Добавляет ERROR(/Set) аннотаций для включения, если тесты помечены ею.
void	addAllIncludeFilters ( filters) Добавляет ERROR(/Set) фильтров, тесты которых следует включить.
void	addExcludeAnnotation (String notAnnotation) Добавляет аннотацию для исключения, если тест ею помечен.
void	addExcludeFilter (String filter) Добавляет фильтр, по которому можно исключить тесты.
void	addIncludeAnnotation (String annotation) Добавляет аннотацию, которая будет включена, если тест отмечен ею.
void	addIncludeFilter (String filter) Добавляет фильтр по тестам, которые следует включить.
void	clearExcludeAnnotations () Удалить все отслеживаемые в данный момент аннотации исключения.
void	clearExcludeFilters () Удалить все отслеживаемые в данный момент фильтры исключения.
void	clearIncludeAnnotations () Удалить все включенные аннотации, отслеживаемые в данный момент.
void	clearIncludeFilters () Удалить все отслеживаемые в данный момент фильтры включения.
String	compileClassPath () Создает classpath для подпроцесса, который включает необходимые jar-файлы для запуска тестов.
	compileCommandArgs (String classpath, File artifactsDir) Собирает аргументы команды для выполнения исполнителя подпроцесса.
void	deleteTempFiles ()
File	getCoverageExecFile ()
	getExcludeAnnotations () Возвращает текущую ERROR(/Set) аннотаций для исключения.
	getExcludeFilters () Возвращает текущую ERROR(/Set) исключающих фильтров.
	getIncludeAnnotations () Возвращает текущую ERROR(/Set) аннотаций для включения.
	getIncludeFilters () Возвращает текущую ERROR(/Set) включенных фильтров.
void	run ( TestInformation testInfo, ITestInvocationListener listener) Запускает тесты и сообщает результаты слушателю.
void	setBuild ( IBuildInfo build)
void	setCollectTestsOnly (boolean shouldCollectTest) Включает или выключает режим сбора тестов
void	setConfiguration ( IConfiguration configuration) Внедряет используемую IConfiguration .
void	setDebug (boolean debug)
	split (int shardCount) Альтернативная версия split() , которая также предоставляет shardCount, который пытается запуститься.
void	uploadTestArtifacts (File logDir, ITestInvocationListener listener)
boolean	useRavenwoodResources ()
boolean	useRobolectricResources ()

Защищенные методы
String	compileLdLibraryPathInner (String androidHostOut) Мы вызываем эту версию из модульного теста и напрямую передаем ANDROID_HOST_OUT.
File	getJarFile (String jarName, TestInformation testInfo) Скопировано из HostTest для имитации использования его модульного тестирования.
void	setServer (ServerSocket server)

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

ИзолированныйHostTest

public IsolatedHostTest ()

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

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Добавляет ERROR(/Set) аннотаций для исключения, если тесты помечены ею.

Параметры
notAnnotations

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Добавляет ERROR(/Set) фильтров, тесты которых следует исключить.

Параметры
filters

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Добавляет ERROR(/Set) аннотаций для включения, если тесты помечены ею.

Параметры
annotations

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Добавляет ERROR(/Set) фильтров, тесты которых следует включить.

Параметры
filters

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

Добавляет аннотацию для исключения, если тест ею помечен.

Параметры
notAnnotation	String

addExcludeFilter

public void addExcludeFilter (String filter)

Добавляет фильтр, по которому можно исключить тесты.

Параметры
filter	String

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Добавляет аннотацию, которая будет включена, если тест отмечен ею.

Параметры
annotation	String

addIncludeFilter

public void addIncludeFilter (String filter)

Добавляет фильтр по тестам, которые следует включить.

Параметры
filter	String

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Удалить все отслеживаемые в данный момент аннотации исключения.

clearExcludeFilters

public void clearExcludeFilters ()

Удалить все отслеживаемые в данный момент фильтры исключения.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Удалить все включенные аннотации, отслеживаемые в данный момент.

clearIncludeFilters

public void clearIncludeFilters ()

Удалить все отслеживаемые в данный момент фильтры включения.

compileClassPath

public String compileClassPath ()

Создает classpath для подпроцесса, который включает необходимые jar-файлы для запуска тестов.

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

compileCommandArgs

public  compileCommandArgs (String classpath, 
                File artifactsDir)

Собирает аргументы команды для выполнения исполнителя подпроцесса.

Параметры
classpath	String
artifactsDir	File

Возврат

удалитьTempFiles

public void deleteTempFiles ()

getCoverageExecFile

public File getCoverageExecFile ()

Возврат
File

getExcludeAnnotations

public  getExcludeAnnotations ()

Возвращает текущую ERROR(/Set) аннотаций для исключения.

Возврат

getExcludeFilters

public  getExcludeFilters ()

Возвращает текущую ERROR(/Set) исключающих фильтров.

Возврат

getIncludeAnnotations

public  getIncludeAnnotations ()

Возвращает текущую ERROR(/Set) аннотаций для включения.

Возврат

getIncludeFilters

public  getIncludeFilters ()

Возвращает текущую ERROR(/Set) включенных фильтров.

Возврат

бегать

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

Броски
DeviceNotAvailableException

setBuild

public void setBuild (IBuildInfo build)

Параметры
build	IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Включает или выключает режим сбора тестов

setConfiguration

public void setConfiguration (IConfiguration configuration)

Внедряет используемую IConfiguration .

Параметры
configuration	IConfiguration

setDebug

public void setDebug (boolean debug)

Параметры
debug	boolean

расколоть

public  split (int shardCount)

Альтернативная версия split() , которая также возвращает shardCount, который был предпринят для выполнения. Это полезно для некоторых тестировщиков, которые иногда не могут принимать произвольные решения.

Параметры
shardCount	int : количество попыток осколков.

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

uploadTestArtifacts

public void uploadTestArtifacts (File logDir, 
                ITestInvocationListener listener)

Параметры
logDir	File
listener	ITestInvocationListener

использованиеRavenwoodResources

public boolean useRavenwoodResources ()

Возврат
boolean

useRobolectricResources

public boolean useRobolectricResources ()

Возврат
boolean

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

compileLdLibraryPathInner

protected String compileLdLibraryPathInner (String androidHostOut)

Мы вызываем эту версию из модульного теста и напрямую передаём ANDROID_HOST_OUT. Это необходимо, поскольку в Java нет API для установки переменных окружения.

Параметры
androidHostOut	String

Возврат
String

получитьJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Скопировано из HostTest для имитации использования его модульного тестирования.

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

Параметры
jarName	String
testInfo	TestInformation

Возврат
File

setServer

protected void setServer (ServerSocket server)

Параметры
server	ServerSocket