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, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)

Konstruktor

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

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 IInvocationContext zurück, der mit dem Modul verknüpft ist.

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 IRemoteTest zurück.

final void reportNotExecuted(ITestInvocationListener listener, String message)

Vollständig nicht ausgeführte Module melden.

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.

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.

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.

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 IBuildInfo ein, die während der Tests verwendet werden soll.

void setCollectTestsOnly(boolean collectTestsOnly)

Aktiviert oder deaktiviert den Modus für die Testerhebung

void setDevice(ITestDevice device)

Injizieren Sie die ITestDevice, die während der Tests verwendet werden soll.

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

Liste der IMetricCollector einfügen, die vom Modul verwendet werden soll.

void setRecoverVirtualDevice(boolean recoverVirtualDevice)

Sets sollten das virtuelle Gerät wiederherstellen.

final void setRetryDecision(IRetryDecision decision)

Legt den Wert für IRetryDecision fest, der für den internen Wiederholungsversuch verwendet werden soll.

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 IRemoteTest ausgeführt werden müssen.

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

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

Returns
IConfiguration

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Gibt den IInvocationContext zurück, der mit dem Modul verknüpft ist.

Returns
IInvocationContext

getRequiredTokens

public  getRequiredTokens (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