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

Абстрактный класс, используемый для запуска 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_END_TIME

public static final String MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_START_TIME

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_STAGING_ARTIFACTS

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)
boolean filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude)

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

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 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_END_TIME

public static final String MODULE_END_TIME

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

MODULE_START_TIME

public static final String MODULE_START_TIME

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_STAGING_ARTIFACTS

public static final String SKIP_STAGING_ARTIFACTS

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

filterByConfigMetadata

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

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

Параметры
config IConfiguration : IConfiguration оценивается.

include MultiMap : метаданные включают фильтр

exclude MultiMap : фильтр исключения метаданных

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

получить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)

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

Параметры
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 . Эти слушатели будут повторно использоваться для каждого модуля, они не будут создаваться повторно, поэтому они не должны принимать внутреннее состояние.

Возвращает

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