Esecuzione dell'invocazione

public class InvocationExecution
extends Object implements IInvocationExecution

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


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

Riepilogo

Campi

public static final String ADB_VERSION_KEY

public static final String JAVA_CLASSPATH_KEY

public static final 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)

Eseguire il passaggio di pulizia target_preparer e multi_target_preparer.

void doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener)

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

Segnala alcuni log del dispositivo in diverse fasi della chiamata.

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

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

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

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

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

Metodi protetti

void collectAutoInfo ( IConfiguration config, TestInformation info)

Raccoglie automaticamente alcune informazioni sul dispositivo primario in prova.

IShardHelper createShardHelper ()

Crea un ritorno IShardHelper da utilizzare.

void customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)

Dare la possibilità di personalizzare parte del dispositivo prima della preInvocationSetup.

String getAdbVersion ()

Restituisce la versione adb in uso per l'invocazione.

getLabPreparersToRun ( IConfiguration config, String deviceName)

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

getTargetPreparersToRun ( IConfiguration config, String deviceName)

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

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) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) 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 test nelle informazioni sulla build.

Campi

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Costruttori pubblici

Esecuzione dell'invocazione

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 : l' IInvocationContext dell'invocazione.

config IConfiguration : la IConfiguration di questa esecuzione di test.

doCleanUp

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

Eseguire il passaggio di pulizia target_preparer e multi_target_preparer. I dispositivi vengono puliti.

Parametri
context IInvocationContext : l' IInvocationContext dell'invocazione.

config IConfiguration : la IConfiguration di questa esecuzione di test.

exception Throwable : l'eccezione originale generata dal test in esecuzione.

fareSetup

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

Eseguire il passaggio di configurazione target_preparer e multi_target_preparer. Esegue la configurazione di tutti i dispositivi necessari per l'esecuzione del test.

Parametri
testInfo TestInformation : TestInformation dell'invocazione.

config IConfiguration : la IConfiguration di questa esecuzione di test.

listener ITestLogger : ITestLogger per segnalare i registri degli errori di configurazione.

Lancia
BuildError
DeviceNotAvailableException
TargetSetupError

fareTeardown

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

Esegui il passaggio di smontaggio target_preparer e multi_target_preparer. I dispositivi si smantellano associati alla configurazione.

Parametri
testInfo TestInformation : TestInformation dell'invocazione.

config IConfiguration : la IConfiguration di questa esecuzione di test.

logger ITestLogger : ITestLogger per segnalare i log.

exception Throwable : l'eccezione originale generata dal test in esecuzione.

fetchBuild

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

Esegui il passaggio build_provider dell'invocazione.

Parametri
testInfo TestInformation : TestInformation dell'invocazione.

config IConfiguration : la IConfiguration di questa esecuzione di test.

rescheduler IRescheduler : IRescheduler , per riprogrammare parti dell'invocazione per l'esecuzione su altre risorse

listener ITestInvocationListener : ITestInvocation per segnalare errori di download della build.

ritorna
boolean Vero se abbiamo scaricato correttamente la build, falso altrimenti.

Lancia
BuildRetrievalError
DeviceNotAvailableException

reportLogs

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

Segnala alcuni log del dispositivo in diverse fasi della chiamata. 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)

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

Parametri
context IInvocationContext : l' IInvocationContext dell'invocazione.

config IConfiguration : la IConfiguration di questa esecuzione di test.

exception Throwable : l'eccezione originale generata dal test in esecuzione, se presente.

eseguireDevicePreInvocationSetup

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

Richiamare 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 : l' IInvocationContext dell'invocazione.

config IConfiguration : la IConfiguration di questa esecuzione di test.

logger ITestLogger : ITestLogger per segnalare i log.

Lancia
DeviceNotAvailableException
TargetSetupError

eseguireTest

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

Esegue il test.

Parametri
info TestInformation : TestInformation con cui eseguire i test.

config IConfiguration : la IConfiguration da eseguire

listener ITestInvocationListener : ITestInvocationListener dei risultati del test

shardConfig

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

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

Se il conteggio dei frammenti è maggiore di 1, creerà semplicemente le configurazioni per ciascun frammento impostando gli indici dei frammenti e riprogrammandoli. Se non viene impostato un conteggio di shard, verrà eseguito il fallback su IShardHelper#shardConfig .

Parametri
config IConfiguration : la IConfiguration corrente.

testInfo TestInformation : TestInformation che contiene le informazioni sui test.

rescheduler IRescheduler : l' IRescheduler .

logger ITestLogger : ITestLogger utilizzato per registrare il file durante lo sharding.

ritorna
boolean true se il test è stato partizionato. Altrimenti restituisce false

Metodi protetti

raccogliAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Raccoglie automaticamente alcune informazioni sul dispositivo primario in prova.

Parametri
config IConfiguration

info TestInformation

Lancia
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

Crea un ritorno IShardHelper da utilizzare.

ritorna
IShardHelper

personalizzaDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Dare la possibilità di personalizzare parte del dispositivo prima della preInvocationSetup.

Parametri
config IConfiguration : la configurazione dell'invocazione.

context IInvocationContext : il contesto di chiamata corrente.

getAdbVersion

protected String getAdbVersion ()

Restituisce la versione adb in uso per l'invocazione.

ritorna
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

Sostituito nelle classi sandbox per impedire ai preparatori di laboratorio di essere eseguiti all'interno del figlio sandbox

Parametri
config IConfiguration

deviceName String

ritorna

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

Sostituito nelle classi sandbox per impedire ai preparatori di laboratorio di essere eseguiti all'interno del figlio sandbox

Parametri
config IConfiguration

deviceName String

ritorna

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

ritorna
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

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

Parametri
info IBuildInfo

config IConfiguration