O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

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`