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.

IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

Classi di sottoclasse indirette note

DelegatedInvocationExecution, InvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution` che delegano l'esecuzione a un altro file binario TradeFed.
InvocationExecution	Classe che descrive tutti i passaggi di chiamata: download della compilazione, preparazione del target, esecuzione dei test, pulizia.
ParentSandboxInvocationExecution	Versione di `InvocationExecution` per le azioni speciali di chiamata del chiamante quando viene eseguita una sandbox.
RemoteInvocationExecution	Implementazione di `InvocationExecution` che gestisce un'esecuzione remota.
SandboxedInvocationExecution	Esecuzione speciale della sandbox dell'invocazione: si tratta di InvocationExection quando siamo all'interno della sandbox che esegue il comando.

Interfaccia che descrive le azioni che verranno eseguite nell'ambito di un'invocazione. 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 di target_preparer e multi_target_preparer.
`default void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger)` Esegui il passaggio di configurazione di target_preparer e multi_target_preparer.
`default void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Esegui il passaggio di smantellamento 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)` Genera report su alcuni log del dispositivo in fasi diverse 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)` Prova a suddividere la configurazione in sottoconfigurazioni, da riprogrammare per l'esecuzione su più risorse in parallelo.

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` della chiamata.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.

doCleanUp

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

Esegui il passaggio di pulizia di target_preparer e multi_target_preparer. I dispositivi si ripuliscono.

Parametri
`context`	`IInvocationContext`: il `IInvocationContext` della chiamata.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.
`exception`	`Throwable`: l'eccezione originale lanciata dal test in esecuzione.

doSetup

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

Esegui il passaggio di configurazione di target_preparer e multi_target_preparer. Sono stati configurati tutti i dispositivi necessari per l'esecuzione del test.

Parametri
`testInfo`	`TestInformation`: il `TestInformation` della chiamata.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.
`logger`	`ITestLogger`: il `ITestLogger` per segnalare i log relativi agli errori di configurazione.

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

doTeardown

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

Esegui il passaggio di smantellamento di target_preparer e multi_target_preparer. I dispositivi associati alla configurazione vengono ritirati?

Parametri
`testInfo`	`TestInformation`: il `TestInformation` della chiamata.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.
`logger`	`ITestLogger`: il `ITestLogger` per generare i log.
`exception`	`Throwable`: l'eccezione originale lanciata dal test in esecuzione.

Lanci
	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` della chiamata.
`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.

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

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

reportLogs

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

Genera report su alcuni log del dispositivo in fasi diverse dell'invocazione. Ad esempio: logcat.

Parametri
`device`	`ITestDevice`: il dispositivo da cui generare 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` della chiamata.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.
`exception`	`Throwable`: l'eventuale eccezione originale lanciata dal test in esecuzione.

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` della chiamata.
`config`	`IConfiguration`: il `IConfiguration` di questa esecuzione di test.
`logger`	`ITestLogger`: il `ITestLogger` per generare i log.

Lanci
	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

Lanci
	Throwable

shardConfig

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

Prova a suddividere la configurazione in sottoconfigurazioni, da riprogrammare per l'esecuzione su più risorse in parallelo.

Se il numero di shard è maggiore di 1, verranno semplicemente create le configurazioni per ogni shard impostando gli indici dei shard e riprogrammandoli. Se non è impostato un numero di shard,verrà utilizzato il valore IShardHelper.shardConfig.

Parametri
`config`	`IConfiguration`: l'`IConfiguration` corrente.
`testInfo`	`TestInformation`: il `TestInformation` che contiene le informazioni sui test.
`rescheduler`	`IRescheduler`: il `IRescheduler`.
`logger`	`ITestLogger`: `ITestLogger` utilizzato per registrare il file durante lo sharding.

Ritorni
`boolean`	true se il test è stato suddiviso in parti. In caso contrario, restituisce `false`