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

ITestSuite

public abstract class ITestSuite
extends Object implements IRemoteTest , IDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest , ITestLoggerReceiver

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

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

Базетестсуите , TfSuiteRunner

BaseTestSuite	Тест для запуска Compatibility Test Suite с новой системой Suite.
TfSuiteRunner	Реализация `ITestSuite` , которая будет загружать тесты из папки TF jars res/config/suite/.

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

АтестРуннер , ТестмаппингСуитеРуннер

АтестРаннер	Внедрение `ITestSuite`
TestMappingSuiteRunner	Реализация `BaseTestSuite` для запуска тестов, указанных параметром include-filter, или файлов TEST_MAPPING из сборки в виде комплекта.

Абстрактный класс, используемый для запуска Test Suite. Этот класс обеспечивает основу для запуска Suite. Каждая реализация может определить список тестов с помощью метода loadTests() .

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

Поля
`public static final String`	`ABI_OPTION`
`public static final String`	`ACTIVE_MAINLINE_PARAMETER_KEY`
`public static final String`	`MAINLINE_PARAMETER_KEY`
`public static final String`	`MODULE_CHECKER_POST`
`public static final String`	`MODULE_CHECKER_PRE`
`public static final String`	`MODULE_METADATA_EXCLUDE_FILTER`
`public static final String`	`MODULE_METADATA_INCLUDE_FILTER`
`public static final String`	`PARAMETER_KEY`
`public static final String`	`PREPARER_WHITELIST`
`public static final String`	`PRIMARY_ABI_RUN`
`public static final String`	`RANDOM_SEED`
`public static final String`	`RUNNER_WHITELIST`
`public static final String`	`SKIP_HOST_ARCH_CHECK`
`public static final String`	`SKIP_SYSTEM_STATUS_CHECKER`
`public static final String`	`TOKEN_KEY`

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

Публичные методы
`void`	`addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)`
`void`	`addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)`
	`getAbis ( ITestDevice device)` Получает набор ABI, поддерживаемый как тестированием на совместимость `AbiUtils.getAbisSupportedByCompatibility()` так и тестируемым устройством.
`static`	`getAbisForBuildTargetArchFromSuite ()` Возвращает возможный абис из TestSuiteInfo.
`IBuildInfo`	`getBuildInfo ()` Для реализации `ITestSuite` может потребоваться информация о сборке для загрузки тестов.
`final IConfiguration`	`getConfiguration ()` Возвращает вызов `IConfiguration` .
`ITestLogger`	`getCurrentTestLogger ()`
`ITestDevice`	`getDevice ()` Получить тестируемое устройство.
`ModuleDefinition`	`getDirectModule ()` Возвращает `ModuleDefinition` для непосредственного выполнения или значение null, если его еще нет (если ITestSuite еще не был разделен).
`IInvocationContext`	`getInvocationContext ()` Возвращает контекст вызова.
`MultiMap <String, String>`	`getModuleMetadataIncludeFilters ()`
`final String`	`getRequestedAbi ()` Возвращает abi, запрошенный с опцией -a или --abi.
	`getRequiredTokens ( TestInformation testInfo)` Возвращает список необходимых токенов по тесту.
`long`	`getRuntimeHint ()` Возвращает ожидаемое время выполнения теста в миллисекундах.
`File`	`getTestsDir ()`
`boolean`	`isSplitting ()` Возвращает true, если мы в данный момент находимся в `IShardableTest.split(int)` .
`abstract`	`loadTests ()` Абстрактный метод для загрузки конфигурации тестов, которые будут запущены.
`void`	`reportNotExecuted ( ITestInvocationListener listener, String message)` Сообщите о невыполненных тестах предоставленному основному слушателю.
`void`	`reportNotExecuted ( ITestInvocationListener listener)` Сообщите о невыполненных тестах предоставленному основному слушателю.
`final void`	`run ( TestInformation testInfo, ITestInvocationListener listener)` Общий метод запуска для всех тестов, загруженных из `loadTests()` .
`void`	`setAbiName (String abiName)` Установите значение mAbiName
`final void`	`setAbis ( abis)` `setAbis ( abis)`
`void`	`setBuild ( IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly (boolean shouldCollectTest)` Запустите набор тестов только в режиме сборщика, для этого требуется, чтобы все подтесты также реализовывали этот интерфейс.
`void`	`setConfiguration ( IConfiguration configuration)` Внедряет используемую `IConfiguration` .
`void`	`setDevice ( ITestDevice device)` Введите тестируемое устройство.
`void`	`setDirectModule ( ModuleDefinition module)`
`void`	`setInvocationContext ( IInvocationContext invocationContext)`
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` Задает список объектов `IMetricCollector` , определенных для выполнения теста.
`void`	`setPrimaryAbiRun (boolean primaryAbiRun)` Установите значение mPrimaryAbiRun
`void`	`setShouldMakeDynamicModule (boolean dynamicModule)` При распределенном сегментировании мы не можем иметь ModuleDefinition, который разделяет тесты в пуле, иначе внутримодульное сегментирование не будет работать, поэтому мы разрешаем его отключить.
`void`	`setSystemStatusChecker ( systemCheckers)` `setSystemStatusChecker ( systemCheckers)` Задает `ISystemStatusChecker` из конфигурации для теста.
`void`	`setTestLogger ( ITestLogger testLogger)` Внедряет экземпляр `ITestLogger`
	`split (Integer shardCountHint, TestInformation testInfo)` Альтернативная версия `split(int)` , которая также предоставляет `TestInformation` , содержащую раннюю информацию от родителя, создающего осколки.

Защищенные методы
	`createModuleListeners ()` Возвращает список `ITestInvocationListener` , применимый к уровню `ModuleListener` .
`boolean`	`filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude)` Примените фильтр метаданных к конфигурации и посмотрите, должна ли конфигурация работать.
`boolean`	`filterByRunnerType ( IConfiguration config, allowedRunners)` `filterByRunnerType ( IConfiguration config, allowedRunners)` Примените фильтрацию белого списка бегунов, удалив все бегуны, не внесенные в белый список.
	`getAbisForBuildTargetArch ()` Вернуть abis, поддерживаемый целевой архитектурой сборки хоста.
	`getHostAbis ()` Возвращает abis хост-машины.
`void`	`setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)`
`boolean`	`shouldModuleRun ( ModuleDefinition module)`

Поля

ABI_OPTION

public static final String ABI_OPTION

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

PARAMETER_KEY

public static final String PARAMETER_KEY

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

СЛУЧАЙНОЕ ЗЕРНО

public static final String RANDOM_SEED

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TOKEN_KEY

public static final String TOKEN_KEY

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

ITestSuite

public ITestSuite ()

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

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

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

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

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

получитьAbis

public  getAbis (ITestDevice device)

Получает набор ABI, поддерживаемый как тестированием на совместимость AbiUtils.getAbisSupportedByCompatibility() так и тестируемым устройством.

Параметры
`device`	`ITestDevice`

Возвращает
	Набор ABI для запуска тестов.

Броски
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Возвращает возможный абис из TestSuiteInfo.

Возвращает

getBuildInfo

public IBuildInfo getBuildInfo ()

Для реализации ITestSuite может потребоваться информация о сборке для загрузки тестов.

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

получить конфигурацию

public final IConfiguration getConfiguration ()

Возвращает вызов IConfiguration .

Возвращает
`IConfiguration`

GetCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

Возвращает
`ITestLogger`

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

public ITestDevice getDevice ()

Получить тестируемое устройство.

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

getDirectModule

public ModuleDefinition getDirectModule ()

Возвращает ModuleDefinition для непосредственного выполнения или значение null, если его еще нет (если ITestSuite еще не был разделен).

Возвращает
`ModuleDefinition`

getInvocationContext

public IInvocationContext getInvocationContext ()

Возвращает контекст вызова.

Возвращает
`IInvocationContext`

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

Возвращает
`MultiMap <String, String>`

getRequestedAbi

public final String getRequestedAbi ()

Возвращает abi, запрошенный с опцией -a или --abi.

Возвращает
`String`

получитьрекуиредтокенс

public  getRequiredTokens (TestInformation testInfo)

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

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

Возвращает

getRuntimeHint

public long getRuntimeHint ()

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

Возвращает
`long`

getTestsDir

public File getTestsDir ()

Возвращает
`File`

Расщепление

public boolean isSplitting ()

Возвращает true, если мы в данный момент находимся в IShardableTest.split(int) .

Возвращает
`boolean`

loadTests

public abstract  loadTests ()

Абстрактный метод для загрузки конфигурации тестов, которые будут запущены. Каждый тест определяется IConfiguration и уникальным именем, под которым он будет сообщать о результатах.

Возвращает

отчет не выполнен

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Сообщите о невыполненных тестах предоставленному основному слушателю. О них следует сообщать как о неудачных с сообщением NOT_EXECUTED_FAILURE .

Параметры
`listener`	`ITestInvocationListener` : основной слушатель, куда сообщать о невыполненных результатах.
`message`	`String` : сообщение, которое должно быть связано с невыполненным сбоем.

отчет не выполнен

public void reportNotExecuted (ITestInvocationListener listener)

Параметры
`listener`	`ITestInvocationListener` : основной слушатель, куда сообщать о невыполненных результатах.

бегать

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Общий метод запуска для всех тестов, загруженных из loadTests() .

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

Броски
`DeviceNotAvailableException`

setAbiName

public void setAbiName (String abiName)

Установите значение mAbiName

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

setAbis

public final void setAbis ( abis)

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

setBuild

public void setBuild (IBuildInfo buildInfo)

Параметры
`buildInfo`	`IBuildInfo`

сетколлектестсонли

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

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

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

setDevice

public void setDevice (ITestDevice device)

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

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

setDirectModule

public void setDirectModule (ModuleDefinition module)

Параметры
`module`	`ModuleDefinition`

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Параметры
`invocationContext`	`IInvocationContext`

setMetricCollectors

public void setMetricCollectors ( collectors)

Задает список объектов IMetricCollector , определенных для выполнения теста.

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

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Установите значение mPrimaryAbiRun

Параметры
`primaryAbiRun`	`boolean`

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

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

Параметры
`dynamicModule`	`boolean`

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Задает ISystemStatusChecker из конфигурации для теста.

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

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Внедряет экземпляр ITestLogger

Параметры
`testLogger`	`ITestLogger`

расколоть

public  split (Integer shardCountHint, 
                TestInformation testInfo)

Альтернативная версия split(int) , которая также предоставляет TestInformation , содержащую раннюю информацию от родителя, создающего осколки. Это полезно, если во время сегментирования необходимо получить доступ к таким вещам, как информация об устройстве или сборке.

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

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

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

createModuleListeners

protected  createModuleListeners ()

Возвращает список ITestInvocationListener , применимый к уровню ModuleListener . Эти слушатели будут повторно использоваться для каждого модуля, они не будут создаваться повторно, поэтому они не должны принимать внутреннее состояние.

Возвращает

filterByConfigMetadata

protected boolean filterByConfigMetadata (IConfiguration config, 
                MultiMap<String, String> include, 
                MultiMap<String, String> exclude)

Примените фильтр метаданных к конфигурации и посмотрите, должна ли конфигурация работать.

Параметры
`config`	`IConfiguration` : `IConfiguration` оценивается.
`include`	`MultiMap` : метаданные включают фильтр
`exclude`	`MultiMap` : фильтр исключения метаданных

Возвращает
`boolean`	True, если модуль должен работать, иначе false.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Примените фильтрацию белого списка бегунов, удалив все бегуны, не внесенные в белый список. Если в конфигурации есть несколько бегунов, некоторые из них могут быть удалены, но конфигурация все равно будет работать.

Параметры
`config`	`IConfiguration` : `IConfiguration` оценивается.
`allowedRunners`	: Текущий белый список бегунов.

Возвращает
`boolean`	True, если запуск модуля конфигурации разрешен, в противном случае — false.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Вернуть abis, поддерживаемый целевой архитектурой сборки хоста. Выставлен на тестирование.

Возвращает

getHostAbis

protected  getHostAbis ()

Возвращает abis хост-машины.

Возвращает

setMultiDeviceStrategy

protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

Параметры
`strategy`	`ITestSuite.MultiDeviceModuleStrategy`

долженмодулрун

protected boolean shouldModuleRun (ModuleDefinition module)

Параметры
`module`	`ModuleDefinition`

Возвращает
`boolean`