A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

Sottoclassi indirette note

DelegatedInvocationExecution, InvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution` che delegano l'esecuzione a un altro binario Tradefed.
InvocationExecution	Classe che descrive tutti i passaggi di invocazione: download della build, target_prep, esecuzione dei test, liberare spazio.
ParentSandboxInvocationExecution	Versione di `InvocationExecution` per le azioni speciali di chiamata principale durante l'esecuzione di una sandbox.
RemoteInvocationExecution	Implementazione di `InvocationExecution` che gestisce un'esecuzione remota.
SandboxedInvocationExecution	Esecuzione speciale della sandbox dell'invocazione: si tratta di InvocationExection per quando ci troviamo all'interno della sandbox che esegue il comando.

Interfaccia che descrive le azioni che verranno eseguite nell'ambito di una chiamata. L'invocazione TestInvocation stessa garantisce l'ordine delle chiamate.

Riepilogo

Metodi pubblici
`default void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Esegui il passaggio di pulizia build_provider.
`default void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` Esegui il passaggio di pulizia target_preparer e multi_target_preparer.
`default void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger)` Esegui il passaggio di configurazione target_preparer e multi_target_preparer.
`default void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Esegui il passaggio di smontaggio di target_preparer e multi_target_preparer.
`default boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Esegui il passaggio build_provider dell'invocazione.
`abstract void`	`reportLogs(ITestDevice device, ITestLogger logger, TestInvocation.Stage stage)` Segnala alcuni log del dispositivo in diverse fasi dell'invocazione.
`default void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Richiama `ITestDevice.postInvocationTearDown(Throwable)` per ogni parte del dispositivo dell'invocazione.
`default void`	`runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)` Richiama `ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo))` per ogni parte del dispositivo dell'invocazione.
`default void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Esegue il test.
`default boolean`	`shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` Tenta di suddividere la configurazione in sottoconfigurazioni da riprogrammare per l'esecuzione in parallelo su più risorse.

Metodi pubblici

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Esegui il passaggio di pulizia build_provider. Associato al recupero della build.

Parametri
`context`	`IInvocationContext`: il `IInvocationContext` dell'invocazione.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.

doCleanUp

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Esegui il passaggio di pulizia target_preparer e multi_target_preparer. Does the devices clean up.

Parametri
`context`	`IInvocationContext`: il `IInvocationContext` dell'invocazione.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.
`exception`	`Throwable`: l'eccezione originale generata dall'esecuzione del test.

doSetup

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger)

Esegui il passaggio di configurazione target_preparer e multi_target_preparer. Esegue tutta la configurazione dei dispositivi necessaria per l'esecuzione del test.

Parametri
`testInfo`	`TestInformation`: il `TestInformation` dell'invocazione.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.
`logger`	`ITestLogger`: il `ITestLogger` per segnalare i log degli errori di configurazione.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.targetprep.TargetSetupError
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

Esegui il passaggio di smontaggio di target_preparer e multi_target_preparer. Smontaggio dei dispositivi associati alla configurazione.

Parametri
`testInfo`	`TestInformation`: il `TestInformation` dell'invocazione.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.
`logger`	`ITestLogger`: il `ITestLogger` per segnalare i log.
`exception`	`Throwable`: l'eccezione originale generata dall'esecuzione del test.

Genera
	java.lang.Throwable
`Throwable`

fetchBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

Esegui il passaggio build_provider dell'invocazione.

Parametri
`testInfo`	`TestInformation`: il `TestInformation` dell'invocazione.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.
`rescheduler`	`IRescheduler`: il `IRescheduler`, per riprogrammare parti dell'invocazione per l'esecuzione su altre risorse
`listener`	`ITestInvocationListener`: il `ITestInvocation` per segnalare gli errori di download della build.

Resi
`boolean`	Vero se abbiamo scaricato correttamente la build, falso in caso contrario.

Genera
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.device.DeviceNotAvailableException
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

public abstract void reportLogs (ITestDevice device, 
                ITestLogger logger, 
                TestInvocation.Stage stage)

Segnala alcuni log del dispositivo in diverse fasi dell'invocazione. Ad esempio: logcat.

Parametri
`device`	`ITestDevice`: il dispositivo da cui segnalare i log.
`logger`	`ITestLogger`: il logger per i log.
`stage`	`TestInvocation.Stage`: la fase dell'invocazione in cui ci troviamo.

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Richiama ITestDevice.postInvocationTearDown(Throwable) per ogni parte del dispositivo dell'invocazione.

Parametri
`context`	`IInvocationContext`: il `IInvocationContext` dell'invocazione.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.
`exception`	`Throwable`: l'eccezione originale generata dall'esecuzione del test, se presente.

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

Richiama ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) per ogni parte del dispositivo dell'invocazione.

Parametri
`context`	`IInvocationContext`: il `IInvocationContext` dell'invocazione.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.
`logger`	`ITestLogger`: il `ITestLogger` per segnalare i log.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`

runTests

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

Esegue il test.

Parametri
`info`	`TestInformation`: il `TestInformation` con cui eseguire i test.
`config`	`IConfiguration`: il `IConfiguration` da eseguire
`listener`	`ITestInvocationListener`: il `ITestInvocationListener` dei risultati del test

Genera
	java.lang.Throwable
`Throwable`

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

Tenta di suddividere la configurazione in sottoconfigurazioni da riprogrammare per l'esecuzione in parallelo su più risorse.

Se il conteggio degli shard è maggiore di 1, verranno create configurazioni per ogni shard impostando gli indici degli shard e riprogrammandoli. Se non viene impostato un conteggio di shard,verrà utilizzato il valore predefinito IShardHelper.shardConfig.

Parametri
`config`	`IConfiguration`: il `IConfiguration` attuale.
`testInfo`	`TestInformation`: il `TestInformation` contenente le informazioni dei test.
`rescheduler`	`IRescheduler`: il `IRescheduler`.
`logger`	`ITestLogger`: `ITestLogger` utilizzato per il file di log durante lo sharding.

Resi
`boolean`	true se il test è stato suddiviso in shard. In caso contrario, restituisci `false`