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 outros 79.

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.
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.
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 e limpar o usuário no final.
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 algum espaço livre esteja 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 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 em cima de um build de dispositivo com a Atualização dinâmica do sistema.
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	Atualiza o DeviceConfig (flags de recursos ajustadas por um serviço remoto).
FoldableModePreparer	Um preparador de destino que pode mudar 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.
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ó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 encerra um emulador em execução.
KnownFailurePreparer	Preparador de destino para ignorar novas tentativas 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.
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.
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	Preparador de destino que executa "adb root" ou "adb unroot" com base na opção "force-root".
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Preparador de destino para executar comandos de host arbitrários 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.
SideloadOtaTargetPreparer	Um preparador de destino que realiza o 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	Marcador de posição de uma implementação vazia 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	Um `ITargetPreparer` que muda para o tipo de usuário especificado em setUp.
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 Como opção, esse preparador pode forçar um `TargetSetupError` se a data e hora não forem definidas 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(com.android.tradefed.invoker.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)` Faça a limpeza/desmontagem do destino após o teste.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` Esse método foi descontinuado. Use `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)` em vez disso

Métodos públicos

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Esse método foi descontinuado.
Use setUp(com.android.tradefed.invoker.TestInformation) em vez disso

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
`TargetSetupError`	se um erro fatal ocorreu 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)

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

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

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

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Faça a limpeza/desmontagem 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, esta 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(com.android.tradefed.invoker.TestInformation, Throwable) em vez disso

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

Gera
`DeviceNotAvailableException`	se o dispositivo não responder