ITestSuite

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

java.lang.Object
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_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 REBOOT_BEFORE_TEST

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)
final void enableRebootBeforeTest ()

Устанавливает для reboot-before-test значение true.

getAbis (ITestDevice device)

Возвращает набор АБИС , которые поддерживают и тестирования совместимости AbiUtils.getAbisSupportedByCompatibility() и испытуемое устройство.

static getAbisForBuildTargetArchFromSuite ()

Возвращает возможное значение abis из TestSuiteInfo.

IBuildInfo getBuildInfo ()

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

final IConfiguration getConfiguration ()

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

ITestLogger getCurrentTestLogger ()
ITestDevice getDevice ()

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

ModuleDefinition getDirectModule ()

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

IInvocationContext getInvocationContext ()

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

final String getRequestedAbi ()

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

getRequiredTokens ()
long getRuntimeHint ()

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

File getTestsDir ()
boolean isSplitting ()

Возвращает истину , если мы в настоящее время в 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 setInvocationContext (IInvocationContext invocationContext)

void setInvocationInjector (Injector injector)

Получить текущую Guice Injector от вызова.

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)

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.

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

REBOOT_BEFORE_TEST

public static final String REBOOT_BEFORE_TEST

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

enableRebootBeforeTest

public final void enableRebootBeforeTest ()

Устанавливает для reboot-before-test значение true.

getAbis

public  getAbis (ITestDevice device)

Возвращает набор АБИС , которые поддерживают и тестирования совместимости AbiUtils.getAbisSupportedByCompatibility() и испытуемое устройство.

Параметры
device ITestDevice

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

Броски
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Возвращает возможное значение abis из TestSuiteInfo.

Возврат

getBuildInfo

public IBuildInfo getBuildInfo ()

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

Возврат
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

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

Возврат
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

Возврат
ITestLogger

getDevice

public ITestDevice getDevice ()

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

Возврат
ITestDevice ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

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

Возврат
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

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

Возврат
IInvocationContext

getRequestedAbi

public final String getRequestedAbi ()

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

Возврат
String

getRequiredTokens

public  getRequiredTokens ()

Возврат

getRuntimeHint

public long getRuntimeHint ()

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

Возврат
long

getTestsDir

public File getTestsDir ()

Возврат
File

isSplitting

public boolean isSplitting ()

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

Возврат
boolean

loadTests

public abstract  loadTests ()

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

Возврат

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

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

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

message String : сообщение , которое будет связанно с невыполненной неудачей.

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

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

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

запустить

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

Параметры
testInfo TestInformation

listener 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

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

Впрыскивает IConfiguration в использовании.

Параметры
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

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

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

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Параметры
invocationContext IInvocationContext

setInvocationInjector

public void setInvocationInjector (Injector injector)

Получить текущую Guice Injector от вызова. Это должно позволить нам продолжить внедрение модулей в объект.

Параметры
injector Injector

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)

Параметры
testLogger ITestLogger

расколоть

public  split (Integer shardCountHint, 
                TestInformation testInfo)

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

Параметры
shardCountHint Integer : попытка подсчета осколок.

testInfo TestInformation : Родитель TestInformation

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

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

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 Истина, если модуль должен работать, в противном случае - ложь.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

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

allowedRunners : Текущий белый список участников.

Возврат
boolean Истина, если модуль конфигурации разрешен для запуска, в противном случае - ложь.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

Возврат

getHostAbis

protected  getHostAbis ()

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

Возврат

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Параметры
module ModuleDefinition

Возврат
boolean