InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

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

Subclasses diretas conhecidas DelegatedInvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution DelegatedInvocationExecution (em inglês) InvocationExecution, que delega a execução a outro binário do Tradefed.  ParentSandboxInvocationExecution (em inglês) Versão de InvocationExecution para as ações especiais de invocação pai ao executar um sandbox  RemoteInvocationExecution (em inglês) Implementação de InvocationExecution que impulsiona uma execução remota.  SandboxedInvocationExecution (em inglês) Execução em sandbox especial da invocação: esta é a InvocationExection para quando dentro do sandbox que executa o comando.

---

Classe que descreve todas as etapas da invocação: download do build, target_prep, execução de testes e limpeza. Pode ser estendido para substituir o comportamento padrão de algumas etapas. A ordem das etapas é definida pela 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 do build_provider.
void	doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception) Execute a etapa de limpeza target_preparer e multi_target_preparer cleanUp.
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) Informar alguns registros 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 do 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 do invocação.
void	runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener) Executa o teste.
boolean	shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger) Tentativa de fragmentar a configuração em subconfigurações, a serem reagendadas para execução vários recursos em paralelo.

Métodos protegidos
void	collectAutoInfo(IConfiguration config, TestInformation info) Colete automaticamente algumas informações no dispositivo principal em teste.
IShardHelper	createShardHelper() Crie uma classe de retorno do IShardHelper a ser usado.
void	customizeDevicePreInvocation(IConfiguration config, IInvocationContext context) Dê a chance de personalizar alguns dos dispositivos antes de preInvocationConfigurar.
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) Recuperar uma lista de preparadores de destino para executar neste dispositivo.
void	linkExternalDirs(IBuildInfo info, TestInformation testInfo)
void	logHostAdb(IConfiguration config, ITestLogger logger) Colete os registros de $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) Processe a definição da tag de teste nas informações do build.

Campos

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

CHAVE_DE_VERSÃO_JAVA

public static final String JAVA_VERSION_KEY

Construtores públicos

InvocationExecution

public InvocationExecution ()

Métodos públicos

Limpeza de builds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Execute a etapa de limpeza do build_provider. Associadas à busca de build.

Parâmetros
context	IInvocationContext: o IInvocationContext da invocação.
config	IConfiguration: o 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 cleanUp. Os dispositivos são limpos? para cima.

Parâmetros
context	IInvocationContext: o IInvocationContext da invocação.
config	IConfiguration: o IConfiguration desta execução de teste.
exception	Throwable: a exceção original gerada pela execução do teste.

Configuração

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

Execute a etapa de configuração "target_preparer" e "multi_target_preparer". Todos os dispositivos estão configurados? necessários para a execução do teste.

Parâmetros
testInfo	TestInformation: o TestInformation da invocação.
config	IConfiguration: o IConfiguration desta execução de teste.
listener	ITestLogger: o ITestLogger para relatar os registros de falhas de configuração.

Gera
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 rompem associados à configuração.

Parâmetros
testInfo	TestInformation: o TestInformation da invocação.
config	IConfiguration: o IConfiguration desta execução de teste.
logger	ITestLogger: o ITestLogger para relatar registros.
exception	Throwable: a exceção original gerada pela execução do teste.

GETBuild

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: o IConfiguration desta execução de teste.
rescheduler	IRescheduler: o IRescheduler para reprogramar partes da invocação de execução em outros recursos
listener	ITestInvocationListener: o ITestInvocation para relatar falhas de download do build.

Retorna
boolean	Verdadeiro se o download do build tiver sido concluído. Caso contrário, retorna falso.

Gera
BuildRetrievalError
DeviceNotAvailableException

reportLogs

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

Informar alguns registros do dispositivo em diferentes estágios da invocação. Por exemplo: Logcat.

Parâmetros
device	ITestDevice: o dispositivo do qual os registros serão relatados.
listener	ITestLogger: o logger dos registros.
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 do invocação.

Parâmetros
context	IInvocationContext: o IInvocationContext da invocação.
config	IConfiguration: o IConfiguration desta execução de teste.
exception	Throwable: a exceção original gerada 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 do invocação.

Parâmetros
context	IInvocationContext: o IInvocationContext da invocação.
config	IConfiguration: o IConfiguration desta execução de teste.
logger	ITestLogger: o ITestLogger para relatar registros.

Gera
DeviceNotAvailableException
TargetSetupError

runTests

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

Executa o teste.

Parâmetros
info	TestInformation: o TestInformation usado para 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)

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

Se uma contagem de fragmentos for maior que 1, ele simplesmente criará configurações para cada fragmento ao definindo índices de fragmento e reprogramando-os. Se uma contagem de fragmentos não estiver definida,ele usará IShardHelper#shardConfig:

Parâmetros
config	IConfiguration: o IConfiguration atual.
testInfo	TestInformation: o TestInformation que contém as informações dos testes.
rescheduler	IRescheduler: o IRescheduler.
logger	ITestLogger: ITestLogger usado para registrar o arquivo durante a fragmentação.

Retorna
boolean	verdadeiro se o teste foi fragmentado. Caso contrário, retorna false

Métodos protegidos

coletarAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

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

Parâmetros
config	IConfiguration
info	TestInformation

Gera
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

Crie uma classe de retorno do IShardHelper a ser usado.

Retorna
IShardHelper

personalizarDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Dê a chance de personalizar alguns dos dispositivos antes de preInvocationConfigurar.

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.

Retorna
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

Substituído em classes de sandbox para restringir a execução de preparadores de laboratório dentro do sandbox criança

Parâmetros
config	IConfiguration
deviceName	String

Retorna

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

Substituído em classes de sandbox para restringir a execução de preparadores de laboratório dentro do sandbox criança

Parâmetros
config	IConfiguration
deviceName	String

Retorna

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

Parâmetros
info	IBuildInfo
testInfo	TestInformation

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Colete os registros 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

Retorna
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Processe a definição da tag de teste nas informações do build.

Parâmetros
info	IBuildInfo
config	IConfiguration