Execução de invocação

public class InvocationExecution
extends Object implements IInvocationExecution

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

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

---

Classe que descreve todas as etapas de invocação: download de compilação, target_prep, execução de testes, limpeza. Pode ser estendido para substituir o comportamento padrão de algumas etapas. A ordem das etapas é orientada 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 chamada.
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, a serem reprogramadas para execução em vários recursos em paralelo.

Métodos protegidos
void	collectAutoInfo ( IConfiguration config, TestInformation info) Colete automaticamente algumas informações no dispositivo primário em teste.
IShardHelper	createShardHelper () Crie um retorno do IShardHelper a ser usado.
void	customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context) Dê a chance de personalizar alguns dispositivos antes de preInvocationSetup.
String	getAdbVersion () Retorna a versão do adb em uso para a invocação.
	getPreparersToRun ( IConfiguration config, String deviceName) Recupere uma lista de preparadores para executar neste dispositivo.
void	logHostAdb ( IConfiguration config, ITestLogger logger) Colete os logs de $TMPDIR/adb.$UID.log.
void	runPreparersSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Throwable	runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun) runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun)
void	setTestTag (IBuildInfo info, IConfiguration config) Manipule 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

Execução de invocaçã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 compilação.

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. Os dispositivos limpam.

Parâmetros
context	IInvocationContext : o IInvocationContext da invocação.
config	IConfiguration : o IConfiguration desta execução de teste.
exception	Throwable : a exceção original lançada pelo teste em execução.

doSetup

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

Execute a etapa de configuração target_preparer e multi_target_preparer. Faz toda a configuração de dispositivos necessária para que o teste seja executado.

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

Lança
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 : o IConfiguration desta execução de teste.
logger	ITestLogger : o ITestLogger para relatar logs.
exception	Throwable : a exceção original lançada pelo teste em execução.

fetchBuild

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 para execução em outro(s) recurso(s)
listener	ITestInvocationListener : o ITestInvocation para relatar falhas de download de compilação.

Devoluções
boolean	True se baixamos a compilação com sucesso, false caso contrário.

Lança
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 os logs.
listener	ITestLogger : O criador de logs 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 : o 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 chamada.

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

Lança
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, a serem reprogramadas para execução em vários recursos em paralelo.

Se uma contagem de estilhaços for maior que 1, ele simplesmente criará configurações para cada estilhaço definindo índices de estilhaços e reagendando-os. Se uma contagem de estilhaços não for definida, ela retornará para 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.

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

Métodos protegidos

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Colete automaticamente algumas informações no dispositivo primário em teste.

Parâmetros
config	IConfiguration
info	TestInformation

Lança
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 personalizar alguns dispositivos antes de 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

getPreparersToRun

protected  getPreparersToRun (IConfiguration config, 
                String deviceName)

Recupere uma lista de preparadores para executar neste dispositivo.

Substituído em classes de sandbox para impedir que os preparadores de laboratório sejam executados dentro do filho de 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

configuração do runPreparers

protected void runPreparersSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

Parâmetros
testInfo	TestInformation
config	IConfiguration
listener	ITestLogger

Lança
BuildError
DeviceNotAvailableException
TargetSetupError

runPreparersTearDown

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

Parâmetros
testInfo	TestInformation
device	ITestDevice
deviceName	String
deviceIndex	int
logger	ITestLogger
exception	Throwable
preparersToRun

Devoluções
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

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

Parâmetros
info	IBuildInfo
config	IConfiguration