Определение модуля

public class ModuleDefinition
extends Object implements Comparable< ModuleDefinition >, ITestCollector

java.lang.Object
↳ com.android.tradefed.testtype.suite.ModuleDefinition

Контейнер для конфигурации запуска тестов. Этот класс является вспомогательным инструментом для подготовки и запуска тестов.

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

Константы

String ISOLATION_COST

String MODULE_ABI

String MODULE_CACHED

Это свойство устанавливается в значение true, если результаты тестового модуля были кэшированы.

String MODULE_CONTROLLER

String MODULE_EXTERNAL_DEPENDENCIES

String MODULE_ID

Идентификатор модуля — имя, которое будет использоваться для однозначной идентификации модуля во время выполнения команды testRunStart.

String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

String MODULE_ISOLATED

Это свойство устанавливается в значение true, если модуль работал на только что подготовленном устройстве.

String MODULE_NAME

Имя модуля — это базовое имя, связанное с модулем, обычно берущееся из XML-файла конфигурации TF, из которого был загружен модуль.

String MODULE_PARAMETERIZATION

String MODULE_SKIPPED

Это свойство устанавливается в значение true, если тестовый модуль был пропущен.

String MODULE_TEST_COUNT

String PREPARATION_TIME

String RETRY_FAIL_COUNT

String RETRY_SUCCESS_COUNT

String RETRY_TIME

String SPARSE_MODULE

Это свойство устанавливается в значение true, если сообщается только о событиях на уровне модуля.

String TEAR_DOWN_TIME

String TEST_TIME

Государственные строители

ModuleDefinition ()
ModuleDefinition (String name, Collection< IRemoteTest > tests, Map<String, List< ITargetPreparer >> preparersPerDevice, List< IMultiTargetPreparer > multiPreparers, IConfiguration moduleConfig)

Конструктор

ModuleDefinition (String name, Collection< IRemoteTest > tests, Map<String, List< ITargetPreparer >> preparersPerDevice, Map<String, List< ITargetPreparer >> suitePreparersPerDevice, List< IMultiTargetPreparer > multiPreparers, IConfiguration moduleConfig)

Конструктор

Общедоступные методы

int compareTo ( ModuleDefinition moduleDef)

Set<Digest> getFilterDigests ()

Возвращает дайджесты фильтров, связанных с тестами.

String getId ()

Возвращает уникальное имя модуля.

Integer getIntraModuleShardCount ()
Integer getIntraModuleShardIndex ()
IConfiguration getModuleConfiguration ()
IInvocationContext getModuleInvocationContext ()

Возвращает объект IInvocationContext связанный с модулем.

TestInformation getModuleTestInformation ()
Set< TokenProperty > getRequiredTokens ( TestInformation testInfo)
long getRuntimeHint ()

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

boolean hasModuleFailed ()

Возвращает True, если для модуля был вызван метод testRunFailure.

int neededDevices ()

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

int numTests ()

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

final void reportNotExecuted ( ITestInvocationListener listener, String message)

Сообщается, что все модули полностью не выполнены.

final void run ( TestInformation moduleInfo, ITestInvocationListener listener, int maxRunLimit)

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

final void run ( TestInformation moduleInfo, ITestInvocationListener listener)

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

Throwable runPreparation (boolean includeSuitePreparers)

Запустить средства подготовки тестов, включая средства подготовки на уровне набора тестов, если таковые указаны.

void setBuild ( IBuildInfo build)

Внедрите объект IBuildInfo , который будет использоваться во время тестирования.

void setCollectKernelLog (boolean collectKernelLog)
void setCollectTestsOnly (boolean collectTestsOnly)

Включает или отключает режим сбора тестовых данных.

void setDefaultLogCollectors (List< IMetricCollector > collectors)
void setDevice ( ITestDevice device)

Внедрите ITestDevice , который будет использоваться во время тестирования.

void setEnableDynamicDownload (boolean enableDynamicDownload)

Включать ли динамическую загрузку на уровне модуля.

void setIntraModuleInformation (int shardCount, int shardIndex)
void setLogSaver ( ILogSaver logSaver)

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

final void setMergeAttemps (boolean mergeAttempts)

Определяет, следует ли объединять результаты.

void setMetricCollectors (List< IMetricCollector > collectors)

Внедрите список объектов IMetricCollector , которые будут использоваться модулем.

void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Необходимо восстановить виртуальное устройство.

void setRemoveModuleBuffering (boolean removeModuleBuffering)
void setReportModuleEnd (boolean shouldReportModuleEnd)
void setReportModuleStart (boolean shouldReportModuleStart)
final void setRetryDecision ( IRetryDecision decision)

Задает параметр IRetryDecision , используемый для повторной попытки внутри модуля.

void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)
boolean shouldRecoverVirtualDevice ()

Возвращает значение, указывающее, следует ли восстанавливать виртуальное устройство.

String toString ()

void transferSuiteLevelOptions ( IConfiguration mSuiteConfiguration)

Скопируйте несколько параметров конфигурации на уровне пакета.

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

boolean hasTests ()

Возвращает True, если в пуле модулей еще есть IRemoteTest , который необходимо запустить.

Константы

СТОИМОСТЬ ИЗОЛЯЦИИ 

public static final String ISOLATION_COST

Постоянная величина: "ISOLATION_COST"

MODULE_ABI 

public static final String MODULE_ABI

Постоянное значение: "module-abi"

MODULE_CACHED 

public static final String MODULE_CACHED

Это свойство устанавливается в значение true, если результаты тестового модуля были кэшированы.

Постоянное значение: "кэшированный модуль"

MODULE_CONTROLLER 

public static final String MODULE_CONTROLLER

Постоянное значение: "module_controller"

MODULE_EXTERNAL_DEPENDENCIES 

public static final String MODULE_EXTERNAL_DEPENDENCIES

Постоянное значение: "module-external-dependencies"

MODULE_ID 

public static final String MODULE_ID

Идентификатор модуля — это имя, которое будет использоваться для однозначной идентификации модуля во время выполнения testRunStart. Обычно это комбинация MODULE_ABI + MODULE_NAME.

Постоянное значение: "module-id"

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY 

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

Постоянное значение: "module-flag-overrides"

MODULE_ISOLATED 

public static final String MODULE_ISOLATED

Это свойство устанавливается в значение true, если модуль работал на только что подготовленном устройстве.

Постоянное значение: "изолированный модуль"

НАЗВАНИЕ_МОДУЛЯ 

public static final String MODULE_NAME

Имя модуля — это базовое имя, связанное с модулем, обычно берущееся из XML-файла конфигурации TF, из которого был загружен модуль.

Постоянное значение: "имя модуля"

ПАРАМЕТРИЗАЦИЯ МОДУЛЯ 

public static final String MODULE_PARAMETERIZATION

Постоянное значение: "параметр модуля"

MODULE_SKIPPED 

public static final String MODULE_SKIPPED

Это свойство устанавливается в значение true, если тестовый модуль был пропущен.

Постоянное значение: "модуль пропущен"

MODULE_TEST_COUNT 

public static final String MODULE_TEST_COUNT

Постоянное значение: "MODULE_TEST_COUNT"

ВРЕМЯ_ПОДГОТОВКИ 

public static final String PREPARATION_TIME

Постоянное значение: "PREP_TIME"

КОЛИЧЕСТВО НЕУДАЧНЫХ ПОПЫТОК ПОВТОРНОЙ ПОПЫТКИ 

public static final String RETRY_FAIL_COUNT

Постоянное значение: "MODULE_RETRY_FAILED"

КОЛИЧЕСТВО УСПЕШНЫХ ПОПЫТОК ПОВТОРИТЬ 

public static final String RETRY_SUCCESS_COUNT

Постоянное значение: "MODULE_RETRY_SUCCESS"

RETRY_TIME 

public static final String RETRY_TIME

Постоянное значение: "MODULE_RETRY_TIME"

SPARSE_MODULE 

public static final String SPARSE_MODULE

Это свойство устанавливается в значение true, если сообщается только о событиях на уровне модуля.

Постоянное значение: "разреженный модуль"

ВРЕМЯ_РАЗБОРКИ 

public static final String TEAR_DOWN_TIME

Постоянное значение: "TEARDOWN_TIME"

TEST_TIME 

public static final String TEST_TIME

Постоянное значение: "TEST_TIME"

Государственные строители

Определение модуля 

public ModuleDefinition ()

Определение модуля 

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

Конструктор

Параметры
name String : уникальное имя конфигурации теста.

tests Collection : список IRemoteTest , которые необходимо запустить.

preparersPerDevice Map : список объектов ITargetPreparer , которые будут использоваться для настройки устройства.

multiPreparers List

moduleConfig IConfiguration : IConfiguration конфигурации базового модуля.

Определение модуля 

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                Map<String, List<ITargetPreparer>> suitePreparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

Конструктор

Параметры
name String : уникальное имя конфигурации теста.

tests Collection : список IRemoteTest , которые необходимо запустить.

preparersPerDevice Map : список объектов ITargetPreparer , которые будут использоваться для настройки устройства.

suitePreparersPerDevice Map

multiPreparers List

moduleConfig IConfiguration : IConfiguration конфигурации базового модуля.

Общедоступные методы

compareTo 

public int compareTo (ModuleDefinition moduleDef)

Параметры
moduleDef ModuleDefinition

Возвраты
int

getFilterDigests 

public Set<Digest> getFilterDigests ()

Возвращает дайджесты фильтров, связанных с тестами.

Возвраты
Set<Digest>

Броски
IOException

получить ID 

public String getId ()

Возвращает уникальное имя модуля.

Возвраты
String

getIntraModuleShardCount 

public Integer getIntraModuleShardCount ()

Возвраты
Integer

getIntraModuleShardIndex 

public Integer getIntraModuleShardIndex ()

Возвраты
Integer

getModuleConfiguration 

public IConfiguration getModuleConfiguration ()

Возвраты
IConfiguration

getModuleInvocationContext 

public IInvocationContext getModuleInvocationContext ()

Возвращает объект IInvocationContext связанный с модулем.

Возвраты
IInvocationContext

получить информацию о модуле тестирования 

public TestInformation getModuleTestInformation ()

Возвраты
TestInformation

getRequiredTokens 

public Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

Параметры
testInfo TestInformation

Возвраты
Set< TokenProperty >

getRuntimeHint 

public long getRuntimeHint ()

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

Возвраты
long

hasModuleFailed 

public boolean hasModuleFailed ()

Возвращает True, если для модуля был вызван метод testRunFailure.

Возвраты
boolean

необходимые устройства 

public int neededDevices ()

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

Возвраты
int

numTests 

public int numTests ()

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

Возвраты
int

reportNotExecuted 

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Сообщается, что все модули полностью не выполнены.

Параметры
listener ITestInvocationListener

message String

бегать 

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                int maxRunLimit)

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

Параметры
moduleInfo TestInformation : информация TestInformation для данного модуля.

listener ITestInvocationListener : объект ITestInvocationListener куда следует сообщать о результатах.

maxRunLimit int : максимальное количество запусков для каждого тестового случая.

Броски
DeviceNotAvailableException в случае отключения устройства от сети.

бегать 

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

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

Параметры
moduleInfo TestInformation

listener ITestInvocationListener : объект ITestInvocationListener куда следует сообщать о результатах.

Броски
DeviceNotAvailableException в случае отключения устройства от сети.

подготовка к запуску 

public Throwable runPreparation (boolean includeSuitePreparers)

Запустить средства подготовки тестов, включая средства подготовки на уровне набора тестов, если таковые указаны.

Параметры
includeSuitePreparers boolean : Установите значение true , чтобы также запускать средства подготовки на уровне пакета документов.

Возвраты
Throwable Throwable исключение, возникающее при выполнении подготовительных процессов.

setBuild 

public void setBuild (IBuildInfo build)

Внедрите объект IBuildInfo , который будет использоваться во время тестирования.

Параметры
build IBuildInfo

setCollectKernelLog 

public void setCollectKernelLog (boolean collectKernelLog)

Параметры
collectKernelLog boolean

setCollectTestsOnly 

public void setCollectTestsOnly (boolean collectTestsOnly)

Включает или отключает режим сбора тестовых данных.

setDefaultLogCollectors 

public void setDefaultLogCollectors (List<IMetricCollector> collectors)

Параметры
collectors List

setDevice 

public void setDevice (ITestDevice device)

Внедрите ITestDevice , который будет использоваться во время тестирования.

Параметры
device ITestDevice

setEnableDynamicDownload 

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Включать ли динамическую загрузку на уровне модуля.

Параметры
enableDynamicDownload boolean

setIntraModuleInformation 

public void setIntraModuleInformation (int shardCount, 
                int shardIndex)

Параметры
shardCount int

shardIndex int

setLogSaver 

public void setLogSaver (ILogSaver logSaver)

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

Параметры
logSaver ILogSaver

setMergeAttempts 

public final void setMergeAttemps (boolean mergeAttempts)

Определяет, следует ли объединять результаты.

Параметры
mergeAttempts boolean

setMetricCollectors 

public void setMetricCollectors (List<IMetricCollector> collectors)

Внедрите список объектов IMetricCollector , которые будут использоваться модулем.

Параметры
collectors List

setRecoverVirtualDevice 

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Необходимо восстановить виртуальное устройство.

Параметры
recoverVirtualDevice boolean

setRemoveModuleBuffering 

public void setRemoveModuleBuffering (boolean removeModuleBuffering)

Параметры
removeModuleBuffering boolean

setReportModuleEnd 

public void setReportModuleEnd (boolean shouldReportModuleEnd)

Параметры
shouldReportModuleEnd boolean

setReportModuleStart 

public void setReportModuleStart (boolean shouldReportModuleStart)

Параметры
shouldReportModuleStart boolean

setRetryDecision 

public final void setRetryDecision (IRetryDecision decision)

Задает параметр IRetryDecision , используемый для повторной попытки внутри модуля.

Параметры
decision IRetryDecision

setUseModuleResultsForwarder 

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Параметры
useModuleResultsForwarder boolean

shouldRecoverVirtualDevice 

public boolean shouldRecoverVirtualDevice ()

Возвращает значение, указывающее, следует ли восстанавливать виртуальное устройство.

Возвраты
boolean

toString 

public String toString ()

Возвраты
String

transferSuiteLevelOptions 

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Скопируйте несколько параметров конфигурации на уровне пакета.

Параметры
mSuiteConfiguration IConfiguration

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

hasTests 

protected boolean hasTests ()

Возвращает True, если в пуле модуля еще есть IRemoteTest для выполнения. В противном случае — False.

Возвраты
boolean