ModuleDefinition
public
class
ModuleDefinition
extends Object
implements
ITestCollector
java.lang.Object | |
↳ | com.android.tradefed.testtype.suite.ModuleDefinition |
Container für die Konfiguration des Testlaufs. Dieser Kurs hilft Ihnen bei der Vorbereitung und Durchführung der Tests.
Zusammenfassung
Felder | |
---|---|
public
static
final
String |
ISOLATION_COST
|
public
static
final
String |
MODULE_ABI
|
public
static
final
String |
MODULE_CACHED
Diese Property wird auf „true“ gesetzt, wenn die Testmodulergebnisse im Cache gespeichert wurden. |
public
static
final
String |
MODULE_CONTROLLER
|
public
static
final
String |
MODULE_EXTERNAL_DEPENDENCIES
|
public
static
final
String |
MODULE_ID
„Modul-ID“ ist der Name, mit dem das Modul während „testRunStart“ eindeutig identifiziert wird. |
public
static
final
String |
MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY
|
public
static
final
String |
MODULE_ISOLATED
Diese Eigenschaft wird auf „true“ gesetzt, wenn das Modul auf einem frisch vorbereiteten Gerät ausgeführt wurde. |
public
static
final
String |
MODULE_NAME
Der Modulname ist der dem Modul zugeordnete Basisname. Er stammt normalerweise aus der XML-TF-Konfigurationsdatei, aus der das Modul geladen wurde. |
public
static
final
String |
MODULE_PARAMETERIZATION
|
public
static
final
String |
MODULE_SKIPPED
Diese Property wird auf „true“ gesetzt, wenn das Testmodul übersprungen wurde. |
public
static
final
String |
MODULE_TEST_COUNT
|
public
static
final
String |
PREPARATION_TIME
|
public
static
final
String |
RETRY_FAIL_COUNT
|
public
static
final
String |
RETRY_SUCCESS_COUNT
|
public
static
final
String |
RETRY_TIME
|
public
static
final
String |
SPARSE_MODULE
Diese Property ist auf „true“ gesetzt, wenn nur Ereignisse auf Modulebene erfasst werden. |
public
static
final
String |
TEAR_DOWN_TIME
|
public
static
final
String |
TEST_TIME
|
Öffentliche Konstruktoren | |
---|---|
ModuleDefinition()
|
|
ModuleDefinition(String name,
Konstruktor |
|
ModuleDefinition(String name,
Konstruktor |
Öffentliche Methoden | |
---|---|
int
|
compareTo(ModuleDefinition moduleDef)
|
String
|
getId()
Gibt den eindeutigen Modulnamen zurück. |
Integer
|
getIntraModuleShardCount()
|
Integer
|
getIntraModuleShardIndex()
|
IConfiguration
|
getModuleConfiguration()
|
IInvocationContext
|
getModuleInvocationContext()
Gibt den |
|
getRequiredTokens(TestInformation testInfo)
|
long
|
getRuntimeHint()
Gibt die ungefähre Zeit zurück, die zum Ausführen aller Tests im Modul benötigt wird. |
boolean
|
hasModuleFailed()
Gibt „True“ zurück, wenn für das Modul „testRunFailure“ aufgerufen wurde. |
int
|
neededDevices()
Gibt die Anzahl der Geräte zurück, auf denen dieser Test voraussichtlich ausgeführt werden soll. |
int
|
numTests()
Gibt die aktuelle Anzahl der ausstehenden |
final
void
|
reportNotExecuted(ITestInvocationListener listener, String message)
Vollständig nicht ausgeführte Module melden. |
final
void
|
run(TestInformation moduleInfo, ITestInvocationListener listener,
Führen Sie alle im Modul enthaltenen |
final
void
|
run(TestInformation moduleInfo, ITestInvocationListener listener,
Führen Sie alle im Modul enthaltenen |
final
void
|
run(TestInformation moduleInfo, ITestInvocationListener listener)
Führen Sie alle im Modul enthaltenen |
Throwable
|
runPreparation(boolean includeSuitePreparers)
Ausführende des Tests ausführen, einschließlich Ausführender auf Suite-Ebene, sofern angegeben. |
void
|
setBuild(IBuildInfo build)
Fügen Sie die |
void
|
setCollectTestsOnly(boolean collectTestsOnly)
Aktiviert oder deaktiviert den Modus für die Testerhebung |
void
|
setDevice(ITestDevice device)
Injizieren Sie die |
void
|
setEnableDynamicDownload(boolean enableDynamicDownload)
Ob der dynamische Download auf Modulebene aktiviert werden soll. |
void
|
setIntraModuleInformation(int shardCount, int shardIndex)
|
void
|
setLogSaver(ILogSaver logSaver)
Übergeben Sie den Aufrufprotokoll-Speicher an das Modul, damit es bei Bedarf verwendet werden kann. |
final
void
|
setMergeAttemps(boolean mergeAttempts)
Legt fest, ob Ergebnisse zusammengeführt werden sollen. |
void
|
setMetricCollectors(
Liste der |
void
|
setRecoverVirtualDevice(boolean recoverVirtualDevice)
Sets sollten das virtuelle Gerät wiederherstellen. |
final
void
|
setRetryDecision(IRetryDecision decision)
Legt den Wert für |
boolean
|
shouldRecoverVirtualDevice()
Gibt zurück, ob das virtuelle Gerät wiederhergestellt werden soll. |
String
|
toString()
|
void
|
transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)
Einige Konfigurationen auf Suiteebene kopieren |
Geschützte Methoden | |
---|---|
boolean
|
hasTests()
Gibt „True“ zurück, wenn im Pool des Moduls noch |
Felder
ISOLATION_COST
public static final String ISOLATION_COST
MODULE_ABI
public static final String MODULE_ABI
MODULE_CACHED
public static final String MODULE_CACHED
Diese Property wird auf „true“ gesetzt, wenn die Testmodulergebnisse im Cache gespeichert wurden.
MODULE_CONTROLLER
public static final String MODULE_CONTROLLER
MODULE_EXTERNAL_DEPENDENCIES
public static final String MODULE_EXTERNAL_DEPENDENCIES
MODULE_ID
public static final String MODULE_ID
„Modul-ID“ ist der Name, mit dem das Modul während „testRunStart“ eindeutig identifiziert wird. In der Regel ist es eine Kombination aus MODULE_ABI + MODULE_NAME.
MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY
public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY
MODULE_ISOLATED
public static final String MODULE_ISOLATED
Diese Eigenschaft wird auf „true“ gesetzt, wenn das Modul auf einem frisch vorbereiteten Gerät ausgeführt wurde.
MODULE_NAME
public static final String MODULE_NAME
Der Modulname ist der dem Modul zugeordnete Basisname. Er stammt in der Regel aus der XML-TF-Konfigurationsdatei, aus der das Modul geladen wurde.
MODULE_PARAMETERIZATION
public static final String MODULE_PARAMETERIZATION
MODULE_SKIPPED
public static final String MODULE_SKIPPED
Dieses Attribut wird auf „true“ gesetzt, wenn das Testmodul übersprungen wurde
MODULE_TEST_COUNT
public static final String MODULE_TEST_COUNT
VORBEREITUNGSZEIT
public static final String PREPARATION_TIME
RETRY_FAIL_COUNT
public static final String RETRY_FAIL_COUNT
RETRY_SUCCESS_COUNT
public static final String RETRY_SUCCESS_COUNT
RETRY_TIME
public static final String RETRY_TIME
SPARSE_MODULE
public static final String SPARSE_MODULE
Diese Property ist auf „true“ gesetzt, wenn nur Ereignisse auf Modulebene erfasst werden.
TEAR_DOWN_TIME
public static final String TEAR_DOWN_TIME
TEST_ZEIT
public static final String TEST_TIME
Öffentliche Konstruktoren
ModuleDefinition
public ModuleDefinition ()
ModuleDefinition
public ModuleDefinition (String name,tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)
Konstruktor
Parameter | |
---|---|
name |
String : Eindeutiger Name der Testkonfiguration. |
tests |
: Liste der auszuführenden IRemoteTest . |
preparersPerDevice |
: Liste der ITargetPreparer , die zum Einrichten des Geräts verwendet werden sollen. |
multiPreparers |
|
moduleConfig |
IConfiguration : der IConfiguration der zugrunde liegenden Modulkonfiguration. |
ModuleDefinition
public ModuleDefinition (String name,tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)
Konstruktor
Parameter | |
---|---|
name |
String : Eindeutiger Name der Testkonfiguration. |
tests |
: Liste der auszuführenden IRemoteTest . |
preparersPerDevice |
: Liste der ITargetPreparer , die zum Einrichten des Geräts verwendet werden sollen. |
suitePreparersPerDevice |
|
multiPreparers |
|
moduleConfig |
IConfiguration : IConfiguration der zugrunde liegenden Modulkonfiguration. |
Öffentliche Methoden
compareTo
public int compareTo (ModuleDefinition moduleDef)
Parameter | |
---|---|
moduleDef |
ModuleDefinition |
Returns | |
---|---|
int |
getId
public String getId ()
Gibt den eindeutigen Modulnamen zurück.
Returns | |
---|---|
String |
getIntraModuleShardCount
public Integer getIntraModuleShardCount ()
Returns | |
---|---|
Integer |
getIntraModuleShardIndex
public Integer getIntraModuleShardIndex ()
Returns | |
---|---|
Integer |
getModuleInvocationContext
public IInvocationContext getModuleInvocationContext ()
Gibt den IInvocationContext
zurück, der mit dem Modul verknüpft ist.
Returns | |
---|---|
IInvocationContext |
getRequiredTokens
publicgetRequiredTokens (TestInformation testInfo)
Parameter | |
---|---|
testInfo |
TestInformation |
Returns | |
---|---|
|
getRuntimeHint
public long getRuntimeHint ()
Gibt die ungefähre Zeit für die Ausführung aller Tests im Modul zurück.
Returns | |
---|---|
long |
hasModuleFailed
public boolean hasModuleFailed ()
Gibt „True“ zurück, wenn für das Modul „testRunFailure“ aufgerufen wurde.
Returns | |
---|---|
boolean |
neededDevices
public int neededDevices ()
Gibt die Anzahl der Geräte zurück, auf denen dieser Test voraussichtlich ausgeführt wird.
Returns | |
---|---|
int |
numTests
public int numTests ()
Gibt die aktuelle Anzahl der ausstehenden IRemoteTest
zurück.
Returns | |
---|---|
int |
reportNotExecuted
public final void reportNotExecuted (ITestInvocationListener listener, String message)
Vollständig nicht ausgeführte Module melden.
Parameter | |
---|---|
listener |
ITestInvocationListener |
message |
String |
Homerun
public final void run (TestInformation moduleInfo, ITestInvocationListener listener,moduleLevelListeners)
Führen Sie alle im Modul enthaltenen IRemoteTest
aus und verwenden Sie vor und nach dem Test alle Vorbereitenden, um das Gerät einzurichten und zu reinigen.
Parameter | |
---|---|
moduleInfo |
TestInformation |
listener |
ITestInvocationListener : ITestInvocationListener , unter dem die Ergebnisse gemeldet werden sollen. |
moduleLevelListeners |
: Die Liste der Listener auf Modulebene. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
im Falle eines Geräteausfalls. |
Homerun
public final void run (TestInformation moduleInfo, ITestInvocationListener listener,moduleLevelListeners, int maxRunLimit)
Führen Sie alle im Modul enthaltenen IRemoteTest
aus und verwenden Sie vor und nach dem Test alle Vorbereitenden, um das Gerät einzurichten und zu reinigen.
Parameter | |
---|---|
moduleInfo |
TestInformation : TestInformation für das Modul. |
listener |
ITestInvocationListener : ITestInvocationListener , unter dem die Ergebnisse gemeldet werden sollen. |
moduleLevelListeners |
: Die Liste der Listener auf Modulebene. |
maxRunLimit |
int : Die maximale Anzahl von Ausführungen für jeden Testfall. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
im Falle eines Geräteausfalls. |
Homerun
public final void run (TestInformation moduleInfo, ITestInvocationListener listener)
Führen Sie alle im Modul enthaltenen IRemoteTest
aus und verwenden Sie vor und nach dem Test alle Vorbereitenden, um das Gerät einzurichten und zu reinigen.
Parameter | |
---|---|
moduleInfo |
TestInformation |
listener |
ITestInvocationListener : ITestInvocationListener , unter dem die Ergebnisse gemeldet werden sollen. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
im Falle eines Geräteausfalls. |
runPreparation
public Throwable runPreparation (boolean includeSuitePreparers)
Ausführende des Tests ausführen, einschließlich Ausführender auf Suite-Ebene, sofern angegeben.
Parameter | |
---|---|
includeSuitePreparers |
boolean : Legen Sie true fest, damit auch Vorbereitungen auf Suite-Ebene ausgeführt werden. |
Returns | |
---|---|
Throwable |
Throwable von jeder Ausnahme, die beim Ausführen von Vorbereiten ausgelöst wird. |
SetBuild
public void setBuild (IBuildInfo build)
Fügen Sie die IBuildInfo
ein, die während der Tests verwendet werden soll.
Parameter | |
---|---|
build |
IBuildInfo |
setCollectTestsOnly
public void setCollectTestsOnly (boolean collectTestsOnly)
Aktiviert oder deaktiviert den Modus für die Testerhebung
setDevice
public void setDevice (ITestDevice device)
Fügen Sie die ITestDevice
ein, die während der Tests verwendet werden soll.
Parameter | |
---|---|
device |
ITestDevice |
setEnableDynamicDownload
public void setEnableDynamicDownload (boolean enableDynamicDownload)
Ob der dynamische Download auf Modulebene aktiviert werden soll.
Parameter | |
---|---|
enableDynamicDownload |
boolean |
setIntraModuleInformation
public void setIntraModuleInformation (int shardCount, int shardIndex)
Parameter | |
---|---|
shardCount |
int |
shardIndex |
int |
setLogSaver
public void setLogSaver (ILogSaver logSaver)
Übergeben Sie den Aufrufprotokoll-Speicher an das Modul, damit es bei Bedarf verwendet werden kann.
Parameter | |
---|---|
logSaver |
ILogSaver |
MergeAttemps festlegen
public final void setMergeAttemps (boolean mergeAttempts)
Legt fest, ob Ergebnisse zusammengeführt werden sollen.
Parameter | |
---|---|
mergeAttempts |
boolean |
setMetricCollectors
public void setMetricCollectors (collectors)
Fügen Sie die Liste der IMetricCollector
ein, die vom Modul verwendet werden soll.
Parameter | |
---|---|
collectors |
|
setRecoverVirtualDevice
public void setRecoverVirtualDevice (boolean recoverVirtualDevice)
Sets sollten das virtuelle Gerät wiederherstellen.
Parameter | |
---|---|
recoverVirtualDevice |
boolean |
setRetryDecision
public final void setRetryDecision (IRetryDecision decision)
Legt die IRetryDecision
fest, die für Wiederholungsversuche innerhalb des Moduls verwendet werden soll.
Parameter | |
---|---|
decision |
IRetryDecision |
shouldRecoverVirtualDevice
public boolean shouldRecoverVirtualDevice ()
Gibt an, ob das virtuelle Gerät wiederhergestellt werden soll.
Returns | |
---|---|
boolean |
toString
public String toString ()
Returns | |
---|---|
String |
TransferSuiteLevelOptions
public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)
Einige Konfigurationen auf Suiteebene kopieren
Parameter | |
---|---|
mSuiteConfiguration |
IConfiguration |
Geschützte Methoden
hasTests
protected boolean hasTests ()
Gibt "True" zurück, wenn im Pool des Moduls noch IRemoteTest
ausgeführt werden muss. Andernfalls „false“.
Returns | |
---|---|
boolean |