Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .

Эта страница переведена с помощью Cloud Translation API.

ХостТест

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

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

Известные прямые подклассы

JarHostTest

JarHostTest Средство запуска тестов JUnit на стороне хоста.

Средство запуска тестов для тестов на основе хоста JUnit. Если запускаемый тест реализует IDeviceTest этот бегун передаст ссылку на устройство.

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

Поля
`public static final String`	`SET_OPTION_DESC`
`public static final String`	`SET_OPTION_NAME`

Общественные конструкторы
`HostTest ()`

Публичные методы
`void`	`addAllExcludeAnnotation ( notAnnotations)` `addAllExcludeAnnotation ( notAnnotations)` Добавляет `ERROR(/Set)` аннотаций, чтобы исключить наличие тестов, помеченных ими.
`void`	`addAllExcludeFilters ( filters)` `addAllExcludeFilters ( filters)` Добавляет `ERROR(/Set)` фильтров, тесты которых нужно исключить.
`void`	`addAllIncludeAnnotation ( annotations)` `addAllIncludeAnnotation ( annotations)` Добавляет `ERROR(/Set)` аннотаций, которые включаются, если тесты отмечены ими.
`void`	`addAllIncludeFilters ( filters)` `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 ()` Удалите все отслеживаемые в данный момент фильтры включения.
`int`	`countTestCases ()` Возвращает количество тестовых случаев во всех классах, входящих в тесты.
`IAbi`	`getAbi ()`
	`getClassNames ()`
`ITestDevice`	`getDevice ()` Получите устройство для тестирования.
	`getExcludeAnnotations ()` Возвращает текущую `ERROR(/Set)` аннотаций, которые необходимо исключить.
	`getExcludeFilters ()` Возвращает текущую `ERROR(/Set)` фильтров исключения.
	`getIncludeAnnotations ()` Возвращает текущую `ERROR(/Set)` аннотаций, которые нужно включить.
	`getIncludeFilters ()` Возвращает текущую `ERROR(/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, keyValueOptions)` `setOptionToLoadedObject (Object testObj, keyValueOptions)` Помощник для запуска устройств, который можно использовать для установки параметров так же, как HostTest, из set-option.
`void`	`setTestInformation ( TestInformation testInfo)`
	`split (Integer shardCount, TestInformation testInfo)` Мы разделяем данные по отдельным тестовым классам или методам.

Защищенные методы
`HostTest`	`createHostTest (Class<?> classObj)` Помощник для создания экземпляра HostTest при сегментировании.
`IBuildInfo`	`getBuild ()` Получите информацию о сборке, полученную HostTest.
`ClassLoader`	`getClassLoader ()` Возвращает загрузчик классов по умолчанию.
`final`	`getClasses ()`
`File`	`getJarFile (String jarName, TestInformation testInfo)` Осмотрите несколько мест, где обычно находится артефакт для разных вариантов использования, чтобы найти нашу банку.
`boolean`	`hasJUnit4Annotation (Class<?> classObj)` Помощник, позволяющий определить, имеем ли мы дело с тестовым классом с аннотациями Junit4.
`Object`	`loadObject (Class<?> classObj)` загрузите объект класса и установите тестовую информацию (устройство, сборка).
`void`	`setClassName (String className)` Очистите, а затем задайте имя класса для запуска.
`boolean`	`shouldTestRun (AnnotatedElement annotatedElement)` Проверьте, проходят ли элементы с аннотацией фильтр.

Поля

SET_OPTION_DESC

public static final String SET_OPTION_DESC

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Общественные конструкторы

ХостТест

public HostTest ()

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

добавитьAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

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

Параметры
`notAnnotations`

добавитьаллексклудефилтерс

public void addAllExcludeFilters ( filters)

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

Параметры
`filters`

AddAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

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

Параметры
`annotations`

добавитьаллинклудефилтерс

public void addAllIncludeFilters ( filters)

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

Параметры
`filters`

добавитьExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

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

Параметры
`notAnnotation`	`String`

добавитьExcludeFilter

public void addExcludeFilter (String filter)

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

Параметры
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

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

Параметры
`annotation`	`String`

адиндклюдефилтер

public void addIncludeFilter (String filter)

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

Параметры
`filter`	`String`

ОчиститьИсключитьАннотации

public void clearExcludeAnnotations ()

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

ОчиститьExcludeFilters

public void clearExcludeFilters ()

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

ClearIncludeAnnotations

public void clearIncludeAnnotations ()

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

ClearIncludeFilters

public void clearIncludeFilters ()

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

количество тестовых случаев

public int countTestCases ()

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

Возврат
`int`

получитьАби

public IAbi getAbi ()

Возврат
`IAbi`

getClassNames

public  getClassNames ()

Возврат

получитьустройство

public ITestDevice getDevice ()

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

Возврат
`ITestDevice`	`ITestDevice`

getExcludeAnnotations

public  getExcludeAnnotations ()

Возвращает текущую ERROR(/Set) аннотаций, которые необходимо исключить.

Возврат

getExcludeFilters

public  getExcludeFilters ()

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

Возврат

getIncludeAnnotations

public  getIncludeAnnotations ()

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

Возврат

getIncludeFilters

public  getIncludeFilters ()

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

Возврат

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`

setCollectTestOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

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

Параметры
`configuration`	`IConfiguration`

УстановитьУстройство

public void setDevice (ITestDevice device)

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

Параметры
`device`	`ITestDevice` : используемый `ITestDevice` .

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

Помощник для запуска устройств, который можно использовать для установки параметров так же, как HostTest, из set-option.

Параметры
`testObj`	`Object` : объект, который получит параметры.
`keyValueOptions`	: список параметров, отформатированный в соответствии с требованиями параметра HostTest.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Параметры
`testInfo`	`TestInformation`

расколоть

public  split (Integer shardCount, 
                TestInformation testInfo)

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

Параметры
`shardCount`	`Integer` : количество попыток осколков.
`testInfo`	`TestInformation` : родительская `TestInformation`

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

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

создатьHostTest

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

Возврат

ПолучитьJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

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

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

Возврат
`File`

имеетJUnit4Аннотация

protected boolean hasJUnit4Annotation (Class<?> classObj)

Помощник, позволяющий определить, имеем ли мы дело с тестовым классом с аннотациями Junit4.

Параметры
`classObj`	`Class`

Возврат
`boolean`

ЗагрузитьОбъект

protected Object loadObject (Class<?> classObj)

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

Параметры
`classObj`	`Class`

Возврат
`Object`

setClassName

protected void setClassName (String className)

Очистите, а затем задайте имя класса для запуска.

Параметры
`className`	`String`

долженTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

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

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