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.

ITestSuite

public abstract class ITestSuite
extends Object implements IRemoteTest, IDeviceTest, IBuildReceiver, ISystemStatusCheckerReceiver, IShardableTest, ITestCollector, IInvocationContextReceiver, IRuntimeHintProvider, IMetricCollectorReceiver, IConfigurationReceiver, IReportNotExecuted, ITokenRequest, ITestLoggerReceiver

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

Classi di sottoclasse dirette note

BaseTestSuite, TfSuiteRunner

BaseTestSuite	Un test per eseguire Compatibility Test Suite con il nuovo sistema di suite.
TfSuiteRunner	Implementazione di `ITestSuite` che caricherà i test dalle cartelle res/config/suite/ dei jar TF.

Classi di sottoclasse indirette note

TestMappingSuiteRunner

TestMappingSuiteRunner Implementazione di BaseTestSuite per eseguire i test specificati dall'opzione include-filter o i file TEST_MAPPING dalla compilazione, come suite.

Classe astratta utilizzata per eseguire la suite di test. Questo corso fornisce le basi per l'esecuzione della suite. Ogni implementazione può definire l'elenco dei test tramite il metodo loadTests().

Riepilogo

Campi
`public static final String`	`ABI_OPTION`
`public static final String`	`ACTIVE_MAINLINE_PARAMETER_KEY`
`public static final String`	`MAINLINE_PARAMETER_KEY`
`public static final String`	`MODULE_CHECKER_POST`
`public static final String`	`MODULE_CHECKER_PRE`
`public static final String`	`MODULE_METADATA_EXCLUDE_FILTER`
`public static final String`	`MODULE_METADATA_INCLUDE_FILTER`
`public static final String`	`PARAMETER_KEY`
`public static final String`	`PREPARER_WHITELIST`
`public static final String`	`PRIMARY_ABI_RUN`
`public static final String`	`RANDOM_SEED`
`public static final String`	`REBOOT_BEFORE_TEST`
`public static final String`	`RUNNER_WHITELIST`
`public static final String`	`SKIP_HOST_ARCH_CHECK`
`public static final String`	`SKIP_SYSTEM_STATUS_CHECKER`
`public static final String`	`TOKEN_KEY`

Costruttori pubblici
`ITestSuite()`

Metodi pubblici
`void`	`addModuleMetadataExcludeFilters(MultiMap<String, String> filters)`
`void`	`addModuleMetadataIncludeFilters(MultiMap<String, String> filters)`
`final void`	`enableRebootBeforeTest()` Imposta reboot-before-test su true.
	`getAbis(ITestDevice device)` Recupera l'insieme di ABI supportati sia dai test di compatibilità `AbiUtils.getAbisSupportedByCompatibility()` sia dal dispositivo in test.
`static`	`getAbisForBuildTargetArchFromSuite()` Restituisce i possibili abis da TestSuiteInfo.
`IBuildInfo`	`getBuildInfo()` L'implementazione di `ITestSuite` potrebbe richiedere le informazioni di compilazione per caricare i test.
`final IConfiguration`	`getConfiguration()` Restituisce l'invocazione `IConfiguration`.
`ITestLogger`	`getCurrentTestLogger()`
`ITestDevice`	`getDevice()` Ottieni il dispositivo di test.
`ModuleDefinition`	`getDirectModule()` Restituisce il `ModuleDefinition` da eseguire direttamente o null se non è ancora presente (quando ITestSuite non è ancora stato suddiviso in parti).
`IInvocationContext`	`getInvocationContext()` Restituisce il contesto di chiamata.
`final String`	`getRequestedAbi()` Restituisce l'abi richiesto con l'opzione -a o --abi.
	`getRequiredTokens()`
`long`	`getRuntimeHint()` Restituisce il tempo di esecuzione previsto del test in millisecondi.
`File`	`getTestsDir()`
`boolean`	`isSplitting()` Restituisce true se siamo attualmente in `IShardableTest.split(int)`.
`abstract`	`loadTests()` Metodo astratto per caricare la configurazione dei test che verranno eseguiti.
`void`	`reportNotExecuted(ITestInvocationListener listener, String message)` Segnala i test non eseguiti all'ascoltatore principale fornito.
`void`	`reportNotExecuted(ITestInvocationListener listener)` Segnala i test non eseguiti all'ascoltatore principale fornito.
`final void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Metodo di esecuzione generico per tutti i test caricati da `loadTests()`.
`void`	`setAbiName(String abiName)` Imposta il valore di mAbiName
`final void`	`setAbis( abis)`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Esegui la suite di test in modalità solo collettore, il che richiede che anche tutti i sottotest implementino questa interfaccia.
`void`	`setConfiguration(IConfiguration configuration)` Invia il `IConfiguration` in uso.
`void`	`setDevice(ITestDevice device)` Esegui l'iniezione del dispositivo di test.
`void`	`setInvocationContext(IInvocationContext invocationContext)`
`void`	`setInvocationInjector(Injector injector)` Recupera l'attuale `Injector` Guice dall'invocazione.
`void`	`setMetricCollectors( collectors)` Imposta l'elenco di `IMetricCollector` definiti per l'esecuzione del test.
`void`	`setPrimaryAbiRun(boolean primaryAbiRun)` Imposta il valore di mPrimaryAbiRun
`void`	`setShouldMakeDynamicModule(boolean dynamicModule)` Quando eseguiamo lo sharding distribuito, non possiamo avere ModuleDefinition che condivide i test in un pool, altrimenti lo sharding intra-modulo non funzionerà, quindi consentiamo di disattivarlo.
`void`	`setSystemStatusChecker( systemCheckers)` Imposta i `ISystemStatusChecker` dalla configurazione per il test.
`void`	`setTestLogger(ITestLogger testLogger)`
	`split(Integer shardCountHint, TestInformation testInfo)` Versione alternativa di `split(int)` che fornisce anche un `TestInformation` che contiene informazioni iniziali del proprietario che crea gli shard.

Metodi protetti
	`createModuleListeners()` Restituisce l'elenco di `ITestInvocationListener` applicabili al livello `ModuleListener`.
`boolean`	`filterByConfigMetadata(IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)` Applica il filtro dei metadati alla configurazione e controlla se deve essere eseguita.
`boolean`	`filterByRunnerType(IConfiguration config, allowedRunners)` Applica il filtro della lista consentita dei runner, rimuovendo tutti i runner non inclusi nella lista.
	`getAbisForBuildTargetArch()` Restituisce gli ABI supportati dall'architettura di destinazione della compilazione dell'host.
	`getHostAbis()` Restituisce gli abis della macchina host.
`boolean`	`shouldModuleRun(ModuleDefinition module)`

Campi

ABI_OPTION

public static final String ABI_OPTION

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

PARAMETER_KEY

public static final String PARAMETER_KEY

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

RANDOM_SEED

public static final String RANDOM_SEED

REBOOT_BEFORE_TEST

public static final String REBOOT_BEFORE_TEST

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TOKEN_KEY

public static final String TOKEN_KEY

Costruttori pubblici

ITestSuite

public ITestSuite ()

Metodi pubblici

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

Parametri
`filters`	`MultiMap`

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

Parametri
`filters`	`MultiMap`

enableRebootBeforeTest

public final void enableRebootBeforeTest ()

Imposta reboot-before-test su true.

getAbis

public  getAbis (ITestDevice device)

Recupera l'insieme di ABI supportati sia dai test di compatibilità AbiUtils.getAbisSupportedByCompatibility() sia dal dispositivo in test.

Parametri
`device`	`ITestDevice`

Ritorni
	L'insieme di ABI su cui eseguire i test

Lanci
`DeviceNotAvailableException`

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Restituisce i possibili abis da TestSuiteInfo.

Ritorni

getBuildInfo

public IBuildInfo getBuildInfo ()

L'implementazione di ITestSuite potrebbe richiedere le informazioni di compilazione per caricare i test.

Ritorni
`IBuildInfo`

getConfiguration

public final IConfiguration getConfiguration ()

Restituisce l'invocazione IConfiguration.

Ritorni
`IConfiguration`

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

Ritorni
`ITestLogger`

getDevice

public ITestDevice getDevice ()

Ottieni il dispositivo di test.

Ritorni
`ITestDevice`	`ITestDevice`

getDirectModule

public ModuleDefinition getDirectModule ()

Restituisce il ModuleDefinition da eseguire direttamente o null se non è ancora presente (quando ITestSuite non è ancora stato suddiviso in parti).

Ritorni
`ModuleDefinition`

getInvocationContext

public IInvocationContext getInvocationContext ()

Restituisce il contesto di chiamata.

Ritorni
`IInvocationContext`

getRequestedAbi

public final String getRequestedAbi ()

Restituisce l'abi richiesto con l'opzione -a o --abi.

Ritorni
`String`

getRequiredTokens

public  getRequiredTokens ()

Ritorni

getRuntimeHint

public long getRuntimeHint ()

Restituisce il tempo di esecuzione previsto del test in millisecondi. Il tempo viene utilizzato per bilanciare il carico dell'esecuzione suddivisa in parti

Ritorni
`long`

getTestsDir

public File getTestsDir ()

Ritorni
`File`

isSplitting

public boolean isSplitting ()

Restituisce true se siamo attualmente in IShardableTest.split(int).

Ritorni
`boolean`

loadTests

public abstract  loadTests ()

Metodo astratto per caricare la configurazione dei test che verranno eseguiti. Ogni test è definito da un IConfiguration e da un nome univoco sotto il quale verranno riportati i risultati.

Ritorni

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Segnala i test non eseguiti all'ascoltatore principale fornito. Devono essere segnalati come non riusciti con il messaggio NOT_EXECUTED_FAILURE.

Parametri
`listener`	`ITestInvocationListener`: l'ascoltatore principale a cui segnalare i risultati non eseguiti.
`message`	`String`: il messaggio da associare all'errore di mancata esecuzione.

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

Segnala i test non eseguiti all'ascoltatore principale fornito. Devono essere segnalati come non riusciti con il messaggio NOT_EXECUTED_FAILURE.

Parametri
`listener`	`ITestInvocationListener`: l'ascoltatore principale a cui segnalare i risultati non eseguiti.

run

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Metodo di esecuzione generico per tutti i test caricati da loadTests().

Parametri
`testInfo`	`TestInformation`
`listener`	`ITestInvocationListener`

Lanci
`DeviceNotAvailableException`

setAbiName

public void setAbiName (String abiName)

Imposta il valore di mAbiName

Parametri
`abiName`	`String`

setAbis

public final void setAbis ( abis)

Parametri
`abis`

setBuild

public void setBuild (IBuildInfo buildInfo)

Parametri
`buildInfo`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Esegui la suite di test in modalità solo collettore, il che richiede che anche tutti i sottotest implementino questa interfaccia.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Invia il IConfiguration in uso.

Parametri
`configuration`	`IConfiguration`

setDevice

public void setDevice (ITestDevice device)

Esegui l'iniezione del dispositivo di test.

Parametri
`device`	`ITestDevice`: il `ITestDevice` da utilizzare

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parametri
`invocationContext`	`IInvocationContext`

setInvocationInjector

public void setInvocationInjector (Injector injector)

Recupera l'attuale Injector Guice dall'invocazione. Dovrebbe consentirci di continuare l'iniezione di oggetti dei moduli.

Parametri
`injector`	`Injector`

setMetricCollectors

public void setMetricCollectors ( collectors)

Imposta l'elenco di IMetricCollector definiti per l'esecuzione del test.

Parametri
`collectors`

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Imposta il valore di mPrimaryAbiRun

Parametri
`primaryAbiRun`	`boolean`

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

Quando eseguiamo lo sharding distribuito, non possiamo avere ModuleDefinition che condivide i test in un pool, altrimenti lo sharding intra-modulo non funzionerà, quindi consentiamo di disattivarlo.

Parametri
`dynamicModule`	`boolean`

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Imposta i ISystemStatusChecker dalla configurazione per il test.

Parametri
`systemCheckers`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Parametri
`testLogger`	`ITestLogger`

suddivisione

public  split (Integer shardCountHint, 
                TestInformation testInfo)

Versione alternativa di split(int) che fornisce anche un TestInformation che contiene informazioni iniziali del proprietario che crea gli shard. È utile se durante lo sharding è necessario accedere a informazioni come quelle relative al dispositivo o alla compilazione.

Parametri
`shardCountHint`	`Integer`: il numero di tentativi di shard.
`testInfo`	`TestInformation`: l'elemento principale `TestInformation`

Ritorni
	una raccolta di sottotesti da eseguire separatamente o `null` se il test non è attualmente suddivisibile in parti

Metodi protetti

createModuleListeners

protected  createModuleListeners ()

Restituisce l'elenco di ITestInvocationListener applicabili al livello ModuleListener. Questi ascoltatori verranno riutilizzati per ogni modulo, non verranno re-istanziati, quindi non devono assumere uno stato interno.

Ritorni

filterByConfigMetadata

protected boolean filterByConfigMetadata (IConfiguration config, 
                MultiMap<String, String> include, 
                MultiMap<String, String> exclude)

Applica il filtro dei metadati alla configurazione e controlla se deve essere eseguita.

Parametri
`config`	`IConfiguration`: il `IConfiguration` oggetto della valutazione.
`include`	`MultiMap`: il filtro include i metadati
`exclude`	`MultiMap`: il filtro di esclusione dei metadati

Ritorni
`boolean`	Vero se il modulo deve essere eseguito, falso in caso contrario.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Applica il filtro della lista consentita dei runner, rimuovendo tutti i runner non inclusi nella lista. Se una configurazione ha diversi runner, alcuni potrebbero essere rimossi e la configurazione verrà comunque eseguita.

Parametri
`config`	`IConfiguration`: il `IConfiguration` oggetto della valutazione.
`allowedRunners`	: la lista consentita attuale per i partecipanti.

Ritorni
`boolean`	Vero se il modulo di configurazione è consentito, falso in caso contrario.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Restituisce gli ABI supportati dall'architettura di destinazione della compilazione dell'host. Esposto per i test.

Ritorni

getHostAbis

protected  getHostAbis ()

Restituisce gli abis della macchina host.

Ritorni

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parametri
`module`	`ModuleDefinition`

Ritorni
`boolean`