ModuleDefinition

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

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

---

Container für die Konfiguration des Testlaufs. Diese Klasse ist ein Helfer zum Vorbereiten und Ausführen der Tests.

Zusammenfassung

Konstanten
String	ISOLATION_COST
String	MODULE_ABI
String	MODULE_CACHED Diese Property wird auf „true“ gesetzt, wenn die Ergebnisse des Testmoduls im Cache gespeichert wurden.
String	MODULE_CONTROLLER
String	MODULE_EXTERNAL_DEPENDENCIES
String	MODULE_ID Die Modul-ID ist der Name, der verwendet wird, um das Modul während „testRunStart“ eindeutig zu identifizieren.
String	MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY
String	MODULE_ISOLATED Diese Eigenschaft wird auf „true“ gesetzt, wenn das Modul auf einem neu vorbereiteten Gerät ausgeführt wurde.
String	MODULE_NAME Der Modulname ist der Basisname, der dem Modul zugeordnet ist. Er stammt in der Regel aus der XML-TF-Konfigurationsdatei, aus der das Modul geladen wurde.
String	MODULE_PARAMETERIZATION
String	MODULE_SKIPPED Diese Property wird auf „true“ gesetzt, wenn das Testmodul übersprungen wurde.
String	MODULE_TEST_COUNT
String	PREPARATION_TIME
String	RETRY_FAIL_COUNT
String	RETRY_SUCCESS_COUNT
String	RETRY_TIME
String	SPARSE_MODULE Diese Property ist auf „true“ gesetzt, wenn nur Ereignisse auf Modulebene gemeldet werden.
String	TEAR_DOWN_TIME
String	TEST_TIME

Öffentliche Konstruktoren
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

Öffentliche Methoden
int	compareTo(ModuleDefinition moduleDef)
Set<Digest>	getFilterDigests() Gibt die Digests der Filter zurück, die den Tests zugeordnet sind.
String	getId() Gibt den eindeutigen Modulnamen zurück.
Integer	getIntraModuleShardCount()
Integer	getIntraModuleShardIndex()
IConfiguration	getModuleConfiguration()
IInvocationContext	getModuleInvocationContext() Gibt den IInvocationContext zurück, der dem Modul zugeordnet ist.
TestInformation	getModuleTestInformation()
Set<TokenProperty>	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 „testRunFailure“ für das Modul aufgerufen wurde. *
int	neededDevices() Gibt die Anzahl der Geräte zurück, auf denen dieser Test voraussichtlich ausgeführt wird.
int	numTests() Gibt die aktuelle Anzahl der IRemoteTest zurück, die auf die Ausführung warten.
final void	reportNotExecuted(ITestInvocationListener listener, String message) Bericht zu Modulen, die nicht vollständig ausgeführt wurden.
final void	run(TestInformation moduleInfo, ITestInvocationListener listener, int maxRunLimit) Führen Sie alle IRemoteTest im Modul aus und verwenden Sie alle Preparer vor und nach dem Einrichten und Bereinigen des Geräts.
final void	run(TestInformation moduleInfo, ITestInvocationListener listener) Führen Sie alle IRemoteTest im Modul aus und verwenden Sie alle Preparer vor und nach dem Einrichten und Bereinigen des Geräts.
Throwable	runPreparation(boolean includeSuitePreparers) Führen Sie die Vorbereitungsschritte des Tests aus, einschließlich der Vorbereitungsschritte auf Suite-Ebene, falls angegeben.
void	setBuild(IBuildInfo build) Fügen Sie die IBuildInfo ein, die während der Tests verwendet werden soll.
void	setCollectKernelLog(boolean collectKernelLog)
void	setCollectTestsOnly(boolean collectTestsOnly) Aktiviert oder deaktiviert den Testsammlungsmodus
void	setDefaultLogCollectors(List<IMetricCollector> collectors)
void	setDevice(ITestDevice device) Fügen Sie die ITestDevice ein, die während der Tests verwendet werden soll.
void	setEnableDynamicDownload(boolean enableDynamicDownload) Gibt an, ob der dynamische Download auf Modulebene aktiviert werden soll.
void	setIntraModuleInformation(int shardCount, int shardIndex)
void	setLogSaver(ILogSaver logSaver) Übergeben Sie den Aufruflogspeicher an das Modul, damit es ihn bei Bedarf verwenden kann.
final void	setMergeAttemps(boolean mergeAttempts) Legt fest, ob Ergebnisse zusammengeführt werden sollen.
void	setMetricCollectors(List<IMetricCollector> collectors) Fügen Sie die Liste der IMetricCollector ein, die vom Modul verwendet werden soll.
void	setRecoverVirtualDevice(boolean recoverVirtualDevice) Sets sollten das virtuelle Gerät wiederherstellen.
void	setRemoveModuleBuffering(boolean removeModuleBuffering)
void	setReportModuleEnd(boolean shouldReportModuleEnd)
void	setReportModuleStart(boolean shouldReportModuleStart)
final void	setRetryDecision(IRetryDecision decision) Legt die IRetryDecision fest, die für die Wiederholung innerhalb des Moduls verwendet werden soll.
void	setUseModuleResultsForwarder(boolean useModuleResultsForwarder)
boolean	shouldRecoverVirtualDevice() Gibt zurück, ob das virtuelle Gerät wiederhergestellt werden soll.
String	toString()
void	transferSuiteLevelOptions(IConfiguration mSuiteConfiguration) Einige Konfigurationen auf Suite-Ebene kopieren

Geschützte Methoden
boolean	hasTests() Gibt „True“ zurück, wenn das Modul noch IRemoteTest in seinem Pool hat.

Konstanten

ISOLATION_COST

public static final String ISOLATION_COST

Konstanter Wert: "ISOLATION_COST"

MODULE_ABI

public static final String MODULE_ABI

Konstanter Wert: "module-abi"

MODULE_CACHED

public static final String MODULE_CACHED

Diese Property wird auf „true“ gesetzt, wenn die Ergebnisse des Testmoduls im Cache gespeichert wurden.

Konstanter Wert: "module-cached"

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

Konstanter Wert: "module_controller"

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

Konstanter Wert: "module-external-dependencies"

MODULE_ID

public static final String MODULE_ID

Die Modul-ID ist der Name, der verwendet wird, um das Modul während „testRunStart“ eindeutig zu identifizieren. In der Regel ist es eine Kombination aus MODULE_ABI + MODULE_NAME.

Constant Value: "module-id"

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

Konstanter Wert: "module-flag-overrides"

MODULE_ISOLATED

public static final String MODULE_ISOLATED

Diese Eigenschaft wird auf „true“ gesetzt, wenn das Modul auf einem neu vorbereiteten Gerät ausgeführt wurde.

Konstanter Wert: "module-isolated"

MODULE_NAME

public static final String MODULE_NAME

Der Modulname ist der Basisname, der dem Modul zugeordnet ist. Er stammt in der Regel aus der XML-TF-Konfigurationsdatei, aus der das Modul geladen wurde.

Konstanter Wert: "module-name"

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

Konstanter Wert: "module-param"

MODULE_SKIPPED

public static final String MODULE_SKIPPED

Diese Property wird auf „true“ gesetzt, wenn das Testmodul übersprungen wurde.

Konstanter Wert: "module-skipped"

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

Constant Value: "MODULE_TEST_COUNT"

PREPARATION_TIME

public static final String PREPARATION_TIME

Konstanter Wert: "PREP_TIME"

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

Konstanter Wert: "MODULE_RETRY_FAILED"

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

Konstanter Wert: "MODULE_RETRY_SUCCESS"

RETRY_TIME

public static final String RETRY_TIME

Constant Value: "MODULE_RETRY_TIME"

SPARSE_MODULE

public static final String SPARSE_MODULE

Diese Property ist auf „true“ gesetzt, wenn nur Ereignisse auf Modulebene gemeldet werden.

Konstanter Wert: "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

Constant Value: "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

Konstanter Wert: "TEST_TIME"

Öffentliche Konstruktoren

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

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

Konstruktor

Parameter
name	String: Eindeutiger Name der Testkonfiguration.
tests	Collection: Liste der auszuführenden IRemoteTest.
preparersPerDevice	Map: Liste der ITargetPreparer, die zum Einrichten des Geräts verwendet werden sollen.
multiPreparers	List
moduleConfig	IConfiguration: die IConfiguration der zugrunde liegenden Modulkonfiguration.

ModuleDefinition

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

Konstruktor

Parameter
name	String: Eindeutiger Name der Testkonfiguration.
tests	Collection: Liste der auszuführenden IRemoteTest.
preparersPerDevice	Map: Liste der ITargetPreparer, die zum Einrichten des Geräts verwendet werden sollen.
suitePreparersPerDevice	Map
multiPreparers	List
moduleConfig	IConfiguration: die IConfiguration der zugrunde liegenden Modulkonfiguration.

Öffentliche Methoden

compareTo

public int compareTo (ModuleDefinition moduleDef)

Parameter
moduleDef	ModuleDefinition

Gibt Folgendes zurück:
int

getFilterDigests

public Set<Digest> getFilterDigests ()

Gibt die Digests der Filter zurück, die den Tests zugeordnet sind.

Gibt Folgendes zurück:
Set<Digest>

Löst aus
IOException

getId

public String getId ()

Gibt den eindeutigen Modulnamen zurück.

Gibt Folgendes zurück:
String

getIntraModuleShardCount

public Integer getIntraModuleShardCount ()

Gibt Folgendes zurück:
Integer

getIntraModuleShardIndex

public Integer getIntraModuleShardIndex ()

Gibt Folgendes zurück:
Integer

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

Gibt Folgendes zurück:
IConfiguration

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Gibt den IInvocationContext zurück, der dem Modul zugeordnet ist.

Gibt Folgendes zurück:
IInvocationContext

getModuleTestInformation

public TestInformation getModuleTestInformation ()

Gibt Folgendes zurück:
TestInformation

getRequiredTokens

public Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

Parameter
testInfo	TestInformation

Gibt Folgendes zurück:
Set<TokenProperty>

getRuntimeHint

public long getRuntimeHint ()

Gibt die ungefähre Zeit zurück, die zum Ausführen aller Tests im Modul benötigt wird.

Gibt Folgendes zurück:
long

hasModuleFailed

public boolean hasModuleFailed ()

Gibt „True“ zurück, wenn „testRunFailure“ für das Modul * aufgerufen wurde.

Gibt Folgendes zurück:
boolean

neededDevices

public int neededDevices ()

Gibt die Anzahl der Geräte zurück, auf denen dieser Test voraussichtlich ausgeführt wird.

Gibt Folgendes zurück:
int

numTests

public int numTests ()

Gibt die aktuelle Anzahl der IRemoteTest zurück, die auf die Ausführung warten.

Gibt Folgendes zurück:
int

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Bericht zu Modulen, die nicht vollständig ausgeführt wurden.

Parameter
listener	ITestInvocationListener
message	String

run

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

Führen Sie alle IRemoteTest im Modul aus und verwenden Sie alle Preparer vor und nach dem Einrichten und Bereinigen des Geräts.

Parameter
moduleInfo	TestInformation: die TestInformation für das Modul.
listener	ITestInvocationListener: Der ITestInvocationListener, an den Ergebnisse gesendet werden sollen.
maxRunLimit	int: Die maximale Anzahl von Ausführungen für jeden Testlauf.

Löst aus
DeviceNotAvailableException	wenn das Gerät offline geht.

run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

Führen Sie alle IRemoteTest im Modul aus und verwenden Sie alle Preparer vor und nach dem Einrichten und Bereinigen des Geräts.

Parameter
moduleInfo	TestInformation
listener	ITestInvocationListener: Der ITestInvocationListener, an den Ergebnisse gesendet werden sollen.

Löst aus
DeviceNotAvailableException	wenn das Gerät offline geht.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Führen Sie die Vorbereitungsschritte des Tests aus, einschließlich der Vorbereitungsschritte auf Suite-Ebene, falls angegeben.

Parameter
includeSuitePreparers	boolean: Wenn Sie diesen Wert auf true setzen, werden auch Preparer auf Suite-Ebene ausgeführt.

Gibt Folgendes zurück:
Throwable	Throwable einer Ausnahme, die beim Ausführen von Preparers 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

setCollectKernelLog

public void setCollectKernelLog (boolean collectKernelLog)

Parameter
collectKernelLog	boolean

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Aktiviert oder deaktiviert den Testsammlungsmodus

setDefaultLogCollectors

public void setDefaultLogCollectors (List<IMetricCollector> collectors)

Parameter
collectors	List

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)

Gibt an, 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 Aufruflogspeicher an das Modul, damit es ihn bei Bedarf verwenden kann.

Parameter
logSaver	ILogSaver

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Legt fest, ob Ergebnisse zusammengeführt werden sollen.

Parameter
mergeAttempts	boolean

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

Fügen Sie die Liste der IMetricCollector ein, die vom Modul verwendet werden soll.

Parameter
collectors	List

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Sets sollten das virtuelle Gerät wiederherstellen.

Parameter
recoverVirtualDevice	boolean

setRemoveModuleBuffering

public void setRemoveModuleBuffering (boolean removeModuleBuffering)

Parameter
removeModuleBuffering	boolean

setReportModuleEnd

public void setReportModuleEnd (boolean shouldReportModuleEnd)

Parameter
shouldReportModuleEnd	boolean

setReportModuleStart

public void setReportModuleStart (boolean shouldReportModuleStart)

Parameter
shouldReportModuleStart	boolean

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Legt die IRetryDecision fest, die für die Wiederholung innerhalb des Moduls verwendet werden soll.

Parameter
decision	IRetryDecision

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Parameter
useModuleResultsForwarder	boolean

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Gibt zurück, ob das virtuelle Gerät wiederhergestellt werden soll.

Gibt Folgendes zurück:
boolean

toString

public String toString ()

Gibt Folgendes zurück:
String

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Einige Konfigurationen auf Suite-Ebene kopieren

Parameter
mSuiteConfiguration	IConfiguration

Geschützte Methoden

hasTests

protected boolean hasTests ()

Gibt „True“ zurück, wenn das Modul noch IRemoteTest in seinem Pool hat. Andernfalls „Falsch”.

Gibt Folgendes zurück:
boolean