Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Subclasses indiretas conhecidas

AFlagsTargetPreparer, AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BaseSwitchUserTargetPreparer, BaseSystemTestEnvPreparer, BaseTargetPreparer, BuildInfoRecorder, CheckPairingPreparer, CompanionAllocator, CompanionAwarePreparer, CompanionRunCommandTargetPreparer e mais 94.

AFlagsTargetPreparer	Usa `aflags` para substituir flags antes de executar um teste.
AdbStopServerPreparer	Preparador de destino 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	Crie o diretório chroot para testes do ART.
BaseEmulatorPreparer	Preparador comum para iniciar um emulador local.
BaseSwitchUserTargetPreparer	Um `ITargetPreparer` que muda para o tipo de usuário especificado em setUp.
BaseSystemTestEnvPreparer	Reinicializa para o ambiente de teste do sistema de base
BaseTargetPreparer	Classe de implementação de base para `ITargetPreparer` que permite controlar se o objeto está desativado ou não.
BuildInfoRecorder	Um `ITargetPreparer` que grava metadados de informações de build em um arquivo especificado.
CheckPairingPreparer	Um `CompanionAwarePreparer` que verifica a vinculação por BT entre dispositivos principais e complementares
CompanionAllocator	Classe de 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.
CompatTargetPreparer	Um `ITargetPreparer` que prepara o dispositivo para executar testes de compatibilidade.
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 todos os núcleos seja restaurada para o nível mais alto disponível.
CreateAvdPreparer
CreateUserPreparer	Preparador de destino para criar um usuário secundário e limpar no final.
CrosDutTopologyPreparer	Um preparador que executa a ferramenta dt-converter para gerar configuração e parâmetros de teste.
CrosLsNexusPreparer	Um preparador que inicia e interrompe o serviço LSNexus para um dispositivo ChromeOS.
CtsSettingsSetup	Um `ITargetPreparer` que configura as definições de um dispositivo em preparação para a execução de testes do CTS.
DeviceActionTargetPreparer	Um `ITargetPreparer` para realizar ações no dispositivo.
DeviceBuildInfoBootStrapper	Um `ITargetPreparer` que substitui campos de informações de 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	Executa a reinicialização ou formatação como ação de limpeza após o teste e, opcionalmente, desliga a tela
DeviceFlashPreparer	Um `ITargetPreparer` que atualiza uma imagem em um hardware Android físico.
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 teste com base nos `Option`s fornecidos.
DeviceStorageFiller	O preparador de destino preenche o armazenamento para que haja algum espaço livre disponível.
DeviceStringPusher	Preparador de destino para gravar uma string em um arquivo.
DeviceUpdateTargetPreparer	Um `ITargetPreparer` abstrato que cuida das etapas comuns para atualizar dispositivos com um arquivo de imagem de dispositivo de uma fonte externa (em vez de um serviço de build).
DeviceWiper	Um `ITargetPreparer` que exclui os dados do usuário
DexMetadataExtractor	Instala arquivos de metadados DEX para os APKs especificados.
DisableSELinuxTargetPreparer	Preparador de destino que desativa o SELinux se ele estiver ativado.
DynamicSystemPreparer	Um `ITargetPreparer` que configura uma imagem do sistema em cima de um build de dispositivo com a Atualização dinâmica do sistema.
EhideTargetPreparer	Inicia o ehide, que oculta a interface Ethernet da pilha de rede do Android.
EraseUserDataPreparer	Um `ITargetPreparer` que exclui permanentemente os dados do usuário no dispositivo.
FastbootCommandPreparer	Preparador de destino que aciona o fastboot e envia comandos do fastboot.
FastbootUpdateBootstrapPreparer	Um `ITargetPreparer` que organiza arquivos especificados (bootloader, rádio, zip de imagem do dispositivo) em `IDeviceBuildInfo` para fazer o flash dos dispositivos com `FastbootDeviceFlasher` e injeta atributos do dispositivo pós-inicialização nas informações de build para fins de geração de relatórios de resultados.
FeatureFlagTargetPreparer	Essa classe foi descontinuada. Use `AFlagsTargetPreparer`.
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, compacta e salva no back-end de geração de registros.
FutilityCommandPreparer	Preparador para executar comandos de inutilidade.
GkiDeviceFlashPreparer	Um preparador de destino que atualiza o dispositivo com uma imagem genérica do kernel comum do Android.
GoogleAccountPreparer	Um `ITargetPreparer` que permite configurar Contas do Google.
GoogleAppsSetup	Um `ITargetPreparer` que oferece suporte a várias opções de configuração para apps do Google Observação: um dispositivo precisa ter uma conta configurada primeiro. Consulte `GoogleAccountPreparer`
GoogleDeviceFlashPreparer	Uma especialização de `DeviceFlashPreparer` que oferece suporte às etapas personalizadas necessárias para atualizar dispositivos do Google.
GoogleDeviceSetup	Uma extensão de `DeviceSetup` que permite a configuração de outras propriedades específicas do Google.
GsiDeviceFlashPreparer	Um preparador de destino que atualiza o dispositivo com a imagem genérica do sistema Android.
HsumBootStrategyPreparer
ILabPreparer	Interface de marcador para preparadores de laboratório. Consulte `ITargetPreparer` para ver uma descrição da finalidade dessas interfaces.
ITargetCleaner	Essa interface foi descontinuada. tearDown foi movido para a interface base ITargetPreparer.
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 da 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 desliga um emulador em execução.
KnownFailurePreparer	Preparador de destino para ignorar 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 de kernel com a imagem do dispositivo.
MixRadioTargetPreparer	Um `ITargetPreparer` que permite misturar uma imagem de rádio com a imagem do dispositivo.
ModuleOemTargetPreparer
NativeLeakCollector	Um `ITargetPreparer` que executa "dumpsys meminfo --unreachable -a" para identificar a memória nativa inacessível mantida por cada processo.
NoApkTestSkipper	Preparador especial que permite ignorar completamente uma invocação (preparação e testes) se não houver APKs para testar.
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 de base para configurar o preparador de destino para qualquer usuário de perfil `android.os.usertype.profile.XXX`.
PushFileInvoker	Essa classe foi descontinuada. Use `PushFilePreparer` em vez disso.
PushFilePreparer	Um `ITargetPreparer` que tenta enviar qualquer número de arquivos de qualquer caminho de host para qualquer caminho de dispositivo.
PythonVirtualenvPreparer	Configura um virtualenv do Python no host e instala pacotes.
RamdumpPreparer	Ative o Ramdump.
RebootTargetPreparer	Preparador de destino que reinicializa 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 um teste.
RestartSystemServerTargetPreparer	Preparador de destino que reinicia o servidor do sistema sem reiniciar o dispositivo.
RootTargetPreparer	O preparador de destino executa "adb root" ou "adb unroot" com base na opção "force-root".
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Preparador de destino para executar comandos arbitrários do host antes e depois da execução do 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 devem 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 devem ser executados nesse usuário.
SemaphoreTokenTargetPreparer	Um preparador usado para usar o token e serializar a execução do teste no host do Tradefed.
SettingsSetup	Um `ITargetPreparer` que configura as configurações do dispositivo usando a instrumentação de SettingsUtil.apk.
SideloadOtaTargetPreparer	Um preparador de destino que realiza sideload de um pacote OTA especificado, aplica o pacote, aguarda a inicialização do dispositivo 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 garante que ele 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 marcadora de posição de um `ITargetPreparer`.
SuiteApkInstaller	Instala os APKs especificados para configuração da Suite: da variável $ANDROID_TARGET_OUT_TESTCASES ou do ROOT_DIR nas informações de build.
SwitchUserTargetPreparer	Implementação padrão de `BaseSwitchUserTargetPreparer`. Consulte o javadoc dessa classe para mais informações.
TearDownPassThroughPreparer	Permite executar tearDown em preparadores incluídos em uma configuração como um objeto.
TemperatureThrottlingWaiter	Um `ITargetPreparer` que espera 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	Um preparador de destino simples para perder tempo e potencialmente reiniciar o dispositivo.
UserCleaner	Um `ITargetPreparer` que remove usuários secundários na desmontagem.
VisibleBackgroundUserPreparer	Preparador de destino para executar testes em um usuário iniciado em segundo plano.
WaitForDeviceDatetimePreparer	Um `ITargetPreparer` que aguarda a definição de data e hora no dispositivo. Opcionalmente, esse preparador pode forçar um `TargetSetupError` se o datetime não for definido 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 configurações de ambiente para testes, inicia destinos etc.

Vários ITargetPreparers podem ser especificados em uma configuração. É recomendável que cada ITargetPreparer documente claramente o pré-setup e o pós-setup do ambiente esperado. Por exemplo, um ITargetPreparer que configura um dispositivo para teste precisa ser executado depois do ITargetPreparer que instala o software.

Resumo

Métodos públicos
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Esse método foi descontinuado. Use `setUp(TestInformation)` em vez disso
`default void`	`setUp(TestInformation testInformation)` Faça a configuração de destino para testes.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` Execute a limpeza/desmontagem de destino após o teste.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` Esse método foi descontinuado. Use `tearDown(TestInformation,Throwable)` em vez disso

Métodos públicos

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Esse método foi descontinuado.
Use setUp(TestInformation)

Faça a configuração de destino para testes.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser preparado.
`buildInfo`	`IBuildInfo`: dados sobre o build em teste.

Gera
`DeviceNotAvailableException`	se o dispositivo não responder
`BuildError`	Se ocorrer um erro relacionado ao BuildInfo
`TargetSetupError`	se um erro fatal ocorreu ao configurar o ambiente

setUp

public void setUp (TestInformation testInformation)

Faça a configuração de destino para testes.

Parâmetros
`testInformation`	`TestInformation`: o `TestInformation` da invocação.

Gera
`DeviceNotAvailableException`	se o dispositivo não responder
`BuildError`	Se ocorrer um erro devido à preparação do build
`TargetSetupError`	se um erro fatal ocorreu ao configurar o ambiente

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Execute a limpeza/desmontagem de 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, será a exceção capturada no nível de 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)

Esse método foi descontinuado.
Use tearDown(TestInformation,Throwable)

Execute a limpeza/desmontagem de 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, será a exceção capturada no nível de invocação. Caso contrário, será `null`.

Gera
`DeviceNotAvailableException`	se o dispositivo não responder