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 , CompanionTestAppInstall Setup , CompileBootImageWithSpeedTargetPreparer , CpuThrottlingWaiter e 73 outros. AdbStopServerPreparer Preparador de destino para parar o servidor adb no host antes e depois de executar testes adb. AllTestAppsInstallSetup Um ITargetPreparer que instala todos os aplicativos de uma pasta IDeviceBuildInfo#getTestsDir() no dispositivo. AoaTargetPreparer ITargetPreparer que executa uma série de ações (por exemplo, cliques e furtos) usando o protocolo Android Open Accessory (AOAv2). AppSetup Um ITargetPreparer que instala um apk e seus testes. ArtChrootPreparerName Crie o diretório chroot para testes ART. BaseEmulatorPreparer Preparador comum para iniciar um emulador local. BaseTargetPreparer Classe de implementação base para ITargetPreparer que permite controlar se o objeto está desabilitado ou não. BuildInfoRecorder Um ITargetPreparer que grava metadados de informações de compilação em um arquivo especificado. CheckPairingPreparer Um CompanionAwarePreparer que verifica a ligação BT entre dispositivos primários e complementares CompanionAllocator Classe base que cuida da alocação e liberação do dispositivo complementar getCompanionDeviceSelectionOptions() deve ser implementado para descrever os critérios necessários para alocar o dispositivo complementar CompanionAwarePreparer Um ITargetPreparer que encapsula a lógica de obtenção de um dispositivo complementar já alocado. CompanionRunCommandTargetPreparer Um ITargetPreparer que executa comandos especificados no dispositivo complementar alocado CompanionTestAppInstallSetup Um ITargetPreparer que instala um ou mais aplicativos 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 de compilador 'speed'. CpuThrottlingWaiter Um ITargetPreparer que espera 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 o usuário e limpá-lo no final. DeviceBuildInfoBootStrapper Um ITargetPreparer que substitui campos de informações de compilação por atributos lidos do dispositivo Isso é útil para testar dispositivos com compilações geradas de uma fonte externa (por exemplo, DeviceBuildInfoInjector Um ITargetPreparer que insere metadados DeviceBuildDescriptor no IBuildInfo . DeviceCleaner Executa reinicialização ou formatação como ação de limpeza após o teste e, opcionalmente, desliga a tela DeviceFlashPreparer Um ITargetPreparer que exibe uma imagem no hardware Android físico. DeviceImageZipFlashingTargetPreparer Um preparador de destino que atualiza o dispositivo com imagens do dispositivo fornecidas por meio de um formato específico. DeviceOwnerTargetPreparer Um ITargetPreparer que configura um componente proprietário do dispositivo. Configuração do dispositivo Um ITargetPreparer que configura um dispositivo para teste com base nas Option fornecidas. DeviceStorageFiller Preparador de destino para preencher o armazenamento para que alguma quantidade de 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 relacionadas à atualização de dispositivos com um arquivo de imagem de dispositivo de uma fonte externa (em oposição a um serviço de compilação). DeviceWiper Um ITargetPreparer que limpa os dados do usuário DisableSELinuxTargetPreparer Preparador de destino que desativa o SELinux, se ativado. DynamicSystemPreparer Um ITargetPreparer que configura uma imagem do sistema sobre um dispositivo criado com a atualização dinâmica do sistema. EraseUserDataPreparer Um ITargetPreparer que limpa os dados do usuário no dispositivo. FastbootCommandPreparer Preparador de destino que aciona o fastboot e envia comandos de fastboot. FastbootUpdateBootstrapPreparer Um ITargetPreparer que organiza arquivos especificados (carregador de inicialização, rádio, zip de imagem do dispositivo) em IDeviceBuildInfo para obter dispositivos atualizados com FastbootDeviceFlasher e, em seguida, injeta atributos de dispositivo pós-inicialização nas informações de compilação para fins de relatório de resultados. FeatureFlagTargetPreparer Atualiza o DeviceConfig (sinalizadores de recursos ajustados por um serviço remoto). FoldableModePreparer Um preparador de destino que pode alternar o estado dobrável de um dispositivo. Folder Saver 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 do sistema genérico do Android. ILabPreparerName Interface de marcador para preparadores de laboratório Consulte ITargetPreparer para obter uma descrição do objetivo dessas interfaces. ITargetCleaner Esta interface está obsoleta. tearDown foi movido para a interface base ITargetPreparer. InstallAllTestZipAppsSetup Um ITargetPreparer que instala todos os aplicativos em um 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 compilação da plataforma Android. Preparador de instrumentação Um ITargetPreparer que executa 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 de um ambiente de compilação Android. LocalEmulatorSnapshot Um TargetPreparer destinado a gerar um instantâneo de emulador limpo a partir de um ambiente de construção/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 completamente uma invocação (preparação e testes) se não houver apks para testes. PerfettoPreparer O preparador Perfetto envia o arquivo de configuração para o dispositivo em um local padrão ao qual 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 está obsoleta. 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. PythonVirtualenvPreparerName Configura um Python virtualenv no host e instala pacotes. RebootTargetPreparer Preparador de destino que reinicializa o dispositivo. RecoveryLogPreparer Um preparador de destino usado para coletar logs 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 reinicializar 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 de executar o teste. RunHostScriptTargetPreparer Preparador de destino que executa um script antes de executar um teste. RunOnCloneProfileTargetPreparer RunOnSdkSandboxTargetPreparer Um ITargetPreparer para marcar que os testes devem ser executados na caixa de proteção sdk. RunOnSecondaryUserTargetPreparer Um ITargetPreparer que cria um usuário secundário na configuração e marca que os testes devem ser executados nesse usuário. RunOnSystemUserTargetPreparer Um ITargetPreparer que marca os testes que 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 Este é um preparador usado para usar o token para serializar a execução do teste no host alimentado por troca. SideloadOtaTargetPreparer Um preparador de destino que executa o sideload de um pacote OTA especificado, aplica o pacote, aguarda a inicialização do dispositivo e injeta as propriedades de compilação do dispositivo para usar como informações de compilação Este preparador de destino assume que o dispositivo estará no modo adb regular quando iniciado e garantirá que o dispositivo saia no mesmo modo, mas com a compilação mais recente aplicada. StopServicesSetup Um ITargetPreparer que interrompe os serviços no dispositivo. StubTargetPreparer Implementação vazia de espaço reservado de um ITargetPreparer . SuiteApkInstaller Instala os APKs especificados para a configuração do Suite: da variável $ANDROID_TARGET_OUT_TESTCASES ou do ROOT_DIR nas informações de compilação. SwitchUserTargetPreparer Um ITargetPreparer que alterna para o tipo de usuário especificado em setUp. TearDownPassThroughPreparer Permite executar tearDown em preparadores que estão incluídos em uma configuração como um objeto. TemperatureThrottlingWaiter Um ITargetPreparer que espera até que a temperatura do dispositivo desça para o alvo TestAppInstallSetup Um ITargetPreparer que instala um ou mais aplicativos 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 aplicativos de uma pasta IDeviceBuildInfo.getTestsDir() na partição /system no dispositivo. Desperdiçador de tempo 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 execução de testes em um usuário que é iniciado no visível em segundo plano. WaitForDeviceDatetimePreparer Um ITargetPreparer que espera que a data e a hora sejam definidas no dispositivo Opcionalmente, este preparador pode forçar um TargetSetupError se a data e hora não for definida dentro do tempo limite ou forçar a data e hora do host no dispositivo, WifiPreparer Um ITargetPreparer que configura wifi 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 teste, inicia alvos, etc.

Observe que vários ITargetPreparer s podem ser especificados em uma configuração. Recomenda-se que cada ITargetPreparer documente claramente sua pré-configuração e pós-configuração do ambiente esperado. por exemplo, um ITargetPreparer que configura um dispositivo para teste deve 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 está obsoleto. Em vez disso, use setUp(com.android.tradefed.invoker.TestInformation)
default void	setUp ( TestInformation testInformation) Execute a configuração de destino para teste.
default void	tearDown ( TestInformation testInformation, Throwable e) Execute a limpeza/desmontagem do alvo após o teste.
default void	tearDown ( ITestDevice device, IBuildInfo buildInfo, Throwable e) Este método está obsoleto. Em vez disso, use tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

Métodos públicos

configurar

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Este método está obsoleto.
Em vez disso, use setUp(com.android.tradefed.invoker.TestInformation)

Execute a configuração de destino para teste.

Parâmetros
device	ITestDevice : o ITestDevice a ser preparado.
buildInfo	IBuildInfo : dados sobre a compilação em teste.

lances
TargetSetupError	se ocorreu um erro fatal ao configurar o ambiente
BuildError	Se ocorrer um erro relacionado ao BuildInfo
DeviceNotAvailableException	se o dispositivo deixou de responder

configurar

public void setUp (TestInformation testInformation)

Execute a configuração de destino para teste.

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

lances
TargetSetupError	se ocorreu um erro fatal ao configurar o ambiente
BuildError	Se ocorrer um erro devido à preparação da compilação
DeviceNotAvailableException	se o dispositivo deixou de responder

destruir

public void tearDown (TestInformation testInformation, 
                Throwable e)

Execute a limpeza/desmontagem do alvo após o teste.

Parâmetros
testInformation	TestInformation : O TestInformation da invocação.
e	Throwable : se a invocação terminou com uma exceção, esta será a exceção que foi capturada no nível de Invocação. Caso contrário, será null .

lances
DeviceNotAvailableException	se o dispositivo deixou de responder

destruir

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

Este método está obsoleto.
Em vez disso, use tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

Execute a limpeza/desmontagem do alvo após o teste.

Parâmetros
device	ITestDevice : o ITestDevice a ser preparado.
buildInfo	IBuildInfo : dados sobre a compilação em teste.
e	Throwable : se a invocação terminou com uma exceção, esta será a exceção que foi capturada no nível de Invocação. Caso contrário, será null .

lances
DeviceNotAvailableException	se o dispositivo deixou de responder