ModuleDefinition

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

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


Kontener konfiguracji testu. Ta klasa pomaga przygotowywać i przeprowadzać testy.

Podsumowanie

Stałe

String ISOLATION_COST

String MODULE_ABI

String MODULE_CACHED

Ta właściwość ma wartość „true”, jeśli wyniki modułu testowego zostały zapisane w pamięci podręcznej.

String MODULE_CONTROLLER

String MODULE_EXTERNAL_DEPENDENCIES

String MODULE_ID

Identyfikator modułu to nazwa, która będzie używana do jednoznacznego identyfikowania modułu podczas testRunStart.

String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

String MODULE_ISOLATED

Ta właściwość ma wartość „true”, jeśli moduł działał na nowo przygotowanym urządzeniu.

String MODULE_NAME

Nazwa modułu to nazwa podstawowa powiązana z modułem, zwykle pochodząca z pliku konfiguracyjnego XML TF, z którego moduł został wczytany.

String MODULE_PARAMETERIZATION

String MODULE_SKIPPED

Ta właściwość ma wartość „true”, jeśli moduł testowy został pominięty.

String MODULE_TEST_COUNT

String PREPARATION_TIME

String RETRY_FAIL_COUNT

String RETRY_SUCCESS_COUNT

String RETRY_TIME

String SPARSE_MODULE

Ta właściwość ma wartość „true”, jeśli zgłaszane są tylko zdarzenia na poziomie modułu.

String TEAR_DOWN_TIME

String TEST_TIME

Konstruktory publiczne

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

Konstruktor

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

Konstruktor

Metody publiczne

int compareTo(ModuleDefinition moduleDef)

Set<Digest> getFilterDigests()

Zwraca skróty filtrów powiązanych z testami.

String getId()

Zwraca unikalną nazwę modułu.

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

Zwraca IInvocationContext powiązany z modułem.

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

Zwraca przybliżony czas potrzebny na uruchomienie wszystkich testów w module.

boolean hasModuleFailed()

Zwraca wartość Prawda, jeśli w module * wywołano funkcję testRunFailure.

int neededDevices()

Zwraca liczbę urządzeń, na których ma zostać przeprowadzony ten test.

int numTests()

Zwraca bieżącą liczbę zadań IRemoteTest oczekujących na wykonanie.

final void reportNotExecuted(ITestInvocationListener listener, String message)

Raportowanie modułów, które nie zostały w ogóle wykonane.

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

Uruchom wszystkie IRemoteTest zawarte w module i użyj wszystkich preparatorów przed i po, aby skonfigurować i wyczyścić urządzenie.

final void run(TestInformation moduleInfo, ITestInvocationListener listener)

Uruchom wszystkie IRemoteTest zawarte w module i użyj wszystkich preparatorów przed i po, aby skonfigurować i wyczyścić urządzenie.

Throwable runPreparation(boolean includeSuitePreparers)

Uruchom przygotowania do testu, w tym przygotowania na poziomie pakietu, jeśli zostały określone.

void setBuild(IBuildInfo build)

Wstrzyknij IBuildInfo, który ma być używany podczas testów.

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

Włącza lub wyłącza tryb zbierania testów

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

Wstrzyknij ITestDevice, który ma być używany podczas testów.

void setEnableDynamicDownload(boolean enableDynamicDownload)

Określa, czy włączyć pobieranie dynamiczne na poziomie modułu.

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

Przekaż do modułu zapisywacz logów wywołania, aby w razie potrzeby mógł go użyć.

final void setMergeAttemps(boolean mergeAttempts)

Określa, czy wyniki mają być scalane.

void setMetricCollectors(List<IMetricCollector> collectors)

Wstrzyknij listę IMetricCollector, która będzie używana przez moduł.

void setRecoverVirtualDevice(boolean recoverVirtualDevice)

Zestawy powinny przywrócić urządzenie wirtualne.

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

Ustawia wartość IRetryDecision, która będzie używana do ponawiania prób w ramach modułu.

void setUseModuleResultsForwarder(boolean useModuleResultsForwarder)
boolean shouldRecoverVirtualDevice()

Zwraca informację o tym, czy należy odzyskać urządzenie wirtualne.

String toString()

void transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)

Skopiuj kilka ustawień konfiguracji na poziomie pakietu.

Metody chronione

boolean hasTests()

Zwraca wartość Prawda, jeśli moduł nadal ma IRemoteTest do uruchomienia w swojej puli.

Stałe

ISOLATION_COST

public static final String ISOLATION_COST

Wartość stała: "ISOLATION_COST"

MODULE_ABI

public static final String MODULE_ABI

Wartość stała: "module-abi"

MODULE_CACHED

public static final String MODULE_CACHED

Ta właściwość ma wartość „true”, jeśli wyniki modułu testowego zostały zapisane w pamięci podręcznej.

Wartość stała: "module-cached"

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

Wartość stała: "module_controller"

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

Wartość stała: "module-external-dependencies"

MODULE_ID

public static final String MODULE_ID

Identyfikator modułu to nazwa, która będzie używana do jednoznacznego identyfikowania modułu podczas testRunStart. Zwykle jest to kombinacja MODULE_ABI + MODULE_NAME.

Wartość stała: "module-id"

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

Wartość stała: "module-flag-overrides"

MODULE_ISOLATED

public static final String MODULE_ISOLATED

Ta właściwość ma wartość „true”, jeśli moduł działał na nowo przygotowanym urządzeniu.

Wartość stała: "module-isolated"

MODULE_NAME

public static final String MODULE_NAME

Nazwa modułu to nazwa podstawowa powiązana z modułem, zwykle pochodząca z pliku konfiguracyjnego XML TF, z którego moduł został wczytany.

Wartość stała: "module-name"

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

Wartość stała: "module-param"

MODULE_SKIPPED

public static final String MODULE_SKIPPED

Ta właściwość ma wartość „true”, jeśli moduł testowy został pominięty.

Wartość stała: "module-skipped"

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

Wartość stała: "MODULE_TEST_COUNT"

PREPARATION_TIME

public static final String PREPARATION_TIME

Wartość stała: "PREP_TIME"

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

Wartość stała: "MODULE_RETRY_FAILED"

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

Wartość stała: "MODULE_RETRY_SUCCESS"

RETRY_TIME

public static final String RETRY_TIME

Wartość stała: "MODULE_RETRY_TIME"

SPARSE_MODULE

public static final String SPARSE_MODULE

Ta właściwość ma wartość „true”, jeśli zgłaszane są tylko zdarzenia na poziomie modułu.

Wartość stała: "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

Wartość stała: "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

Wartość stała: "TEST_TIME"

Konstruktory publiczne

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

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

Konstruktor

Parametry
name String: unikalna nazwa konfiguracji testu.

tests Collection: lista IRemoteTest, które muszą zostać uruchomione.

preparersPerDevice Map: lista ITargetPreparer, które mają być używane do konfigurowania urządzenia.

multiPreparers List

moduleConfig IConfiguration: IConfiguration konfiguracji modułu bazowego.

ModuleDefinition

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

Konstruktor

Parametry
name String: unikalna nazwa konfiguracji testu.

tests Collection: lista IRemoteTest, które muszą zostać uruchomione.

preparersPerDevice Map: lista ITargetPreparer, które mają być używane do konfigurowania urządzenia.

suitePreparersPerDevice Map

multiPreparers List

moduleConfig IConfiguration: IConfiguration konfiguracji modułu bazowego.

Metody publiczne

compareTo

public int compareTo (ModuleDefinition moduleDef)

Parametry
moduleDef ModuleDefinition

Zwraca
int

getFilterDigests

public Set<Digest> getFilterDigests ()

Zwraca skróty filtrów powiązanych z testami.

Zwraca
Set<Digest>

Zgłasza
IOException

getId

public String getId ()

Zwraca unikalną nazwę modułu.

Zwraca
String

getIntraModuleShardCount

public Integer getIntraModuleShardCount ()

Zwraca
Integer

getIntraModuleShardIndex

public Integer getIntraModuleShardIndex ()

Zwraca
Integer

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

Zwraca
IConfiguration

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Zwraca IInvocationContext powiązany z modułem.

Zwraca
IInvocationContext

getModuleTestInformation

public TestInformation getModuleTestInformation ()

Zwraca
TestInformation

getRequiredTokens

public Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

Parametry
testInfo TestInformation

Zwraca
Set<TokenProperty>

getRuntimeHint

public long getRuntimeHint ()

Zwraca przybliżony czas potrzebny na uruchomienie wszystkich testów w module.

Zwraca
long

hasModuleFailed

public boolean hasModuleFailed ()

Zwraca wartość Prawda, jeśli w module * wywołano funkcję testRunFailure.

Zwraca
boolean

neededDevices

public int neededDevices ()

Zwraca liczbę urządzeń, na których ma zostać przeprowadzony ten test.

Zwraca
int

numTests

public int numTests ()

Zwraca bieżącą liczbę zadań IRemoteTest oczekujących na wykonanie.

Zwraca
int

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Raportowanie modułów, które nie zostały w ogóle wykonane.

Parametry
listener ITestInvocationListener

message String

home run

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

Uruchom wszystkie IRemoteTest zawarte w module i użyj wszystkich preparatorów przed i po, aby skonfigurować i wyczyścić urządzenie.

Parametry
moduleInfo TestInformation: TestInformation modułu.

listener ITestInvocationListener: ITestInvocationListener, w którym mają być raportowane wyniki.

maxRunLimit int: maksymalna liczba uruchomień każdego przypadku testowego.

Zgłasza
DeviceNotAvailableException w przypadku przejścia urządzenia w tryb offline.

home run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

Uruchom wszystkie IRemoteTest zawarte w module i użyj wszystkich preparatorów przed i po, aby skonfigurować i wyczyścić urządzenie.

Parametry
moduleInfo TestInformation

listener ITestInvocationListener: ITestInvocationListener, w którym mają być raportowane wyniki.

Zgłasza
DeviceNotAvailableException w przypadku przejścia urządzenia w tryb offline.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Uruchom przygotowania do testu, w tym przygotowania na poziomie pakietu, jeśli zostały określone.

Parametry
includeSuitePreparers boolean: ustaw na true, aby uruchomić też przygotowania na poziomie pakietu.

Zwraca
Throwable Throwable – dowolny wyjątek zgłoszony podczas uruchamiania funkcji przygotowujących.

setBuild

public void setBuild (IBuildInfo build)

Wstrzyknij IBuildInfo, który ma być używany podczas testów.

Parametry
build IBuildInfo

setCollectKernelLog

public void setCollectKernelLog (boolean collectKernelLog)

Parametry
collectKernelLog boolean

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Włącza lub wyłącza tryb zbierania testów

setDefaultLogCollectors

public void setDefaultLogCollectors (List<IMetricCollector> collectors)

Parametry
collectors List

setDevice

public void setDevice (ITestDevice device)

Wstrzyknij ITestDevice, który ma być używany podczas testów.

Parametry
device ITestDevice

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Określa, czy włączyć pobieranie dynamiczne na poziomie modułu.

Parametry
enableDynamicDownload boolean

setIntraModuleInformation

public void setIntraModuleInformation (int shardCount, 
                int shardIndex)

Parametry
shardCount int

shardIndex int

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Przekaż do modułu zapisywacz logów wywołania, aby w razie potrzeby mógł go użyć.

Parametry
logSaver ILogSaver

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Określa, czy wyniki mają być scalane.

Parametry
mergeAttempts boolean

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

Wstrzyknij listę IMetricCollector, która będzie używana przez moduł.

Parametry
collectors List

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Zestawy powinny przywrócić urządzenie wirtualne.

Parametry
recoverVirtualDevice boolean

setRemoveModuleBuffering

public void setRemoveModuleBuffering (boolean removeModuleBuffering)

Parametry
removeModuleBuffering boolean

setReportModuleEnd

public void setReportModuleEnd (boolean shouldReportModuleEnd)

Parametry
shouldReportModuleEnd boolean

setReportModuleStart

public void setReportModuleStart (boolean shouldReportModuleStart)

Parametry
shouldReportModuleStart boolean

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Ustawia wartość IRetryDecision, która będzie używana do ponawiania prób w ramach modułu.

Parametry
decision IRetryDecision

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Parametry
useModuleResultsForwarder boolean

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Zwraca informację o tym, czy należy odzyskać urządzenie wirtualne.

Zwraca
boolean

toString

public String toString ()

Zwraca
String

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Skopiuj kilka ustawień konfiguracji na poziomie pakietu.

Parametry
mSuiteConfiguration IConfiguration

Metody chronione

hasTests

protected boolean hasTests ()

Zwraca wartość Prawda, jeśli moduł nadal ma IRemoteTest do uruchomienia w swojej puli. W przeciwnym razie ma wartość Fałsz.

Zwraca
boolean