Начиная с 2026 года, в соответствии с нашей моделью стабильной разработки основной ветки и для обеспечения стабильности платформы для экосистемы, мы будем публиковать исходный код в AOSP во 2-м и 4-м кварталах. Для сборки и внесения вклада в AOSP мы рекомендуем использовать android-latest-release вместо aosp-main . Ветка манифеста android-latest-release всегда будет ссылаться на самый последний релиз, выпущенный в AOSP. Для получения дополнительной информации см. раздел «Изменения в AOSP» .

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

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

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

JarHostTest

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

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

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

Константы
`String`	`SET_OPTION_DESC`
`String`	`SET_OPTION_NAME`

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

Публичные методы
`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 ()` Удалить все отслеживаемые в данный момент фильтры включения.
`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)` Вспомогательный модуль для Device Runners, который можно использовать для установки параметров так же, как 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

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

SET_OPTION_NAME

public static final String SET_OPTION_NAME

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

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

HostTest

public HostTest ()

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

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

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

countTestCases

public int countTestCases ()

Верните количество тестовых случаев по всем классам части тестов.

Возврат
`int`

получитьАби

public IAbi getAbi ()

Возврат
`IAbi`

получитьИменаКласса

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`

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, 
                 keyValueOptions)

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

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

setTestInformation

public void setTestInformation (TestInformation testInfo)

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

расколоть

public  split (Integer shardCount, 
                TestInformation testInfo)

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

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

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

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

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Вспомогательный метод для создания экземпляра HostTest при шардинге. Переопределение для возврата любого дочернего элемента из HostTest.

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

Возврат
`HostTest`

получитьСборку

protected IBuildInfo getBuild ()

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

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

получитьClassLoader

protected ClassLoader getClassLoader ()

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

Возврат
`ClassLoader`

получитьклассы

protected final  getClasses ()

Возврат

получитьJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

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

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

Возврат
`File`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

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

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

Возврат
`boolean`

loadObject

protected Object loadObject (Class<?> classObj)

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

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

Возврат
`Object`

setClassName

protected void setClassName (String className)

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

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

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

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

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