IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution


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. Configura 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 i problemi 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'attuale IConfiguration.

testInfo TestInformation: il TestInformation che detiene 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