A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi Modifiche ad AOSP.

InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
↳	com.android.tradefed.invoker.InvocationExecution

Sottoclassi dirette note

DelegatedInvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution` che delegano l'esecuzione a un altro binario Tradefed.
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.

Classe che descrive tutti i passaggi di chiamata: download della build, target_prep, esecuzione dei test, pulizia. Può essere esteso per ignorare il comportamento predefinito di alcuni passaggi. L'ordine dei passaggi è determinato da TestInvocation.

Riepilogo

Costanti
`String`	`ADB_VERSION_KEY`
`String`	`JAVA_CLASSPATH_KEY`
`String`	`JAVA_VERSION_KEY`

Costruttori pubblici
`InvocationExecution()`

Metodi pubblici
`void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Esegui il passaggio di pulizia build_provider.
`void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` Esegui il passaggio di pulizia target_preparer e multi_target_preparer.
`void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)` Esegui il passaggio di configurazione target_preparer e multi_target_preparer.
`void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Esegui il passaggio di smontaggio di target_preparer e multi_target_preparer.
`boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Esegui il passaggio build_provider dell'invocazione.
`void`	`reportLogs(ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)` Report some device logs at different stage of the invocation.
`void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Richiama `ITestDevice.postInvocationTearDown(Throwable)` per ogni parte del dispositivo dell'invocazione.
`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.
`void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Esegue il test.
`boolean`	`shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` Tenta di suddividere la configurazione in sottoconfigurazioni, da riprogrammare per l'esecuzione su più risorse in parallelo.

Metodi protetti
`void`	`collectAutoInfo(IConfiguration config, TestInformation info)` Raccogliere automaticamente alcune informazioni sul dispositivo principale in fase di test.
`IShardHelper`	`createShardHelper()` Crea e restituisci il `IShardHelper` da utilizzare.
`void`	`customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)` Offri la possibilità di personalizzare alcuni aspetti del dispositivo prima di preInvocationSetup.
`String`	`getAdbVersion()` Restituisce la versione di adb in uso per la chiamata.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` Recupera un elenco di preparatori di lab da eseguire su questo dispositivo.
	`getTargetPreparersToRun(IConfiguration config, String deviceName)` Recupera un elenco di preparatori di target da eseguire su questo dispositivo.
`void`	`linkExternalDirs(IBuildInfo info, TestInformation testInfo)`
`void`	`logHostAdb(IConfiguration config, ITestLogger logger)` Raccogli i log da $TMPDIR/adb.$UID.log.
`Throwable`	`runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)`
`void`	`setTestTag(IBuildInfo info, IConfiguration config)` Gestisci l'impostazione del tag di test nelle informazioni sulla build.

Costanti

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

Valore costante: "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

Constant Value: "java_classpath"

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Constant Value: "java_version"

Costruttori pubblici

InvocationExecution

public InvocationExecution ()

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 listener)

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.
`listener`	`ITestLogger`: il `ITestLogger` per segnalare i log degli errori di configurazione.

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

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.

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

Lanci
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

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

Report some device logs at different stage of the invocation. Ad esempio: logcat.

Parametri
`device`	`ITestDevice`: Il dispositivo da cui segnalare i log.
`listener`	`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.

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

shardConfig

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

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

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`: l'`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.

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

Metodi protetti

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Raccogliere automaticamente alcune informazioni sul dispositivo principale in fase di test.

Parametri
`config`	`IConfiguration`
`info`	`TestInformation`

Lanci
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

Crea e restituisci il IShardHelper da utilizzare.

Ritorni
`IShardHelper`

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Offri la possibilità di personalizzare alcuni aspetti del dispositivo prima di preInvocationSetup.

Parametri
`config`	`IConfiguration`: La configurazione dell'invocazione.
`context`	`IInvocationContext`: Il contesto di chiamata corrente.

getAdbVersion

protected String getAdbVersion ()

Restituisce la versione di adb in uso per la chiamata.

Ritorni
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Recupera un elenco di preparatori di lab da eseguire su questo dispositivo.

Eseguito l'override nelle classi sandbox per impedire l'esecuzione dei preparatori di lab all'interno del figlio sandbox

Parametri
`config`	`IConfiguration`
`deviceName`	`String`

Ritorni

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Recupera un elenco di preparatori di target da eseguire su questo dispositivo.

Eseguito l'override nelle classi sandbox per impedire l'esecuzione dei preparatori di lab all'interno della sandbox figlio

Parametri
`config`	`IConfiguration`
`deviceName`	`String`

Ritorni

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

Parametri
`info`	`IBuildInfo`
`testInfo`	`TestInformation`

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Raccogli i log da $TMPDIR/adb.$UID.log.

Parametri
`config`	`IConfiguration`
`logger`	`ITestLogger`

runPreparersTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun, 
                 trackPreparersMap)

Parametri
`testInfo`	`TestInformation`
`device`	`ITestDevice`
`deviceName`	`String`
`deviceIndex`	`int`
`logger`	`ITestLogger`
`exception`	`Throwable`
`preparersToRun`
`trackPreparersMap`

Ritorni
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Gestisci l'impostazione del tag di test nelle informazioni sulla build.

Parametri
`info`	`IBuildInfo`
`config`	`IConfiguration`