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

BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CreateAvdPreparer, CreateUserPreparer, DeviceBuildInfoBootStrapper, DeviceBuildInfoInjector, DeviceCleaner, DeviceFlashPreparer, DeviceImageZipFlashingTargetPreparer, DeviceSetup, DeviceUpdateTargetPreparer, FastbootUpdateBootstrapPreparer, FoldableModePreparer, GkiDeviceFlashPreparer e 15 outras.

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.
CreateAvdPreparer
CreateUserPreparer	Preparador de destino para criar o usuário e limpá-lo no final.
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	Realiza a reinicialização ou formatação 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.
DeviceSetup	Um `ITargetPreparer` que configura um dispositivo para testes com base nos `Option`s fornecidos.
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).
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.
FoldableModePreparer	Um preparador de destino que pode mudar o estado dobrável de um dispositivo.
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.
ITargetCleaner (link em inglês)	Essa interface foi descontinuada. O tearDown foi movido para a interface ITargetPreparer de base.
InstallApexModuleTargetPreparer
KillExistingEmulatorPreparer	Um `ITargetPreparer` que encerra um emulador em execução.
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 em um ambiente de build/desenvolvimento do Android
ModuleOemTargetPreparer
RecoveryLogPreparer	Um preparador de destino usado para coletar registros antes da recuperação.
RunCommandTargetPreparer
RunOnSecondaryUserTargetPreparer	Um `ITargetPreparer` que cria um usuário secundário na configuração e marca que os testes precisam ser executados nesse usuá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.
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.
TestAppInstallSetup	Um `ITargetPreparer` que instala um ou mais apps de uma pasta `IDeviceBuildInfo.getTestsDir()` no dispositivo.

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 após a 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