A partir de 2026, para alinearnos con nuestro modelo de desarrollo estable de la rama principal y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en AOSP en el segundo y cuarto trimestre. Para compilar AOSP y contribuir a él, te recomendamos que utilices android-latest-release en lugar de aosp-main. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en AOSP.

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

java.lang.Object
↳	com.android.tradefed.device.NativeDevice

Subclases directas conocidas

TestDevice

TestDevice Implementación de un ITestDevice para un dispositivo Android de pila completa

Subcategorías indirectas conocidas

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	Clase para dispositivos virtuales locales que se ejecutan en el host de Tradefed.
ManagedRemoteDevice	Es un dispositivo que se ejecuta dentro de una máquina virtual que administramos de forma remota a través de una instancia de Tradefed dentro de la VM.
NestedRemoteDevice	Representación del dispositivo que se ejecuta dentro de una VM de Cuttlefish remota.
RemoteAndroidDevice	Implementación de un `ITestDevice` para un dispositivo Android de pila completa conectado a través de adb connect.
RemoteAndroidVirtualDevice	Extiende el comportamiento de `RemoteAndroidDevice` para un dispositivo Android de pila completa que se ejecuta en Google Compute Engine (GCE).

Es la implementación predeterminada de un ITestDevice para dispositivos Android que no son de pila completa.

Resumen

Clases anidadas
`class`	`NativeDevice.AdbAction` Es un `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` para ejecutar un comando del SO "adb…".
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` para reiniciar un dispositivo

Constantes
`String`	`DEBUGFS_PATH`
`int`	`INVALID_USER_ID` Valor que se devuelve para cualquier ID de usuario no válido o no encontrado: UserHandle definió el valor -10000
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` Cantidad predeterminada de intentos de reejecución de comandos que se realizarán
`String`	`SD_CARD`
`String`	`STORAGE_EMULATED`

Campos
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

Constructores públicos
`NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` Crea un `TestDevice`.

Métodos públicos
`void`	`batchPrefetchStartupBuildProps()` Microoptimización (alrededor de 400 ms) mediante la recuperación previa de todas las propiedades que necesitamos en lugar de llamar a "adb getprop" para cada una.
`boolean`	`canSwitchToHeadlessSystemUser()` Devuelve si se permite cambiar al usuario SYSTEM sin interfaz gráfica.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Comprueba si una función se admite actualmente en un nivel de compatibilidad mínimo.
`boolean`	`checkConnectivity()` Comprueba que el dispositivo tenga conectividad de red.
`boolean`	`clearErrorDialogs()` Intenta descartar los diálogos de error que se muestran actualmente en la IU del dispositivo.
`void`	`clearLastConnectedWifiNetwork()` Borra la última red Wi-Fi a la que se conectó.
`void`	`clearLogcat()` Borra los datos de logcat acumulados.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Se conecta a una red Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Se conecta a una red Wi-Fi.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Se conecta a una red Wi-Fi.f
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` Se conecta a una red Wi-Fi.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` Es una variante de `connectToWifiNetwork(String, String)` que solo se conecta si el dispositivo no tiene conectividad de red en ese momento.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` Es una variante de `connectToWifiNetwork(String, String)` que solo se conecta si el dispositivo no tiene conectividad de red en ese momento.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` Crea un usuario con un nombre determinado y las marcas proporcionadas
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Crea un usuario con un nombre determinado y las marcas proporcionadas
`int`	`createUser(String name)` Crea un usuario con un nombre determinado y marcas predeterminadas 0.
`int`	`createUserNoThrow(String name)` Crea un usuario con un nombre determinado y marcas predeterminadas 0.
`DeviceInspectionResult`	`debugDeviceNotAvailable()` Inspecciona un dispositivo y devuelve información detallada cuando un dispositivo deja de estar disponible.
`void`	`deleteFile(String deviceFilePath, int userId)` Método auxiliar para borrar un archivo o directorio en el dispositivo.
`void`	`deleteFile(String deviceFilePath)` Método auxiliar para borrar un archivo o directorio en el dispositivo.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Quita el `IDeviceActionReceiver` registrado.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Método auxiliar para verificar si el dispositivo se reinició de forma parcial comparando el system_server actual con el system_server anterior `ProcessInfo`.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Método de ayuda para verificar si el dispositivo se reinició de forma parcial desde la hora UTC desde la época del dispositivo y su `ERROR(/TimeUnit)`.
`boolean`	`disableAdbRoot()` Desactiva el acceso raíz de adb.
`void`	`disableKeyguard()` Intenta inhabilitar el bloqueo de teclado.
`boolean`	`disableNetworkMonitor()` Inhabilita la supervisión de la red en el dispositivo.
`boolean`	`disconnectFromWifi()` Se desconecta de una red Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` Método de ayuda para determinar si existe un archivo en el dispositivo para un usuario determinado.
`boolean`	`doesFileExist(String deviceFilePath)` Método auxiliar para determinar si existe un archivo en el dispositivo.
`File`	`dumpHeap(String process, String devicePath)` Intenta volcar el montón de system_server.
`boolean`	`enableAdbRoot()` Activa el acceso raíz de adb.
`boolean`	`enableNetworkMonitor()` Habilita la supervisión de la red en el dispositivo.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` Método auxiliar que ejecuta un comando de adb como un comando del sistema con un tiempo de espera especificado.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` Método auxiliar que ejecuta un comando de adb como un comando del sistema con un tiempo de espera especificado.
`String`	`executeAdbCommand(String... cmdArgs)` Método auxiliar que ejecuta un comando de adb como un comando del sistema.
`CommandResult`	`executeAdbV2Command(String... cmdArgs)` Método auxiliar que ejecuta un comando de adb como un comando del sistema.
`CommandResult`	`executeAdbV2Command(long timeout, String... cmdArgs)` Método auxiliar que ejecuta un comando de adb como un comando del sistema con un tiempo de espera especificado.
`CommandResult`	`executeAdbV2Command(long timeout, envMap, String... cmdArgs)` Método auxiliar que ejecuta un comando de adb como un comando del sistema con un tiempo de espera especificado.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` Método auxiliar que ejecuta un comando de fastboot como un comando del sistema con un tiempo de espera predeterminado de 2 minutos.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` Método auxiliar que ejecuta un comando de fastboot como un comando del sistema.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` Método auxiliar que ejecuta un comando fastboot de larga duración como un comando del sistema.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` Método auxiliar que ejecuta un comando fastboot de larga duración como un comando del sistema con variables de entorno del sistema.
`String`	`executeShellCommand(String command)` Método de ayuda que ejecuta un comando shell de adb y muestra el resultado como un `String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Ejecuta el comando adb shell especificado y vuelve a intentarlo varias veces si falla.
`CommandResult`	`executeShellV2Command(String cmd)` Método de ayuda que ejecuta un comando shell de adb y devuelve los resultados como un `CommandResult` completado correctamente con el resultado del estado del comando, stdout y stderr.
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` Método auxiliar que ejecuta un comando shell de adb y devuelve los resultados como un objeto `CommandResult` correctamente completado con el resultado del estado del comando y stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` Método auxiliar que ejecuta un comando shell de adb y devuelve los resultados como un `CommandResult` completado correctamente con el resultado del estado del comando, stdout y stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.
`CommandResult`	`fastbootWipePartition(String partition)` Método auxiliar que borra una partición del dispositivo.
	`getActiveApexes()` Recupera la información sobre los APEX activados en el dispositivo.
`String`	`getAdbPath()` Devuelve la ruta de acceso del objeto binario de adb que se está usando.
	`getAllSettings(String namespace)` Devuelve pares clave-valor del espacio de nombres solicitado.
`DeviceAllocationState`	`getAllocationState()` Devuelve el estado de asignación actual del dispositivo
`String`	`getAndroidId(int userId)` Busca y devuelve el android-id asociado a un userId. Devuelve null si no se encuentra.
	`getAndroidIds()` Crea un mapa de los IDs de Android que coinciden con los IDs de usuario.
`int`	`getApiLevel()` Obtiene el nivel de API del dispositivo.
`PackageInfo`	`getAppPackageInfo(String packageName)` Recupera información sobre un paquete instalado en el dispositivo.
	`getAppPackageInfos()` Recupera información de los paquetes instalados en el dispositivo.
`String`	`getBasebandVersion()` Método de conveniencia para obtener la versión de banda base (radio) de este dispositivo.
`Integer`	`getBattery()` Devuelve el nivel de batería actual de un dispositivo o Null si el nivel de batería no está disponible.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` Devuelve el valor booleano de la propiedad determinada.
	`getBootHistory()` El método auxiliar recopila el mapa del historial de inicio con la hora y el motivo del inicio.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` El método auxiliar recopila el mapa del historial de inicio con la hora y el motivo del inicio desde el momento determinado desde la época del dispositivo y la unidad de tiempo especificada.
`String`	`getBootloaderVersion()` Método de conveniencia para obtener la versión del bootloader de este dispositivo.
`InputStreamSource`	`getBugreport()` Recupera un informe de errores del dispositivo.
`InputStreamSource`	`getBugreportz()` Recupera un bugreportz del dispositivo.
`String`	`getBuildAlias()` Recupera el alias de la compilación que se está ejecutando en el dispositivo.
`String`	`getBuildFlavor()` Recupera la variante de compilación para el dispositivo.
`String`	`getBuildId()` Recupera la compilación que se está ejecutando en el dispositivo.
`String`	`getBuildSigningKeys()` Devuelve el tipo de clave que se usó para firmar la imagen del dispositivo. Por lo general, los dispositivos Android se pueden firmar con claves de prueba (como en AOSP) o claves de lanzamiento (controladas por los fabricantes de dispositivos individuales).
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Devuelve un objeto `DeviceDescriptor` almacenado en caché si el dispositivo está asignado; de lo contrario, devuelve el objeto `DeviceDescriptor` actual.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Devuelve un objeto `DeviceDescriptor` almacenado en caché si el dispositivo está asignado; de lo contrario, devuelve el objeto `DeviceDescriptor` actual.
`String[]`	`getChildren(String path)` Alternativa al uso de `IFileEntry` que, a veces, no funciona debido a los permisos.
`AbstractConnection`	`getConnection()` Es la conexión actual asociada al dispositivo.
`ContentProviderHandler`	`getContentProvider(int userId)` Devuelve `ContentProviderHandler` o null si no está disponible.
`DeviceFoldableState`	`getCurrentFoldableState()` Devuelve el estado actual de plegado del dispositivo o un valor nulo si se produjo algún problema.
`int`	`getCurrentUser()` Devuelve el ID del usuario que se está ejecutando actualmente.
`String`	`getDeviceClass()` Obtiene la clase del dispositivo.
`long`	`getDeviceDate()` Devuelve la fecha del dispositivo en milisegundos desde el ciclo.
`DeviceDescriptor`	`getDeviceDescriptor()` Devuelve un `DeviceDescriptor` a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo real.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Devuelve un `DeviceDescriptor` a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo real.
`TestDeviceState`	`getDeviceState()` Obtiene el estado del dispositivo.
`long`	`getDeviceTimeOffset(Date date)` Es un asistente para obtener la diferencia horaria entre el dispositivo y un `ERROR(/Date)` determinado.
`InputStreamSource`	`getEmulatorOutput()` Obtén el flujo de stdout y stderr del emulador
`Process`	`getEmulatorProcess()` Devuelve el `Process` correspondiente a este emulador.
`final File`	`getExecuteShellCommandLog()` Es el registro que contiene todos los registros de `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` Método de ayuda para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo.
`String`	`getFastbootPath()` Devuelve la ruta de acceso del objeto binario de fastboot que se usa.
`String`	`getFastbootProductType()` Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.
`String`	`getFastbootProductVariant()` Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.
`String`	`getFastbootSerialNumber()` Devuelve el número de serie del modo fastboot.
`String`	`getFastbootVariable(String variableName)` Recupera el valor de la variable fastboot determinada del dispositivo.
`String`	`getFastbootVersion()` Devuelve la cadena de versión del objeto binario de fastboot que se usa.
`IFileEntry`	`getFileEntry(String path)` Recupera una referencia a un archivo remoto en el dispositivo.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` Es un auxiliar no oficial para obtener un `FileEntry` a partir de una ruta que no es raíz.
	`getFoldableStates()` Devuelve la lista de estados de plegado del dispositivo.
`IDevice`	`getIDevice()` Devuelve una referencia al objeto `IDevice` de ddmlib asociado.
	`getInstalledPackageNames()` Recupera los nombres de los paquetes de aplicaciones presentes en el dispositivo.
`long`	`getIntProperty(String name, long defaultValue)` Devuelve el valor entero de la propiedad determinada del dispositivo.
`String`	`getIpAddress()` Obtiene la dirección IP del dispositivo.
`KeyguardControllerState`	`getKeyguardState()` Devuelve un objeto para obtener el estado actual de Keyguard o un valor nulo si no se admite.
`long`	`getLastExpectedRebootTimeMillis()` Devuelve la última vez que las APIs de Tradefed activaron un reinicio en milisegundos desde la EPOCH, según lo que devuelve `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` Obtiene el primer nivel de API que se lanzó en el dispositivo.
`InputStreamSource`	`getLogcat()` Toma una transmisión de instantáneas de los datos de logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` Toma una transmisión de instantáneas de los últimos `maxBytes` de los datos de logcat capturados.
`InputStreamSource`	`getLogcatDump()` Obtén un volcado del logcat actual del dispositivo.
`InputStreamSource`	`getLogcatSince(long date)` Toma una transmisión de instantáneas de los datos de logcat capturados a partir de la fecha proporcionada.
`String`	`getMacAddress()` Devuelve la dirección MAC del dispositivo o un valor nulo si no se puede consultar desde el dispositivo.
`Integer`	`getMainUserId()` Devuelve el ID del usuario principal.
	`getMainlineModuleInfo()` Obtiene información sobre los módulos de la línea principal instalados en el dispositivo.
`int`	`getMaxNumberOfRunningUsersSupported()` Obtiene la cantidad máxima de usuarios que se pueden ejecutar de forma simultánea.
`int`	`getMaxNumberOfUsersSupported()` Obtiene la cantidad máxima de usuarios admitidos.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Devuelve el `IDeviceStateMonitor` asociado con el dispositivo.
`String`	`getMountPoint(String mountName)` Devuelve un punto de activación.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` Devuelve un `MountPointInfo` que corresponde a la ruta de acceso del punto de montaje especificado o `null` si esa ruta de acceso no tiene nada montado o no aparece en /proc/mounts como un punto de montaje.
	`getMountPointInfo()` Devuelve una versión analizada de la información en /proc/mounts en el dispositivo.
`TestDeviceOptions`	`getOptions()` Recupera las opciones de prueba para el dispositivo.
`long`	`getPartitionFreeSpace(String partition)` Método auxiliar para determinar la cantidad de espacio libre en la partición del dispositivo.
`Integer`	`getPrimaryUserId()` Devuelve el ID de usuario principal.
`ProcessInfo`	`getProcessByName(String processName)` El método auxiliar ejecuta los comandos "pidof" y "stat", y devuelve el objeto `ProcessInfo` con el PID y la hora de inicio del proceso determinado.
`String`	`getProcessPid(String process)` Devuelve el PID del servicio o null si algo salió mal.
`String`	`getProductType()` Método de conveniencia para obtener el tipo de producto de este dispositivo.
`String`	`getProductVariant()` Método de conveniencia para obtener la variante del producto de este dispositivo.
`String`	`getProperty(String name)` Recupera el valor de la propiedad determinado del dispositivo.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Obtiene el modo de recuperación actual que se usa para el dispositivo.
`InputStreamSource`	`getScreenshot(long displayId)` Toma una captura de pantalla del dispositivo con el ID de pantalla determinado.
`InputStreamSource`	`getScreenshot(String format)` Toma una captura de pantalla del dispositivo.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` Toma una captura de pantalla del dispositivo.
`InputStreamSource`	`getScreenshot()` Toma una captura de pantalla del dispositivo.
`String`	`getSerialNumber()` Método de conveniencia para obtener el número de serie de este dispositivo.
`String`	`getSetting(int userId, String namespace, String key)` Devuelve el valor del parámetro de configuración solicitado.
`String`	`getSetting(String namespace, String key)` Consulta `getSetting(int, String, String)` y se realiza en el usuario del sistema.
`String`	`getSimOperator()` Devuelve el operador de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible.
`String`	`getSimState()` Devuelve el estado de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible.
	`getTombstones()` Recupera y devuelve la lista de marcas de eliminación de los dispositivos.
`long`	`getTotalMemory()` Devuelve el tamaño total de la memoria física en bytes o -1 en caso de error interno.
`String`	`getTrackingSerial()` Se obtiene el número de serie que se usa para hacer un seguimiento del dispositivo con fines de administración.
	`getUninstallablePackageNames()` Recupera los nombres de los paquetes de aplicaciones que se pueden desinstalar.
`boolean`	`getUseFastbootErase()` Obtiene si se debe usar fastboot erase o fastboot format para borrar una partición en el dispositivo.
`int`	`getUserFlags(int userId)` Busca y devuelve las marcas de un usuario determinado.
	`getUserInfos()` Obtiene el mapa de useId a `UserInfo` en el dispositivo.
`int`	`getUserSerialNumber(int userId)` Devuelve el número de serie asociado al userId si se encuentra; de lo contrario, devuelve -10000.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Procesa el DeviceEvent determinado. Procesa el DeviceEvent, que puede o no hacer que este dispositivo pase a un nuevo estado de asignación.
`boolean`	`hasFeature(String feature)` Comprueba si una función está disponible en un dispositivo.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)` Inicializa la conexión con el dispositivo.
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` Instala un paquete de Android en el dispositivo.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` Instala un paquete de Android en el dispositivo.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` Instala un paquete de Android en el dispositivo para un usuario determinado.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Instala un paquete de Android en el dispositivo para un usuario determinado.
`boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` Instala APKs con el modo incremental.
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` Verifica si la plataforma del dispositivo admite la enumeración de apps
`boolean`	`isBypassLowTargetSdkBlockSupported()` Comprueba si la plataforma del dispositivo admite la omisión del bloqueo del SDK de destino bajo en las instalaciones de apps
`boolean`	`isDebugfsMounted()` Verifica si debugfs está montado.
`boolean`	`isDeviceEncrypted()` Devuelve si el dispositivo está encriptado.
`boolean`	`isDirectory(String path)` Devuelve True si la ruta de acceso en el dispositivo es un directorio y False en caso contrario.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Devuelve si el dispositivo admite la encriptación.
`boolean`	`isExecutable(String fullPath)` Devuelve True si la ruta de acceso al archivo en el dispositivo es un archivo ejecutable; de lo contrario, devuelve False.
`boolean`	`isFastbootEnabled()` Devuelve si fastboot está disponible para el dispositivo.
`boolean`	`isHeadless()` Devuelve verdadero si el dispositivo no tiene pantalla y falso en caso contrario.
`boolean`	`isHeadlessSystemUserMode()` Devuelve si el dispositivo usa el modo de usuario del sistema sin interfaz gráfica.
`boolean`	`isMainUserPermanentAdmin()` Devuelve si el usuario principal es un administrador permanente y no se puede borrar ni degradar a un estado que no sea de administrador.
`boolean`	`isMultiUserSupported()` Determina si se admite la función de múltiples usuarios.
`boolean`	`isPackageInstalled(String packageName, String userId)` Consulta el dispositivo para un nombre de paquete y un ID de usuario determinados para verificar si está instalado actualmente para ese usuario.
`boolean`	`isPackageInstalled(String packageName)` Consulta el dispositivo para un nombre de paquete determinado y verifica si está instalado actualmente.
`boolean`	`isRuntimePermissionSupported()` Comprueba si la plataforma del dispositivo admite el otorgamiento de permisos en el tiempo de ejecución
`boolean`	`isStateBootloaderOrFastbootd()` Devuelve verdadero si el dispositivo está en `TestDeviceState.FASTBOOT` o `TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` Comprueba si un usuario determinado está ejecutando la app.
`boolean`	`isUserSecondary(int userId)` Devuelve si el usuario especificado es un usuario secundario según sus marcas.
`boolean`	`isUserVisible(int userId)` Verifica si el usuario determinado es visible.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` Verifica si el usuario determinado es visible en la pantalla determinada.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` Devuelve si el dispositivo permite que los usuarios inicien la visibilidad en segundo plano en `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`boolean`	`isVisibleBackgroundUsersSupported()` Devuelve si el dispositivo permite que los usuarios inicien la visibilidad en segundo plano.
`boolean`	`isWifiEnabled()` Prueba si el Wi-Fi está habilitado.
	`listDisplayIds()` Recopila la lista de IDs de pantallas disponibles en el dispositivo, según lo indica "dumpsys SurfaceFlinger".
	`listDisplayIdsForStartingVisibleBackgroundUsers()` Obtiene la lista de pantallas que se pueden usar para `start a user visible in the background`.
	`listUsers()` Obtiene la lista de usuarios del dispositivo.
`boolean`	`logAnrs(ITestLogger logger)` Recopila y registra los errores ANR del dispositivo.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` Método auxiliar para tomar un informe de errores y registrarlo para los reporteros.
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Registra un mensaje en el logcat del dispositivo.
`void`	`mountDebugfs()` Activa debugfs.
`void`	`nonBlockingReboot()` Envía un comando para reiniciar el dispositivo y regresa cuando se completa el comando y cuando el dispositivo ya no es visible para adb.
`void`	`postAdbRootAction()` Anula si el dispositivo necesita que se realicen algunas acciones específicas después de adb root y antes de que el dispositivo vuelva a estar en línea.
`void`	`postAdbUnrootAction()` Anula si el dispositivo necesita que se realicen algunas acciones específicas después de quitar el acceso de administrador con adb y antes de que el dispositivo vuelva a estar en línea.
`void`	`postBootSetup()` Sigue las instrucciones para configurar el dispositivo para las pruebas después de cada arranque.
`void`	`postInvocationTearDown(Throwable exception)` Pasos adicionales para la limpieza requerida específica del dispositivo que se ejecutarán después de que se complete la invocación.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Son pasos adicionales para la configuración requerida específica del dispositivo que se ejecutarán en el dispositivo antes del flujo de invocación.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` Extrae de forma recursiva el contenido del directorio del dispositivo.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Extrae de forma recursiva el contenido del directorio del dispositivo.
`boolean`	`pullFile(String remoteFilePath, File localFile)` Recupera un archivo del dispositivo.
`File`	`pullFile(String remoteFilePath, int userId)` Recupera un archivo del dispositivo, lo almacena en un objeto `ERROR(/File)` temporal local y devuelve ese objeto `File`.
`File`	`pullFile(String remoteFilePath)` Recupera un archivo del dispositivo, lo almacena en un objeto `ERROR(/File)` temporal local y devuelve ese objeto `File`.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` Recupera un archivo del dispositivo.
`String`	`pullFileContents(String remoteFilePath)` Recupera un archivo del dispositivo y devuelve su contenido.
`File`	`pullFileFromExternal(String remoteFilePath)` Es un método de conveniencia para recuperar un archivo del almacenamiento externo del dispositivo, almacenarlo en un `ERROR(/File)` temporal local y devolver una referencia a ese `File`.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Envía de forma recursiva el contenido del directorio al dispositivo y excluye algunos directorios que se filtran.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` Envía de forma recursiva el contenido del directorio al dispositivo.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` Envía de forma recursiva el contenido del directorio al dispositivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` Variante de `pushFile(File, String)` que puede considerar de forma opcional la evaluación de la necesidad del proveedor de contenido.
`boolean`	`pushFile(File localFile, String remoteFilePath)` Envía un archivo al dispositivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Envía un archivo al dispositivo.
`boolean`	`pushString(String contents, String remoteFilePath)` Envía al dispositivo el archivo creado a partir de una cadena
`void`	`reboot(String reason)` Reinicia el dispositivo en modo adb con el `reason` determinado para que persista después del reinicio.
`void`	`reboot()` Reinicia el dispositivo en modo adb.
`void`	`rebootIntoBootloader()` Reinicia el dispositivo en el modo de cargador de arranque.
`void`	`rebootIntoFastbootd()` Reinicia el dispositivo en el modo fastbootd.
`void`	`rebootIntoRecovery()` Reinicia el dispositivo en el modo de recuperación de adb.
`void`	`rebootIntoSideload()` Reinicia el dispositivo en el modo de carga lateral de adb (ten en cuenta que este es un modo especial en recuperación). Se bloquea hasta que el dispositivo entra en el modo de carga lateral.
`void`	`rebootIntoSideload(boolean autoReboot)` Reinicia el dispositivo en el modo de carga lateral de adb (ten en cuenta que este es un modo especial en recuperación). Se bloquea hasta que el dispositivo entra en el modo de carga lateral.
`void`	`rebootUntilOnline()` Es una alternativa a `reboot()` que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.
`void`	`rebootUntilOnline(String reason)` Es una alternativa a `reboot()` que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.
`void`	`rebootUserspace()` Solo reinicia la parte del espacio del usuario del dispositivo.
`void`	`rebootUserspaceUntilOnline()` Es una alternativa a `rebootUserspace()` ()} que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb.
`boolean`	`recoverDevice()` Intenta recuperar la comunicación del dispositivo.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Registra un `IDeviceActionReceiver` para este dispositivo.
`void`	`remountSystemReadOnly()` Haz que la partición del sistema en el dispositivo sea de solo lectura.
`void`	`remountSystemWritable()` Haz que se pueda escribir en la partición del sistema del dispositivo.
`void`	`remountVendorReadOnly()` Haz que la partición del proveedor en el dispositivo sea de solo lectura.
`void`	`remountVendorWritable()` Haz que la partición del proveedor en el dispositivo sea grabable.
`boolean`	`removeAdmin(String componentName, int userId)` Quita el administrador de dispositivos determinado del usuario determinado y devuelve `true` si se realiza correctamente o `false` si no se realiza correctamente.
`void`	`removeOwners()` Quita todos los propietarios de perfiles de dispositivos existentes con el mejor esfuerzo.
`boolean`	`removeUser(int userId)` Quita un usuario determinado del dispositivo.
`void`	`resetContentProviderSetup()` Restablece la marca para la configuración del proveedor de contenido y, así, vuelve a activarla.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Método de conveniencia para realizar `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` con uno o más objetos de escucha pasados como parámetros.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` Ejecuta pruebas de instrumentación y proporciona recuperación del dispositivo.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` Es igual que `ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))`, pero ejecuta la prueba para el usuario determinado.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` Es igual que `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, pero ejecuta la prueba para un usuario determinado.
`void`	`setAdbPath(String adbPath)` Establece la ruta de acceso al objeto binario de adb que se debe usar.
`void`	`setConfiguration(IConfiguration configuration)` Inserta el `IConfiguration` en uso.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` Establece la fecha en el dispositivo Nota: Establecer la fecha en el dispositivo requiere acceso de administrador.
`boolean`	`setDeviceOwner(String componentName, int userId)` Establece un componente de administrador del dispositivo como propietario del dispositivo en el usuario determinado.
`void`	`setDeviceState(TestDeviceState deviceState)` Actualiza el estado del dispositivo.
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` Para el emulador, configura `SizeLimitedOutputStream` para registrar el resultado
`void`	`setEmulatorProcess(Process p)` Establece el `Process` cuando este dispositivo es un emulador.
`void`	`setFastbootEnabled(boolean fastbootEnabled)` Establece la opción de fastboot para el dispositivo.
`void`	`setFastbootPath(String fastbootPath)` Establece la ruta de acceso al objeto binario de fastboot que se debe usar.
`void`	`setIDevice(IDevice newDevice)` Actualiza el IDevice asociado con este ITestDevice.
`void`	`setLogStartDelay(int delay)` Establece el tiempo en ms que se debe esperar antes de iniciar la captura de logcat para un dispositivo en línea.
`void`	`setOptions(TestDeviceOptions options)` Cómo configurar el `TestDeviceOptions` para el dispositivo
`boolean`	`setProperty(String propKey, String propValue)` Establece el valor de propiedad determinado en el dispositivo.
`void`	`setRecovery(IDeviceRecovery recovery)` Establece el `IDeviceRecovery` que se usará para este dispositivo.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Establece el modo de recuperación actual que se usará para el dispositivo.
`void`	`setSetting(String namespace, String key, String value)` Consulta `setSetting(int, String, String, String)` y se realiza en el usuario del sistema.
`void`	`setSetting(int userId, String namespace, String key, String value)` Agrega un valor de configuración al espacio de nombres de un usuario determinado.
`void`	`setTestLogger(ITestLogger testLogger)` Inyecta la instancia de `ITestLogger`.
`void`	`setTrackingSerial(String trackingSerial)` Para fines de administración de dispositivos, se hace un seguimiento del número de serie que usamos para hacer referencia al dispositivo.
`void`	`setUseFastbootErase(boolean useFastbootErase)` Establece si se debe usar fastboot erase o fastboot format para borrar una partición del dispositivo.
`void`	`startLogcat()` Comienza a capturar el resultado de logcat del dispositivo en segundo plano.
`boolean`	`startTradeInModeTesting(int timeoutMs)` Habilita el modo de prueba de intercambio.
`boolean`	`startUser(int userId)` Inicia un usuario determinado en segundo plano si está detenido.
`boolean`	`startUser(int userId, boolean waitFlag)` Inicia un usuario determinado en segundo plano si está detenido.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` Inicia un usuario determinado en segundo plano, visible en la pantalla determinada (es decir, permite que el usuario inicie actividades en esa pantalla).
`void`	`stopEmulatorOutput()` Cierra y borra el resultado del emulador.
`void`	`stopLogcat()` Deja de capturar el resultado de Logcat del dispositivo y descarta los datos de Logcat guardados actualmente.
`void`	`stopTradeInModeTesting()` Detener las pruebas del modo de intercambio.
`boolean`	`stopUser(int userId)` Detiene a un usuario determinado.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Detiene a un usuario determinado.
`String`	`switchToAdbTcp()` Cambia el dispositivo al modo adb-over-tcp.
`boolean`	`switchToAdbUsb()` Cambia el dispositivo al modo adb a través de USB.
`boolean`	`switchUser(int userId)` Cambia a otro userId con un tiempo de espera predeterminado.
`boolean`	`switchUser(int userId, long timeout)` Cambia a otro userId con el tiempo de espera proporcionado como fecha límite.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Sincroniza de forma incremental el contenido de un directorio de archivos local con el dispositivo.
`Bugreport`	`takeBugreport()` Toma un informe de errores y lo devuelve dentro de un objeto `Bugreport` para controlarlo.
`String`	`uninstallPackage(String packageName)` Desinstala un paquete de Android del dispositivo.
`String`	`uninstallPackageForUser(String packageName, int userId)` Desinstala un paquete de Android del dispositivo para un usuario determinado.
`boolean`	`unlockDevice()` Desbloquea el dispositivo si está encriptado.
`void`	`unmountDebugfs()` Desmonta debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Se bloquea hasta que se establece la marca de inicio completo del dispositivo.
`boolean`	`waitForDeviceAvailable()` Espera a que el dispositivo responda y esté disponible para las pruebas.
`boolean`	`waitForDeviceAvailable(long waitTime)` Espera a que el dispositivo responda y esté disponible para las pruebas.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Espera a que el dispositivo responda y esté disponible sin tener en cuenta la ruta de recuperación.
`void`	`waitForDeviceBootloader()` Se bloquea hasta que el dispositivo esté visible a través de fastboot.
`void`	`waitForDeviceFastbootD()`
`boolean`	`waitForDeviceInRecovery(long waitTime)` Bloquea el dispositivo para que esté en el estado "adb recovery" (ten en cuenta que es diferente de `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Bloqueos para que el dispositivo esté en el estado "adb sideload"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Bloquea el dispositivo para que no esté disponible, es decir, que no aparezca en adb.
`void`	`waitForDeviceOnline()` Se bloquea hasta que el dispositivo esté visible a través de adb.
`void`	`waitForDeviceOnline(long waitTime)` Se bloquea hasta que el dispositivo esté visible a través de adb.
`boolean`	`waitForDeviceShell(long waitTime)` Espera a que el dispositivo responda a un comando básico de adb shell.

Métodos protegidos
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` Compila el comando del SO para la sesión y los argumentos del comando adb shell determinados
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` Crea un `RebootDeviceAction` para usarlo cuando se realice una acción de reinicio.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Realiza un reinicio con adb.
`void`	`ensureRuntimePermissionSupported()` Método auxiliar para arrojar una excepción si no se admite el permiso de tiempo de ejecución
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` Obtén la instancia de `RunUtil` que se usará.
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Recupera una propiedad del dispositivo, de la caché de ddmlib de forma predeterminada, y recurre a `adb shell getprop` o `fastboot getvar` según si el dispositivo está en Fastboot o no.
`boolean`	`isInRebootCallback()` Devuelve un valor que indica si las devoluciones de llamada de reinicio se están ejecutando actualmente.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Devuelve `true` si el archivo local es más reciente que el archivo remoto.
`void`	`notifyRebootEnded()` Notifica a todos los `IDeviceActionReceiver` sobre el evento de finalización del reinicio.
`void`	`notifyRebootStarted()` Notifica a todos los `IDeviceActionReceiver` sobre el evento de inicio de reinicio.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Realiza una acción en este dispositivo.
`void`	`postAdbReboot(NativeDevice.RebootMode rebootMode)` Son las posibles acciones adicionales que se pueden realizar después de un reinicio.
`void`	`prePostBootSetup()` Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) anule este método para una configuración específica posterior al inicio.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Establece la instancia de Clock que se usará.
`void`	`setMicrodroidProcess(Process process)` Marca el TestDevice como microdroid y establece su CID.
`void`	`setTestDeviceOptions( deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)` Ejecuta un comando fastboot simple con variables de entorno y registra el estado del comando.
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` Ejecuta un comando fastboot simple y registra el estado del comando.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` Espera a que el dispositivo deje de estar disponible (deje de enviar informes a adb).

Constantes

DEBUG_PATH

public static final String DEBUGFS_PATH

Valor de la constante: "/sys/kernel/debug"

INVALID_USER_ID

public static final int INVALID_USER_ID

Valor que se devuelve para cualquier ID de usuario no válido o no encontrado: UserHandle definió el valor -10000

Valor constante: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Valor constante: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

Cantidad predeterminada de intentos de reejecución de comandos que se realizarán

Valor constante: 2 (0x00000002)

SD_CARD

protected static final String SD_CARD

Valor de la constante: "/sdcard/"

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

Valor de la constante: "/storage/emulated/"

Campos

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Constructores públicos

NativeDevice

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Crea un TestDevice.

Parámetros
`device`	`IDevice`: El `IDevice` asociado
`stateMonitor`	`IDeviceStateMonitor`: Es el mecanismo de `IDeviceStateMonitor` que se usará.
`allocationMonitor`	`IDeviceMonitor`: Es el objeto `IDeviceMonitor` para informar sobre los cambios de estado de asignación. Puede ser nulo.

Métodos públicos

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Microoptimización (alrededor de 400 ms) mediante la recuperación previa de todas las propiedades que necesitamos en lugar de llamar a "adb getprop" para cada una. Es decir, es igual de rápido recuperar todas las propiedades que recuperar una. Funciones como device.getApiLevel(), checkApiLevelAgainstNextRelease y getBuildAlias llaman a `adb getprop` de forma interna. Los recuperamos en una sola llamada y llamamos a NativeDevice.setProperty. Incluso si no lo hacemos, NativeDevice llamará a setProperty y almacenará en caché el resultado para futuras llamadas. Solo lo haremos un poco antes. Si el dispositivo está en modo de recuperación o hay otros errores al recuperar las propiedades, simplemente los ignoramos.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Devuelve si se permite cambiar al usuario SYSTEM sin interfaz gráfica.

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Comprueba si una función se admite actualmente en un nivel de compatibilidad mínimo. Este método tiene en cuenta las funciones que aún no se lanzaron antes de que se aumente el nivel de API.

Parámetros
`strictMinLevel`	`int`: Es el nivel mínimo posible estricto que admite la función.

Muestra
`boolean`	Es verdadero si se admite el nivel. De lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

Comprueba que el dispositivo tenga conectividad de red.

Muestra
`boolean`	`true` si el dispositivo tiene una conexión de red activa, `false` en caso contrario.

Arroja
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

Intenta descartar los diálogos de error que se muestran actualmente en la IU del dispositivo.

Muestra
`boolean`	`true` si no había diálogos o si se borraron correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Borra la última red Wi-Fi a la que se conectó. Se debe llamar a este método cuando se inicia una nueva invocación para evitar conectarse a la red Wi-Fi que se usó en la prueba anterior después de que se reinicia el dispositivo.

clearLogcat

public void clearLogcat ()

Borra los datos de logcat acumulados.

Esto es útil en los casos en los que deseas asegurarte de que ITestDevice.getLogcat() solo devuelva datos de registro producidos después de un punto determinado (por ejemplo, después de escribir una nueva compilación del dispositivo, etcétera).

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se conecta a una red Wi-Fi.

Activa el Wi-Fi y se bloquea hasta que se establece una conexión exitosa con una de las redes Wi-Fi que se indican en el mapa wifiSsidToPsk. Una vez que se establezca una conexión, la instancia intentará restablecerla después de cada reinicio hasta que se llame a ITestDevice.disconnectFromWifi() o ITestDevice.clearLastConnectedWifiNetwork().

Parámetros
`wifiSsidToPsk`	: Es un mapa de los SSID de Wi-Fi y sus contraseñas.
`scanSsid`	`boolean`: Indica si se deben buscar SSID ocultos para esta red.

Muestra
`boolean`	`true` si se conectó correctamente a la red Wi-Fi `false` de lo contrario

Arroja
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se conecta a una red Wi-Fi.

Activa el Wi-Fi y se bloquea hasta que se establece una conexión correcta a la red Wi-Fi especificada. Una vez que se establezca una conexión, la instancia intentará restablecerla después de cada reinicio hasta que se llame a ITestDevice.disconnectFromWifi() o ITestDevice.clearLastConnectedWifiNetwork().

Parámetros
`wifiSsid`	`String`: Es el SSID de Wi-Fi al que se conectará.
`wifiPsk`	`String`: Es la frase de contraseña de PSK o nula si no está encriptada.

Muestra
`boolean`	`true` si se conectó correctamente a la red Wi-Fi `false` en otros casos

Arroja
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Se conecta a una red Wi-Fi.

Parámetros
`wifiSsidToPsk`	: Es un mapa de los SSID de Wi-Fi y sus contraseñas.

Muestra
`boolean`	`true` si se conectó correctamente a la red Wi-Fi `false` de lo contrario

Arroja
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Se conecta a una red Wi-Fi.

Parámetros
`wifiSsid`	`String`: Es el SSID de Wi-Fi al que se conectará.
`wifiPsk`	`String`: Es la frase de contraseña de PSK o nula si no está encriptada.
`scanSsid`	`boolean`: Indica si se debe buscar el SSID oculto de esta red.

Muestra
`boolean`	`true` si se conectó correctamente a la red Wi-Fi `false` en otros casos

Arroja
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Es una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo no tiene conectividad de red en ese momento.

Parámetros
`scanSsid`	`boolean`: Indica si se debe buscar el SSID oculto de esta red.

Muestra
`boolean`	`true` si se conectó correctamente a la red Wi-Fi `false` en otros casos

Arroja
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Es una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo no tiene conectividad de red en ese momento.

Muestra
`boolean`	`true` si se conectó correctamente a la red Wi-Fi `false` en otros casos

Arroja
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Crea un usuario con un nombre determinado y las marcas proporcionadas

Parámetros
`name`	`String`: del usuario que se creará en el dispositivo
`guest`	`boolean`: Habilita la marca de usuario --guest durante la creación.
`ephemeral`	`boolean`: Habilita la marca del usuario --ephemeral durante la creación.

Muestra
`int`	ID del usuario creado

Arroja
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Crea un usuario con un nombre determinado y las marcas proporcionadas

Parámetros
`name`	`String`: del usuario que se creará en el dispositivo
`guest`	`boolean`: Habilita la marca de usuario --guest durante la creación.
`ephemeral`	`boolean`: Habilita la marca del usuario --ephemeral durante la creación.
`forTesting`	`boolean`: Habilita la marca de prueba --for-testing durante la creación.

Muestra
`int`	ID del usuario creado

Arroja
`DeviceNotAvailableException`

createUser

public int createUser (String name)

Crea un usuario con un nombre determinado y marcas predeterminadas 0.

Parámetros
`name`	`String`: del usuario que se creará en el dispositivo

Muestra
`int`	Es el número entero del ID de usuario creado.

Arroja
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

Crea un usuario con un nombre determinado y marcas predeterminadas 0.

Parámetros
`name`	`String`: del usuario que se creará en el dispositivo

Muestra
`int`	Es el número entero del ID de usuario creado o -1 si se produjo un error.

Arroja
`DeviceNotAvailableException`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

Inspecciona un dispositivo y devuelve información detallada cuando un dispositivo deja de estar disponible.

Muestra
`DeviceInspectionResult`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

Método auxiliar para borrar un archivo o directorio en el dispositivo.

Parámetros
`deviceFilePath`	`String`: Es la ruta de acceso absoluta del archivo en el dispositivo.
`userId`	`int`: ID del usuario que se borrará de

Arroja
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath)

Método auxiliar para borrar un archivo o directorio en el dispositivo.

Parámetros
`deviceFilePath`	`String`: Es la ruta de acceso absoluta del archivo en el dispositivo.

Arroja
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Quita el IDeviceActionReceiver registrado.

Parámetros
`deviceActionReceiver`	`IDeviceActionReceiver`: Es un `IDeviceActionReceiver` que se quitará.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Método auxiliar para verificar si el dispositivo se reinició de forma parcial comparando el system_server actual con el system_server anterior ProcessInfo. Usa getProcessByName(String) para obtener ProcessInfo.

Parámetros
`prevSystemServerProcess`	`ProcessInfo`: Es el proceso system_server anterior `ProcessInfo`.

Muestra
`boolean`	`true` si se reinició el dispositivo de forma suave

Arroja
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Método de ayuda para verificar si el dispositivo se reinició de forma parcial desde la hora UTC desde la época del dispositivo y su ERROR(/TimeUnit). El reinicio parcial se refiere al reinicio de system_server fuera de un reinicio forzado del dispositivo (por ejemplo, un reinicio solicitado). El utcEpochTime del dispositivo actual en milisegundos se puede obtener con el método getDeviceDate().

Parámetros
`utcEpochTime`	`long`: Es la hora del dispositivo en segundos desde el ciclo de entrenamiento.
`timeUnit`	`TimeUnit`: Es la unidad de tiempo `TimeUnit` para el utcEpochTime determinado.

Muestra
`boolean`	`true` si se reinició el dispositivo de forma suave

Arroja
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

Desactiva el acceso raíz de adb.

Si inhabilitas adb root, es posible que el dispositivo se desconecte de adb. Este método se bloqueará hasta que el dispositivo esté disponible.

Muestra
`boolean`	`true` si la operación se realiza correctamente.

Arroja
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

Intenta inhabilitar el bloqueo de teclado.

Primero, espera a que el envío de entrada esté listo. Esto sucede aproximadamente al mismo tiempo en que el dispositivo informa BOOT_COMPLETE, aparentemente de forma asíncrona, porque la implementación actual del framework tiene una condición de carrera ocasional. Luego, se envía el comando para descartar el bloqueo de teclado (solo funciona en los no seguros).

Arroja
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Inhabilita la supervisión de la red en el dispositivo.

Muestra
`boolean`	Devuelve `true` si la supervisión se inhabilita correctamente. `false` si falló.

Arroja
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

Se desconecta de una red Wi-Fi.

Quita todas las redes de la lista de redes conocidas y, luego, inhabilita la conexión Wi-Fi.

Muestra
`boolean`	`true` si se desconectó correctamente de la red Wi-Fi. `false` si no se pudo desconectar.

Arroja
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Método de ayuda para determinar si existe un archivo en el dispositivo para un usuario determinado.

Parámetros
`deviceFilePath`	`String`: Es la ruta de acceso absoluta del archivo en el dispositivo que se verificará.
`userId`	`int`: Es el ID del usuario con el que se verificará la existencia del archivo.

Muestra
`boolean`	`true` si el archivo existe; de lo contrario, `false`.

Arroja
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Método auxiliar para determinar si existe un archivo en el dispositivo.

Parámetros
`deviceFilePath`	`String`: Es la ruta de acceso absoluta del archivo en el dispositivo que se verificará.

Muestra
`boolean`	`true` si el archivo existe; de lo contrario, `false`.

Arroja
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Intenta volcar el montón de system_server. Es responsabilidad del llamador limpiar el archivo volcado.

Parámetros
`process`	`String`: Es el nombre del proceso del dispositivo en el que se volcará el montón.
`devicePath`	`String`: Es la ruta de acceso en el dispositivo en la que se colocará el volcado. Debe ser una ubicación donde los permisos lo permitan.

Muestra
`File`	El `ERROR(/File)` que contiene el informe. Es nulo si se produjo un error.

Arroja
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

Activa el acceso raíz de adb. Si el parámetro de configuración "enable-root" es "false", se registrará un mensaje y se devolverá sin habilitar el acceso de administrador.

Habilitar adb root puede provocar que el dispositivo se desconecte de adb. Este método se bloqueará hasta que el dispositivo esté disponible.

Muestra
`boolean`	`true` si la operación se realiza correctamente.

Arroja
`DeviceNotAvailableException`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Habilita la supervisión de la red en el dispositivo.

Muestra
`boolean`	`true` si la supervisión se habilitó correctamente. `false` si falló.

Arroja
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

Método auxiliar que ejecuta un comando de adb como un comando del sistema con un tiempo de espera especificado.

En su lugar, se debe usar executeShellCommand(String) siempre que sea posible, ya que ese método proporciona una mejor detección de errores y rendimiento.

Parámetros
`timeout`	`long`: Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Se establece en 0 L para que no haya tiempo de espera.
`cmdArgs`	`String`: El comando y los argumentos de adb que se ejecutarán

Muestra
`String`	stdout del comando. `null` si no se pudo ejecutar el comando.

Arroja
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

Método auxiliar que ejecuta un comando de adb como un comando del sistema con un tiempo de espera especificado.

En su lugar, se debe usar executeShellCommand(String) siempre que sea posible, ya que ese método proporciona una mejor detección de errores y rendimiento.

Parámetros
`timeout`	`long`: Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Se establece en 0 L para que no haya tiempo de espera.
`envMap`	: Es el entorno que se configurará para el comando.
`cmdArgs`	`String`: El comando y los argumentos de adb que se ejecutarán

Muestra
`String`	stdout del comando. `null` si no se pudo ejecutar el comando.

Arroja
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

Método auxiliar que ejecuta un comando de adb como un comando del sistema.

En su lugar, se debe usar executeShellCommand(String) siempre que sea posible, ya que ese método proporciona una mejor detección de errores y rendimiento.

Parámetros
`cmdArgs`	`String`: El comando y los argumentos de adb que se ejecutarán

Muestra
`String`	stdout del comando. `null` si no se pudo ejecutar el comando.

Arroja
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

Método auxiliar que ejecuta un comando de adb como un comando del sistema.

En su lugar, se debe usar executeShellCommand(String) siempre que sea posible, ya que ese método proporciona una mejor detección de errores y rendimiento.

Parámetros
`cmdArgs`	`String`: El comando y los argumentos de adb que se ejecutarán

Muestra
`CommandResult`	Es el CommandResult que contiene el resultado del comando.

Arroja
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                String... cmdArgs)

Método auxiliar que ejecuta un comando de adb como un comando del sistema con un tiempo de espera especificado.

En su lugar, se debe usar executeShellCommand(String) siempre que sea posible, ya que ese método proporciona una mejor detección de errores y rendimiento.

Parámetros
`timeout`	`long`: Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Se establece en 0 L para que no haya tiempo de espera.
`cmdArgs`	`String`: El comando y los argumentos de adb que se ejecutarán

Muestra
`CommandResult`	Es el CommandResult que contiene el resultado del comando.

Arroja
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... cmdArgs)

Método auxiliar que ejecuta un comando de adb como un comando del sistema con un tiempo de espera especificado.

En su lugar, se debe usar executeShellCommand(String) siempre que sea posible, ya que ese método proporciona una mejor detección de errores y rendimiento.

Parámetros
`timeout`	`long`: Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Se establece en 0 L para que no haya tiempo de espera.
`envMap`	: Es el entorno que se configurará para el comando.
`cmdArgs`	`String`: El comando y los argumentos de adb que se ejecutarán

Muestra
`CommandResult`	Es el CommandResult que contiene el resultado del comando.

Arroja
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

Método auxiliar que ejecuta un comando de fastboot como un comando del sistema con un tiempo de espera predeterminado de 2 minutos.

Se espera que se use cuando el dispositivo ya está en modo fastboot.

Parámetros
`cmdArgs`	`String`: El comando y los argumentos de fastboot que se ejecutarán

Muestra
`CommandResult`	El CommandResult que contiene el resultado del comando

Arroja
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

Método auxiliar que ejecuta un comando de fastboot como un comando del sistema.

Se espera que se use cuando el dispositivo ya está en modo fastboot.

Parámetros
`timeout`	`long`: Es el tiempo en milisegundos antes de que caduque el comando.
`cmdArgs`	`String`: El comando y los argumentos de fastboot que se ejecutarán

Muestra
`CommandResult`	El CommandResult que contiene el resultado del comando

Arroja
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

Método auxiliar que ejecuta un comando fastboot de larga duración como un comando del sistema.

Es idéntico a executeFastbootCommand(String), excepto que usa un tiempo de espera más largo.

Parámetros
`cmdArgs`	`String`: El comando y los argumentos de fastboot que se ejecutarán

Muestra
`CommandResult`	El CommandResult que contiene el resultado del comando

Arroja
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

Método auxiliar que ejecuta un comando fastboot de larga duración como un comando del sistema con variables de entorno del sistema.

Es idéntico a executeFastbootCommand(String), excepto que usa un tiempo de espera más largo.

Parámetros
`envVarMap`	: Son las variables de entorno del sistema con las que se ejecuta el comando fastboot.
`cmdArgs`	`String`: El comando y los argumentos de fastboot que se ejecutarán

Muestra
`CommandResult`	El CommandResult que contiene el resultado del comando

Arroja
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

Método de ayuda que ejecuta un comando shell de adb y muestra el resultado como un String.

Parámetros
`command`	`String`: Es el comando de adb shell que se ejecutará.

Muestra
`String`	el resultado de la shell

Arroja
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
`command`	`String`: Es el comando de adb shell que se ejecutará.
`receiver`	`IShellOutputReceiver`: Es el `IShellOutputReceiver` al que se dirige el resultado de la shell.
`maxTimeToOutputShellResponse`	`long`: Es la cantidad máxima de tiempo durante la cual se permite que el comando no genere ninguna respuesta. La unidad se especifica en `timeUnit`.
`timeUnit`	`TimeUnit`: Unidad para `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Es la cantidad máxima de veces que se reintentará el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si `retryAttempts` se realizan sin éxito.

Arroja
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
`command`	`String`: Es el comando de adb shell que se ejecutará.
`receiver`	`IShellOutputReceiver`: Es el `IShellOutputReceiver` al que se dirige el resultado de la shell.
`maxTimeoutForCommand`	`long`: Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en `timeUnit`.
`maxTimeToOutputShellResponse`	`long`: Es la cantidad máxima de tiempo durante la cual se permite que el comando no genere ninguna respuesta. La unidad se especifica en `timeUnit`.
`timeUnit`	`TimeUnit`: Unidad para `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Es la cantidad máxima de veces que se reintentará el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si las `retryAttempts` se realizan sin éxito.

Arroja
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Ejecuta el comando adb shell especificado y vuelve a intentarlo varias veces si falla.

Es una forma más simple de executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) con valores predeterminados.

Parámetros
`command`	`String`: Es el comando de adb shell que se ejecutará.
`receiver`	`IShellOutputReceiver`: Es el `IShellOutputReceiver` al que se dirige el resultado de la shell.

Arroja
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

Método de ayuda que ejecuta un comando shell de adb y devuelve los resultados como un CommandResult completado correctamente con el resultado del estado del comando, stdout y stderr.

Parámetros
`cmd`	`String`: Es el comando que se debe ejecutar.

Muestra
`CommandResult`	Es el resultado en `CommandResult`.

Arroja
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Método auxiliar que ejecuta un comando de shell de adb y devuelve los resultados como un CommandResult completado correctamente con el resultado del estado del comando y stderr. stdout se dirige al flujo especificado.

Parámetros
`cmd`	`String`: Es el comando que se debe ejecutar.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` en el que se redireccionará la salida estándar o nulo.

Muestra
`CommandResult`	Es el resultado en `CommandResult`.

Arroja
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Método auxiliar que ejecuta un comando shell de adb y devuelve los resultados como un CommandResult completado correctamente con el resultado del estado del comando, stdout y stderr.

Parámetros
`cmd`	`String`: Es el comando que se debe ejecutar.
`pipeAsInput`	`File`: Es un `ERROR(/File)` que se canalizará como entrada para el comando o será nulo.

Muestra
`CommandResult`	Es el resultado en `CommandResult`.

Arroja
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
`cmd`	`String`: Es el comando de adb shell que se ejecutará.
`maxTimeoutForCommand`	`long`: Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en `timeUnit`.
`timeUnit`	`TimeUnit`: Unidad para `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Es la cantidad máxima de veces que se reintentará el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si las `retryAttempts` se realizan sin éxito.

Muestra
`CommandResult`

Arroja
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
`cmd`	`String`: Es el comando de adb shell que se ejecutará.
`maxTimeoutForCommand`	`long`: Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en `timeUnit`.
`timeUnit`	`TimeUnit`: Unidad para `maxTimeToOutputShellResponse`

Muestra
`CommandResult`

Arroja
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
`cmd`	`String`: Es el comando de adb shell que se ejecutará.
`pipeAsInput`	`File`: Es un `ERROR(/File)` que se canalizará como entrada para el comando o será nulo.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` en el que se redireccionará la salida estándar o nulo.
`maxTimeoutForCommand`	`long`: Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en `timeUnit`.
`timeUnit`	`TimeUnit`: Unidad para `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Es la cantidad máxima de veces que se reintentará el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si las `retryAttempts` se realizan sin éxito.

Muestra
`CommandResult`

Arroja
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
`cmd`	`String`: Es el comando de adb shell que se ejecutará.
`pipeAsInput`	`File`: Es un `ERROR(/File)` que se canalizará como entrada para el comando o será nulo.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` en el que se redireccionará la salida estándar o nulo.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)` donde se redireccionará el error estándar o nulo.
`maxTimeoutForCommand`	`long`: Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en `timeUnit`.
`timeUnit`	`TimeUnit`: Unidad para `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Es la cantidad máxima de veces que se reintentará el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si las `retryAttempts` se realizan sin éxito.

Muestra
`CommandResult`

Arroja
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

Método auxiliar que borra una partición del dispositivo.

Si getUseFastbootErase() es true, se usará fastboot erase para borrar la partición. Luego, el dispositivo debe crear un sistema de archivos la próxima vez que se inicie. De lo contrario, se usará el formato fastboot, que creará un nuevo sistema de archivos en el dispositivo.

Se espera que se use cuando el dispositivo ya está en modo fastboot.

Parámetros
`partition`	`String`: Es la partición que se borrará.

Muestra
`CommandResult`	El CommandResult que contiene el resultado del comando

Arroja
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

Recupera la información sobre los APEX activados en el dispositivo.

Muestra
	`ERROR(/Set)` de `ApexInfo` activados actualmente en el dispositivo

Arroja
`DeviceNotAvailableException`

getAdbPath

public String getAdbPath ()

Devuelve la ruta de acceso del objeto binario de adb que se está usando.

Muestra
`String`

getAllSettings

public  getAllSettings (String namespace)

Devuelve pares clave-valor del espacio de nombres solicitado.

Parámetros
`namespace`	`String`: Debe ser uno de los siguientes valores: {"system", "secure", "global"}

Muestra
	Mapa de pares clave-valor. Es nulo si no se admite el espacio de nombres.

Arroja
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Devuelve el estado de asignación actual del dispositivo

Muestra
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

Busca y devuelve el android-id asociado a un userId. Devuelve null si no se encuentra.

Parámetros
`userId`	`int`

Muestra
`String`

Arroja
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Crea un mapa de los IDs de Android que coinciden con los IDs de usuario. No hay garantía de que cada ID de usuario encuentre un ID de Android asociado en esta función, por lo que algunos IDs de usuario pueden coincidir con nulos.

Muestra
	Mapa de los IDs de Android que coinciden con los IDs de usuario.

Arroja
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

Obtiene el nivel de API del dispositivo. La configuración predeterminada es UNKNOWN_API_LEVEL.

Muestra
`int`	Es un número entero que indica el nivel de API del dispositivo.

Arroja
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Recupera información sobre un paquete instalado en el dispositivo.

Parámetros
`packageName`	`String`

Muestra
`PackageInfo`	`PackageInfo` o `null` si no se pudo recuperar la información

Arroja
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

Recupera información de los paquetes instalados en el dispositivo.

Muestra
	`ERROR(/List)` de `PackageInfo` instaladas en el dispositivo.

Arroja
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

Método de conveniencia para obtener la versión de banda base (radio) de este dispositivo. Obtener la versión de radio es específico del dispositivo, por lo que es posible que no devuelva la información correcta para todos los dispositivos. Este método se basa en la propiedad gsm.version.baseband para devolver la información de versión correcta. Esto no es preciso para algunos dispositivos CDMA, y es posible que la versión que se devuelve aquí no coincida con la versión que se informa desde fastboot ni devuelva la versión de la radio CDMA. En resumen, este método solo informa la versión correcta si la propiedad gsm.version.baseband es la misma que la versión que devuelve fastboot getvar version-baseband.

Muestra
`String`	La versión de banda base `String` o `null` si no se puede determinar (el dispositivo no tiene radio o no se puede leer la cadena de versión)

Arroja
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

Devuelve el nivel de batería actual de un dispositivo o Null si el nivel de batería no está disponible.

Muestra
`Integer`

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Devuelve el valor booleano de la propiedad determinada.

Parámetros
`name`	`String`: Es el nombre de la propiedad.
`defaultValue`	`boolean`: Es el valor predeterminado que se devuelve si la propiedad está vacía o no existe.

Muestra
`boolean`	`true` si la propiedad tiene el valor `"1"`, `"y"`, `"yes"`, `"on"` o `"true"`; `false` si la propiedad tiene el valor `"0"`, `"n"`, `"no"`, `"off"`, `"false"` o `defaultValue`; de lo contrario.

Arroja
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

El método auxiliar recopila el mapa del historial de inicio con la hora y el motivo del inicio.

Muestra
	Mapa de la hora de inicio (hora UTC en segundos desde la época) y el motivo de inicio

Arroja
`DeviceNotAvailableException`

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

El método auxiliar recopila el mapa del historial de inicio con la hora y el motivo del inicio desde el momento determinado desde la época del dispositivo y la unidad de tiempo especificada. El utcEpochTime del dispositivo actual en milisegundos se puede obtener con el método getDeviceDate().

Parámetros
`utcEpochTime`	`long`: Es la hora del dispositivo desde el ciclo de entrenamiento.
`timeUnit`	`TimeUnit`: Es la unidad de tiempo `TimeUnit`.

Muestra
	Mapa de la hora de inicio (hora UTC en segundos desde la época) y el motivo de inicio

Arroja
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

Método de conveniencia para obtener la versión del bootloader de este dispositivo.

Se intentará recuperar la versión del bootloader del estado actual del dispositivo. (es decir, si el dispositivo está en modo fastboot, intentará recuperar la versión de fastboot)

Muestra
`String`	La versión del bootloader `String` o `null` si no se puede encontrar

Arroja
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

Recupera un informe de errores del dispositivo.

Se garantiza que la implementación de esto seguirá funcionando en un dispositivo sin tarjeta SD (o en el que la tarjeta SD aún no esté montada).

Muestra
`InputStreamSource`	Es un `InputStreamSource` que producirá el contenido del informe de errores a pedido. En caso de falla, el `InputStreamSource` producirá un `ERROR(/InputStream)` vacío.

getBugreportz

public InputStreamSource getBugreportz ()

Recupera un bugreportz del dispositivo. El informe de errores en formato ZIP contiene el informe de errores principal y otros archivos de registro que son útiles para la depuración.

Solo se admite para "adb version" > 1.0.36

Muestra
`InputStreamSource`	Un `InputStreamSource` del archivo ZIP que contiene el bugreportz. Devuelve nulo en caso de falla.

getBuildAlias

public String getBuildAlias ()

Recupera el alias de la compilación que se está ejecutando en el dispositivo.

El alias de compilación suele ser una cadena más legible que el ID de compilación (por lo general, un número para las compilaciones de Nexus). Por ejemplo, la versión final de Android 4.2 tiene el alias de compilación JDQ39 y el ID de compilación 573038.

Muestra
`String`	Alias de compilación o ID de compilación de resguardo si no se pudo recuperar

Arroja
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Recupera la variante de compilación para el dispositivo.

Muestra
`String`	Es el sabor de compilación o nulo si no se pudo recuperar.

Arroja
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

Recupera la compilación que se está ejecutando en el dispositivo.

Muestra
`String`	El ID de compilación o `IBuildInfo.UNKNOWN_BUILD_ID` si no se pudo recuperar

Arroja
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

Devuelve el tipo de clave que se usó para firmar la imagen del dispositivo.

Por lo general, los dispositivos Android se pueden firmar con claves de prueba (como en AOSP) o claves de lanzamiento (controladas por los fabricantes de dispositivos individuales).

Muestra
`String`	La clave de firma si se encuentra; de lo contrario, es nula.

Arroja
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Devuelve un objeto DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, devuelve el objeto DeviceDescriptor actual.

Muestra
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Devuelve un objeto DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, devuelve el objeto DeviceDescriptor actual.

Parámetros
`shortDescriptor`	`boolean`: Indica si se debe limitar el descriptor a la información mínima necesaria.

Muestra
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

Alternativa al uso de IFileEntry que, a veces, no funciona debido a los permisos.

Parámetros
`path`	`String`: Es la ruta de acceso en el dispositivo en la que se realizará la búsqueda.

Muestra
`String[]`	Es un array de cadenas que contiene todos los archivos de una ruta de acceso en el dispositivo.

Arroja
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

Es la conexión actual asociada al dispositivo.

Muestra
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Devuelve ContentProviderHandler o null si no está disponible.

El proveedor de contenido se puede reutilizar si se construyó antes con el mismo userId.

Parámetros
`userId`	`int`: Es el ID de usuario con el que se inicializará el proveedor de contenido.

Muestra
`ContentProviderHandler`

Arroja
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Devuelve el estado actual de plegado del dispositivo o un valor nulo si se produjo algún problema.

Muestra
`DeviceFoldableState`

Arroja
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Devuelve el ID del usuario que se está ejecutando actualmente. En caso de error, devuelve -10000.

Muestra
`int`

Arroja
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

Obtiene la clase del dispositivo.

Muestra
`String`	la clase de dispositivo `String`

getDeviceDate

public long getDeviceDate ()

Devuelve la fecha del dispositivo en milisegundos desde el ciclo.

Muestra
`long`	Es la fecha del dispositivo en formato de época.

Arroja
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Devuelve un DeviceDescriptor a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo real.

Muestra
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Devuelve un DeviceDescriptor a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo real.

Parámetros
`shortDescriptor`	`boolean`: Indica si se debe limitar el descriptor a la información mínima necesaria.

Muestra
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

Obtiene el estado del dispositivo.

Muestra
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Es un asistente para obtener la diferencia horaria entre el dispositivo y un ERROR(/Date) determinado. Usa la hora de Epoch de forma interna.

Parámetros
`date`	`Date`

Muestra
`long`	La diferencia en milisegundos

Arroja
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Obtén el flujo de stdout y stderr del emulador

Muestra
`InputStreamSource`	Resultado del emulador

getEmulatorProcess

public Process getEmulatorProcess ()

Devuelve el Process correspondiente a este emulador.

Muestra
`Process`	el `Process` o el `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Es el registro que contiene todos los registros de executeShellCommand(String).

Muestra
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Método de ayuda para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo.

Muestra
`long`	La cantidad de espacio libre en KB

Arroja
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

Devuelve la ruta de acceso del objeto binario de fastboot que se usa. Aun así, se requiere que isFastbootEnabled() sea verdadero para habilitar las funciones de fastboot.

Muestra
`String`

getFastbootProductType

public String getFastbootProductType ()

Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.

Este método solo debe usarse si el dispositivo debe estar en fastboot. En este caso, es una variante un poco más segura que el método getProductType() genérico, ya que ITestDevice sabrá cómo recuperar el dispositivo en fastboot si se encuentra en un estado incorrecto o no responde.

Muestra
`String`	El nombre del tipo de producto `String` o `null` si no se puede determinar

Arroja
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.

Muestra
`String`	El nombre del tipo de producto `String` o `null` si no se puede determinar

Arroja
`DeviceNotAvailableException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Devuelve el número de serie del modo fastboot.

Muestra
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

Recupera el valor de la variable fastboot determinada del dispositivo.

Parámetros
`variableName`	`String`: el nombre de la variable

Muestra
`String`	El valor de la propiedad o `null` si no existe

Arroja
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

Devuelve la cadena de versión del objeto binario de fastboot que se usa. O bien, es nulo si algo sale mal.

Muestra
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

Recupera una referencia a un archivo remoto en el dispositivo.

Parámetros
`path`	`String`: Es la ruta de acceso del archivo que se recuperará. Puede ser una ruta de acceso absoluta o relativa a “/” (es decir, se admite la sintaxis “/system” y “system”).

Muestra
`IFileEntry`	`IFileEntry` o `null` si no se encuentra el archivo en el `path` determinado

Arroja
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Es un auxiliar no oficial para obtener un FileEntry a partir de una ruta que no es raíz. FIXME: Refactorizar el sistema FileEntry para que esté disponible desde cualquier ruta de acceso (incluso sin acceso de administrador).

Parámetros
`entry`	`FileListingService.FileEntry`: Un `FileEntry` que no necesariamente es raíz, como lo requiere Ddmlib.

Muestra
`IFileEntry`	Un objeto FileEntryWrapper que representa el objeto FileEntry.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

Devuelve la lista de estados de plegado del dispositivo. Se puede obtener con "cmd device_state print-states".

Muestra

Arroja
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

Devuelve una referencia al objeto IDevice de ddmlib asociado.

DDMS puede asignar un nuevo IDevice cada vez que el dispositivo se desconecta y se vuelve a conectar desde adb. Por lo tanto, los llamadores no deben conservar una referencia a IDevice, ya que esa referencia puede volverse obsoleta.

Muestra
`IDevice`	el `IDevice`

getInstalledPackageNames

public  getInstalledPackageNames ()

Recupera los nombres de los paquetes de aplicaciones presentes en el dispositivo.

Muestra
	`ERROR(/Set)` de los nombres de paquete `String` instalados actualmente en el dispositivo.

Arroja
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Devuelve el valor entero de la propiedad determinada del dispositivo.

Parámetros
`name`	`String`: Es el nombre de la propiedad.
`defaultValue`	`long`: Es el valor predeterminado que se devuelve si la propiedad está vacía o no existe.

Muestra
`long`	El valor de la propiedad o `defaultValue` si la propiedad está vacía, no existe o no tiene un valor entero.

Arroja
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Obtiene la dirección IP del dispositivo.

Muestra
`String`	La dirección IP del dispositivo o `null` si el dispositivo no tiene dirección IP

Arroja
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Devuelve un objeto para obtener el estado actual de Keyguard o un valor nulo si no se admite.

Muestra
`KeyguardControllerState`	Un `KeyguardControllerState` que contiene una instantánea del estado del protector de teclado y devuelve nulo si no se admite la consulta de Keyguard.

Arroja
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

Devuelve la última vez que las APIs de Tradefed activaron un reinicio en milisegundos desde la EPOCH, según lo que devuelve System.currentTimeMillis().

Muestra
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

Obtiene el primer nivel de API que se lanzó en el dispositivo. La configuración predeterminada es UNKNOWN_API_LEVEL.

Muestra
`int`	Es un número entero que indica el primer nivel de API del dispositivo que se lanzó.

Arroja
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

Toma una transmisión de instantáneas de los datos de logcat.

Funciona en dos modos:

Si logcat se está capturando en segundo plano, se devolverán hasta TestDeviceOptions.getMaxLogcatDataSize() bytes del contenido actual de la captura de logcat en segundo plano.

De lo contrario, devolverá un volcado estático de los datos de logcat si el dispositivo responde en ese momento.

Muestra
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

Toma una transmisión de instantáneas de los últimos maxBytes de los datos de logcat capturados.

Es útil en los casos en los que deseas capturar instantáneas frecuentes de los datos de logcat capturados sin incurrir en la penalización potencialmente grande de espacio en disco que implica obtener la instantánea completa de getLogcat().

Parámetros
`maxBytes`	`int`: Es la cantidad máxima de datos que se devolverán. Debe ser una cantidad que quepa cómodamente en la memoria.

Muestra
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

Obtén un volcado del logcat actual del dispositivo. A diferencia de getLogcat(), este método siempre devolverá un volcado estático de logcat.

Tiene la desventaja de que no se devolverá nada si no se puede acceder al dispositivo.

Muestra
`InputStreamSource`	un `InputStreamSource` de los datos de Logcat Se devuelve un flujo vacío si no se pueden capturar datos de logcat.

getLogcatSince

public InputStreamSource getLogcatSince (long date)

Toma una transmisión de instantáneas de los datos de logcat capturados a partir de la fecha proporcionada. La hora del dispositivo se debe usar getDeviceDate().

Parámetros
`date`	`long`: Es el formato de milisegundos desde el ciclo de entrenamiento de cuándo comenzar la instantánea hasta el presente. (se puede obtener con "date +%s")

Muestra
`InputStreamSource`

getMacAddress

public String getMacAddress ()

Devuelve la dirección MAC del dispositivo o un valor nulo si no se puede consultar desde el dispositivo.

Muestra
`String`

getMainUserId

public Integer getMainUserId ()

Devuelve el ID del usuario principal.

Muestra
`Integer`	Es el ID del usuario principal, si lo hay, y es nulo si no hay un usuario principal.

Arroja
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Obtiene información sobre los módulos de la línea principal instalados en el dispositivo.

Muestra
	`ERROR(/Set)` de los módulos de la línea principal de `String` que están instalados actualmente en el dispositivo.

Arroja
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Obtiene la cantidad máxima de usuarios que se pueden ejecutar de forma simultánea. La configuración predeterminada es 0.

Muestra
`int`	Es un número entero que indica la cantidad de usuarios que ejecutan la aplicación de forma simultánea.

Arroja
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Obtiene la cantidad máxima de usuarios admitidos. La configuración predeterminada es 0.

Muestra
`int`	Un número entero que indica la cantidad de usuarios admitidos

Arroja
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

Muestra
`Process`	Devuelve el proceso de la VM de Microdroid. Si TestDevice no es un Microdroid, devuelve null.

getMonitor

public IDeviceStateMonitor getMonitor ()

Devuelve el IDeviceStateMonitor asociado con el dispositivo.

Muestra
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

Devuelve un punto de activación.

Consulta el dispositivo directamente si la información almacenada en caché en IDevice no está disponible.

PENDIENTE: Mover este comportamiento a IDevice.getMountPoint(String)

Parámetros
`mountName`	`String`: el nombre del punto de montaje

Muestra
`String`	El punto de activación o `null`

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Devuelve un MountPointInfo que corresponde a la ruta de acceso del punto de montaje especificado o null si esa ruta de acceso no tiene nada montado o no aparece en /proc/mounts como un punto de montaje.

Parámetros
`mountpoint`	`String`

Muestra
`ITestDevice.MountPointInfo`	Un `ERROR(/List)` de `MountPointInfo` que contiene la información en "/proc/mounts"

Arroja
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

Devuelve una versión analizada de la información en /proc/mounts en el dispositivo.

Muestra
	Un `ERROR(/List)` de `MountPointInfo` que contiene la información en "/proc/mounts"

Arroja
`DeviceNotAvailableException`

getOptions

public TestDeviceOptions getOptions ()

Recupera las opciones de prueba para el dispositivo.

Muestra
`TestDeviceOptions`	`TestDeviceOptions` relacionado con el dispositivo que se está probando.

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

Método auxiliar para determinar la cantidad de espacio libre en la partición del dispositivo.

Parámetros
`partition`	`String`

Muestra
`long`	La cantidad de espacio libre en KB

Arroja
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

Devuelve el ID de usuario principal.

Muestra
`Integer`	Es el ID del usuario principal, si lo hay, y es nulo si no hay un usuario principal.

Arroja
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

El método auxiliar ejecuta los comandos "pidof" y "stat", y devuelve el objeto ProcessInfo con el PID y la hora de inicio del proceso determinado.

Parámetros
`processName`	`String`: Es el nombre del proceso como una cadena.

Muestra
`ProcessInfo`	ProcessInfo del proceso dado processName

Arroja
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

Devuelve el PID del servicio o null si algo salió mal.

Parámetros
`process`	`String`: Es la cadena del nombre del proceso.

Muestra
`String`

Arroja
`DeviceNotAvailableException`

getProductType

public String getProductType ()

Método de conveniencia para obtener el tipo de producto de este dispositivo.

Este método funcionará si el dispositivo está en modo adb o fastboot.

Muestra
`String`	Es el nombre del tipo de producto `String`. No será nulo

Arroja
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

Método de conveniencia para obtener la variante del producto de este dispositivo.

Este método funcionará si el dispositivo está en modo adb o fastboot.

Muestra
`String`	El nombre de la variante del producto `String` o `null` si no se puede determinar

Arroja
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

Recupera el valor de la propiedad determinado del dispositivo.

Parámetros
`name`	`String`: Es el nombre de la propiedad.

Muestra
`String`	El valor de la propiedad o `null` si no existe

Arroja
`DeviceNotAvailableException`

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

Obtiene el modo de recuperación actual que se usa para el dispositivo.

Muestra
`ITestDevice.RecoveryMode`	Es el modo de recuperación actual que se usa para el dispositivo.

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Toma una captura de pantalla del dispositivo con el ID de pantalla determinado. El formato es PNG.

PENDIENTE: Extiende las implementaciones anteriores para admitir "format" y "rescale".

Parámetros
`displayId`	`long`: Es el ID de pantalla desde la que se obtendrá la captura de pantalla.

Muestra
`InputStreamSource`	`InputStreamSource` de la captura de pantalla en formato, o `null` si la captura de pantalla no se realizó correctamente.

Arroja
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

Toma una captura de pantalla del dispositivo. Se recomienda usar getScreenshot(format) con codificación JPEG para un tamaño más pequeño.

Parámetros
`format`	`String`: Se admiten PNG y JPEG

Muestra
`InputStreamSource`	`InputStreamSource` de la captura de pantalla en formato, o `null` si la captura de pantalla no se realizó correctamente.

Arroja
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Toma una captura de pantalla del dispositivo. Se recomienda usar getScreenshot(String) con codificación JPEG para un tamaño más pequeño.

Parámetros
`format`	`String`: Se admiten PNG y JPEG
`rescale`	`boolean`: Indica si se debe cambiar el tamaño de la captura de pantalla para reducir el tamaño de la imagen resultante.

Muestra
`InputStreamSource`	`InputStreamSource` de la captura de pantalla en formato, o `null` si la captura de pantalla no se realizó correctamente.

Arroja
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

Toma una captura de pantalla del dispositivo.

Muestra
`InputStreamSource`	Un `InputStreamSource` de la captura de pantalla en formato PNG o `null` si la captura no se realizó correctamente.

Arroja
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

Método de conveniencia para obtener el número de serie de este dispositivo.

Muestra
`String`	El número de serie `String`

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

Devuelve el valor del parámetro de configuración solicitado. El espacio de nombres debe ser uno de los siguientes: {"system", "secure", "global"}

Parámetros
`userId`	`int`
`namespace`	`String`
`key`	`String`

Muestra
`String`	Es el valor asociado con el par namespace:key de un usuario. Es nulo si no se encuentra.

Arroja
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

Consulta getSetting(int, String, String) y se realiza en el usuario del sistema.

Parámetros
`namespace`	`String`
`key`	`String`

Muestra
`String`

Arroja
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

Devuelve el operador de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible.

Muestra
`String`

getSimState

public String getSimState ()

Devuelve el estado de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible.

Muestra
`String`

getTombstones

public  getTombstones ()

Recupera y devuelve la lista de marcas de eliminación de los dispositivos. Requiere acceso raíz.

El método es de mejor esfuerzo, por lo que, si no se puede extraer una lápida por algún motivo, no aparecerá en la lista. Solo un DeviceNotAvailableException finalizará el método de forma anticipada.

Muestra
	Es una lista de archivos de marcadores de posición, que está vacía si no hay marcadores de posición.

Arroja
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

Devuelve el tamaño total de la memoria física en bytes o -1 en caso de error interno.

Muestra
`long`

getTrackingSerial

public String getTrackingSerial ()

Se obtiene el número de serie que se usa para hacer un seguimiento del dispositivo con fines de administración.

Muestra
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Recupera los nombres de los paquetes de aplicaciones que se pueden desinstalar. Actualmente, se definen como paquetes que no son del sistema y paquetes del sistema actualizados.

Muestra
	`ERROR(/Set)` de nombres de paquetes `String` no desinstalables instalados actualmente en el dispositivo.

Arroja
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

Obtiene si se debe usar fastboot erase o fastboot format para borrar una partición en el dispositivo.

Muestra
`boolean`	`true` si se usará fastboot erase o `false` si se usará fastboot format.

getUserFlags

public int getUserFlags (int userId)

Busca y devuelve las marcas de un usuario determinado. Las marcas se definen en la clase "android.content.pm.UserInfo" del Proyecto de código abierto de Android.

Parámetros
`userId`	`int`

Muestra
`int`	Son las marcas asociadas al userId proporcionado si se encuentra, o bien -10000 en cualquier otro caso.

Arroja
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Obtiene el mapa de useId a UserInfo en el dispositivo. Se arrojará DeviceRuntimeException si el resultado del dispositivo no es el esperado.

Muestra
	Es la lista de objetos UserInfo.

Arroja
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

Devuelve el número de serie asociado al userId si se encuentra; de lo contrario, devuelve -10000.

Parámetros
`userId`	`int`

Muestra
`int`

Arroja
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Procesa el DeviceEvent determinado. Puede hacer que el dispositivo pase a un nuevo estado. Informará al IDeviceMonitor sobre cualquier transición de estado.

Procesa el DeviceEvent, que puede o no hacer que este dispositivo pase a un nuevo estado de asignación.

Parámetros
`event`	`DeviceEvent`

Muestra
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

Comprueba si una función está disponible en un dispositivo.

Parámetros
`feature`	`String`: Indica qué formato debe ser "feature:" o "" directamente.

Muestra
`boolean`	Es verdadero si se encuentra la función y falso en caso contrario.

Arroja
`DeviceNotAvailableException`

initializeConnection

public void initializeConnection (IBuildInfo info, 
                MultiMap<String, String> attributes)

Inicializa la conexión con el dispositivo. Se llama a este método desde preInvocationSetup, pero, en casos excepcionales, es posible que deba llamarse por separado cuando se crea la conexión durante la configuración del dispositivo.

Parámetros
`info`	`IBuildInfo`
`attributes`	`MultiMap`

Arroja
`DeviceNotAvailableException`
`TargetSetupError`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Instala un paquete de Android en el dispositivo.

Parámetros
`packageFile`	`File`: Es el archivo APK que se instalará.
`reinstall`	`boolean`: `true` si se debe realizar una reinstalación
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

Muestra
`String`	Un `String` con un código de error o `null` si la operación se realizó correctamente

Arroja
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Instala un paquete de Android en el dispositivo.

Nota: Solo se debe llamar a esta función en los casos de uso que requieran un control explícito del otorgamiento de permisos de tiempo de ejecución durante la instalación.

Parámetros
`packageFile`	`File`: Es el archivo APK que se instalará.
`reinstall`	`boolean`: `true` si se debe realizar una reinstalación
`grantPermissions`	`boolean`: Indica si se deben otorgar todos los permisos de tiempo de ejecución durante la instalación.
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

Muestra
`String`	Un `String` con un código de error o `null` si la operación se realizó correctamente

Arroja
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Instala un paquete de Android en el dispositivo para un usuario determinado.

Parámetros
`packageFile`	`File`: Es el archivo APK que se instalará.
`reinstall`	`boolean`: `true` si se debe realizar una reinstalación
`userId`	`int`: Es el ID de usuario entero para el que se realizará la instalación.
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

Muestra
`String`	Un `String` con un código de error o `null` si la operación se realizó correctamente

Arroja
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Instala un paquete de Android en el dispositivo para un usuario determinado.

Nota: Solo se debe llamar a esta función en los casos de uso que requieran un control explícito del otorgamiento de permisos de tiempo de ejecución durante la instalación.

Parámetros
`packageFile`	`File`: Es el archivo APK que se instalará.
`reinstall`	`boolean`: `true` si se debe realizar una reinstalación
`grantPermissions`	`boolean`: Indica si se deben otorgar todos los permisos de tiempo de ejecución durante la instalación.
`userId`	`int`: Es el ID de usuario entero para el que se realizará la instalación.
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

Muestra
`String`	Un `String` con un código de error o `null` si la operación se realizó correctamente

Arroja
`DeviceNotAvailableException`

installPackageWithIncrementalMode

public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

Instala APKs con el modo incremental.

Parámetros
`apkFiles`	`File`: Son los archivos APK que se instalarán.
`extraArgs`	`String`
`userId`	`String`

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

Muestra
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Verifica si la plataforma del dispositivo admite la enumeración de apps

Muestra
`boolean`	Es verdadero si se admite la enumeración de apps; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

Comprueba si la plataforma del dispositivo admite la omisión del bloqueo del SDK de destino bajo en las instalaciones de apps

Muestra
`boolean`	Es verdadero si se admite la omisión del bloqueo del SDK de destino bajo; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Verifica si debugfs está montado.

Muestra
`boolean`	`true` si se activó debugfs

Arroja
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

Devuelve si el dispositivo está encriptado.

Muestra
`boolean`	`true` si el dispositivo está encriptado.

Arroja
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

Devuelve True si la ruta de acceso en el dispositivo es un directorio y False en caso contrario.

Parámetros
`path`	`String`

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

Muestra
`boolean`	`true` si se debe habilitar adb root en el dispositivo

isEncryptionSupported

public boolean isEncryptionSupported ()

Devuelve si el dispositivo admite la encriptación.

Muestra
`boolean`	`true` si el dispositivo admite la encriptación.

Arroja
`DeviceNotAvailableException`

isExecutable

public boolean isExecutable (String fullPath)

Devuelve True si la ruta de acceso al archivo en el dispositivo es un archivo ejecutable; de lo contrario, devuelve False.

Parámetros
`fullPath`	`String`

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

Devuelve si fastboot está disponible para el dispositivo.

Muestra
`boolean`

isHeadless

public boolean isHeadless ()

Devuelve verdadero si el dispositivo no tiene pantalla y falso en caso contrario.

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Devuelve si el dispositivo usa el modo de usuario del sistema sin interfaz gráfica.

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Devuelve si el usuario principal es un administrador permanente y no se puede borrar ni degradar a un estado que no sea de administrador.

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Determina si se admite la función de múltiples usuarios.

Muestra
`boolean`	Es verdadero si se admite la función multiusuario; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Consulta el dispositivo para un nombre de paquete y un ID de usuario determinados para verificar si está instalado actualmente para ese usuario.

Parámetros
`packageName`	`String`: Es el paquete que verificamos si está instalado.
`userId`	`String`: Es el ID de usuario para el que verificamos si está instalado el paquete. Si es nulo, se usará el usuario principal cero.

Muestra
`boolean`	Es verdadero si se informa que el paquete está instalado. De lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Consulta el dispositivo para un nombre de paquete determinado y verifica si está instalado actualmente.

Parámetros
`packageName`	`String`

Muestra
`boolean`	Es verdadero si se informa que el paquete está instalado. De lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

Comprueba si la plataforma del dispositivo admite el otorgamiento de permisos en el tiempo de ejecución

Muestra
`boolean`	Es verdadero si se admiten permisos de tiempo de ejecución; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

Devuelve verdadero si el dispositivo está en TestDeviceState.FASTBOOT o TestDeviceState.FASTBOOTD.

Muestra
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

Comprueba si un usuario determinado está ejecutando la app.

Parámetros
`userId`	`int`

Muestra
`boolean`	Es verdadero si el usuario está corriendo y falso en todos los demás casos.

Arroja
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

Devuelve si el usuario especificado es un usuario secundario según sus marcas.

Parámetros
`userId`	`int`

Muestra
`boolean`	Es verdadero si el usuario es secundario; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

Verifica si el usuario determinado es visible.

Un usuario "visible" es un usuario que interactúa con el usuario "humano" y, por lo tanto, puede iniciar actividades de inicio (por lo general, en la pantalla predeterminada).

Parámetros
`userId`	`int`

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Verifica si el usuario determinado es visible en la pantalla determinada.

Un usuario "visible" es un usuario que interactúa con el usuario "humano" y, por lo tanto, puede iniciar actividades de inicio en esa pantalla.

Parámetros
`userId`	`int`
`displayId`	`int`

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Devuelve si el dispositivo permite que los usuarios inicien la visibilidad en segundo plano en ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

Si es así, puedes llamar a startVisibleBackgroundUser(int, int, boolean) y pasar una pantalla que muestre listDisplayIdsForStartingVisibleBackgroundUsers() (que debería incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Devuelve si el dispositivo permite que los usuarios inicien la visibilidad en segundo plano.

Si es así, puedes llamar a startVisibleBackgroundUser(int, int, boolean) y pasar una pantalla que muestre listDisplayIdsForStartingVisibleBackgroundUsers().

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Prueba si el Wi-Fi está habilitado.

Comprueba si el Wi-Fi está habilitado en el dispositivo. Es útil para confirmar el estado de la conexión Wi-Fi antes de las pruebas que no se deben ejecutar con Wi-Fi, p.ej., las pruebas de datos móviles.

Muestra
`boolean`	`true` si el Wi-Fi está habilitado. `false` si está inhabilitado

Arroja
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

Recopila la lista de IDs de pantallas disponibles en el dispositivo, según lo indica "dumpsys SurfaceFlinger".

Muestra
	Es la lista de pantallas. Default siempre devuelve la pantalla predeterminada 0.

Arroja
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Obtiene la lista de pantallas que se pueden usar para start a user visible in the background.

Muestra

Arroja
`DeviceNotAvailableException`

listUsers

public  listUsers ()

Obtiene la lista de usuarios del dispositivo. Se arrojará DeviceRuntimeException si el resultado del dispositivo no es el esperado.

Muestra
	Es la lista de IDs de usuarios.

Arroja
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

Recopila y registra los errores ANR del dispositivo.

Parámetros
`logger`	`ITestLogger`: Es un `ITestLogger` para registrar los errores de ANR.

Muestra
`boolean`	Es verdadero si el registro se realizó correctamente y falso en caso contrario.

Arroja
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Método auxiliar para tomar un informe de errores y registrarlo para los reporteros.

Parámetros
`dataName`	`String`: Es el nombre con el que se informará el informe de errores.
`listener`	`ITestLogger`: Es un `ITestLogger` para registrar el informe de errores.

Muestra
`boolean`	Es verdadero si el registro se realizó correctamente y falso en caso contrario.

logOnDevice

public void logOnDevice (String tag, 
                Log.LogLevel level, 
                String format, 
                Object... args)

Registra un mensaje en el logcat del dispositivo. Esta es una llamada segura que no arrojará una excepción incluso si falla el registro.

Parámetros
`tag`	`String`: Es la etiqueta con la que registramos nuestro mensaje en Logcat.
`level`	`Log.LogLevel`: Es el nivel de depuración del mensaje en Logcat.
`format`	`String`: Es el formato del mensaje.
`args`	`Object`: Son los argumentos que se reemplazarán a través de String.format().

mountDebugfs

public void mountDebugfs ()

Activa debugfs.

Arroja
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

Envía un comando para reiniciar el dispositivo y regresa cuando se completa el comando y cuando el dispositivo ya no es visible para adb.

Arroja
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Anula si el dispositivo necesita que se realicen algunas acciones específicas después de adb root y antes de que el dispositivo vuelva a estar en línea. La implementación predeterminada no incluye ninguna acción adicional. No se garantiza que adb root esté habilitado en esta etapa.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postAdbUnrootAction

public void postAdbUnrootAction ()

Anula si el dispositivo necesita que se realicen algunas acciones específicas después de quitar el acceso de administrador con adb y antes de que el dispositivo vuelva a estar en línea. La implementación predeterminada no incluye ninguna acción adicional. No se garantiza que la raíz de adb esté inhabilitada en esta etapa.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public void postBootSetup ()

Sigue las instrucciones para configurar el dispositivo para las pruebas después de cada arranque.

Se debe llamar después de que el dispositivo se haya iniciado o esté disponible por completo

En circunstancias normales, no es necesario llamar a este método de forma explícita, ya que las implementaciones deben realizar estos pasos automáticamente cuando se realiza un reinicio.

Se puede llamar cuando el dispositivo se reinicia debido a otros eventos (p. ej., cuando se completó un comando de actualización de fastboot).

Arroja
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Pasos adicionales para la limpieza requerida específica del dispositivo que se ejecutarán después de que se complete la invocación.

Parámetros
`exception`	`Throwable`: Si hay alguna, es la excepción final que se generó por la falla de invocación.

preInvocationSetup

public void preInvocationSetup (IBuildInfo info, 
                MultiMap<String, String> attributes)

Son pasos adicionales para la configuración requerida específica del dispositivo que se ejecutarán en el dispositivo antes del flujo de invocación.

Parámetros
`info`	`IBuildInfo`: Es el `IBuildInfo` del dispositivo.
`attributes`	`MultiMap`: Son los atributos almacenados en el contexto de invocación.

Arroja
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

Extrae de forma recursiva el contenido del directorio del dispositivo.

Parámetros
`deviceFilePath`	`String`: Es la ruta de acceso absoluta del archivo de la fuente remota.
`localDir`	`File`: Es el directorio local en el que se extraerán los archivos.
`userId`	`int`: ID del usuario del que se extraerá la información

Muestra
`boolean`	`true` si el archivo se extrajo correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Extrae de forma recursiva el contenido del directorio del dispositivo.

Parámetros
`deviceFilePath`	`String`: Es la ruta de acceso absoluta del archivo de la fuente remota.
`localDir`	`File`: Es el directorio local en el que se extraerán los archivos.

Muestra
`boolean`	`true` si el archivo se extrajo correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

Recupera un archivo del dispositivo.

Parámetros
`remoteFilePath`	`String`: Es la ruta de acceso absoluta al archivo en el dispositivo.
`localFile`	`File`: Es el archivo local en el que se almacenará el contenido. Si no está vacío, se reemplazará el contenido.

Muestra
`boolean`	`true` si el archivo se recuperó correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

Recupera un archivo del dispositivo, lo almacena en un objeto ERROR(/File) temporal local y devuelve ese objeto File.

Parámetros
`remoteFilePath`	`String`: Es la ruta de acceso absoluta al archivo en el dispositivo.
`userId`	`int`: ID del usuario del que se extraerá la información

Muestra
`File`	Un `ERROR(/File)` que contiene el contenido del archivo del dispositivo o `null` si la copia falló por algún motivo (incluidos problemas con el sistema de archivos del host)

Arroja
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

Recupera un archivo del dispositivo, lo almacena en un objeto ERROR(/File) temporal local y devuelve ese objeto File.

Parámetros
`remoteFilePath`	`String`: Es la ruta de acceso absoluta al archivo en el dispositivo.

Muestra
`File`	Un `ERROR(/File)` que contiene el contenido del archivo del dispositivo o `null` si la copia falló por algún motivo (incluidos problemas con el sistema de archivos del host)

Arroja
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

Recupera un archivo del dispositivo.

Parámetros
`remoteFilePath`	`String`: Es la ruta de acceso absoluta al archivo en el dispositivo.
`localFile`	`File`: Es el archivo local en el que se almacenará el contenido. Si no está vacío, se reemplazará el contenido.
`userId`	`int`: ID del usuario del que se extraerá la información

Muestra
`boolean`	`true` si el archivo se recuperó correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

Recupera un archivo del dispositivo y devuelve su contenido.

Parámetros
`remoteFilePath`	`String`: Es la ruta de acceso absoluta al archivo en el dispositivo.

Muestra
`String`	Un `String` que contiene el contenido del archivo del dispositivo o `null` si la copia falló por algún motivo (incluidos problemas con el sistema de archivos del host)

Arroja
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

Es un método de conveniencia para recuperar un archivo del almacenamiento externo del dispositivo, almacenarlo en un ERROR(/File) temporal local y devolver una referencia a ese File.

Parámetros
`remoteFilePath`	`String`: Es la ruta de acceso al archivo en el dispositivo, relativa al punto de montaje del almacenamiento externo del dispositivo.

Muestra
`File`	Un `ERROR(/File)` que contiene el contenido del archivo del dispositivo o `null` si la copia falló por algún motivo (incluidos problemas con el sistema de archivos del host)

Arroja
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

Envía de forma recursiva el contenido del directorio al dispositivo y excluye algunos directorios que se filtran.

Parámetros
`localFileDir`	`File`: Es el directorio local que se enviará.
`deviceFilePath`	`String`: Es la ruta de acceso absoluta del archivo del destino remoto.
`excludedDirectories`	: Es el conjunto de nombres de directorios excluidos que no se deben enviar.

Muestra
`boolean`	`true` si el archivo se envió correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Envía de forma recursiva el contenido del directorio al dispositivo.

Parámetros
`localFileDir`	`File`: Es el directorio local que se enviará.
`deviceFilePath`	`String`: Es la ruta de acceso absoluta del archivo del destino remoto.

Muestra
`boolean`	`true` si el archivo se envió correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                int userId)

Envía de forma recursiva el contenido del directorio al dispositivo.

Parámetros
`localFileDir`	`File`: Es el directorio local que se enviará.
`deviceFilePath`	`String`: Es la ruta de acceso absoluta del archivo del destino remoto.
`userId`	`int`: ID del usuario al que se enviará la notificación push

Muestra
`boolean`	`true` si el archivo se envió correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                boolean evaluateContentProviderNeeded)

Variante de pushFile(File, String) que puede considerar de forma opcional la evaluación de la necesidad del proveedor de contenido.

Parámetros
`localFile`	`File`: Es el archivo local que se enviará.
`remoteFilePath`	`String`: Es la ruta de acceso absoluta del archivo de destino remoto.
`evaluateContentProviderNeeded`	`boolean`: Indica si se debe verificar si necesitamos el proveedor de contenido.

Muestra
`boolean`	`true` si el archivo se envió correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

Envía un archivo al dispositivo. De forma predeterminada, se usa un proveedor de contenido.

Parámetros
`localFile`	`File`: Es el archivo local que se enviará.
`remoteFilePath`	`String`: Es la ruta de acceso absoluta del archivo de destino remoto.

Muestra
`boolean`	`true` si el archivo se envió correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                int userId)

Envía un archivo al dispositivo. De forma predeterminada, se usa un proveedor de contenido.

Parámetros
`localFile`	`File`: Es el archivo local que se enviará.
`remoteFilePath`	`String`: Es la ruta de acceso absoluta del archivo de destino remoto.
`userId`	`int`: Es el ID de usuario al que se enviará la notificación push.

Muestra
`boolean`	`true` si el archivo se envió correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

Envía al dispositivo el archivo creado a partir de una cadena

Parámetros
`contents`	`String`: Contenido del archivo que se enviará
`remoteFilePath`	`String`: Es la ruta de acceso absoluta del archivo de destino remoto.

Muestra
`boolean`	`true` si la cadena se envió correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

reiniciar

public void reboot (String reason)

Reinicia el dispositivo en modo adb con el reason determinado para que persista después del reinicio.

Se bloquea hasta que el dispositivo esté disponible.

La razón del último reinicio se puede obtener consultando la propiedad sys.boot.reason.

Parámetros
`reason`	`String`: Es un motivo para este reinicio o `null` si no se especifica ningún motivo.

Arroja
`DeviceNotAvailableException`

reiniciar

public void reboot ()

Reinicia el dispositivo en modo adb.

Se bloquea hasta que el dispositivo esté disponible.

Arroja
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

Reinicia el dispositivo en el modo de cargador de arranque.

Se bloquea hasta que el dispositivo esté en modo de bootloader.

Arroja
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

Reinicia el dispositivo en el modo fastbootd.

Se bloquea hasta que el dispositivo está en modo fastbootd.

Arroja
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

Reinicia el dispositivo en el modo de recuperación de adb.

Se bloquea hasta que el dispositivo entra en el modo de recuperación

Arroja
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

Reinicia el dispositivo en el modo de carga lateral de adb (ten en cuenta que este es un modo especial en recuperación).

Se bloquea hasta que el dispositivo entra en el modo de carga lateral.

Arroja
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

Reinicia el dispositivo en el modo de carga lateral de adb (ten en cuenta que este es un modo especial en recuperación).

Se bloquea hasta que el dispositivo entra en el modo de carga lateral.

Parámetros
`autoReboot`	`boolean`: Indica si se debe reiniciar automáticamente el dispositivo después de la transferencia

Arroja
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

Es una alternativa a reboot() que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.

Arroja
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline (String reason)

Es una alternativa a reboot() que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.

Parámetros
`reason`	`String`: Es un motivo para este reinicio o `null` si no se especifica ningún motivo.

Arroja
`DeviceNotAvailableException`

rebootUserspace

public void rebootUserspace ()

Solo reinicia la parte del espacio del usuario del dispositivo.

Se bloquea hasta que el dispositivo esté disponible.

ADVERTENCIA. El reinicio del espacio del usuario está en desarrollo activo. Úsalo bajo tu propia responsabilidad.

Arroja
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

Es una alternativa a rebootUserspace() ()} que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb.

Arroja
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

Intenta recuperar la comunicación del dispositivo.

Muestra
`boolean`	Es verdadero si se intentó la recuperación y se realizó correctamente. Devuelve falso si se omitió la recuperación.

Arroja
`DeviceNotAvailableException`	Si el dispositivo ya no está disponible

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver para este dispositivo.

Todos los IDeviceActionReceivers registrados recibirán una notificación antes de que comience una acción del dispositivo y después de que finalice.

Parámetros
`deviceActionReceiver`	`IDeviceActionReceiver`: Es un `IDeviceActionReceiver` que se registrará.

remountSystemReadOnly

public void remountSystemReadOnly ()

Haz que la partición del sistema en el dispositivo sea de solo lectura. Es posible que se reinicie el dispositivo.

Arroja
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

Haz que se pueda escribir en la partición del sistema del dispositivo. Es posible que se reinicie el dispositivo.

Arroja
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

Haz que la partición del proveedor en el dispositivo sea de solo lectura. Es posible que se reinicie el dispositivo.

Arroja
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

Haz que la partición del proveedor en el dispositivo sea grabable. Es posible que se reinicie el dispositivo.

Arroja
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Quita el administrador de dispositivos determinado del usuario determinado y devuelve true si se realiza correctamente o false si no se realiza correctamente.

Parámetros
`componentName`	`String`: del administrador de dispositivos que se quitará.
`userId`	`int`: Del usuario en el que reside el administrador del dispositivo.

Muestra
`boolean`	Es verdadero si se ejecuta correctamente; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Quita todos los propietarios de perfiles de dispositivos existentes con el mejor esfuerzo.

Arroja
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

Quita un usuario determinado del dispositivo.

Parámetros
`userId`	`int`: del usuario que se quitará

Muestra
`boolean`	Es verdadero si se quitó el usuario correctamente y falso en caso contrario.

Arroja
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

Restablece la marca para la configuración del proveedor de contenido y, así, vuelve a activarla.

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                ITestLifeCycleReceiver... listeners)

Método de conveniencia para realizar ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) con uno o más objetos de escucha pasados como parámetros.

Parámetros
`runner`	`IRemoteAndroidTestRunner`: Es el `IRemoteAndroidTestRunner` que ejecuta las pruebas.
`listeners`	`ITestLifeCycleReceiver`: Son los objetos de escucha de los resultados de la prueba.

Muestra
`boolean`	`true` si se completó el comando de prueba. `false` si no se pudo completar, pero la recuperación se realizó correctamente

Arroja
`DeviceNotAvailableException`

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Ejecuta pruebas de instrumentación y proporciona recuperación del dispositivo.

Si se pierde la conexión con el dispositivo antes de que se complete la ejecución de la prueba y la recuperación se realiza correctamente, se informará a todos los objetos de escucha sobre testRunFailed y se devolverá "false". No se volverá a ejecutar el comando de prueba. Los llamadores deben volver a intentarlo si es necesario.

Si se pierde la conexión con el dispositivo antes de que se complete la ejecución de prueba y falla la recuperación, se informará a todos los objetos de escucha sobre testRunFailed y se arrojará DeviceNotAvailableException.

Parámetros
`runner`	`IRemoteAndroidTestRunner`: Es el `IRemoteAndroidTestRunner` que ejecuta las pruebas.
`listeners`	: Son los objetos de escucha de los resultados de la prueba.

Muestra
`boolean`	`true` si se completó el comando de prueba. `false` si no se pudo completar debido a una excepción de comunicación del dispositivo, pero se realizó la recuperación correctamente

Arroja
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                 listeners)

Es igual que ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), pero ejecuta la prueba para el usuario determinado.

Parámetros
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

Es igual que ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), pero ejecuta la prueba para un usuario determinado.

Parámetros
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`ITestLifeCycleReceiver`

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

setAdbPath

public void setAdbPath (String adbPath)

Establece la ruta de acceso al objeto binario de adb que se debe usar.

Parámetros
`adbPath`	`String`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inserta el IConfiguration en uso.

Parámetros
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

Parámetros
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

Establece la fecha en el dispositivo

Nota: Establecer la fecha en el dispositivo requiere acceso de administrador.

Parámetros
`date`	`Date`: Especifica una fecha en particular. Se usará la fecha del host si es `null`.

Arroja
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Establece un componente de administrador del dispositivo como propietario del dispositivo en el usuario determinado.

Parámetros
`componentName`	`String`: del administrador del dispositivo para que sea el propietario del dispositivo
`userId`	`int`: del usuario en el que vive el propietario del dispositivo.

Muestra
`boolean`	Es verdadero si se ejecuta correctamente; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Actualiza el estado del dispositivo.

Parámetros
`deviceState`	`TestDeviceState`: El `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

Para el emulador, configura SizeLimitedOutputStream para registrar el resultado

Parámetros
`output`	`SizeLimitedOutputStream`: Para registrar el resultado

setEmulatorProcess

public void setEmulatorProcess (Process p)

Establece el Process cuando este dispositivo es un emulador.

Parámetros
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

Establece la opción de fastboot para el dispositivo. Se debe establecer cuando se asigna el dispositivo por primera vez.

Parámetros
`fastbootEnabled`	`boolean`: Indica si fastboot está disponible para el dispositivo.

setFastbootPath

public void setFastbootPath (String fastbootPath)

Establece la ruta de acceso al objeto binario de fastboot que se debe usar. Aun así, se requiere que isFastbootEnabled() sea verdadero para habilitar las funciones de fastboot.

Parámetros
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Actualiza el IDevice asociado con este ITestDevice.

El nuevo IDevice debe hacer referencia al mismo dispositivo físico que la referencia actual. Se llamará a este método si DDMS asignó un nuevo IDevice.

Parámetros
`newDevice`	`IDevice`: El `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

Establece el tiempo en ms que se debe esperar antes de iniciar la captura de logcat para un dispositivo en línea.

Parámetros
`delay`	`int`: Es la demora en ms.

setOptions

public void setOptions (TestDeviceOptions options)

Cómo configurar el TestDeviceOptions para el dispositivo

Parámetros
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

Establece el valor de propiedad determinado en el dispositivo. Requiere que adb root sea verdadero.

Parámetros
`propKey`	`String`: Es la clave objetivo que se configurará.
`propValue`	`String`: Es el valor de la propiedad que se establecerá.

Muestra
`boolean`	Devuelve `True` si el comando setprop se ejecutó correctamente; de lo contrario, devuelve False.

Arroja
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

Establece el IDeviceRecovery que se usará para este dispositivo. Se debe establecer cuando se asigna el dispositivo por primera vez.

Parámetros
`recovery`	`IDeviceRecovery`: El `IDeviceRecovery`

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

Establece el modo de recuperación actual que se usará para el dispositivo.

Se usa para controlar qué método de recuperación se debe usar cuando se detecta un problema de comunicación del dispositivo. Se recomienda usar este método solo con moderación cuando sea necesario (por ejemplo, cuando el framework no funciona, etc.).

Parámetros
`mode`	`ITestDevice.RecoveryMode`: Indica si el modo "Recuperar solo hasta que esté en línea" debe estar activado o no.

setSetting

public void setSetting (String namespace, 
                String key, 
                String value)

Consulta setSetting(int, String, String, String) y se realiza en el usuario del sistema.

Parámetros
`namespace`	`String`
`key`	`String`
`value`	`String`

Arroja
`DeviceNotAvailableException`

setSetting

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Agrega un valor de configuración al espacio de nombres de un usuario determinado. Algunos parámetros de configuración solo estarán disponibles después de reiniciar el dispositivo. El espacio de nombres debe ser uno de los siguientes: {"system", "secure", "global"}

Parámetros
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

Arroja
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Inyecta la instancia de ITestLogger.

Parámetros
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

Para fines de administración de dispositivos, se hace un seguimiento del número de serie que usamos para hacer referencia al dispositivo.

Parámetros
`trackingSerial`	`String`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

Establece si se debe usar fastboot erase o fastboot format para borrar una partición del dispositivo.

Parámetros
`useFastbootErase`	`boolean`: `true` si se debe usar fastboot erase o `false` si se debe usar fastboot format.

startLogcat

public void startLogcat ()

Comienza a capturar el resultado de logcat del dispositivo en segundo plano.

No tendrá efecto si ya se está capturando el registro de logcat. Los datos se pueden recuperar más tarde con getLogcat.

Cuando el dispositivo ya no esté en uso, se debe llamar a stopLogcat().

Por lo general, no es necesario llamar a startLogcat() y stopLogcat() cuando se está dentro de un contexto de invocación de TF, ya que el framework de TF iniciará y detendrá Logcat.

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

Habilita el modo de prueba de intercambio. Se borrará el dispositivo y se reiniciará.

Parámetros
`timeoutMs`	`int`

Muestra
`boolean`	Es verdadero si la operación se realizó correctamente y falso en caso contrario.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId)

Inicia un usuario determinado en segundo plano si está detenido. Si el usuario ya se está ejecutando en segundo plano, este método es una operación nula.

Parámetros
`userId`	`int`: del usuario que se iniciará en segundo plano

Muestra
`boolean`	Es verdadero si el usuario se inició correctamente en segundo plano.

Arroja
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Inicia un usuario determinado en segundo plano si está detenido. Si el usuario ya se está ejecutando en segundo plano, este método es una operación nula. Es posible proporcionar una marca adicional para esperar a que la operación surta efecto.

Parámetros
`userId`	`int`: del usuario que se iniciará en segundo plano
`waitFlag`	`boolean`: Hará que el comando espere hasta que se inicie y desbloquee el usuario.

Muestra
`boolean`	Es verdadero si el usuario se inició correctamente en segundo plano.

Arroja
`DeviceNotAvailableException`

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Inicia un usuario determinado en segundo plano, visible en la pantalla determinada (es decir, permite que el usuario inicie actividades en esa pantalla).

NOTA: Este comando no verifica si el usuario existe, si la pantalla está disponible, device supports such feature, etcétera.

Parámetros
`userId`	`int`: del usuario que se iniciará en segundo plano
`displayId`	`int`: Pantalla en la que se inicia el usuario visible
`waitFlag`	`boolean`: Hará que el comando espere hasta que se inicie y desbloquee el usuario.

Muestra
`boolean`	`true` si el usuario se inició correctamente en segundo plano.

Arroja
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

Cierra y borra el resultado del emulador.

stopLogcat

public void stopLogcat ()

Deja de capturar el resultado de Logcat del dispositivo y descarta los datos de Logcat guardados actualmente.

No tendrá efecto si no se captura el resultado de logcat.

stopTradeInModeTesting

public void stopTradeInModeTesting ()

Detener las pruebas del modo de intercambio.

Arroja
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

Detiene a un usuario determinado. Si el usuario ya se detuvo, este método no hace nada. No se puede detener al usuario actual ni al usuario del sistema.

Parámetros
`userId`	`int`: del usuario que se detendrá.

Muestra
`boolean`	Es verdadero si el usuario se detuvo correctamente.

Arroja
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Detiene a un usuario determinado. Es posible proporcionar marcas adicionales para esperar a que la operación surta efecto y forzar la finalización del usuario. No se puede detener al usuario actual ni al usuario del sistema.

Parámetros
`userId`	`int`: del usuario que se detendrá.
`waitFlag`	`boolean`: Hará que el comando espere hasta que se detenga el usuario.
`forceFlag`	`boolean`: Forzará la detención del usuario.

Muestra
`boolean`	Es verdadero si el usuario se detuvo correctamente.

Arroja
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

Cambia el dispositivo al modo adb-over-tcp.

Muestra
`String`	El número de serie de TCP o `null` si no se pudo cambiar el dispositivo

Arroja
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Cambia el dispositivo al modo adb a través de USB.

Muestra
`boolean`	`true` si el cambio se realizó correctamente; de lo contrario, `false`.

Arroja
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

Cambia a otro userId con un tiempo de espera predeterminado. switchUser(int, long).

Parámetros
`userId`	`int`

Muestra
`boolean`	Es verdadero si el nuevo userId coincide con el proveedor de userId. De lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

Cambia a otro userId con el tiempo de espera proporcionado como fecha límite. Intenta inhabilitar el bloqueo de teclado después de que se realice correctamente el cambio de usuario.

Parámetros
`userId`	`int`
`timeout`	`long`: Tiempo de espera antes de devolver el valor falso para el cambio de usuario fallido.

Muestra
`boolean`	Es verdadero si el nuevo userId coincide con el proveedor de userId. De lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

Sincroniza de forma incremental el contenido de un directorio de archivos local con el dispositivo.

Decide qué archivos enviar comparando las marcas de tiempo de los archivos locales con sus equivalentes remotos. Solo se transferirán al dispositivo los archivos "más nuevos" o los que no existan. Por lo tanto, la sobrecarga debería ser relativamente pequeña si el conjunto de archivos del dispositivo ya está actualizado.

Se ignorarán los archivos ocultos (con nombres que comiencen con ".").

Ejemplo de uso: syncFiles("/tmp/files", "/sdcard") creará un directorio /sdcard/files si aún no existe y enviará de forma recursiva el contenido de /tmp/files a /sdcard/files.

Parámetros
`localFileDir`	`File`: Es el directorio de archivos local que contiene los archivos que se deben enviar de forma recursiva.
`deviceFilePath`	`String`: Es la raíz de la ruta de acceso absoluta del archivo de destino remoto. Todos los directorios de esa ruta de acceso al archivo deben ser legibles. Es decir, si se intenta enviar a /data/local/tmp cuando adb no es root, se producirá un error.

Muestra
`boolean`	`true` si los archivos se sincronizaron correctamente. En caso contrario, `false`.

Arroja
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

Toma un informe de errores y lo devuelve dentro de un objeto Bugreport para controlarlo. Devuelve nulo en caso de problemas. El archivo al que se hace referencia en el objeto Bugreport debe limpiarse a través de Bugreport.close().

Muestra
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

Desinstala un paquete de Android del dispositivo.

Parámetros
`packageName`	`String`: Es el paquete de Android que se desinstalará.

Muestra
`String`	Un `String` con un código de error o `null` si la operación se realizó correctamente

Arroja
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Desinstala un paquete de Android del dispositivo para un usuario determinado.

Parámetros
`packageName`	`String`: Es el paquete de Android que se desinstalará.
`userId`	`int`: Es el ID de usuario entero para el que se desinstalará.

Muestra
`String`	Un `String` con un código de error o `null` si la operación se realizó correctamente

Arroja
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

Desbloquea el dispositivo si está encriptado.

Este método puede reiniciar el framework, pero no llamará a postBootSetup(). Por lo tanto, es posible que el dispositivo no esté completamente listo para probarse cuando este método muestre un valor de retorno.

Muestra
`boolean`	`true` si la operación se realiza correctamente o si el dispositivo no está encriptado.

Arroja
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

Desmonta debugfs.

Arroja
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

Se bloquea hasta que se establece la marca de inicio completo del dispositivo.

Parámetros
`timeOut`	`long`: Tiempo en milisegundos que se espera para que se establezca la marca

Muestra
`boolean`	Es verdadero si la marca de inicio completo del dispositivo se establece dentro del tiempo de espera.

Arroja
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

Espera a que el dispositivo responda y esté disponible para las pruebas. Se usa el tiempo de espera predeterminado.

Muestra
`boolean`	Es verdadero si el dispositivo está disponible y falso si la recuperación está inhabilitada y no está disponible.

Arroja
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

Espera a que el dispositivo responda y esté disponible para las pruebas.

Parámetros
`waitTime`	`long`: Es el tiempo en ms que se debe esperar.

Muestra
`boolean`	Es verdadero si el dispositivo está disponible y falso si la recuperación está inhabilitada y no está disponible.

Arroja
`DeviceNotAvailableException`

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Espera a que el dispositivo responda y esté disponible sin tener en cuenta la ruta de recuperación.

Parámetros
`waitTime`	`long`

Muestra
`boolean`	Es verdadero si el dispositivo está disponible y falso si no lo está.

Arroja
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

Se bloquea hasta que el dispositivo esté visible a través de fastboot. Usa el tiempo de espera predeterminado.

Arroja
`DeviceNotAvailableException`

waitForDeviceFastbootD

public void waitForDeviceFastbootD ()

Arroja
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

Bloquea el dispositivo para que esté en el estado "adb recovery" (ten en cuenta que es diferente de IDeviceRecovery).

Parámetros
`waitTime`	`long`: Es el tiempo en ms que se debe esperar.

Muestra
`boolean`	`true` si el dispositivo se inicia en el modo de recuperación antes de que venza el tiempo. `false` de lo contrario

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

Bloqueos para que el dispositivo esté en el estado "adb sideload"

Parámetros
`waitTime`	`long`: Es el tiempo en ms que se debe esperar.

Muestra
`boolean`	`true` si el dispositivo se inicia en la transferencia antes de que venza el tiempo. `false` de lo contrario

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

Bloquea el dispositivo para que no esté disponible, es decir, que no aparezca en adb.

Parámetros
`waitTime`	`long`: Es el tiempo en ms que se debe esperar.

Muestra
`boolean`	`true` si el dispositivo deja de estar disponible antes de que venza el tiempo `false` de lo contrario

waitForDeviceOnline

public void waitForDeviceOnline ()

Se bloquea hasta que el dispositivo esté visible a través de adb. Usa el tiempo de espera predeterminado

Ten en cuenta que es posible que el dispositivo no responda a los comandos cuando se complete el proceso. En su lugar, usa waitForDeviceAvailable().

Arroja
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

Se bloquea hasta que el dispositivo esté visible a través de adb.

Ten en cuenta que es posible que el dispositivo no responda a los comandos cuando se complete el proceso. En su lugar, usa waitForDeviceAvailable().

Parámetros
`waitTime`	`long`: Es el tiempo en ms que se debe esperar.

Arroja
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

Espera a que el dispositivo responda a un comando básico de adb shell.

Parámetros
`waitTime`	`long`: Es el tiempo en ms que se debe esperar.

Muestra
`boolean`	`true` si el dispositivo responde antes de que transcurra `waitTime`

Métodos protegidos

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

Parámetros
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

protected String[] buildAdbShellCommand (String command, 
                boolean forceExitStatusDetection)

Compila el comando del SO para la sesión y los argumentos del comando adb shell determinados.

Parámetros
`command`	`String`
`forceExitStatusDetection`	`boolean`

Muestra
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

Parámetros
`feature`	`String`
`strictMinLevel`	`int`

createRebootDeviceAction

protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

Crea un RebootDeviceAction para usarlo cuando se realice una acción de reinicio.

Parámetros
`rebootMode`	`NativeDevice.RebootMode`: Es un modo de este reinicio.
`reason`	`String`: Para este reinicio.

Muestra
`NativeDevice.RebootDeviceAction`	el `RebootDeviceAction` creado.

createRunUtil

protected IRunUtil createRunUtil ()

Muestra
`IRunUtil`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Realiza un reinicio con adb.

Parámetros
`rebootMode`	`NativeDevice.RebootMode`: Es un modo de este reinicio.
`reason`	`String`: Para este reinicio.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

Método auxiliar para arrojar una excepción si no se admite el permiso de tiempo de ejecución

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getApiLevelSafe

protected int getApiLevelSafe ()

Muestra
`int`

getLogger

protected ITestLogger getLogger ()

Muestra
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

Obtén la instancia de RunUtil que se usará.

Muestra
`IRunUtil`

internalGetProperty

protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

Recupera una propiedad del dispositivo, de la caché de ddmlib de forma predeterminada, y recurre a `adb shell getprop` o `fastboot getvar` según si el dispositivo está en Fastboot o no.

Parámetros
`propName`	`String`: Es el nombre de la propiedad del dispositivo que devuelve "adb shell getprop".
`fastbootVar`	`String`: Nombre de la variable de fastboot equivalente que se consultará. Si es `null`, no se intentará realizar la consulta de fastboot.
`description`	`String`: Es una descripción simple de la variable. La primera letra debe estar en mayúscula.

Muestra
`String`	Es una cadena, posiblemente `null` o vacía, que contiene el valor de la propiedad determinada.

Arroja
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

Devuelve un valor que indica si las devoluciones de llamada de reinicio se están ejecutando actualmente. Todas las APIs públicas para el reinicio deben inhabilitarse si es verdadero.

Muestra
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Devuelve true si el archivo local es más reciente que el archivo remoto. IFileEntry debe ser preciso hasta el minuto. En caso de que los tiempos sean iguales, se considerará que el archivo es más nuevo.

Parámetros
`localFile`	`File`
`entry`	`IFileEntry`

Muestra
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

Notifica a todos los IDeviceActionReceiver sobre el evento de finalización del reinicio.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

notifyRebootStarted

protected void notifyRebootStarted ()

Notifica a todos los IDeviceActionReceiver sobre el evento de inicio de reinicio.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

performDeviceAction

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

Realiza una acción en este dispositivo. Intenta recuperar el dispositivo y, de manera opcional, vuelve a intentar el comando si falla la acción.

Parámetros
`actionDescription`	`String`: Es una descripción breve de la acción que se realizará. Solo se usa para fines de registro.
`action`	`NativeDevice.DeviceAction`: La acción que se realizará
`retryAttempts`	`int`: Son los intentos de reintento que se deben realizar para la acción si falla, pero la recuperación se realiza correctamente.

Muestra
`boolean`	`true` si la acción se realizó correctamente

Arroja
`DeviceNotAvailableException`	Si falla el intento de recuperación o se realizan los intentos máximos sin éxito

postAdbReboot

protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

Son las posibles acciones adicionales que se pueden realizar después de un reinicio.

Parámetros
`rebootMode`	`NativeDevice.RebootMode`

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

prePostBootSetup

protected void prePostBootSetup ()

Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) anule este método para una configuración específica posterior al inicio.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

Parámetros
`remoteFilePath`	`String`
`localFile`	`File`

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

Establece la instancia de Clock que se usará.

Parámetros
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Marca el TestDevice como microdroid y establece su CID.

Parámetros
`process`	`Process`: Es el proceso de la VM de Microdroid.

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

Parámetros
`deviceOptions`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                 envVarMap, 
                String[] fullCmd)

Ejecuta un comando fastboot simple con variables de entorno y registra el estado del comando.

Parámetros
`timeout`	`long`
`envVarMap`
`fullCmd`	`String`

Muestra
`CommandResult`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

Ejecuta un comando fastboot simple y registra el estado del comando.

Parámetros
`timeout`	`long`
`fullCmd`	`String`

Muestra
`CommandResult`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

Espera a que el dispositivo deje de estar disponible (deje de enviar informes a adb).

Parámetros
`operationDesc`	`String`: Es el nombre de la operación que está esperando a que esté disponible.
`time`	`long`: Es el tiempo que se debe esperar para que se produzca el estado no disponible.

Muestra
`boolean`	Es verdadero si el dispositivo dejó de estar disponible.

NativeDevice

Resumen

Clases anidadas

Constantes

Campos

Constructores públicos

Métodos públicos

Métodos protegidos

Constantes

DEBUG_PATH

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

SD_CARD

STORAGE_EMULATED

Campos

mOptions

mStateMonitor

Constructores públicos

NativeDevice

Métodos públicos

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

debugDeviceNotAvailable

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeAdbV2Command

executeAdbV2Command

executeAdbV2Command

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAdbPath

getAllSettings

getAllocationState

getAndroidId