A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Subclasses indiretas conhecidas

AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CheckPairingPreparer, CompanionAllocator, CompanionAwarePreparer, CompanionRunCommandTargetPreparer, CompanionTestAppInstallSetup, CompileBootImageWithSpeedTargetPreparer, CpuThrottlingWaiter e 76 outras.

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 `Option`s 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