ModuleDefinition

public class ModuleDefinition
extends Object implements 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, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)

Конструктор

ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)

Конструктор

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

int compareTo ( ModuleDefinition moduleDef)

String getId ()

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

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

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

TestInformation getModuleTestInformation ()
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 setCollectTestsOnly (boolean collectTestsOnly)

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

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 ( 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)

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

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

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-cached»

МОДУЛЬ_КОНТРОЛЛЕР 

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»

МОДУЛЬ_ИЗОЛИРОВАННЫЙ 

public static final String MODULE_ISOLATED

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

Постоянное значение: «модульно-изолированное»

MODULE_NAME 

public static final String MODULE_NAME

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

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

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

public static final String MODULE_PARAMETERIZATION

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

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»

RETRY_FAIL_COUNT 

public static final String RETRY_FAIL_COUNT

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

RETRY_SUCCESS_COUNT 

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, если сообщаются только события на уровне модуля.

Постоянное значение: «sparse-module»

TEAR_DOWN_TIME 

public static final String TEAR_DOWN_TIME

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

ТЕСТОВОЕ_ВРЕМЯ 

public static final String TEST_TIME

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

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

ModuleDefinition 

public ModuleDefinition ()

ModuleDefinition 

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

Конструктор

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

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

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

multiPreparers

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

ModuleDefinition 

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 suitePreparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

Конструктор

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

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

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

suitePreparersPerDevice

multiPreparers

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

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

сравнитьС 

public int compareTo (ModuleDefinition moduleDef)

Параметры
moduleDef ModuleDefinition

Возврат
int

получитьId 

public String getId ()

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

Возврат
String

получитьIntraModuleShardCount 

public Integer getIntraModuleShardCount ()

Возврат
Integer

получитьIntraModuleShardIndex 

public Integer getIntraModuleShardIndex ()

Возврат
Integer

получитьМодульКонфигурация 

public IConfiguration getModuleConfiguration ()

Возврат
IConfiguration

getModuleInvocationContext 

public IInvocationContext getModuleInvocationContext ()

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

Возврат
IInvocationContext

получитьModuleTestInformation 

public TestInformation getModuleTestInformation ()

Возврат
TestInformation

получитьRequiredTokens 

public  getRequiredTokens (TestInformation testInfo)

Параметры
testInfo TestInformation

Возврат

getRuntimeHint 

public long getRuntimeHint ()

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

Возврат
long

hasModuleFailed 

public boolean hasModuleFailed ()

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

Возврат
boolean

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

public int neededDevices ()

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

Возврат
int

numTests 

public int numTests ()

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

Возврат
int

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

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 в случае отключения устройства.

runPreparation 

public Throwable runPreparation (boolean includeSuitePreparers)

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

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

Возврат
Throwable Throwable любое исключение, возникающее при запуске подготовителей.

setBuild 

public void setBuild (IBuildInfo build)

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

Параметры
build IBuildInfo

setCollectTestsOnly 

public void setCollectTestsOnly (boolean collectTestsOnly)

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

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

setMergeAttemps 

public final void setMergeAttemps (boolean mergeAttempts)

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

Параметры
mergeAttempts boolean

setMetricCollectors 

public void setMetricCollectors ( collectors)

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

Параметры
collectors

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)

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

Параметры
mSuiteConfiguration IConfiguration

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

hasTests 

protected boolean hasTests ()

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

Возврат
boolean