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 dient als Hilfsmittel zum Vorbereiten und Ausführen 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 in der Regel 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 wird.
`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, 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, falls 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`	`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.
`void`	`setReportModuleEnd(boolean shouldReportModuleEnd)`
`void`	`setReportModuleStart(boolean shouldReportModuleStart)`
`final void`	`setRetryDecision(IRetryDecision decision)` Legt den Wert für `IRetryDecision` fest, der für den internen Wiederholungsversuch verwendet werden soll.
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`boolean`	`shouldRecoverVirtualDevice()` Gibt zurück, ob wir das virtuelle Gerät wiederherstellen sollen.
`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

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

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

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

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

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_TIME

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

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

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)

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

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

Homerun

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                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.
`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, falls angegeben.

Parameter
`includeSuitePreparers`	`boolean`: Legen Sie diesen Wert auf `true` fest, um auch Vorbereiter auf Suite-Ebene auszuführen.

Returns
`Throwable`	`Throwable` einer Ausnahme, die beim Ausführen von Vorbereitern 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`

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`

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Sets sollten das virtuelle Gerät wiederherstellen.

Parameter
`recoverVirtualDevice`	`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 den Wert für IRetryDecision fest, der für den internen Wiederholungsversuch verwendet werden soll.

Parameter
`decision`	`IRetryDecision`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Parameter
`useModuleResultsForwarder`	`boolean`

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Gibt zurück, ob wir das virtuelle Gerät wiederherstellen sollen.

Returns
`boolean`

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`