HostTest

public class HostTest
extends Object implements IAbiReceiver , IBuildReceiver , IConfigurationReceiver , IDeviceTest , IDiscoverTestClasses, IRemoteTest , IRuntimeHintProvider , IShardableTest , ITestAnnotationFilterReceiver , ITestCollector , ITestFilterReceiver

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

Инструмент для запуска тестов JUnit на основе хост-приложения. Если запускаемый тест реализует IDeviceTest , этот инструмент передаст ссылку на устройство.

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

Константы

String SET_OPTION_DESC

String SET_OPTION_NAME

Государственные строители

HostTest ()

Общедоступные методы

void addAllExcludeAnnotation (Set<String> notAnnotations)

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

void addAllExcludeFilters (Set<String> filters)

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

void addAllIncludeAnnotation (Set<String> annotations)

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

void addAllIncludeFilters (Set<String> filters)

Добавляет 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 ()

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

int countTestCases ()

Возвращает количество тестовых случаев по всем классам, входящим в состав тестов.

IAbi getAbi ()

Set<String> getClassNames ()
ITestDevice getDevice ()

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

Set<String> getExcludeAnnotations ()

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

Set<String> getExcludeFilters ()

Возвращает текущий Set исключаемых фильтров.

Set<String> getIncludeAnnotations ()

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

Set<String> getIncludeFilters ()

Возвращает текущий Set включаемых фильтров.

long getRuntimeHint ()

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

void run ( TestInformation testInfo, ITestInvocationListener listener)

Выполняет тесты и сообщает результаты слушателю.

void setAbi ( IAbi abi)

void setBuild ( IBuildInfo buildInfo)

void setCollectTestsOnly (boolean shouldCollectTest)

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

void setConfiguration ( IConfiguration configuration)

Внедряет используемый объект IConfiguration .

void setDevice ( ITestDevice device)

Введите исследуемое устройство.

static void setOptionToLoadedObject (Object testObj, List<String> keyValueOptions)

Вспомогательная функция для Device Runners, позволяющая устанавливать параметры аналогично HostTest, используя команду set-option.

void setTestInformation ( TestInformation testInfo)
Collection< IRemoteTest > split (Integer shardCount, TestInformation testInfo)

Мы проводим разделение по отдельным участникам либо по классу тестирования, либо по методу.

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

HostTest createHostTest (Class<?> classObj)

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

IBuildInfo getBuild ()

Получите информацию о сборке, полученную HostTest.

ClassLoader getClassLoader ()

Возвращает загрузчик классов по умолчанию.

final List<Class<?>> getClasses ()
File getJarFile (String jarName, TestInformation testInfo)

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

boolean hasJUnit4Annotation (Class<?> classObj)

Вспомогательная функция для определения того, имеем ли мы дело с классом Test, содержащим аннотации JUnit4.

Object loadObject (Class<?> classObj)

Загрузите объект класса и задайте информацию о тестировании (устройство, сборка).

void setClassName (String className)

Очистите поле, затем укажите имя класса для выполнения.

void setMethodName (String methodName)

Укажите имя метода, который будет выполнен.

boolean shouldTestRun (AnnotatedElement annotatedElement)

Проверьте, проходит ли фильтр элемент, имеющий аннотацию.

Константы

SET_OPTION_DESC 

public static final String SET_OPTION_DESC

Постоянное значение: "Параметры, передаваемые проверяемому классу; ключ и значение должны быть разделены двоеточием ":"; например, если проверяемый класс поддерживает "--iteration 1" из командной строки, его следует передавать как "--set-option iteration:1" или "--set-option iteration:key=value" для передачи параметров в map. Значения, содержащие ":" или "=", можно экранировать обратной косой чертой. Конкретный класс можно указать, указав его." --set-option :

SET_OPTION_NAME 

public static final String SET_OPTION_NAME

Постоянное значение: "set-option"

Государственные строители

HostTest 

public HostTest ()

Общедоступные методы

addAllExcludeAnnotation 

public void addAllExcludeAnnotation (Set<String> notAnnotations)

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

Параметры
notAnnotations Set

addAllExcludeFilters 

public void addAllExcludeFilters (Set<String> filters)

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

Параметры
filters Set

addAllIncludeAnnotation 

public void addAllIncludeAnnotation (Set<String> annotations)

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

Параметры
annotations Set

addAllIncludeFilters 

public void addAllIncludeFilters (Set<String> filters)

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

Параметры
filters Set

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 ()

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

countTestCases 

public int countTestCases ()

Возвращает количество тестовых случаев по всем классам, входящим в состав тестов.

Возвраты
int

getAbi 

public IAbi getAbi ()

Возвраты
IAbi

getClassNames 

public Set<String> getClassNames ()

Возвраты
Set<String>

getDevice 

public ITestDevice getDevice ()

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

Возвраты
ITestDevice ITestDevice

getExcludeAnnotations 

public Set<String> getExcludeAnnotations ()

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

Возвраты
Set<String>

getExcludeFilters 

public Set<String> getExcludeFilters ()

Возвращает текущий Set исключаемых фильтров.

Возвраты
Set<String>

getIncludeAnnotations 

public Set<String> getIncludeAnnotations ()

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

Возвраты
Set<String>

getIncludeFilters 

public Set<String> getIncludeFilters ()

Возвращает текущий Set включаемых фильтров.

Возвраты
Set<String>

getRuntimeHint 

public long getRuntimeHint ()

Возвращает ожидаемое время выполнения теста в миллисекундах. Это время используется для балансировки нагрузки при сегментированном выполнении.

Возвраты
long

бегать 

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Выполняет тесты и сообщает результаты слушателю.

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

listener ITestInvocationListener : ITestInvocationListener для результатов тестирования.

Броски
DeviceNotAvailableException

setAbi 

public void setAbi (IAbi abi)

Параметры
abi IAbi

setBuild 

public void setBuild (IBuildInfo buildInfo)

Параметры
buildInfo IBuildInfo

setCollectTestsOnly 

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration 

public void setConfiguration (IConfiguration configuration)

Внедряет используемый объект IConfiguration .

Параметры
configuration IConfiguration

setDevice 

public void setDevice (ITestDevice device)

Введите исследуемое устройство.

Параметры
device ITestDevice : устройство ITestDevice для использования

setOptionToLoadedObject 

public static void setOptionToLoadedObject (Object testObj, 
                List<String> keyValueOptions)

Вспомогательная функция для Device Runners, позволяющая устанавливать параметры аналогично HostTest, используя команду set-option.

Параметры
testObj Object : объект, который будет получать параметры.

keyValueOptions List : список параметров, отформатированный в соответствии с требованиями команды HostTest set-option.

setTestInformation 

public void setTestInformation (TestInformation testInfo)

Параметры
testInfo TestInformation

расколоть 

public Collection<IRemoteTest> split (Integer shardCount, 
                TestInformation testInfo)

Мы проводим разделение по отдельным участникам либо по классу тестирования, либо по методу.

Параметры
shardCount Integer : количество попыток создания фрагментов.

testInfo TestInformation : Родительский объект TestInformation

Возвраты
Collection< IRemoteTest > набор подтестов, которые должны выполняться отдельно, или null если тест в данный момент не может быть разделен на сегменты.

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

createHostTest 

protected HostTest createHostTest (Class<?> classObj)

Вспомогательная функция для создания экземпляра HostTest при сегментировании. Можно переопределить, чтобы возвращать любой дочерний элемент из HostTest.

Параметры
classObj Class

Возвраты
HostTest

getBuild 

protected IBuildInfo getBuild ()

Получите информацию о сборке, полученную HostTest.

Возвраты
IBuildInfo IBuildInfo

getClassLoader 

protected ClassLoader getClassLoader ()

Возвращает загрузчик классов по умолчанию.

Возвраты
ClassLoader

getClasses 

protected final List<Class<?>> getClasses ()

Возвраты
List<Class<?>>

Броски
IllegalArgumentException

getJarFile 

protected File getJarFile (String jarName, 
                TestInformation testInfo)

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

Параметры
jarName String

testInfo TestInformation

Возвраты
File

Броски
FileNotFoundException

hasJUnit4Annotation 

protected boolean hasJUnit4Annotation (Class<?> classObj)

Вспомогательная функция для определения того, имеем ли мы дело с классом Test, содержащим аннотации JUnit4.

Параметры
classObj Class

Возвраты
boolean

загрузка объекта 

protected Object loadObject (Class<?> classObj)

Загрузите объект класса и задайте информацию о тестировании (устройство, сборка).

Параметры
classObj Class

Возвраты
Object

setClassName 

protected void setClassName (String className)

Очистите поле, затем укажите имя класса для выполнения.

Параметры
className String

setMethodName 

protected void setMethodName (String methodName)

Укажите имя метода, который будет выполнен.

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

Параметры
methodName String

shouldTestRun 

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

Проверяет, проходит ли элемент, имеющий аннотацию, фильтр. Доступно для модульного тестирования.

Возвраты
boolean Если тест не должен выполняться, установите значение false.