InvocaçãoExecução

public class InvocationExecution
extends Object implements IInvocationExecution

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


Classe que descreve todas as etapas de invocação: build download, target_prep, executar testes, limpar. Pode ser estendido para substituir o comportamento padrão de algumas etapas. A ordem das etapas é controlada por TestInvocation .

Resumo

Campos

public static final String ADB_VERSION_KEY

public static final String JAVA_CLASSPATH_KEY

public static final String JAVA_VERSION_KEY

Construtores públicos

InvocationExecution ()

Métodos públicos

void cleanUpBuilds ( IInvocationContext context, IConfiguration config)

Execute a etapa de limpeza build_provider.

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

Execute a etapa de limpeza target_preparer e multi_target_preparer.

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

Execute a etapa de configuração target_preparer e multi_target_preparer.

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

Execute a etapa de desmontagem target_preparer e multi_target_preparer.

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

Execute a etapa build_provider da invocação.

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

Relate alguns logs do dispositivo em diferentes estágios da invocação.

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

Invoque o ITestDevice#postInvocationTearDown(Throwable) para cada parte do dispositivo da invocação.

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

Invoque o ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo)) para cada parte do dispositivo da invocação.

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

Executa o teste.

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

Tente fragmentar a configuração em subconfigurações, para serem reagendadas para execução em vários recursos em paralelo.

Métodos protegidos

void collectAutoInfo ( IConfiguration config, TestInformation info)

Colete automaticamente algumas informações sobre o dispositivo principal em teste.

IShardHelper createShardHelper ()

Crie um retorno do IShardHelper a ser usado.

void customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)

Dê a chance de customizar parte do dispositivo antes do preInvocationSetup.

String getAdbVersion ()

Retorna a versão do adb em uso para a invocação.

getLabPreparersToRun ( IConfiguration config, String deviceName)

Recupere uma lista de preparadores de laboratório para executar neste dispositivo.

getTargetPreparersToRun ( IConfiguration config, String deviceName)

Recupere uma lista de preparadores de destino para executar neste dispositivo.

void logHostAdb ( IConfiguration config, ITestLogger logger)

Colete os logs de $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)

Lide com a configuração da tag de teste nas informações de compilação.

Campos

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

Construtores públicos

InvocaçãoExecução

public InvocationExecution ()

Métodos públicos

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Execute a etapa de limpeza build_provider. Associado à busca de build.

Parâmetros
context IInvocationContext : o IInvocationContext da invocação.

config IConfiguration : a IConfiguration desta execução de teste.

doCleanUp

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

Execute a etapa de limpeza target_preparer e multi_target_preparer. Os dispositivos limpam.

Parâmetros
context IInvocationContext : o IInvocationContext da invocação.

config IConfiguration : a IConfiguration desta execução de teste.

exception Throwable : a exceção original lançada pela execução do teste.

doSetup

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

Execute a etapa de configuração target_preparer e multi_target_preparer. Faz todas as configurações de dispositivos necessárias para a execução do teste.

Parâmetros
testInfo TestInformation : o TestInformation da invocação.

config IConfiguration : a IConfiguration desta execução de teste.

listener ITestLogger : o ITestLogger para relatar logs de falhas de configuração.

lances
BuildError
DeviceNotAvailableException
TargetSetupError

doTeardown

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

Execute a etapa de desmontagem target_preparer e multi_target_preparer. Os dispositivos desmontam associados à configuração.

Parâmetros
testInfo TestInformation : o TestInformation da invocação.

config IConfiguration : a IConfiguration desta execução de teste.

logger ITestLogger : o ITestLogger para relatar logs.

exception Throwable : a exceção original lançada pela execução do teste.

buscarBuild

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

Execute a etapa build_provider da invocação.

Parâmetros
testInfo TestInformation : o TestInformation da invocação.

config IConfiguration : a IConfiguration desta execução de teste.

rescheduler IRescheduler : o IRescheduler , para reagendar partes da invocação para execução em outro(s) recurso(s)

listener ITestInvocationListener : o ITestInvocation para relatar falhas de download de compilação.

devoluções
boolean Verdadeiro se baixamos a compilação com sucesso, caso contrário, falso.

lances
BuildRetrievalError
DeviceNotAvailableException

reportLogs

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

Relate alguns logs do dispositivo em diferentes estágios da invocação. Por exemplo: logcat.

Parâmetros
device ITestDevice : O dispositivo do qual relatar logs.

listener ITestLogger : O logger para os logs.

stage TestInvocation.Stage : O estágio da invocação em que estamos.

runDevicePostInvocationTearDown

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

Invoque o ITestDevice#postInvocationTearDown(Throwable) para cada parte do dispositivo da invocação.

Parâmetros
context IInvocationContext : o IInvocationContext da invocação.

config IConfiguration : a IConfiguration desta execução de teste.

exception Throwable : a exceção original lançada pelo teste em execução, se houver.

runDevicePreInvocationSetup

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

Invoque o ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo)) para cada parte do dispositivo da invocação.

Parâmetros
context IInvocationContext : o IInvocationContext da invocação.

config IConfiguration : a IConfiguration desta execução de teste.

logger ITestLogger : o ITestLogger para relatar logs.

lances
DeviceNotAvailableException
TargetSetupError

runTests

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

Executa o teste.

Parâmetros
info TestInformation : o TestInformation com o qual executar testes.

config IConfiguration : o IConfiguration a ser executado

listener ITestInvocationListener : o ITestInvocationListener dos resultados do teste

shardConfig

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

Tente fragmentar a configuração em subconfigurações, para serem reagendadas para execução em vários recursos em paralelo.

Se uma contagem de estilhaços for maior que 1, ela simplesmente criará configurações para cada estilhaço definindo índices de estilhaços e reagendando-os. Se uma contagem de fragmentos não for definida, ela retornará para IShardHelper#shardConfig .

Parâmetros
config IConfiguration : o IConfiguration atual.

testInfo TestInformation : o TestInformation contendo as informações dos testes.

rescheduler IRescheduler : o IRescheduler .

logger ITestLogger : ITestLogger usado para registrar o arquivo durante a fragmentação.

devoluções
boolean true se o teste foi fragmentado. Caso contrário, retorne false

Métodos protegidos

coletarAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Colete automaticamente algumas informações sobre o dispositivo principal em teste.

Parâmetros
config IConfiguration

info TestInformation

lances
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

Crie um retorno do IShardHelper a ser usado.

devoluções
IShardHelper

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Dê a chance de customizar parte do dispositivo antes do preInvocationSetup.

Parâmetros
config IConfiguration : a configuração da invocação.

context IInvocationContext : O contexto de invocação atual.

getAdbVersion

protected String getAdbVersion ()

Retorna a versão do adb em uso para a invocação.

devoluções
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Recupere uma lista de preparadores de laboratório para executar neste dispositivo.

Substituído em classes sandbox para impedir que os preparadores de laboratório sejam executados dentro do filho sandbox

Parâmetros
config IConfiguration

deviceName String

devoluções

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Recupere uma lista de preparadores de destino para executar neste dispositivo.

Substituído em classes sandbox para impedir que os preparadores de laboratório sejam executados dentro do filho sandbox

Parâmetros
config IConfiguration

deviceName String

devoluções

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Colete os logs de $TMPDIR/adb.$UID.log.

Parâmetros
config IConfiguration

logger ITestLogger

runPreparersTearDown

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

Parâmetros
testInfo TestInformation

device ITestDevice

deviceName String

deviceIndex int

logger ITestLogger

exception Throwable

preparersToRun

trackPreparersMap

devoluções
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Lide com a configuração da tag de teste nas informações de compilação.

Parâmetros
info IBuildInfo

config IConfiguration