Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

Diese Seite wurde von der Cloud Translation API übersetzt.

ModuleDefinition

public class ModuleDefinition
extends Object implements 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` Modul-ID: 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 wird auf „true“ gesetzt, wenn nur Ereignisse auf Modulebene gemeldet werden.
`String`	`TEAR_DOWN_TIME`
`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 dem Modul zugeordnet ist.
`TestInformation`	`getModuleTestInformation()`
	`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 überhaupt nicht 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 Preparer des Tests aus, einschließlich der Preparer auf Suite-Ebene, falls angegeben.
`void`	`setBuild(IBuildInfo build)` Fügen Sie die `IBuildInfo` ein, die bei den Tests verwendet werden soll.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Aktiviert oder deaktiviert den Testsammlungsmodus
`void`	`setDevice(ITestDevice device)` Fügen Sie die `ITestDevice` ein, die bei den 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 Aufrufspeicher für Logs 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( 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

Modul-ID: Der Name, der verwendet wird, um das Modul während „testRunStart“ eindeutig zu identifizieren. In der Regel ist es eine Kombination aus MODULE_ABI und 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

Konstanter Wert: "MODULE_RETRY_TIME"

SPARSE_MODULE

public static final String SPARSE_MODULE

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

Konstanter Wert: "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

Konstanter Wert: "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

Konstanter Wert: "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`: die `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`: die `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 dem Modul zugeordnet ist.

Returns
`IInvocationContext`

getModuleTestInformation

public TestInformation getModuleTestInformation ()

Returns
`TestInformation`

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Parameter
`testInfo`	`TestInformation`

Returns

getRuntimeHint

public long getRuntimeHint ()

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

Returns
`long`

hasModuleFailed

public boolean hasModuleFailed ()

Gibt „True“ zurück, wenn „testRunFailure“ für das Modul * 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 IRemoteTest zurück, die auf die Ausführung warten.

Returns
`int`

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Bericht zu Modulen, die überhaupt nicht ausgeführt wurden.

Parameter
`listener`	`ITestInvocationListener`
`message`	`String`

Homerun

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`, in dem Ergebnisse gemeldet werden sollen.
`maxRunLimit`	`int`: Die maximale Anzahl von Ausführungen für jeden Testlauf.

Ausgabe
`DeviceNotAvailableException`	wenn das Gerät offline geht.

Homerun

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`, in dem Ergebnisse gemeldet werden sollen.

Ausgabe
`DeviceNotAvailableException`	wenn das Gerät offline geht.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

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

Parameter
`includeSuitePreparers`	`boolean`: Auf `true` setzen, um auch Preparer auf Suite-Ebene auszuführen.

Returns
`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 bei den Tests verwendet werden soll.

Parameter
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Aktiviert oder deaktiviert den Testsammlungsmodus

setDevice

public void setDevice (ITestDevice device)

Fügen Sie die ITestDevice ein, die bei den 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 Aufrufspeicher für Logs 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 ( 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`

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.

Returns
`boolean`

toString

public String toString ()

Returns
`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. ansonsten „falsch“.

Returns
`boolean`