InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

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


Classe che descrive tutti i passaggi di chiamata: download build, target_prep, esecuzione test, pulizia. Può essere esteso per ignorare il comportamento predefinito di alcuni passaggi. L'ordine dei passaggi è determinato 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)

Esegui i passaggi di pulizia target_preparer e multi_target_preparer.

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

Esegui i passaggi di configurazione target_preparer e multi_target_preparer.

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

Esegui i passaggi di eliminazione target_preparer e multi_target_preparer.

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

Esegui il passaggio build_provider della chiamata.

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

Segnala alcuni log del dispositivo in una diversa fase della chiamata.

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

Richiama ITestDevice#postInvocationTearDown(Throwable) per ogni parte del dispositivo 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 invocazione.

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

Esegue il test.

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

Tenta di eseguire lo sharding della configurazione in sottoconfigurazioni, per riprogrammarla per l'esecuzione più risorse in parallelo.

Metodi protetti

void collectAutoInfo(IConfiguration config, TestInformation info)

Raccogli automaticamente alcune informazioni sul dispositivo principale sottoposto a test.

IShardHelper createShardHelper()

Crea una restituzione di IShardHelper da utilizzare.

void customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)

Dai la possibilità di personalizzare alcuni dispositivi prima di preInvocationSetup.

String getAdbVersion()

Restituisce la versione adb in uso per la chiamata.

getLabPreparersToRun(IConfiguration config, String deviceName)

Recupera un elenco di preparativi del lab da eseguire su questo dispositivo.

getTargetPreparersToRun(IConfiguration config, String deviceName)

Recupera un elenco di preparativi del 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)

Gestire l'impostazione del tag di test sulle informazioni sulla build.

Campi

CHIAVE_VERSIONE_DB

public static final String ADB_VERSION_KEY

CHIAVE_CLASSPATH_JAVA_CLASSPATH

public static final String JAVA_CLASSPATH_KEY

CHIAVE_VERSIONE_JAVA

public static final String JAVA_VERSION_KEY

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

config IConfiguration: IConfiguration di questa esecuzione di test.

DoCleanUp

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

Esegui i passaggi di pulizia target_preparer e multi_target_preparer. I dispositivi puliscono verso l'alto.

Parametri
context IInvocationContext: il IInvocationContext della chiamata.

config IConfiguration: IConfiguration di questa esecuzione di test.

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

Configurazione dell'account

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

Esegui i passaggi di configurazione target_preparer e multi_target_preparer. Tutti i dispositivi vengono configurati richiesta per l'esecuzione del test.

Parametri
testInfo TestInformation: il TestInformation della chiamata.

config IConfiguration: IConfiguration di questa esecuzione di test.

listener ITestLogger: i 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 i passaggi di eliminazione target_preparer e multi_target_preparer. I dispositivi si strappano associati alla configurazione.

Parametri
testInfo TestInformation: il TestInformation della chiamata.

config IConfiguration: 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 della chiamata.

Parametri
testInfo TestInformation: il TestInformation della chiamata.

config IConfiguration: IConfiguration di questa esecuzione di test.

rescheduler IRescheduler: il IRescheduler, per ripianificare parti della chiamata per su altre risorse

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

Ritorni
boolean True se il download della build è andato a buon fine, false in caso contrario.

Lanci
BuildRetrievalError
DeviceNotAvailableException

reportLog

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

Segnala alcuni log del dispositivo in una diversa fase 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 della chiamata in cui ci troviamo.

runDevicePostInvocationTeardown

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

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

Parametri
context IInvocationContext: il IInvocationContext della chiamata.

config IConfiguration: IConfiguration di questa esecuzione di test.

exception Throwable: l'eccezione originale generata dal test in esecuzione, 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 invocazione.

Parametri
context IInvocationContext: il IInvocationContext della chiamata.

config IConfiguration: IConfiguration di questa esecuzione di test.

logger ITestLogger: ITestLogger per segnalare i log.

Lanci
DeviceNotAvailableException
TargetSetupError

runTest

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

Esegue il test.

Parametri
info TestInformation: il valore TestInformation con cui eseguire i test.

config IConfiguration: IConfiguration da eseguire

listener ITestInvocationListener: ITestInvocationListener dei risultati del test

shardConfig

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

Tenta di eseguire lo sharding della configurazione in sottoconfigurazioni, per riprogrammarla per l'esecuzione più risorse in parallelo.

Se il numero di shard è maggiore di 1, creerà semplicemente le configurazioni per ogni shard impostare gli indici di shard e riprogrammarli. Se non viene impostato un numero di shard,viene usato come riserva IShardHelper#shardConfig.

Parametri
config IConfiguration: il valore attuale di IConfiguration.

testInfo TestInformation: il TestInformation che contiene le informazioni sui test.

rescheduler IRescheduler: IRescheduler.

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

Ritorni
boolean true se il test è stato eseguito con sharding. In caso contrario, restituisci false

Metodi protetti

raccogliInfoAuto

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Raccogli automaticamente alcune informazioni sul dispositivo principale sottoposto a test.

Parametri
config IConfiguration

info TestInformation

Lanci
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

Crea una restituzione di IShardHelper da utilizzare.

Ritorni
IShardHelper

personalizzazione della prechiamata del dispositivo

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Dai la possibilità di personalizzare alcuni dispositivi prima di preInvocationSetup.

Parametri
config IConfiguration: la configurazione della chiamata.

context IInvocationContext: contesto di chiamata attuale.

getAdbVersion

protected String getAdbVersion ()

Restituisce la versione adb in uso per la chiamata.

Ritorni
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Recupera un elenco di preparativi del lab da eseguire su questo dispositivo.

Sostituiti nelle classi sandbox per impedire ai preparativi del lab di essere eseguiti all'interno della sandbox figlio/a

Parametri
config IConfiguration

deviceName String

Ritorni

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Recupera un elenco di preparativi del target da eseguire su questo dispositivo.

Sostituiti nelle classi sandbox per impedire ai preparativi del lab di essere eseguiti all'interno della sandbox figlio/a

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

esecuzionePreparazioneRischiodi

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)

Gestire l'impostazione del tag di test sulle informazioni sulla build.

Parametri
info IBuildInfo

config IConfiguration