Ab 2026 werden wir den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen, um unser trunk-stable-Entwicklungsmodell zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten. Für die Entwicklung und das Beitragen zu AOSP empfehlen wir die Verwendung von android-latest-release anstelle von aosp-main. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

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 dient als Hilfsmittel zum Vorbereiten und Ausführen der Tests.

Zusammenfassung

Felder
`public static final String`	`MODULE_ABI`
`public static final String`	`MODULE_CONTROLLER`
`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_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, der in der Regel aus der XML-TF-Konfigurationsdatei stammt, aus der das Modul geladen wurde.
`public static final String`	`MODULE_PARAMETERIZATION`
`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`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

Öffentliche Konstruktoren
`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.
`IInvocationContext`	`getModuleInvocationContext()` Gibt den `IInvocationContext` zurück, der mit dem Modul verknüpft ist.
	`getRequiredTokens()`
`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`	`numTests()` Gibt die aktuelle Anzahl der ausstehenden `IRemoteTest` zurück.
`final void`	`reportNotExecuted(ITestInvocationListener listener, String message)` Melden Sie Module, die nicht vollständig ausgeführt wurden.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)` 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.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit)` Führen Sie alle im Modul enthaltenen `IRemoteTest` aus und verwenden Sie vor und nach dem Test alle Vorbereiter, 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)` Fügen Sie die `ITestDevice` ein, die während der Tests verwendet werden soll.
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` Ob der dynamische Download auf Modulebene aktiviert werden soll.
`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.
`final void`	`setRetryDecision(IRetryDecision decision)` Legt den Wert für `IRetryDecision` fest, der für den internen Wiederholungsversuch verwendet werden soll.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` Einige Konfigurationselemente auf Suitenebene kopieren

Geschützte Methoden
`boolean`	`hasTests()` Gibt „True“ zurück, wenn im Pool des Moduls noch `IRemoteTest` ausgeführt werden müssen.

Felder

MODULE_ABI

public static final String MODULE_ABI

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

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 und MODULE_NAME.

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, der in der Regel aus der XML-TF-Konfigurationsdatei stammt, aus der das Modul geladen wurde.

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

PREPARATION_TIME

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

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

Öffentliche Konstruktoren

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`: der `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`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

Returns
`IInvocationContext`

getRequiredTokens

public  getRequiredTokens ()

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 für das Modul „testRunFailure“ aufgerufen wurde.

Returns
`boolean`

numTests

public int numTests ()

Gibt die aktuelle Anzahl der ausstehenden IRemoteTest zurück.

Returns
`int`

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Melden Sie Module, die nicht vollständig ausgeführt wurden.

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

Homerun

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners, 
                TestFailureListener failureListener)

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.
`failureListener`	`TestFailureListener`: Ein bestimmter Listener, um Protokolle bei testFail zu erfassen. Kann null sein.

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.

Homerun

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners, 
                TestFailureListener failureListener, 
                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`: die `TestInformation` für das Modul.
`listener`	`ITestInvocationListener`: `ITestInvocationListener`, unter dem die Ergebnisse gemeldet werden sollen.
`moduleLevelListeners`	: Die Liste der Listener auf Modulebene.
`failureListener`	`TestFailureListener`: einen bestimmten Listener zum Erfassen von Protokollen bei testFail. Kann null sein.
`maxRunLimit`	`int`: Die maximale Anzahl von Ausführungen für jeden Testfall.

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 diesen Wert auf `true` fest, um auch Vorbereiter auf Suite-Ebene auszuführen.

Returns
`Throwable`	`Throwable` von jeder Ausnahme, die beim Ausführen von Vorbereitern auftritt.

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`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Übergeben Sie den Aufrufprotokoll-Speicher an das Modul, damit es bei Bedarf verwendet werden 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)

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

Parameter
`collectors`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

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

Parameter
`decision`	`IRetryDecision`

toString

public String toString ()

Returns
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Einige Konfigurationselemente auf Suitenebene 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 müssen. Andernfalls „false“.

Returns
`boolean`