Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

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`