A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Esta página se ha traducido con Cloud Translation API.

Preparador de objetivos

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Subclases indirectas conocidas

AdbStopServerPreparer , AllTestAppsInstallSetup , AoaTargetPreparer , AppSetup , ArtChrootPreparer , BaseEmulatorPreparer , BaseTargetPreparer , BuildInfoRecorder , CheckPairingPreparer , CompanionAllocator , CompanionAwarePreparer , CompanionRunCommandTargetPreparer , CompanionTestAppInsta llSetup , CompileBootImageWithSpeedTargetPreparer , CpuThrottlingWaiter y 74 personas más.

AdbStopServerPreparador	El preparador de destino debe detener el servidor adb en el host antes y después de ejecutar las pruebas de adb.
AllTestAppsInstallConfiguración	Un `ITargetPreparer` que instala todas las aplicaciones desde una carpeta `IDeviceBuildInfo#getTestsDir()` en el dispositivo.
AoaTargetPreparador	`ITargetPreparer` que ejecuta una serie de acciones (por ejemplo, clics y deslizamientos) utilizando el protocolo Android Open Accesorio (AOAv2).
Configuración de la aplicación	Un `ITargetPreparer` que instala un apk y lo prueba.
ArtChrootPreparador	Cree un directorio chroot para las pruebas ART.
Preparador del emulador de base	Preparador común para lanzar un emulador local.
Preparador de objetivos base	Clase de implementación base para `ITargetPreparer` que permite controlar si el objeto está deshabilitado o no.
BuildInfoRecorder	Un `ITargetPreparer` que escribe metadatos de información de compilación en un archivo específico.
ComprobarEmparejamientoPreparador	Un `CompanionAwarePreparer` que verifica la vinculación BT entre los dispositivos principal y complementario
Asignador complementario	Clase base que se encarga de asignar y liberar el dispositivo complementario Se debe implementar `getCompanionDeviceSelectionOptions()` para describir los criterios necesarios para asignar el dispositivo complementario.
CompanionAwarePreparador	Un `ITargetPreparer` que encapsula la lógica de obtener un dispositivo complementario ya asignado.
CompanionRunCommandTargetPreparar	Un `ITargetPreparer` que ejecuta comandos específicos en el dispositivo complementario asignado
CompanionTestAppInstallConfiguración	Un `ITargetPreparer` que instala una o más aplicaciones desde una carpeta `IDeviceBuildInfo#getTestsDir()` en un dispositivo complementario asignado.
CompileBootImageWithSpeedTargetPreparar	Recompila el classpath de arranque y el servidor del sistema con el filtro del compilador 'velocidad'.
CpuAceleraciónCamarero	Un `ITargetPreparer` que espera hasta que la frecuencia máxima en todos los núcleos se restablezca al nivel más alto disponible
CrearAvdPreparer
CrearPreparadorDeUsuario	Preparador de destino para crear un usuario y limpiarlo al final.
DispositivoAcciónTargetPreparador	Un `ITargetPreparer` para realizar acciones del dispositivo.
DispositivoBuildInfoBootStrapper	Un `ITargetPreparer` que reemplaza los campos de información de compilación con atributos leídos desde el dispositivo Esto es útil para probar dispositivos con compilaciones generadas desde una fuente externa (p. ej.
DispositivoBuildInfoInjector	Un `ITargetPreparer` que inserta metadatos `DeviceBuildDescriptor` en `IBuildInfo` .
Limpiador de dispositivos	Realiza un reinicio o formateo como acción de limpieza después de la prueba y, opcionalmente, apaga la pantalla.
DispositivoFlashPreparador	Un `ITargetPreparer` que muestra una imagen en el hardware físico de Android.
DispositivoImagenZipFlashingTargetPreparar	Un preparador de objetivos que muestra el dispositivo con imágenes del dispositivo proporcionadas a través de un formato específico.
Propietario del dispositivo, preparador de destino	Un `ITargetPreparer` que configura un componente propietario del dispositivo.
Configuración de dispositivo	Un `ITargetPreparer` que configura un dispositivo para realizar pruebas según las `Option` proporcionadas.
DispositivoAlmacenamientoFiller	Objetivo preparador para llenar el almacenamiento para que haya cierta cantidad de espacio libre disponible.
DispositivoStringPusher	Preparador de destino para escribir una cadena en un archivo.
DispositivoUpdateTargetPreparer	Un `ITargetPreparer` abstracto que se ocupa de los pasos comunes relacionados con la actualización de dispositivos con un archivo de imagen de dispositivo de una fuente externa (a diferencia de un servicio de compilación).
Limpiador de dispositivos	Un `ITargetPreparer` que borra los datos del usuario
Deshabilitar SELinuxTargetPreparer	Preparador de destino que deshabilita SELinux si está habilitado.
Preparador de sistema dinámico	Un `ITargetPreparer` que configura una imagen del sistema sobre una compilación de dispositivo con la Actualización dinámica del sistema.
BorrarUserDataPreparer	Un `ITargetPreparer` que borra los datos del usuario en el dispositivo.
Preparador de comandos Fastboot	Preparador de destino que activa fastboot y envía comandos fastboot.
FastbootUpdateBootstrapPreparador	Un `ITargetPreparer` que organiza archivos específicos (cargador de arranque, radio, zip de imagen del dispositivo) en `IDeviceBuildInfo` para actualizar los dispositivos con `FastbootDeviceFlasher` y luego inyecta atributos del dispositivo posteriores al arranque en la información de compilación para fines de generación de informes de resultados.
FeatureFlagTargetPreparar	Actualiza DeviceConfig (indicadores de funciones ajustados por un servicio remoto).
Preparador de modo plegable	Un preparador de objetivos que puede cambiar el estado plegable de un dispositivo.
Protector de carpetas	Un `ITargetPreparer` que extrae directorios del dispositivo, los comprime y los guarda en el backend de registro.
GkiDeviceFlashPreparador	Un preparador de objetivos que muestra el dispositivo con una imagen genérica del kernel común de Android.
GsiDeviceFlashPreparador	Un preparador de objetivos que muestra el dispositivo con una imagen genérica del sistema Android.
ILabPreparador	Interfaz de marcador para preparadores de laboratorio Consulte `ITargetPreparer` para obtener una descripción de para qué sirven estas interfaces.
ITargetCleaner	Esta interfaz está en desuso. TearDown se ha movido a la interfaz básica de ITargetPreparer.
Instalar AllTestZipAppsConfiguración	Un `ITargetPreparer` que instala todas las aplicaciones en un zip de prueba.
InstalarApexModuleTargetPreparer
InstalarApkSetup	Un `ITargetPreparer` que instala una o más aplicaciones ubicadas en el sistema de archivos.
InstalarBuildEnvApkSetup	Un `ITargetPreparer` que instala una o más aplicaciones de prueba desde un entorno de compilación de plataforma Android.
Preparador de instrumentación	Un `ITargetPreparer` que ejecuta instrumentación
KillExistingEmulatorPreparar	Un `ITargetPreparer` que apaga un emulador en ejecución.
Preparador de fallos conocidos	El preparador de destino debe omitir el reintento de error conocido.
Lanzamiento del emulador local	Un TargetPreparer que inicia un emulador localmente desde un entorno de compilación de Android.
Instantánea del emulador local	Un TargetPreparer destinado a generar una instantánea limpia del emulador desde un entorno de compilación/desarrollo de Android.
MixKernelTargetPreparador	Un `ITargetPreparer` que permite mezclar una imagen del kernel con la imagen del dispositivo.
MóduloOemTargetPreparar
Colector de fugas nativo	Un `ITargetPreparer` que ejecuta 'dumpsys meminfo --unreachable -a' para identificar la memoria nativa inalcanzable que actualmente tiene cada proceso.
NoApkTestSkipper	Preparador especial que permite saltarse una invocación por completo (preparación y pruebas) si no hay apks para probar.
PerfettoPreparador	El preparador de Perfetto inserta el archivo de configuración en el dispositivo en una ubicación estándar a la que perfetto tiene acceso.
Preparador de objetivos de perfil	Clase base para configurar el preparador de objetivos para cualquier usuario de perfil `android.os.usertype.profile.XXX` .
PushFileInvoker	Esta clase está en desuso. Utilice `PushFilePreparer` en su lugar
Preparador de archivos push	Un `ITargetPreparer` que intenta enviar cualquier cantidad de archivos desde cualquier ruta de host a cualquier ruta de dispositivo.
Preparador de PythonVirtualenv	Configura un virtualenv de Python en el host e instala paquetes.
ReiniciarTargetPreparar	Preparador de destino que reinicia el dispositivo.
Preparador de registros de recuperación	Un preparador de destino utilizado para recopilar registros antes de la recuperación.
EliminarSystemAppPreparer	Un `ITargetPreparer` para eliminar un apk de la partición del sistema antes de una ejecución de prueba.
ReiniciarSystemServerTargetPreparer	Preparador de destino que reinicia el servidor del sistema sin reiniciar el dispositivo.
Preparador de destino raíz	Preparador de destino que realiza "adb root" o "adb unroot" según la opción "force-root".
EndodonciaForwarderPreparador
EjecutarCommandTargetPreparador
EjecutarHostCommandTargetPreparer	El preparador de destino ejecutará comandos de host arbitrarios antes y después de ejecutar la prueba.
EjecutarHostScriptTargetPreparar	Preparador de destino que ejecuta un script antes de ejecutar una prueba.
RunOnCloneProfileTargetPreparador
RunOnSdkSandboxTargetPreparar	Un `ITargetPreparer` para marcar que las pruebas deben ejecutarse en el entorno limitado del SDK.
RunOnSecondaryUserTargetPreparador	Un `ITargetPreparer` que crea un usuario secundario en la configuración y marca que las pruebas deben ejecutarse en ese usuario.
RunOnSystemUserTargetPreparador	Un `ITargetPreparer` que marca que las pruebas deben ejecutarse en el usuario (en lugar del usuario actual).
RunOnWorkProfileTargetPreparador	Un `ITargetPreparer` que crea un perfil de trabajo en la configuración y marca que las pruebas deben ejecutarse en ese usuario.
SemaphoreTokenTargetPreparador	Este es un preparador que se utiliza para utilizar token para serializar la ejecución de pruebas en un host comercializado.
Carga lateralOtaTargetPreparar	Un preparador de destino que realiza la carga local de un paquete OTA específico, aplica el paquete, espera a que el dispositivo se inicie e inyecta las propiedades de compilación del dispositivo para usarlas como información de compilación. Este preparador de objetivos supone que el dispositivo estará en modo adb normal cuando se inicie y garantizará que el dispositivo salga en el mismo modo pero con la versión más nueva aplicada.
Detener configuración de servicios	Un `ITargetPreparer` que detiene los servicios en el dispositivo.
Preparador de StubTarget	Implementación vacía de marcador de posición de un `ITargetPreparer` .
SuiteApkInstalador	Instala APK específicos para la configuración de la suite: ya sea desde la variable $ANDROID_TARGET_OUT_TESTCASES o ROOT_DIR en la información de compilación.
SwitchUserTargetPreparador	Un `ITargetPreparer` que cambia al tipo de usuario especificado en setUp.
TearDownPassThroughPreparador	Permite ejecutar TearDown en preparadores que están incluidos en una configuración como un objeto.
TemperaturaEstrangulaciónCamarero	Un `ITargetPreparer` que espera hasta que la temperatura del dispositivo baje al objetivo
Configuración de instalación de aplicación de prueba	Un `ITargetPreparer` que instala una o más aplicaciones desde una carpeta `IDeviceBuildInfo.getTestsDir()` en el dispositivo.
PruebaFilePushConfiguración	Un `ITargetPreparer` que inserta uno o más archivos/directorios desde una carpeta `IDeviceBuildInfo.getTestsDir()` en el dispositivo.
PruebaSystemAppInstallSetup	Un `ITargetPreparer` que instala una o más aplicaciones desde una carpeta `IDeviceBuildInfo.getTestsDir()` en la partición /system del dispositivo.
Derrochador de tiempo	Un preparador de objetivos simple para perder el tiempo y potencialmente reiniciar el dispositivo.
Limpiador de usuarios	Un `ITargetPreparer` que elimina usuarios secundarios durante el desmontaje.
VisibleBackgroundUserPreparador	Preparador de destino para ejecutar pruebas en un usuario que se inicia en modo visible en segundo plano.
WaitForDeviceDatetimePreparar	Un `ITargetPreparer` que espera a que se establezca la fecha y hora en el dispositivo Opcionalmente, este preparador puede forzar un `TargetSetupError` si la fecha y hora no está configurada dentro del tiempo de espera, o forzar la fecha y hora del host en el dispositivo.
Preparador de Wifi	Un `ITargetPreparer` que configura wifi en el dispositivo si es necesario.

Prepara el entorno de prueba para la ejecución de la prueba.

Por ejemplo, instala software, modifica la configuración del entorno para realizar pruebas, lanza objetivos, etc.

Tenga en cuenta que se pueden especificar varios ITargetPreparer en una configuración. Se recomienda que cada ITargetPreparer documente claramente la configuración previa y posterior del entorno esperado. por ejemplo, se debe ejecutar un ITargetPreparer que configura un dispositivo para realizar pruebas después del ITargetPreparer que instala el software.

Resumen

Métodos públicos
`default void`	`setUp ( ITestDevice device, IBuildInfo buildInfo)` Este método está en desuso. Utilice `setUp(com.android.tradefed.invoker.TestInformation)` en su lugar
`default void`	`setUp ( TestInformation testInformation)` Realice la configuración del objetivo para la prueba.
`default void`	`tearDown ( TestInformation testInformation, Throwable e)` Realice la limpieza/desmontaje del objetivo después de la prueba.
`default void`	`tearDown ( ITestDevice device, IBuildInfo buildInfo, Throwable e)` Este método está en desuso. Utilice `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)` en su lugar

Métodos públicos

configuración

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Este método está en desuso.
Utilice setUp(com.android.tradefed.invoker.TestInformation) en su lugar

Realice la configuración del objetivo para la prueba.

Parámetros
`device`	`ITestDevice` : el `ITestDevice` a preparar.
`buildInfo`	`IBuildInfo` : datos sobre la compilación bajo prueba.

Lanza
`TargetSetupError`	si ocurrió un error fatal al configurar el entorno
`BuildError`	Si ocurre un error relacionado con BuildInfo
`DeviceNotAvailableException`	si el dispositivo deja de responder

configuración

public void setUp (TestInformation testInformation)

Realice la configuración del objetivo para la prueba.

Parámetros
`testInformation`	`TestInformation` : La `TestInformation` de la invocación.

Lanza
`TargetSetupError`	si ocurrió un error fatal al configurar el entorno
`BuildError`	Si se produce un error debido a que se está preparando la compilación
`DeviceNotAvailableException`	si el dispositivo deja de responder

demoler

public void tearDown (TestInformation testInformation, 
                Throwable e)

Realice la limpieza/desmontaje del objetivo después de la prueba.

Parámetros
`testInformation`	`TestInformation` : La `TestInformation` de la invocación.
`e`	`Throwable` : si la invocación terminó con una excepción, esta será la excepción que se detectó en el nivel de Invocación. De lo contrario, será `null` .

Lanza
`DeviceNotAvailableException`	si el dispositivo deja de responder

demoler

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

Este método está en desuso.
Utilice tearDown(com.android.tradefed.invoker.TestInformation, Throwable) en su lugar

Realice la limpieza/desmontaje del objetivo después de la prueba.

Parámetros
`device`	`ITestDevice` : el `ITestDevice` a preparar.
`buildInfo`	`IBuildInfo` : datos sobre la compilación bajo prueba.
`e`	`Throwable` : si la invocación terminó con una excepción, esta será la excepción que se detectó en el nivel de Invocación. De lo contrario, será `null` .

Lanza
`DeviceNotAvailableException`	si el dispositivo deja de responder