A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

ModuleDefinition

public class ModuleDefinition
extends Object implements ITestCollector

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

Contenitore per la configurazione dell'esecuzione del test. Questa classe è un helper per preparare ed eseguire i test.

Riepilogo

Costanti
`String`	`ISOLATION_COST`
`String`	`MODULE_ABI`
`String`	`MODULE_CACHED` Questa proprietà è impostata su true se i risultati del modulo di test sono stati memorizzati nella cache.
`String`	`MODULE_CONTROLLER`
`String`	`MODULE_EXTERNAL_DEPENDENCIES`
`String`	`MODULE_ID` ID modulo: il nome che verrà utilizzato per identificare in modo univoco il modulo durante testRunStart.
`String`	`MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY`
`String`	`MODULE_ISOLATED` Questa proprietà è impostata su true se il modulo è stato eseguito su un dispositivo appena preparato.
`String`	`MODULE_NAME` Il nome del modulo è il nome di base associato al modulo, in genere derivato dal file di configurazione Xml TF da cui è stato caricato il modulo.
`String`	`MODULE_PARAMETERIZATION`
`String`	`MODULE_SKIPPED` Questa proprietà è impostata su true se il modulo di test è stato ignorato
`String`	`MODULE_TEST_COUNT`
`String`	`PREPARATION_TIME`
`String`	`RETRY_FAIL_COUNT`
`String`	`RETRY_SUCCESS_COUNT`
`String`	`RETRY_TIME`
`String`	`SPARSE_MODULE` Questa proprietà è impostata su true se vengono segnalati solo eventi a livello di modulo.
`String`	`TEAR_DOWN_TIME`
`String`	`TEST_TIME`

Costruttori pubblici
`ModuleDefinition()`
`ModuleDefinition(String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` Costruttore
`ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` Costruttore

Metodi pubblici
`int`	`compareTo(ModuleDefinition moduleDef)`
`String`	`getId()` Restituisce il nome univoco del modulo.
`Integer`	`getIntraModuleShardCount()`
`Integer`	`getIntraModuleShardIndex()`
`IConfiguration`	`getModuleConfiguration()`
`IInvocationContext`	`getModuleInvocationContext()` Restituisce il `IInvocationContext` associato al modulo.
`TestInformation`	`getModuleTestInformation()`
	`getRequiredTokens(TestInformation testInfo)`
`long`	`getRuntimeHint()` Restituisce il tempo approssimativo per eseguire tutti i test nel modulo.
`boolean`	`hasModuleFailed()` Restituisce True se è stato chiamato un testRunFailure sul modulo *
`int`	`neededDevices()` Restituisce il numero di dispositivi che dovrebbero eseguire questo test.
`int`	`numTests()` Restituisce il numero attuale di `IRemoteTest` in attesa di esecuzione.
`final void`	`reportNotExecuted(ITestInvocationListener listener, String message)` Report sui moduli non eseguiti completamente.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, int maxRunLimit)` Esegui tutti i `IRemoteTest` contenuti nel modulo e utilizza tutti i preparatori prima e dopo per configurare e pulire il dispositivo.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener)` Esegui tutti i `IRemoteTest` contenuti nel modulo e utilizza tutti i preparatori prima e dopo per configurare e pulire il dispositivo.
`Throwable`	`runPreparation(boolean includeSuitePreparers)` Esegui i preparatori del test, inclusi quelli a livello di suite, se specificati.
`void`	`setBuild(IBuildInfo build)` Inserisci `IBuildInfo` da utilizzare durante i test.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Attiva o disattiva la modalità di raccolta dei test
`void`	`setDevice(ITestDevice device)` Inserisci `ITestDevice` da utilizzare durante i test.
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` Se attivare o meno il download dinamico a livello di modulo.
`void`	`setIntraModuleInformation(int shardCount, int shardIndex)`
`void`	`setLogSaver(ILogSaver logSaver)` Passa il salvataggio dei log di invocazione al modulo in modo che possa utilizzarlo se necessario.
`final void`	`setMergeAttemps(boolean mergeAttempts)` Determina se unire o meno i risultati.
`void`	`setMetricCollectors( collectors)` Inserisci l'elenco di `IMetricCollector` da utilizzare nel modulo.
`void`	`setRecoverVirtualDevice(boolean recoverVirtualDevice)` I set devono recuperare il dispositivo virtuale.
`void`	`setRemoveModuleBuffering(boolean removeModuleBuffering)`
`void`	`setReportModuleEnd(boolean shouldReportModuleEnd)`
`void`	`setReportModuleStart(boolean shouldReportModuleStart)`
`final void`	`setRetryDecision(IRetryDecision decision)` Imposta il valore di `IRetryDecision` da utilizzare per il nuovo tentativo all'interno del modulo.
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`boolean`	`shouldRecoverVirtualDevice()` Indica se dobbiamo recuperare il dispositivo virtuale.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` Copia alcune configurazioni a livello di suite

Metodi protetti
`boolean`	`hasTests()` Restituisce True se il modulo ha ancora `IRemoteTest` da eseguire nel suo pool.

Costanti

ISOLATION_COST

public static final String ISOLATION_COST

Constant Value: "ISOLATION_COST"

MODULE_ABI

public static final String MODULE_ABI

Constant Value: "module-abi"

MODULE_CACHED

public static final String MODULE_CACHED

Questa proprietà è impostata su true se i risultati del modulo di test sono stati memorizzati nella cache.

Valore costante: "module-cached"

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

Constant Value: "module_controller"

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

Constant Value: "module-external-dependencies"

MODULE_ID

public static final String MODULE_ID

ID modulo: il nome che verrà utilizzato per identificare in modo univoco il modulo durante testRunStart. Di solito è una combinazione di MODULE_ABI + MODULE_NAME.

Valore costante: "module-id"

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

Valore costante: "module-flag-overrides"

MODULE_ISOLATED

public static final String MODULE_ISOLATED

Questa proprietà è impostata su true se il modulo è stato eseguito su un dispositivo appena preparato.

Constant Value: "module-isolated"

MODULE_NAME

public static final String MODULE_NAME

Il nome del modulo è il nome di base associato al modulo, in genere derivato dal file di configurazione Xml TF da cui è stato caricato il modulo.

Valore costante: "module-name"

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

Constant Value: "module-param"

MODULE_SKIPPED

public static final String MODULE_SKIPPED

Questa proprietà è impostata su true se il modulo di test è stato ignorato

Constant Value: "module-skipped"

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

Valore costante: "MODULE_TEST_COUNT"

PREPARATION_TIME

public static final String PREPARATION_TIME

Constant Value: "PREP_TIME"

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

Valore costante: "MODULE_RETRY_FAILED"

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

Valore costante: "MODULE_RETRY_SUCCESS"

RETRY_TIME

public static final String RETRY_TIME

Valore costante: "MODULE_RETRY_TIME"

SPARSE_MODULE

public static final String SPARSE_MODULE

Questa proprietà è impostata su true se vengono segnalati solo eventi a livello di modulo.

Constant Value: "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

Constant Value: "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

Valore costante: "TEST_TIME"

Costruttori pubblici

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

Costruttore

Parametri
`name`	`String`: nome univoco della configurazione di test.
`tests`	: elenco di `IRemoteTest` da eseguire.
`preparersPerDevice`	: elenco di `ITargetPreparer` da utilizzare per configurare il dispositivo.
`multiPreparers`
`moduleConfig`	`IConfiguration`: il `IConfiguration` della configurazione del modulo sottostante.

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 suitePreparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

Costruttore

Parametri
`name`	`String`: nome univoco della configurazione di test.
`tests`	: elenco di `IRemoteTest` da eseguire.
`preparersPerDevice`	: elenco di `ITargetPreparer` da utilizzare per configurare il dispositivo.
`suitePreparersPerDevice`
`multiPreparers`
`moduleConfig`	`IConfiguration`: il `IConfiguration` della configurazione del modulo sottostante.

Metodi pubblici

compareTo

public int compareTo (ModuleDefinition moduleDef)

Parametri
`moduleDef`	`ModuleDefinition`

Ritorni
`int`

getId

public String getId ()

Restituisce il nome univoco del modulo.

Ritorni
`String`

getIntraModuleShardCount

public Integer getIntraModuleShardCount ()

Ritorni
`Integer`

getIntraModuleShardIndex

public Integer getIntraModuleShardIndex ()

Ritorni
`Integer`

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

Ritorni
`IConfiguration`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Restituisce il IInvocationContext associato al modulo.

Ritorni
`IInvocationContext`

getModuleTestInformation

public TestInformation getModuleTestInformation ()

Ritorni
`TestInformation`

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Parametri
`testInfo`	`TestInformation`

Ritorni

getRuntimeHint

public long getRuntimeHint ()

Restituisce il tempo approssimativo per eseguire tutti i test nel modulo.

Ritorni
`long`

hasModuleFailed

public boolean hasModuleFailed ()

Restituisce True se è stato chiamato un testRunFailure sul modulo *

Ritorni
`boolean`

neededDevices

public int neededDevices ()

Restituisce il numero di dispositivi che dovrebbero eseguire questo test.

Ritorni
`int`

numTest

public int numTests ()

Restituisce il numero attuale di IRemoteTest in attesa di esecuzione.

Ritorni
`int`

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Report sui moduli non eseguiti completamente.

Parametri
`listener`	`ITestInvocationListener`
`message`	`String`

run

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

Esegui tutti i IRemoteTest contenuti nel modulo e utilizza tutti i preparatori prima e dopo per configurare e pulire il dispositivo.

Parametri
`moduleInfo`	`TestInformation`: il `TestInformation` per il modulo.
`listener`	`ITestInvocationListener`: il `ITestInvocationListener` in cui segnalare i risultati.
`maxRunLimit`	`int`: il numero massimo di esecuzioni per ogni caso di test.

Lanci
`DeviceNotAvailableException`	in caso di dispositivo offline.

run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

Esegui tutti i IRemoteTest contenuti nel modulo e utilizza tutti i preparatori prima e dopo per configurare e pulire il dispositivo.

Parametri
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: il `ITestInvocationListener` in cui segnalare i risultati.

Lanci
`DeviceNotAvailableException`	in caso di dispositivo offline.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Esegui i preparatori del test, inclusi quelli a livello di suite, se specificati.

Parametri
`includeSuitePreparers`	`boolean`: impostalo su `true` per eseguire anche i preparatori a livello di suite.

Ritorni
`Throwable`	`Throwable` di qualsiasi eccezione generata durante l'esecuzione dei preparatori.

setBuild

public void setBuild (IBuildInfo build)

Inserisci IBuildInfo da utilizzare durante i test.

Parametri
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Attiva o disattiva la modalità di raccolta dei test

setDevice

public void setDevice (ITestDevice device)

Inserisci ITestDevice da utilizzare durante i test.

Parametri
`device`	`ITestDevice`

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Se attivare o meno il download dinamico a livello di modulo.

Parametri
`enableDynamicDownload`	`boolean`

setIntraModuleInformation

public void setIntraModuleInformation (int shardCount, 
                int shardIndex)

Parametri
`shardCount`	`int`
`shardIndex`	`int`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Passa il salvataggio dei log di invocazione al modulo in modo che possa utilizzarlo se necessario.

Parametri
`logSaver`	`ILogSaver`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Determina se unire o meno i risultati.

Parametri
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors ( collectors)

Inserisci l'elenco di IMetricCollector da utilizzare nel modulo.

Parametri
`collectors`

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

I set devono recuperare il dispositivo virtuale.

Parametri
`recoverVirtualDevice`	`boolean`

setRemoveModuleBuffering

public void setRemoveModuleBuffering (boolean removeModuleBuffering)

Parametri
`removeModuleBuffering`	`boolean`

setReportModuleEnd

public void setReportModuleEnd (boolean shouldReportModuleEnd)

Parametri
`shouldReportModuleEnd`	`boolean`

setReportModuleStart

public void setReportModuleStart (boolean shouldReportModuleStart)

Parametri
`shouldReportModuleStart`	`boolean`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Imposta il valore di IRetryDecision da utilizzare per il nuovo tentativo all'interno del modulo.

Parametri
`decision`	`IRetryDecision`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Parametri
`useModuleResultsForwarder`	`boolean`

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Indica se dobbiamo recuperare il dispositivo virtuale.

Ritorni
`boolean`

toString

public String toString ()

Ritorni
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Copia alcune configurazioni a livello di suite

Parametri
`mSuiteConfiguration`	`IConfiguration`

Metodi protetti

hasTests

protected boolean hasTests ()

Restituisce True se il modulo ha ancora IRemoteTest da eseguire nel suo pool. Falso negli altri casi.

Ritorni
`boolean`