ITestSuite
public abstract class ITestSuite
extends Object
implements IBuildReceiver , IConfigurationReceiver , IDeviceTest , IInvocationContextReceiver , IMetricCollectorReceiver , IRemoteTest , IReportNotExecuted , IRuntimeHintProvider , IShardableTest , ISystemStatusCheckerReceiver , ITestCollector , ITestLoggerReceiver , ITokenRequest
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 | BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY |
public static final String | ENABLE_RESOLVE_SYM_LINKS |
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 | STAGE_MODULE_ARTIFACTS |
public static final String | TEST_TYPE_KEY |
public static final String | TEST_TYPE_VALUE_PERFORMANCE |
public static final String | TOKEN_KEY |
protected boolean | mEnableResolveSymlinks |
protected boolean | mRecoverDeviceByCvd
|
Общественные конструкторы | |
---|---|
ITestSuite () |
Публичные методы | |
---|---|
void | addModuleMetadataExcludeFilters ( MultiMap <String, String> filters) |
void | addModuleMetadataIncludeFilters ( MultiMap <String, String> filters) |
void | cleanUpSuiteSetup () Возможность очистить все, что было необходимо при установке пакетов, но не требуется для запуска тестов. |
boolean | filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) Примените фильтр метаданных к конфигурации и посмотрите, должна ли эта конфигурация работать. |
getAbis ( ITestDevice device) Получает набор ABI, поддерживаемых как тестированием совместимости | |
static | getAbisForBuildTargetArchFromSuite () Возвращает возможный abis из TestSuiteInfo. |
IBuildInfo | getBuildInfo () Реализация |
final IConfiguration | getConfiguration () Возвращает вызов |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () Получите устройство для тестирования. |
ModuleDefinition | getDirectModule () Возвращает |
boolean | getIntraModuleSharding () |
IInvocationContext | getInvocationContext () Возвращает контекст вызова. |
MultiMap <String, String> | getModuleMetadataIncludeFilters () |
ITestSuite.MultiDeviceModuleStrategy | getMultiDeviceStrategy () |
final String | getRequestedAbi () Возвращает abi, запрошенный с опцией -a или --abi. |
getRequiredTokens ( TestInformation testInfo) Возвращает список необходимых токенов по тесту. | |
long | getRuntimeHint () Возвращает ожидаемое время выполнения теста в миллисекундах. |
File | getTestsDir () |
boolean | isSplitting () Возвращает true, если мы в данный момент находимся в |
abstract | loadTests () Абстрактный метод для загрузки конфигурации тестов, которые будут запущены. |
void | reportNotExecuted ( ITestInvocationListener listener, String message) Сообщайте о невыполненных тестах основному прослушивателю. |
void | reportNotExecuted ( ITestInvocationListener listener) Сообщайте о невыполненных тестах основному прослушивателю. |
final void | run ( TestInformation testInfo, ITestInvocationListener listener) Общий метод запуска для всех тестов, загруженных из |
void | setAbiName (String abiName) Установите значение mAbiName |
final void | setAbis ( abis) setAbis ( abis) |
void | setBuild ( IBuildInfo buildInfo) |
void | setCollectTestsOnly (boolean shouldCollectTest) Запустите набор тестов в режиме только сборщика; для этого необходимо, чтобы все подтесты также реализовали этот интерфейс. |
void | setConfiguration ( IConfiguration configuration) Внедряет используемый |
void | setDevice ( ITestDevice device) Введите тестируемое устройство. |
void | setDirectModule ( ModuleDefinition module) |
void | setIntraModuleSharding (boolean intraModuleSharding) |
void | setInvocationContext ( IInvocationContext invocationContext) |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) Устанавливает список |
void | setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy) |
void | setPrimaryAbiRun (boolean primaryAbiRun) Установите значение mPrimaryAbiRun. |
void | setShouldMakeDynamicModule (boolean dynamicModule) При распределенном сегментировании мы не можем использовать ModuleDefinition, который разделяет тесты в пуле, иначе внутримодульное сегментирование не будет работать, поэтому мы разрешаем его отключить. |
void | setSkipContext ( SkipContext skipContext) |
void | setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) Устанавливает |
void | setTestLogger ( ITestLogger testLogger) Внедряет экземпляр |
split (Integer shardCountHint, TestInformation testInfo) Альтернативная версия |
Защищенные методы | |
---|---|
createModuleListeners () Возвращает список | |
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
BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY
public static final String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY
ENABLE_RESOLVE_SYM_LINKS
public static final String ENABLE_RESOLVE_SYM_LINKS
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
ПАРАМЕТР_КЛЮЧ
public static final String PARAMETER_KEY
PREPARER_WHITELIST
public static final String PREPARER_WHITELIST
PRIMARY_ABI_RUN
public static final String PRIMARY_ABI_RUN
RANDOM_SEED
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
STAGE_MODULE_ARTIFACTS
public static final String STAGE_MODULE_ARTIFACTS
TEST_TYPE_KEY
public static final String TEST_TYPE_KEY
TEST_TYPE_VALUE_PERFORMANCE
public static final String TEST_TYPE_VALUE_PERFORMANCE
ТОКЕН_КЛЮЧ
public static final String TOKEN_KEY
менаблерезольсимлинкс
protected boolean mEnableResolveSymlinks
mRecoverDeviceByCvd
protected boolean mRecoverDeviceByCvd
Общественные конструкторы
ITestSuite
public ITestSuite ()
Публичные методы
addModuleMetadataExcludeFilters
public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
Параметры | |
---|---|
filters | MultiMap |
addModuleMetadataIncludeFilters
public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
Параметры | |
---|---|
filters | MultiMap |
CleanUpSuiteSetup
public void cleanUpSuiteSetup ()
Возможность очистить все, что было необходимо при установке пакетов, но не требуется для запуска тестов.
filterByConfigMetadata
public boolean filterByConfigMetadata (IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)
Примените фильтр метаданных к конфигурации и посмотрите, должна ли эта конфигурация работать.
Параметры | |
---|---|
config | IConfiguration : оцениваемая IConfiguration . |
include | MultiMap : метаданные включают фильтр |
exclude | MultiMap : фильтр исключения метаданных |
Возврат | |
---|---|
boolean | True, если модуль должен работать, в противном случае — false. |
getAbis
publicgetAbis (ITestDevice device)
Получает набор ABI, поддерживаемых как тестированием совместимости AbiUtils.getAbisSupportedByCompatibility()
, так и тестируемым устройством.
Параметры | |
---|---|
device | ITestDevice |
Возврат | |
---|---|
Набор ABI для запуска тестов. |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
Возвращает возможный abis из TestSuiteInfo.
Возврат | |
---|---|
getBuildInfo
public IBuildInfo getBuildInfo ()
Реализация ITestSuite
может потребовать информацию о сборке для загрузки тестов.
Возврат | |
---|---|
IBuildInfo |
получить конфигурацию
public final IConfiguration getConfiguration ()
Возвращает вызов IConfiguration
.
Возврат | |
---|---|
IConfiguration |
получитьустройство
public ITestDevice getDevice ()
Получите устройство для тестирования.
Возврат | |
---|---|
ITestDevice | ITestDevice |
getDirectModule
public ModuleDefinition getDirectModule ()
Возвращает ModuleDefinition
для непосредственного выполнения или значение NULL, если его еще нет (если ITestSuite еще не сегментирован).
Возврат | |
---|---|
ModuleDefinition |
getIntraModuleSharding
public boolean getIntraModuleSharding ()
Возврат | |
---|---|
boolean |
getInvoctionContext
public IInvocationContext getInvocationContext ()
Возвращает контекст вызова.
Возврат | |
---|---|
IInvocationContext |
getModuleMetadataIncludeFilters
public MultiMap<String, String> getModuleMetadataIncludeFilters ()
Возврат | |
---|---|
MultiMap <String, String> |
getMultiDeviceStrategy
public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()
Возврат | |
---|---|
ITestSuite.MultiDeviceModuleStrategy |
getRequestedAbi
public final String getRequestedAbi ()
Возвращает abi, запрошенный с опцией -a или --abi.
Возврат | |
---|---|
String |
getRequiredTokens
publicgetRequiredTokens (TestInformation testInfo)
Возвращает список необходимых токенов по тесту. Возвращает ноль, если нет поддержки токенов.
Параметры | |
---|---|
testInfo | TestInformation |
Возврат | |
---|---|
getRuntimeHint
public long getRuntimeHint ()
Возвращает ожидаемое время выполнения теста в миллисекундах. Время используется для балансировки нагрузки при сегментированном выполнении.
Возврат | |
---|---|
long |
getTestsDir
public File getTestsDir ()
Возврат | |
---|---|
File |
isSplitting
public boolean isSplitting ()
Возвращает true, если мы в данный момент находимся в IShardableTest.split(int)
.
Возврат | |
---|---|
boolean |
Нагрузочные тесты
public abstractloadTests ()
Абстрактный метод для загрузки конфигурации тестов, которые будут выполняться. Каждый тест определяется IConfiguration
и уникальным именем, под которым будут сообщаться результаты.
Возврат | |
---|---|
отчетNotExecuted
public void reportNotExecuted (ITestInvocationListener listener, String message)
Сообщайте о невыполненных тестах основному прослушивателю. О них следует сообщать как о неудачных с помощью сообщения NOT_EXECUTED_FAILURE
.
Параметры | |
---|---|
listener | ITestInvocationListener : основной прослушиватель, куда сообщается о невыполненных результатах. |
message | String : сообщение, которое будет связано с невыполненной ошибкой. |
отчетNotExecuted
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 |
setCollectTestOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Запустите набор тестов в режиме только сборщика; для этого необходимо, чтобы все подтесты также реализовали этот интерфейс.
setConfiguration
public void setConfiguration (IConfiguration configuration)
Внедряет используемый IConfiguration
.
Параметры | |
---|---|
configuration | IConfiguration |
УстановитьУстройство
public void setDevice (ITestDevice device)
Введите тестируемое устройство.
Параметры | |
---|---|
device | ITestDevice : используемый ITestDevice |
setDirectModule
public void setDirectModule (ModuleDefinition module)
Параметры | |
---|---|
module | ModuleDefinition |
setIntraModuleSharding
public void setIntraModuleSharding (boolean intraModuleSharding)
Параметры | |
---|---|
intraModuleSharding | boolean |
setInvoctionContext
public void setInvocationContext (IInvocationContext invocationContext)
Параметры | |
---|---|
invocationContext | IInvocationContext |
setMetricCollectors
public void setMetricCollectors (collectors)
Устанавливает список IMetricCollector
, определенных для тестового запуска.
Параметры | |
---|---|
collectors |
setMultiDeviceStrategy
public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)
Параметры | |
---|---|
strategy | ITestSuite.MultiDeviceModuleStrategy |
setPrimaryAbiRun
public void setPrimaryAbiRun (boolean primaryAbiRun)
Установите значение mPrimaryAbiRun.
Параметры | |
---|---|
primaryAbiRun | boolean |
SetShouldMakeDynamicModule
public void setShouldMakeDynamicModule (boolean dynamicModule)
При распределенном сегментировании мы не можем использовать ModuleDefinition, который разделяет тесты в пуле, иначе внутримодульное сегментирование не будет работать, поэтому мы разрешаем его отключить.
Параметры | |
---|---|
dynamicModule | boolean |
setSkipContext
public void setSkipContext (SkipContext skipContext)
Параметры | |
---|---|
skipContext | SkipContext |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
Устанавливает ISystemStatusChecker
из конфигурации для теста.
Параметры | |
---|---|
systemCheckers |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Внедряет экземпляр ITestLogger
Параметры | |
---|---|
testLogger | ITestLogger |
расколоть
publicsplit (Integer shardCountHint, TestInformation testInfo)
Альтернативная версия split(int)
, которая также предоставляет TestInformation
, содержащую раннюю информацию от родителя, создавшего сегменты. Это полезно, если во время сегментирования требуется доступ к таким вещам, как информация об устройстве или сборке.
Параметры | |
---|---|
shardCountHint | Integer : количество попыток осколков. |
testInfo | TestInformation : родительская TestInformation |
Возврат | |
---|---|
набор подтестов, которые будут выполняться отдельно, или null если тест в данный момент не подлежит сегментированию |
Защищенные методы
createModuleListeners
protectedcreateModuleListeners ()
Возвращает список ITestInvocationListener
применимый к уровню ModuleListener
. Эти прослушиватели будут повторно использоваться для каждого модуля, они не будут повторно создаваться, поэтому им не следует принимать внутреннее состояние.
Возврат | |
---|---|
фильтрПоРуннерТип
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
Примените фильтрацию белого списка бегунов, удалив всех бегунов, не внесенных в белый список. Если в конфигурации имеется несколько исполнителей, некоторые из них могут быть удалены, но конфигурация все равно будет работать.
Параметры | |
---|---|
config | IConfiguration : оцениваемая IConfiguration . |
allowedRunners |
Возврат | |
---|---|
boolean | True, если запуск модуля конфигурации разрешен, в противном случае — false. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
Верните abis, поддерживаемый целевой архитектурой сборки хоста. Выставлено на тестирование.
Возврат | |
---|---|
getHostAbis
protectedgetHostAbis ()
Возвращает abis хост-машины.
Возврат | |
---|---|
долженМодулеРун
protected boolean shouldModuleRun (ModuleDefinition module)
Параметры | |
---|---|
module | ModuleDefinition |
Возврат | |
---|---|
boolean |