ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer
AdbStopServerPreparer O preparador de destino é usado para interromper o servidor adb no host antes e depois de executar testes do adb. 
AllTestAppsInstallSetup Um ITargetPreparer que instala todos os apps de uma pasta IDeviceBuildInfo.getTestsDir() no dispositivo. 
AoaTargetPreparer ITargetPreparer que executa uma série de ações (por exemplo, cliques e deslizes) usando o protocolo Android Open Accessory (AOAv2). 
AppSetup Um ITargetPreparer que instala um APK e os testes dele. 
ArtChrootPreparer Cria o diretório chroot para testes do ART. 
BaseEmulatorPreparer Preparador comum para iniciar um emulador local. 
BaseTargetPreparer Classe de implementação básica para ITargetPreparer que permite controlar se o objeto está desativado ou não. 
BuildInfoRecorder Um ITargetPreparer que grava metadados de informações do build em um arquivo especificado. 
CheckPairingPreparer Um CompanionAwarePreparer que verifica a vinculação de BT entre dispositivos principais e secundários
CompanionAllocator Classe base que aloca e libera o dispositivo complementar

getCompanionDeviceSelectionOptions() precisa ser implementado para descrever os critérios necessários para alocar o dispositivo complementar.

CompanionAwarePreparer Um ITargetPreparer que encapsula a lógica de receber um dispositivo complementar já alocado. 
CompanionRunCommandTargetPreparer Um ITargetPreparer que executa comandos especificados no dispositivo complementar alocado
CompanionTestAppInstallSetup Um ITargetPreparer que instala um ou mais apps de uma pasta IDeviceBuildInfo.getTestsDir() em um dispositivo complementar alocado. 
CompileBootImageWithSpeedTargetPreparer Recompila o classpath de inicialização e o servidor do sistema com o filtro do compilador "speed". 
CpuThrottlingWaiter Um ITargetPreparer que aguarda até que a frequência máxima em todas as cores seja restaurada para o nível mais alto disponível.
CreateAvdPreparer  
CreateUserPreparer Preparador de destino para criar usuário e limpar no final. 
DeviceActionTargetPreparer Um ITargetPreparer para realizar ações do dispositivo. 
DeviceBuildInfoBootStrapper Um ITargetPreparer que substitui os campos de informações do build por atributos lidos do dispositivo

Isso é útil para testar dispositivos com builds gerados de uma fonte externa (por exemplo,

DeviceBuildInfoInjector Um ITargetPreparer que insere metadados DeviceBuildDescriptor no IBuildInfo. 
DeviceCleaner (em inglês) Reinicia ou formata como ação de limpeza após o teste e, opcionalmente, desliga a tela 
DeviceFlashPreparer Um ITargetPreparer que mostra uma imagem em hardware físico do Android. 
DeviceImageZipFlashingTargetPreparer Um preparador de destino que atualiza o dispositivo com imagens fornecidas em um formato específico. 
DeviceOwnerTargetPreparer Um ITargetPreparer que configura um componente de proprietário do dispositivo. 
DeviceSetup Um ITargetPreparer que configura um dispositivo para testes com base nos Options fornecidos. 
DeviceStorageFiller Preencha o armazenamento do preparador de destino para que um pouco de espaço livre esteja disponível. 
DeviceStringPusher O preparador de destino grava uma string em um arquivo. 
DeviceUpdateTargetPreparer Um ITargetPreparer abstrato que cuida de etapas comuns de atualização de dispositivos com um arquivo de imagem de dispositivo de uma fonte externa (em vez de um serviço de build). 
DeviceWiper (link em inglês) Um ITargetPreparer que exclui permanentemente os dados do usuário 
DisableSELinuxTargetPreparer Preparador de destino que desativa o SELinux se ele estiver ativado. 
DynamicSystemPreparer Um ITargetPreparer que configura uma imagem do sistema sobre um build do dispositivo com a atualização dinâmica do sistema. 
EraseUserDataPreparer Um ITargetPreparer que exclui permanentemente os dados do usuário do dispositivo. 
FastbootCommandPreparer Preparador de destino que aciona e envia comandos de inicialização rápida. 
FastbootUpdateBootstrapPreparer Um ITargetPreparer que coloca arquivos especificados (bootloader, rádio, ZIP de imagem do dispositivo) em IDeviceBuildInfo para que os dispositivos sejam atualizados com FastbootDeviceFlasher e injete atributos de dispositivo pós-inicialização nas informações de build para fins de geração de relatórios. 
FeatureFlagTargetPreparer Atualiza o DeviceConfig (flags de recursos ajustadas por um serviço remoto). 
FoldableModePreparer Um preparador de destino que pode alternar o estado dobrável de um dispositivo. 
FolderSaver (link em inglês) Um ITargetPreparer que extrai diretórios do dispositivo, os compacta e os salva no back-end de registro. 
GkiDeviceFlashPreparer Um preparador de destino que atualiza o dispositivo com a imagem genérica do kernel comum do Android. 
GsiDeviceFlashPreparer Um preparador de destino que atualiza o dispositivo com a imagem genérica do sistema Android. 
ILabPreparer Interface de marcador para preparadores de laboratórios

Consulte ITargetPreparer para saber o objetivo dessas interfaces. 

ITargetCleaner (link em inglês) Essa interface foi descontinuada. O tearDown foi movido para a interface ITargetPreparer base. 
InstallAllTestZipAppsSetup Um ITargetPreparer que instala todos os apps em um arquivo zip de teste. 
InstallApexModuleTargetPreparer  
InstallApkSetup Um ITargetPreparer que instala um ou mais APKs localizados no sistema de arquivos. 
InstallBuildEnvApkSetup Um ITargetPreparer que instala um ou mais APKs de teste de um ambiente de build de plataforma Android. 
InstallKernelModulePreparer Um preparador de destino que instala módulos do kernel. 
InstrumentationPreparer Um ITargetPreparer que executa a instrumentação
KillExistingEmulatorPreparer Um ITargetPreparer que encerra um emulador em execução. 
KnownFailurePreparer O preparador de destino pula a nova tentativa de falha conhecida. 
LocalEmulatorLaunch Um TargetPreparer que inicia um emulador localmente em um ambiente de build do Android. 
LocalEmulatorSnapshot Um TargetPreparer destinado a gerar um snapshot limpo do emulador de um ambiente de build/desenvolvimento do Android 
MixKernelTargetPreparer Um ITargetPreparer que permite misturar uma imagem do kernel com a imagem do dispositivo. 
ModuleOemTargetPreparer  
NativeLeakCollector Um ITargetPreparer que executa "dumpsys meminfo --unreachable -a" para identificar a memória nativa inacessível atualmente mantida por cada processo. 
NoApkTestSkipper Preparador especial que permite pular uma invocação completamente (preparação e testes) se não houver apks para testes. 
PerfettoPreparer O preparador do Perfetto envia o arquivo de configuração para o dispositivo em um local padrão a que o Perfetto tem acesso. 
ProfileTargetPreparer Classe base para configurar o preparador de destino para qualquer usuário de perfil android.os.usertype.profile.XXX. 
PushFileInvoker Esta classe foi descontinuada. Use PushFilePreparer 
PushFilePreparer Um ITargetPreparer que tenta enviar qualquer número de arquivos de qualquer caminho de host para qualquer caminho de dispositivo. 
PythonVirtualenvPreparer (link em inglês) Configura um virtualenv do Python no host e instala pacotes. 
RebootTargetPreparer Preparador de destino que reinicia o dispositivo. 
RecoveryLogPreparer Um preparador de destino usado para coletar registros antes da recuperação. 
RemoveSystemAppPreparer Um ITargetPreparer para remover um APK da partição do sistema antes de uma execução de teste. 
RestartSystemServerTargetPreparer Preparador de destino que reinicia o servidor do sistema sem reiniciar o dispositivo. 
RootTargetPreparer Preparador de destino que executa "adb root" ou "adb unroot" com base na opção "force-root". 
RootcanalForwarderPreparer  
RunCommandTargetPreparer  
RunHostCommandTargetPreparer O preparador de destino executa comandos arbitrários do host antes e depois de executar o teste. 
RunHostScriptTargetPreparer Preparador de destino que executa um script antes de executar um teste. 
RunOnCloneProfileTargetPreparer  
RunOnPrivateProfileTargetPreparer  
RunOnSdkSandboxTargetPreparer Um ITargetPreparer para marcar que os testes precisam ser executados no sandbox do SDK. 
RunOnSecondaryUserTargetPreparer Um ITargetPreparer para garantir que o teste seja executado como um usuário secundário. 
RunOnSystemUserTargetPreparer Um ITargetPreparer que marca que os testes precisam ser executados no usuário (em vez do usuário atual). 
RunOnWorkProfileTargetPreparer Um ITargetPreparer que cria um perfil de trabalho na configuração e marca que os testes precisam ser executados nesse usuário. 
SemaphoreTokenTargetPreparer Esse é um preparador usado para usar o token para serializar a execução do teste no host tradefed. 
SideloadOtaTargetPreparer Um preparador de destino que executa o sideload de um pacote OTA especificado, aplica o pacote, aguarda o dispositivo ser inicializado e injeta as propriedades de build do dispositivo para usar como informações de build

Esse preparador de destino pressupõe que o dispositivo estará no modo adb normal quando for iniciado e vai garantir que o dispositivo saia no mesmo modo, mas com o build mais recente aplicado. 

StopServicesSetup Um ITargetPreparer que interrompe os serviços no dispositivo. 
StubTargetPreparer Implementação vazia de marcador de posição de um ITargetPreparer. 
SuiteApkInstaller Instala os APKs especificados para a configuração do pacote: da variável $ANDROID_TARGET_OUT_TESTCASES ou do ROOT_DIR nas informações de build. 
SwitchUserTargetPreparer Um ITargetPreparer que muda para o tipo de usuário especificado no setUp. 
TearDownPassThroughPreparer Permite executar o tearDown em preparadores incluídos em uma configuração como um objeto. 
TemperatureThrottlingWaiter Um ITargetPreparer que aguarda até que a temperatura do dispositivo atinja o valor desejado 
TestAppInstallSetup Um ITargetPreparer que instala um ou mais apps de uma pasta IDeviceBuildInfo.getTestsDir() no dispositivo. 
TestFilePushSetup Um ITargetPreparer que envia um ou mais arquivos/diretórios de uma pasta IDeviceBuildInfo.getTestsDir() para o dispositivo. 
TestSystemAppInstallSetup Um ITargetPreparer que instala um ou mais apps de uma pasta IDeviceBuildInfo.getTestsDir() na partição /system do dispositivo. 
TimeWaster (em inglês) Um simples preparador de destino para perder tempo e, possivelmente, reiniciar o dispositivo. 
UserCleaner (em inglês) Um ITargetPreparer que remove usuários secundários na desmontagem. 
VisibleBackgroundUserPreparer Preparador de destino para executar testes em um usuário iniciado no visível em segundo plano. 
WaitForDeviceDatetimePreparer Um ITargetPreparer que aguarda a data e a hora serem definidas no dispositivo

Opcionalmente, esse preparador pode forçar um TargetSetupError se a data/hora não for definida dentro do tempo limite. 

WifiPreparer Um ITargetPreparer que configura o Wi-Fi no dispositivo, se necessário. 

Prepara o ambiente de teste para a execução do teste.

Por exemplo, instala software, ajusta as configurações do ambiente para testes, inicia destinos etc.

Várias ITargetPreparers podem ser especificadas em uma configuração. É recomendável que cada ITargetPreparer documente claramente o ambiente esperado antes e depois da configuração. Por exemplo, um ITargetPreparer que configura um dispositivo para teste precisa ser executado após o ITargetPreparer que instala o software.

Resumo

Métodos públicos

default void setUp(ITestDevice device, IBuildInfo buildInfo)

Este método foi descontinuado. Use setUp(com.android.tradefed.invoker.TestInformation)

default void setUp(TestInformation testInformation)

Realize a configuração do destino para testes.

default void tearDown(TestInformation testInformation, Throwable e)

Execute a limpeza/remoção do destino após o teste.

default void tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)

Este método foi descontinuado. Use tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

Métodos públicos

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Este método foi descontinuado.
Use setUp(com.android.tradefed.invoker.TestInformation)

Realize a configuração do destino para testes.

Parâmetros
device ITestDevice: o ITestDevice a ser preparado.
buildInfo IBuildInfo: dados sobre o build em teste.
Gera
TargetSetupError se ocorreu um erro fatal ao configurar o ambiente
BuildError Se ocorrer um erro relacionado ao BuildInfo
DeviceNotAvailableException se o dispositivo não responder

setUp

public void setUp (TestInformation testInformation)

Realize a configuração do destino para testes.

Parâmetros
testInformation TestInformation: o TestInformation da invocação.
Gera
TargetSetupError se ocorreu um erro fatal ao configurar o ambiente
BuildError Se ocorrer um erro devido ao build que está sendo preparado
DeviceNotAvailableException se o dispositivo não responder

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Execute a limpeza/remoção do destino após o teste.

Parâmetros
testInformation TestInformation: o TestInformation da invocação.
e Throwable: se a invocação terminar com uma exceção, essa será a exceção que foi detectada no nível da invocação. Caso contrário, será null.
Gera
DeviceNotAvailableException se o dispositivo não responder

tearDown

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

Este método foi descontinuado.
Use tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

Execute a limpeza/remoção do destino após o teste.

Parâmetros
device ITestDevice: o ITestDevice a ser preparado.
buildInfo IBuildInfo: dados sobre o build em teste.
e Throwable: se a invocação terminar com uma exceção, essa será a exceção que foi detectada no nível da invocação. Caso contrário, será null.
Gera
DeviceNotAvailableException se o dispositivo não responder