InvocaçãoExecução

public class InvocationExecution
extends Object implements IInvocationExecution

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

Subclasses diretas conhecidas DelegatedInvocationExecution , ParentSandboxInvocationExecution , RemoteInvocationExecution , SandboxedInvocationExecution Execução de Invocação Delegada InvocationExecution que delega a execução para outro binário Tradefed. PaiSandboxInvocaçãoExecução Versão de InvocationExecution para as ações especiais de invocação pai ao executar um sandbox. RemoteInvocationExecution Implementação de InvocationExecution que conduz uma execução remota. SandboxedInvocationExecution Execução de sandbox especial da invocação: Este é o InvocationExection para quando estivermos dentro do sandbox executando o comando.

---

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