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

Se usó la API de Cloud Translation para traducir esta página.

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	Es la clase para dispositivos virtuales locales que se ejecutan en el host de TradeFed.
ManagedRemoteDevice	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).

Implementación predeterminada de un dispositivo Android ITestDevice sin pila completa.

Resumen

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

Constantes
`int`	`INVALID_USER_ID` Valor que se muestra 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` la cantidad predeterminada de reintentos de comandos que se deben realizar

Campos
`public static final String`	`DEBUGFS_PATH`
`protected static final String`	`SD_CARD`
`protected static final String`	`STORAGE_EMULATED`
`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 milisegundos) mediante la precarga de todos los atributos que necesitamos en lugar de llamar a "adb getprop" para cada uno.
`boolean`	`canSwitchToHeadlessSystemUser()` Muestra si se permite cambiar al usuario del sistema sin interfaz gráfica.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Comprueba si una función es compatible actualmente según un nivel de compatibilidad mínimo.
`boolean`	`checkConnectivity()` Verifica 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 conectada.
`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.
`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 las marcas predeterminadas 0.
`int`	`createUserNoThrow(String name)` Crea un usuario con un nombre determinado y las marcas predeterminadas 0.
`DeviceInspectionResult`	`debugDeviceNotAvailable()` Inspeccionar un dispositivo y mostrar información detallada cuando este deje de estar disponible
`void`	`deleteFile(String deviceFilePath, int userId)` Es un método auxiliar para borrar un archivo o directorio del dispositivo.
`void`	`deleteFile(String deviceFilePath)` Es un método auxiliar para borrar un archivo o directorio del 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 suave comparando el system_server actual con el `ProcessInfo` de system_server anterior.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Método auxiliar para verificar si el dispositivo se reinició de forma suave 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 teclas.
`boolean`	`disableNetworkMonitor()` Inhabilita la supervisión de red en el dispositivo.
`boolean`	`disconnectFromWifi()` Se desconecta de una red Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` Método auxiliar 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 desde system_server.
`boolean`	`enableAdbRoot()` Activa el permiso de administrador de adb.
`boolean`	`enableNetworkMonitor()` Habilita la supervisión de red en el dispositivo.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` Es un método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` Es un método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado.
`String`	`executeAdbCommand(String... cmdArgs)` Método de ayuda que ejecuta un comando adb como un comando del sistema.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` Método auxiliar que ejecuta un comando fastboot como un comando del sistema con un tiempo de espera predeterminado de 2 minutos.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` Método de ayuda que ejecuta un comando fastboot como un comando del sistema.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` Es un método auxiliar que ejecuta un comando fastboot de larga duración como un comando del sistema.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` Es un 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)` Es un 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 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 adb shell, con más parámetros para controlar el comportamiento del comando.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Ejecuta el comando adb shell determinado y vuelve a intentarlo varias veces si falla.
`CommandResult`	`executeShellV2Command(String cmd)` Método auxiliar que ejecuta un comando de shell de adb y muestra los resultados como un `CommandResult` propagado correctamente con el resultado del estado del comando, stdout y stderr.
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` Método auxiliar que ejecuta un comando de shell de adb y muestra los resultados como un `CommandResult` propagado correctamente con el resultado del estado del comando y stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` Método auxiliar que ejecuta un comando de shell de adb y muestra los resultados como un `CommandResult` propagado correctamente con el resultado del estado del comando, stdout y stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Ejecuta un comando adb shell, con más parámetros para controlar el comportamiento del comando.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Ejecuta un comando 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 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 adb shell, con más parámetros para controlar el comportamiento del comando.
`CommandResult`	`fastbootWipePartition(String partition)` Es un método auxiliar que borra una partición del dispositivo.
	`getActiveApexes()` Recupera la información sobre los APEX activados en el dispositivo.
	`getAllSettings(String namespace)` Muestra los pares clave-valor del espacio de nombres solicitado.
`DeviceAllocationState`	`getAllocationState()` Muestra el estado de asignación actual del dispositivo
`String`	`getAndroidId(int userId)` Busca y muestra el android-id asociado a un userId, nulo si no se encuentra.
	`getAndroidIds()` Crea un mapa de los IDs de Android que coincidan con los IDs de usuario.
`int`	`getApiLevel()` Obtén 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()` Es un método conveniente para obtener la versión de banda base (radio) de este dispositivo.
`Integer`	`getBattery()` Muestra el nivel de batería actual de un dispositivo o nulo si el nivel de batería no está disponible.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` Muestra el valor booleano de la propiedad determinada.
	`getBootHistory()` El método auxiliar recopila el mapa del historial de inicio con el tiempo de inicio y el motivo del inicio.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` El método de ayuda recopila el mapa del historial de inicio con el tiempo de inicio y el motivo desde el momento determinado desde la época del dispositivo y la unidad de tiempo especificada.
`String`	`getBootloaderVersion()` Es un método conveniente 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 el tipo de compilación del dispositivo.
`String`	`getBuildId()` Recupera la compilación que se está ejecutando en el dispositivo.
`String`	`getBuildSigningKeys()` Muestra el tipo de clave que se usa para firmar la imagen del dispositivo. Por lo general, los dispositivos Android pueden firmarse con claves de prueba (como en AOSP) o claves de lanzamiento (controladas por los fabricantes de dispositivos individuales).
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Muestra un `DeviceDescriptor` almacenado en caché si el dispositivo está asignado; de lo contrario, muestra el `DeviceDescriptor` actual.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Muestra un `DeviceDescriptor` almacenado en caché si el dispositivo está asignado; de lo contrario, muestra el `DeviceDescriptor` actual.
`String[]`	`getChildren(String path)` Es una alternativa al uso de `IFileEntry` que, a veces, no funciona debido a los permisos.
`AbstractConnection`	`getConnection()` Es la conexión actual asociada con el dispositivo.
`ContentProviderHandler`	`getContentProvider(int userId)` Muestra `ContentProviderHandler` o un valor nulo si no está disponible.
`DeviceFoldableState`	`getCurrentFoldableState()` Devuelve el estado plegable actual del dispositivo o un valor nulo si se produjeron algunos problemas.
`int`	`getCurrentUser()` Muestra el ID del usuario que se está ejecutando actualmente.
`String`	`getDeviceClass()` Obtén la clase del dispositivo.
`long`	`getDeviceDate()` Muestra la fecha del dispositivo en milisegundos desde la época.
`DeviceDescriptor`	`getDeviceDescriptor()` Devuelve un `DeviceDescriptor` 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` de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo real.
`TestDeviceState`	`getDeviceState()` Obtén el estado del dispositivo.
`long`	`getDeviceTimeOffset(Date date)` Es un elemento auxiliar para obtener la diferencia horaria entre el dispositivo y un `ERROR(/Date)` determinado.
`InputStreamSource`	`getEmulatorOutput()` Obtén la transmisión de stdout y stderr del emulador
`Process`	`getEmulatorProcess()` Muestra el `Process` correspondiente a este emulador.
`final File`	`getExecuteShellCommandLog()` El registro que contiene todos los registros de `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` Es un método auxiliar para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo.
`String`	`getFastbootPath()` Muestra la ruta de acceso del objeto binario de fastboot que se usa.
`String`	`getFastbootProductType()` Es un método conveniente para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.
`String`	`getFastbootProductVariant()` Es un método conveniente para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.
`String`	`getFastbootSerialNumber()` Muestra el número de serie del modo fastboot.
`String`	`getFastbootVariable(String variableName)` Recupera el valor de la variable fastboot determinado del dispositivo.
`String`	`getFastbootVersion()` Muestra 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 asistente no oficial para obtener un `FileEntry` de una ruta que no es raíz.
	`getFoldableStates()` Muestra la lista de estados plegables en el dispositivo.
`IDevice`	`getIDevice()` Devuelve una referencia al `IDevice` de ddmlib asociado.
	`getInstalledPackageNames()` Recupera los nombres de los paquetes de la aplicación presentes en el dispositivo.
`long`	`getIntProperty(String name, long defaultValue)` Muestra el valor entero de la propiedad determinada del dispositivo.
`String`	`getIpAddress()` Obtiene la dirección IP del dispositivo.
`KeyguardControllerState`	`getKeyguardState()` Muestra un objeto para obtener el estado actual del protector de pantalla o nulo si no es compatible.
`long`	`getLastExpectedRebootTimeMillis()` Muestra la última vez que las APIs de Tradefed activaron un reinicio en milisegundos desde la época, como lo muestra `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` Obtén el primer nivel de API que se lanzó en el dispositivo.
`InputStreamSource`	`getLogcat()` Captura un flujo de instantáneas de los datos de Logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` Captura un flujo de instantáneas de los últimos `maxBytes` de datos de Logcat capturados.
`InputStreamSource`	`getLogcatDump()` Obtén un volcado del logcat actual del dispositivo.
`InputStreamSource`	`getLogcatSince(long date)` Captura una transmisión de instantáneas de datos de Logcat capturados a partir de la fecha proporcionada.
`String`	`getMacAddress()` Muestra la dirección MAC del dispositivo, un valor nulo si no se puede consultar desde el dispositivo.
`Integer`	`getMainUserId()` Muestra el ID de usuario principal.
	`getMainlineModuleInfo()` Obtén información sobre los módulos principales instalados en el dispositivo.
`int`	`getMaxNumberOfRunningUsersSupported()` Obtén la cantidad máxima de usuarios que se ejecutan de forma simultánea.
`int`	`getMaxNumberOfUsersSupported()` Obtén la cantidad máxima de usuarios admitidos.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Muestra el `IDeviceStateMonitor` asociado con el dispositivo.
`String`	`getMountPoint(String mountName)` Muestra un punto de activación.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` Muestra un `MountPointInfo` que corresponde a la ruta de acceso del punto de activación especificado o `null` si esa ruta de acceso no tiene nada activado o, de lo contrario, no aparece en /proc/mounts como punto de activación.
	`getMountPointInfo()` Muestra una versión analizada de la información en /proc/mounts en el dispositivo.
`TestDeviceOptions`	`getOptions()` Recupera las opciones de prueba del dispositivo.
`long`	`getPartitionFreeSpace(String partition)` Es un método auxiliar para determinar la cantidad de espacio libre en la partición del dispositivo.
`Integer`	`getPrimaryUserId()` Muestra el ID de usuario principal.
`ProcessInfo`	`getProcessByName(String processName)` El método de ayuda ejecuta los comandos "pidof" y "stat" y muestra el objeto `ProcessInfo` con el PID y la hora de inicio del proceso determinado.
`String`	`getProcessPid(String process)` Muestra el pid del servicio o un valor nulo si se produjo un error.
`String`	`getProductType()` Es un método conveniente para obtener el tipo de producto de este dispositivo.
`String`	`getProductVariant()` Es un método conveniente para obtener la variante del producto de este dispositivo.
`String`	`getProperty(String name)` Recupera el valor de la propiedad determinada del dispositivo.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Obtén 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 visualización 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()` Es un método conveniente para obtener el número de serie de este dispositivo.
`String`	`getSetting(int userId, String namespace, String key)` Muestra el valor del parámetro de configuración solicitado.
`String`	`getSetting(String namespace, String key)` Consulta `getSetting(int, String, String)` y realiza la acción en el usuario del sistema.
`String`	`getSimOperator()` Muestra el operador de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible.
`String`	`getSimState()` Muestra el estado de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible.
	`getTombstones()` Recupera y muestra la lista de lápidas de los dispositivos.
`long`	`getTotalMemory()` Muestra el tamaño total de la memoria física en bytes o -1 en caso de error interno.
`String`	`getTrackingSerial()` Para la administración de dispositivos, obtén el número de serie que se usa para hacer un seguimiento del dispositivo.
	`getUninstallablePackageNames()` Recupera los nombres de los paquetes de la aplicación que se pueden desinstalar.
`boolean`	`getUseFastbootErase()` Obtén información para usar el comando fastboot erase o fastboot format para limpiar una partición del dispositivo.
`int`	`getUserFlags(int userId)` Busca y muestra 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, -10000 en cualquier otro caso.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Procesa el DeviceEvent determinado. Procesa el DeviceEvent, que puede o no migrar este dispositivo a un nuevo estado de asignación.
`boolean`	`hasFeature(String feature)` Verifica si una función está disponible en un 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 de un usuario determinado.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Instala un paquete de Android en el dispositivo de un usuario determinado.
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` Verifica si la plataforma del dispositivo admite la enumeración de apps
`boolean`	`isBypassLowTargetSdkBlockSupported()` Verifica si la plataforma del dispositivo admite omitir el bloqueo de SDK de destino bajo en las instalaciones de apps
`boolean`	`isDebugfsMounted()` Verifica si debugfs está activado.
`boolean`	`isDeviceEncrypted()` Muestra si el dispositivo está encriptado.
`boolean`	`isDirectory(String path)` Muestra True si la ruta de acceso en el dispositivo es un directorio y False en caso contrario.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Muestra si la encriptación es compatible con el dispositivo.
`boolean`	`isExecutable(String fullPath)` Muestra verdadero si la ruta de acceso del archivo en el dispositivo es un archivo ejecutable; de lo contrario, muestra falso.
`boolean`	`isFastbootEnabled()` Muestra si fastboot está disponible para el dispositivo.
`boolean`	`isHeadless()` Muestra verdadero si el dispositivo no tiene pantalla (sin pantalla) y falso en caso contrario.
`boolean`	`isHeadlessSystemUserMode()` Muestra si el dispositivo usa el modo de usuario del sistema sin interfaz gráfica.
`boolean`	`isMainUserPermanentAdmin()` Muestra si el usuario principal es un administrador permanente y no se puede borrar ni cambiar a un estado que no sea de administrador.
`boolean`	`isMultiUserSupported()` Determina si se admite el modo multiusuario.
`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 o no para ese usuario.
`boolean`	`isPackageInstalled(String packageName)` Consulta el dispositivo para obtener un nombre de paquete determinado y verificar si está instalado o no.
`boolean`	`isRuntimePermissionSupported()` Comprueba si la plataforma del dispositivo admite el otorgamiento de permisos de tiempo de ejecución
`boolean`	`isStateBootloaderOrFastbootd()` Muestra verdadero si el dispositivo está en `TestDeviceState.FASTBOOT` o `TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` Verifica si un usuario determinado está en ejecución.
`boolean`	`isUserSecondary(int userId)` Muestra 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()` Muestra si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano en `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`boolean`	`isVisibleBackgroundUsersSupported()` Muestra si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano.
`boolean`	`isWifiEnabled()` Prueba si la red Wi-Fi está habilitada.
	`listDisplayIds()` Recopila la lista de IDs de pantallas disponibles en el dispositivo, como lo informa "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 errores de ANR del dispositivo.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` Método auxiliar para tomar un informe de errores y registrarlo en los generadores de informes.
`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()` Emite un comando para reiniciar el dispositivo y muestra el resultado cuando se completa el comando y cuando el dispositivo ya no es visible para adb.
`void`	`postAdbRootAction()` Anula esta opción 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 esta opción si el dispositivo necesita que se realicen algunas acciones específicas después de que adb quite el estado de raíz y antes de que el dispositivo vuelva a estar en línea.
`void`	`postBootSetup()` Sigue las instrucciones para configurar el dispositivo y realizar pruebas después de cada inicio.
`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)` Pasos adicionales para la configuración requerida específica del dispositivo que se ejecutará 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 `ERROR(/File)` temporal local y muestra ese `File`.
`File`	`pullFile(String remoteFilePath)` Recupera un archivo del dispositivo, lo almacena en un `ERROR(/File)` temporal local y muestra ese `File`.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` Recupera un archivo del dispositivo.
`String`	`pullFileContents(String remoteFilePath)` Recupera un archivo del dispositivo y muestra su contenido.
`File`	`pullFileFromExternal(String remoteFilePath)` Es un método conveniente para recuperar un archivo del almacenamiento externo del dispositivo, almacenarlo en un `ERROR(/File)` temporal local y mostrar 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)` Es una variante de `pushFile(File, String)` que, de manera opcional, puede considerar evaluar 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)` Cómo enviar un archivo creado a partir de una cadena al dispositivo
`void`	`reboot(String reason)` Reinicia el dispositivo en modo ADB con un `reason` determinado para que se conserve después del reinicio.
`void`	`reboot()` Reinicia el dispositivo en modo ADB.
`void`	`rebootIntoBootloader()` Reinicia el dispositivo en el modo bootloader.
`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 sideload de adb (ten en cuenta que este es un modo especial en la recuperación). Se bloquea hasta que el dispositivo entra en modo de carga lateral.
`void`	`rebootIntoSideload(boolean autoReboot)` Reinicia el dispositivo en el modo sideload de adb (ten en cuenta que este es un modo especial en la recuperación). Se bloquea hasta que el dispositivo entra en modo de carga lateral.
`void`	`rebootUntilOnline()` Es un método alternativo a `reboot()` que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.
`void`	`rebootUntilOnline(String reason)` Es un método alternativo a `reboot()` que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.
`void`	`rebootUserspace()` Reinicia solo la parte del espacio de usuario del dispositivo.
`void`	`rebootUserspaceUntilOnline()` Es un método alternativo a `rebootUserspace()` ()} que solo 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 se pueda escribir en la partición del proveedor del dispositivo.
`boolean`	`removeAdmin(String componentName, int userId)` Quita el administrador del dispositivo determinado en el usuario determinado y muestra `true` si se realiza correctamente, `false` de lo contrario.
`void`	`removeOwners()` Quita todos los propietarios de perfiles de dispositivos existentes con el mejor esfuerzo.
`boolean`	`removeUser(int userId)` Quita a un usuario determinado del dispositivo.
`void`	`resetContentProviderSetup()` Restablece la marca de configuración del proveedor de contenido para volver a activarla.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Es un método conveniente 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 de dispositivos.
`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`	`setConfiguration(IConfiguration configuration)` Inyecta el `IConfiguration` en uso.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` Establece la fecha en el dispositivo. Nota: Para configurar la fecha en el dispositivo, se requiere acceso de raíz.
`boolean`	`setDeviceOwner(String componentName, int userId)` Establece un componente de administrador de dispositivos como propietario del dispositivo en un usuario determinado.
`void`	`setDeviceState(TestDeviceState deviceState)` Actualiza el estado del dispositivo.
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` Para el emulador, establece `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)` Establece el `TestDeviceOptions` para el dispositivo
`boolean`	`setProperty(String propKey, String propValue)` Establece el valor de la propiedad determinada 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 realiza la acción 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 la administración de dispositivos, haz un seguimiento del número de serie que usamos como referencia del dispositivo.
`void`	`setUseFastbootErase(boolean useFastbootErase)` Establece si quieres usar fastboot erase o fastboot format para borrar una partición del dispositivo.
`void`	`startLogcat()` Comienza a capturar el resultado de Logcat desde el dispositivo en segundo plano.
`boolean`	`startTradeInModeTesting(int timeoutMs)` Habilita el modo de intercambio de prueba.
`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()` Detén la captura del resultado de Logcat desde el dispositivo y descarta los datos de Logcat guardados actualmente.
`void`	`stopTradeInModeTesting()` Detén las pruebas del modo de intercambio.
`boolean`	`stopUser(int userId)` Detiene a un usuario determinado.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Detener a un usuario determinado
`String`	`switchToAdbTcp()` Cambia el dispositivo al modo adb-over-tcp.
`boolean`	`switchToAdbUsb()` Cambia el dispositivo al modo adb mediante 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 devuélvelo 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 de un usuario determinado.
`boolean`	`unlockDevice()` Desbloquea el dispositivo si está en un estado encriptado.
`void`	`unmountDebugfs()` Desactiva debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Bloquea hasta que se establezca la marca de inicio completo del dispositivo.
`boolean`	`waitForDeviceAvailable()` Espera a que el dispositivo sea responsivo y esté disponible para las pruebas.
`boolean`	`waitForDeviceAvailable(long waitTime)` Espera a que el dispositivo sea responsivo y esté disponible para las pruebas.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Espera a que el dispositivo sea responsivo y esté disponible sin considerar la ruta de recuperación.
`void`	`waitForDeviceBootloader()` Bloquea el dispositivo hasta que sea visible a través de fastboot.
`boolean`	`waitForDeviceInRecovery(long waitTime)` Bloquea el dispositivo para que esté en el estado "adb recovery" (ten en cuenta que esto es distinto de `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Bloquea el dispositivo para que esté en el estado "sideload de adb".
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Bloquea el dispositivo para que no esté disponible, es decir, que no esté en ADB.
`void`	`waitForDeviceOnline()` Bloquea hasta que el dispositivo sea visible a través de adb.
`void`	`waitForDeviceOnline(long waitTime)` Bloquea hasta que el dispositivo sea visible a través de adb.
`boolean`	`waitForDeviceShell(long waitTime)` Espera a que el dispositivo responda a un comando básico del shell de adb.

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 del shell de adb dados.
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` Crea un `RebootDeviceAction` para usarlo cuando realices una acción de reinicio.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Realiza un reinicio de adb.
`void`	`ensureRuntimePermissionSupported()` método de ayuda para generar 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á.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)`
`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()` Muestra si se están ejecutando las devoluciones de llamada de reinicio en este momento.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Muestra `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 del reinicio.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Realiza una acción en este dispositivo.
`void`	`postAdbReboot()` Son 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 después del inicio.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Establece la instancia de reloj que se usará.
`void`	`setMicrodroidProcess(Process process)` Marca 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, luego, informa el estado del comando.
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` Ejecuta un comando fastboot simple y, luego, informa el estado del comando.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` Espera a que el dispositivo deje de estar disponible (deje de informar a adb).

Constantes

INVALID_USER_ID

public static final int INVALID_USER_ID

Valor que se muestra 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

la cantidad predeterminada de reintentos de comandos que se deben realizar

Valor constante: 2 (0x00000002)

Campos

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

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 `IDeviceStateMonitor` que se usará.
`allocationMonitor`	`IDeviceMonitor`: El `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 milisegundos) mediante la precarga de todos los elementos que necesitamos en lugar de llamar a "adb getprop" para cada uno. Es decir, recuperar todas las propiedades es tan rápido como recuperar una. Elementos como device.getApiLevel(), checkApiLevelAgainstNextRelease y getBuildAlias llaman a "adb getprop" en segundo plano. Los recuperamos en una llamada y llamamos a NativeDevice.setProperty. Incluso si no hacemos esto, NativeDevice llamará a setProperty y almacenará en caché el resultado para llamadas futuras. Solo lo hacemos un poco antes. Si el dispositivo está en modo de recuperación o hay otros errores para recuperar los elementos, los ignoramos.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Muestra si se permite cambiar al usuario del sistema sin interfaz gráfica.

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

Arroja
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

Verifica que el dispositivo tenga conectividad de red.

Muestra
`boolean`	`true` si el dispositivo tiene una conexión de red que funciona, `false` de lo 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 hay diálogos o si se borraron correctamente. `false` en caso contrario.

Arroja
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Borra la última red Wi-Fi conectada. Se debe llamar a esta función 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 reinicie el dispositivo.

clearLogcat

public void clearLogcat ()

Borra los datos de Logcat acumulados.

Esto es útil en los casos en 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 en la memoria flash una nueva compilación del dispositivo, etcétera).

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se conecta a una red Wi-Fi.

Activa la red Wi-Fi y la bloquea hasta que se establezca una conexión correcta con una de las redes Wi-Fi que se proporcionan 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 SSID de Wi-Fi a contraseñas.
`scanSsid`	`boolean`: Indica si se deben buscar SSID ocultos para esta red.

Muestra
`boolean`	`true` si se conecta correctamente a la red Wi-Fi. `false` otherwise

Arroja
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se conecta a una red Wi-Fi.

Activa el Wi-Fi y lo bloquea hasta que se establece una conexión correcta con 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`: El SSID de Wi-Fi al que te conectarás
`wifiPsk`	`String`: La frase de contraseña del PSK o un valor nulo si no está encriptada

Muestra
`boolean`	`true` si se conecta correctamente a la red Wi-Fi. `false` otherwise

Arroja
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Se conecta a una red Wi-Fi.

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

Muestra
`boolean`	`true` si se conecta correctamente a la red Wi-Fi. `false` otherwise

Arroja
`DeviceNotAvailableException`

connectToWifiNetwork

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

Se conecta a una red Wi-Fi.

Parámetros
`wifiSsid`	`String`: El SSID de Wi-Fi al que te conectarás
`wifiPsk`	`String`: La frase de contraseña del PSK o un valor nulo si no está encriptada
`scanSsid`	`boolean`: Indica si se debe buscar un SSID oculto para esta red.

Muestra
`boolean`	`true` si se conecta correctamente a la red Wi-Fi. `false` otherwise

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 un SSID oculto para esta red.

Muestra
`boolean`	`true` si se conecta correctamente a la red Wi-Fi. `false` otherwise

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 conecta correctamente a la red Wi-Fi. `false` otherwise

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`: Es el 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`: Es el 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 las marcas predeterminadas 0.

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

Muestra
`int`	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 las marcas predeterminadas 0.

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

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

Arroja
`DeviceNotAvailableException`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

Inspeccionar un dispositivo y mostrar información detallada cuando este deje de estar disponible

Muestra
`DeviceInspectionResult`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

Es un método auxiliar para borrar un archivo o directorio del dispositivo.

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

Arroja
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath)

Es un método auxiliar para borrar un archivo o directorio del 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 suave comparando el system_server actual con el ProcessInfo de system_server anterior. Usa getProcessByName(String) para obtener ProcessInfo.

Parámetros
`prevSystemServerProcess`	`ProcessInfo`: El proceso system_server anterior `ProcessInfo`.

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

Arroja
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

Arroja
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

Desactiva el acceso raíz de adb.

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

Muestra
`boolean`	`true` si se realiza correctamente.

Arroja
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

Intenta inhabilitar el bloqueo de teclas.

Primero, espera a que el envío de entrada esté listo. Esto ocurre aproximadamente al mismo tiempo 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 teclas (solo funciona en los no seguros).

Arroja
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Inhabilita la supervisión de red en el dispositivo.

Muestra
`boolean`	`true` si la supervisión se inhabilitó 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 red 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 auxiliar 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 debe verificar.
`userId`	`int`: Es el ID de usuario con el que se debe verificar la existencia del archivo.

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

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 debe verificar.

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

Arroja
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Intenta volcar el montón desde 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 heap.
`devicePath`	`String`: Es la ruta de acceso en el dispositivo donde se debe 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 permiso de administrador de adb. Si el parámetro de configuración "enable-root" es "false", se registrará un mensaje y se mostrará sin habilitar el permiso de administrador.

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

Muestra
`boolean`	`true` si se realiza correctamente.

Arroja
`DeviceNotAvailableException`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Habilita la supervisión de red en el dispositivo.

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

Arroja
`DeviceNotAvailableException`

executeAdbCommand

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

Es un método auxiliar que ejecuta un comando 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 un mejor rendimiento y detección de fallas.

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

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

Arroja
`DeviceNotAvailableException`

executeAdbCommand

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

Es un método auxiliar que ejecuta un comando 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 un mejor rendimiento y detección de fallas.

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

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

Arroja
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

Parámetros
`cmdArgs`	`String`: El comando adb y los argumentos para ejecutar

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

Arroja
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

Método auxiliar que ejecuta un comando 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 fastboot y los argumentos para ejecutar

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

Arroja
`DeviceNotAvailableException`

executeFastbootCommand

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

Método de ayuda que ejecuta un comando 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 venza el comando.
`cmdArgs`	`String`: El comando fastboot y los argumentos para ejecutar

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

Arroja
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

Parámetros
`cmdArgs`	`String`: El comando fastboot y los argumentos para ejecutar

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

Arroja
`DeviceNotAvailableException`

executeLongFastbootCommand

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

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

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

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

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

Arroja
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

Es un 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 del shell de adb que se ejecutará.

Muestra
`String`	el resultado del shell

Arroja
`DeviceNotAvailableException`

executeShellCommand

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

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

Parámetros
`command`	`String`: Es el comando del shell de adb 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 el comando puede no mostrar ninguna respuesta. La unidad se especifica en `timeUnit`.
`timeUnit`	`TimeUnit`: Unidad de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si se realiza `retryAttempts` sin éxito.

Arroja
`DeviceNotAvailableException`

executeShellCommand

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

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

Parámetros
`command`	`String`: Es el comando del shell de adb 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 el comando puede no mostrar ninguna respuesta. La unidad se especifica en `timeUnit`.
`timeUnit`	`TimeUnit`: Unidad de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si se realiza `retryAttempts` sin éxito.

Arroja
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Ejecuta el comando adb shell determinado 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 del shell de adb 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 auxiliar que ejecuta un comando de shell de adb y muestra los resultados como un CommandResult propagado correctamente con el resultado del estado del comando, stdout y stderr.

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

Muestra
`CommandResult`	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 muestra los resultados como un CommandResult propagado 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)`, donde se redireccionará el resultado estándar, o bien nulo.

Muestra
`CommandResult`	El resultado en `CommandResult`.

Arroja
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Método auxiliar que ejecuta un comando de shell de adb y muestra los resultados como un CommandResult propagado 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 pasará como entrada al comando o será nulo.

Muestra
`CommandResult`	El resultado en `CommandResult`.

Arroja
`DeviceNotAvailableException`

executeShellV2Command

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

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

Parámetros
`cmd`	`String`: Es el comando del shell de adb 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 de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si se realiza `retryAttempts` sin éxito.

Muestra
`CommandResult`

Arroja
`DeviceNotAvailableException`

executeShellV2Command

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

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

Parámetros
`cmd`	`String`: Es el comando del shell de adb 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 de `maxTimeToOutputShellResponse`

Muestra
`CommandResult`

Arroja
`DeviceNotAvailableException`

executeShellV2Command

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

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

Parámetros
`cmd`	`String`: Es el comando del shell de adb que se ejecutará.
`pipeAsInput`	`File`: Es un `ERROR(/File)` que se pasará como entrada al comando o será nulo.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)`, donde se redireccionará el resultado estándar, o bien 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 de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si se realiza `retryAttempts` 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 adb shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
`cmd`	`String`: Es el comando del shell de adb que se ejecutará.
`pipeAsInput`	`File`: Es un `ERROR(/File)` que se pasará como entrada al comando o será nulo.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)`, donde se redireccionará el resultado estándar, o bien 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 de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si se realiza `retryAttempts` sin éxito.

Muestra
`CommandResult`

Arroja
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

Es un método auxiliar que borra una partición del dispositivo.

Si getUseFastbootErase() es true, se usará el borrado de fastboot para limpiar 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`

getAllSettings

public  getAllSettings (String namespace)

Muestra los pares clave-valor del espacio de nombres solicitado.

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

Muestra
	el mapa de pares clave-valor. Es nulo si el espacio de nombres no es compatible.

Arroja
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Muestra el estado de asignación actual del dispositivo

Muestra
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

Busca y muestra el android-id asociado a un userId, nulo si no se encuentra.

Parámetros
`userId`	`int`

Muestra
`String`

Arroja
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Crea un mapa de los IDs de Android que coincidan 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 IDs de Android que coinciden con los IDs de usuario

Arroja
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

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

Muestra
`int`	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`	el `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` instalados en el dispositivo.

Arroja
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

Es un método conveniente 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 se muestre la información correcta para todos los dispositivos. Este método se basa en la propiedad gsm.version.baseband para mostrar la información de versión correcta. Esto no es preciso para algunos dispositivos CDMA, y es posible que la versión que se muestra aquí no coincida con la versión informada por fastboot ni con la versión de la radio CDMA. En resumen, este método solo informa la versión precisa si la propiedad gsm.version.baseband es la misma que la versión que muestra 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 ()

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

Muestra
`Integer`

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Muestra 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 muestra 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 el tiempo de inicio y el motivo del inicio.

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

Arroja
`DeviceNotAvailableException`

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

El método de ayuda recopila el mapa del historial de inicio con el tiempo de inicio y el motivo desde el momento determinado desde la época del dispositivo y la unidad de tiempo especificada. El utcEpochTime actual del dispositivo 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`: La unidad de tiempo `TimeUnit`.

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

Arroja
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

Es un método conveniente para obtener la versión del bootloader de este dispositivo.

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 una tarjeta SD (o donde la tarjeta SD aún no está activada).

Muestra
`InputStreamSource`	Un `InputStreamSource` que producirá el contenido del informe de errores a pedido. En caso de fallar, `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 es compatible con "versión de adb" > 1.0.36.

Muestra
`InputStreamSource`	un `InputStreamSource` del archivo ZIP que contiene el bugreportz, muestra un valor nulo en caso de falla.

getBuildAlias

public String getBuildAlias ()

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

Por lo general, el alias de compilación es 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`	el alias de compilación o el ID de compilación si no se pudo recuperar

Arroja
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Recupera el tipo de compilación del dispositivo.

Muestra
`String`	el tipo 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 ()

Muestra el tipo de clave que se usa para firmar la imagen del dispositivo.

Por lo general, los dispositivos Android pueden firmarse 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, o un valor nulo de lo contrario.

Arroja
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Muestra un DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, muestra el DeviceDescriptor actual.

Muestra
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Muestra un DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, muestra el DeviceDescriptor actual.

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

Muestra
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

Es una 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 donde se debe realizar la búsqueda.

Muestra
`String[]`	Es un array de cadenas que contiene todo el archivo en una ruta de acceso del dispositivo.

Arroja
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

Es la conexión actual asociada con el dispositivo.

Muestra
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Muestra ContentProviderHandler o un valor nulo si no está disponible.

El proveedor de contenido se puede volver a usar si se construyó antes con el mismo userId.

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

Muestra
`ContentProviderHandler`

Arroja
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Devuelve el estado plegable actual del dispositivo o un valor nulo si se produjeron algunos problemas.

Muestra
`DeviceFoldableState`

Arroja
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

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

Muestra
`int`

Arroja
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

Obtén la clase del dispositivo.

Muestra
`String`	la clase de dispositivo `String`.

getDeviceDate

public long getDeviceDate ()

Muestra la fecha del dispositivo en milisegundos desde la época.

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

Arroja
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Devuelve un DeviceDescriptor 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 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.

Muestra
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

Obtén el estado del dispositivo.

Muestra
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Es un elemento auxiliar para obtener la diferencia horaria entre el dispositivo y un ERROR(/Date) determinado. Usa la hora de época de forma interna.

Parámetros
`date`	`Date`

Muestra
`long`	la diferencia en milisegundos

Arroja
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Obtén la transmisión de stdout y stderr del emulador

Muestra
`InputStreamSource`	resultado del emulador

getEmulatorProcess

public Process getEmulatorProcess ()

Muestra el Process correspondiente a este emulador.

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

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

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

Muestra
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Es un método auxiliar 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 ()

Muestra la ruta de acceso del objeto binario de fastboot que se usa. Aún requiere que isFastbootEnabled() sea verdadero para que se habiliten las funciones de Fastboot.

Muestra
`String`

getFastbootProductType

public String getFastbootProductType ()

Es un método conveniente 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 está 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 ()

Es un método conveniente 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 ()

Muestra el número de serie del modo fastboot.

Muestra
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

Recupera el valor de la variable fastboot determinado del dispositivo.

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

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

Arroja
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

Muestra la cadena de versión del objeto binario de fastboot que se usa. O bien 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`	el `IFileEntry` o `null` si no se puede encontrar el archivo en `path` determinado

Arroja
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

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

Muestra
`IFileEntry`	Un FileEntryWrapper que representa el FileEntry.

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

getFoldableStates

public  getFoldableStates ()

Muestra la lista de estados plegables en el dispositivo. Se puede obtener con "cmd device_state print-states".

Muestra

Arroja
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

Devuelve una referencia al IDevice de ddmlib asociado.

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

Muestra
`IDevice`	el `IDevice`

getInstalledPackageNames

public  getInstalledPackageNames ()

Recupera los nombres de los paquetes de la aplicación presentes en el dispositivo.

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

Arroja
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Muestra 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 muestra 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 de número 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 una dirección IP

Arroja
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Muestra un objeto para obtener el estado actual del protector de pantalla o nulo si no es compatible.

Muestra
`KeyguardControllerState`	Un `KeyguardControllerState` que contiene una instantánea del estado del bloqueo de teclas y muestra un valor nulo si no se admite la consulta del bloqueo de teclas.

Arroja
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

Muestra la última vez que las APIs de Tradefed activaron un reinicio en milisegundos desde la época, como lo muestra System.currentTimeMillis().

Muestra
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

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

Muestra
`int`	Un número entero que indica el primer nivel de API lanzado del dispositivo

Arroja
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

Captura un flujo de instantáneas de los datos de Logcat.

Funciona en dos modos:

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

De lo contrario, mostrará un volcado estático de los datos de Logcat si el dispositivo responde actualmente.

Muestra
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

Captura un flujo de instantáneas de los últimos maxBytes de datos de Logcat capturados.

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

Parámetros
`maxBytes`	`int`: Es la cantidad máxima de datos que se mostrarán. Debe ser una cantidad que se ajuste 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 mostrará un volcado estático del logcat.

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

Muestra
`InputStreamSource`	un `InputStreamSource` de los datos de Logcat. Se muestra una transmisión vacía si no se pueden capturar datos de Logcat.

getLogcatSince

public InputStreamSource getLogcatSince (long date)

Captura una transmisión de instantáneas de datos de Logcat capturados a partir de la fecha proporcionada. Se debe usar la hora del dispositivo getDeviceDate().

Parámetros
`date`	`long`: En milisegundos desde el formato de época de cuándo iniciar la instantánea hasta el presente. (se puede obtener con "date +%s")

Muestra
`InputStreamSource`

getMacAddress

public String getMacAddress ()

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

Muestra
`String`

getMainUserId

public Integer getMainUserId ()

Muestra el ID de usuario principal.

Muestra
`Integer`	el userId del usuario principal si hay uno y nulo si no hay un usuario principal.

Arroja
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Obtén información sobre los módulos principales instalados en el dispositivo.

Muestra
	`ERROR(/Set)` de los módulos principales `String` instalados actualmente en el dispositivo.

Arroja
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Obtén la cantidad máxima de usuarios que se ejecutan de forma simultánea. La configuración predeterminada es 0.

Muestra
`int`	Un número entero que indica la cantidad de usuarios que se ejecutan de forma simultánea.

Arroja
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Obtén 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`	Muestra el proceso de la VM de Microdroid. Si TestDevice no es un Microdroid, muestra un valor nulo.

getMonitor

public IDeviceStateMonitor getMonitor ()

Muestra el IDeviceStateMonitor asociado con el dispositivo.

Muestra
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

Muestra un punto de activación.

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

TODO: mover este comportamiento a IDevice.getMountPoint(String)

Parámetros
`mountName`	`String`: Es el nombre del punto de activación.

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

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Muestra un MountPointInfo que corresponde a la ruta de acceso del punto de activación especificado o null si esa ruta de acceso no tiene nada activado o, de lo contrario, no aparece en /proc/mounts como punto de activación.

Parámetros
`mountpoint`	`String`

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

Arroja
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

Muestra 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 de "/proc/mounts"

Arroja
`DeviceNotAvailableException`

getOptions

public TestDeviceOptions getOptions ()

Recupera las opciones de prueba del dispositivo.

Muestra
`TestDeviceOptions`	`TestDeviceOptions` relacionado con el dispositivo en prueba.

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

Es un 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 ()

Muestra el ID de usuario principal.

Muestra
`Integer`	el userId del usuario principal si hay uno y nulo si no hay un usuario principal.

Arroja
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

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

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

Muestra
`ProcessInfo`	ProcessInfo del proceso processName determinado

Arroja
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

Muestra el pid del servicio o un valor nulo si se produjo un error.

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

Muestra
`String`

Arroja
`DeviceNotAvailableException`

getProductType

public String getProductType ()

Es un método conveniente para obtener el tipo de producto de este dispositivo.

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

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

Arroja
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

Es un método conveniente 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 determinada 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 ()

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

Muestra
`ITestDevice.RecoveryMode`	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 visualización determinado. El formato es PNG.

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

Parámetros
`displayId`	`long`: Es el ID de visualización de la pantalla desde la que se obtiene la captura de pantalla.

Muestra
`InputStreamSource`	un `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 obtener un tamaño más pequeño.

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

Muestra
`InputStreamSource`	un `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) en su lugar con codificación JPEG para obtener 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`	un `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 de pantalla no se realizó correctamente

Arroja
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

Es un método conveniente 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)

Muestra el valor del parámetro de configuración solicitado. namespace debe ser una de las siguientes opciones: {"system", "secure", "global"}

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

Muestra
`String`	el valor asociado con el espacio de nombres:clave 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 realiza la acción en el usuario del sistema.

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

Muestra
`String`

Arroja
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

Muestra 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 ()

Muestra 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 muestra la lista de lápidas de los dispositivos. Requiere permisos de administrador.

es el mejor esfuerzo, por lo que, si no se extrae una lápida por algún motivo, no aparecerá en la lista. Solo un DeviceNotAvailableException finalizará el método antes.

Muestra
	Es una lista de archivos de tumba, vacía si no hay ninguno.

Arroja
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

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

Muestra
`long`

getTrackingSerial

public String getTrackingSerial ()

Para la administración de dispositivos, obtén el número de serie que se usa para hacer un seguimiento del dispositivo.

Muestra
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Recupera los nombres de los paquetes de la aplicación que se pueden desinstalar. Actualmente, se define como paquetes que no son del sistema y paquetes del sistema actualizados.

Muestra
	`ERROR(/Set)` de nombres de paquetes `String` que se pueden desinstalar instalados actualmente en el dispositivo.

Arroja
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

Obtén información para usar el comando fastboot erase o fastboot format para limpiar una partición del dispositivo.

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

getUserFlags

public int getUserFlags (int userId)

Busca y muestra 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`	las marcas asociadas con el userId proporcionado si se encuentra, -10000 en cualquier otro caso

Arroja
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

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

Muestra
	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, -10000 en cualquier otro caso.

Parámetros
`userId`	`int`

Muestra
`int`

Arroja
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

Parámetros
`event`	`DeviceEvent`

Muestra
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

Verifica 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; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

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 para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

Muestra
`String`	Un `String` con un código de error o `null` si se realiza 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 los casos de uso que requieran un control explícito de la concesión de permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta funció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 en el momento de la instalación.
`extraArgs`	`String`: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

Muestra
`String`	Un `String` con un código de error o `null` si se realiza correctamente.

Arroja
`DeviceNotAvailableException`

installPackageForUser

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

Instala un paquete de Android en el dispositivo de 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 instalará.
`extraArgs`	`String`: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

Muestra
`String`	Un `String` con un código de error o `null` si se realiza 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 de un usuario determinado.

Nota: Solo los casos de uso que requieran un control explícito de la concesión de permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta funció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 en el momento de la instalación.
`userId`	`int`: Es el ID de usuario entero para el que se instalará.
`extraArgs`	`String`: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

Muestra
`String`	Un `String` con un código de error o `null` si se realiza correctamente.

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 ()

Verifica si la plataforma del dispositivo admite omitir el bloqueo de SDK de destino bajo en las instalaciones de apps

Muestra
`boolean`	Es verdadero si se admite omitir el bloqueo de SDK de destino bajo; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Verifica si debugfs está activado.

Muestra
`boolean`	`true` si se activa debugfs

Arroja
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

Muestra si el dispositivo está encriptado.

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

Arroja
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

Muestra 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 el permiso de administrador de adb en el dispositivo

isEncryptionSupported

public boolean isEncryptionSupported ()

Muestra si la encriptación es compatible con el dispositivo.

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

Arroja
`DeviceNotAvailableException`

isExecutable

public boolean isExecutable (String fullPath)

Muestra verdadero si la ruta de acceso del archivo en el dispositivo es un archivo ejecutable; de lo contrario, muestra falso.

Parámetros
`fullPath`	`String`

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

Muestra si fastboot está disponible para el dispositivo.

Muestra
`boolean`

isHeadless

public boolean isHeadless ()

Muestra verdadero si el dispositivo no tiene pantalla (sin pantalla) y falso en caso contrario.

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Determina si se admite el modo multiusuario.

Muestra
`boolean`	Es verdadero si se admite el uso 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 o no 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 estamos verificando que se haya instalado el paquete. Si es nulo, se usará el usuario principal cero.

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

Arroja
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Consulta el dispositivo para obtener un nombre de paquete determinado y verificar si está instalado o no.

Parámetros
`packageName`	`String`

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

Arroja
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

Comprueba si la plataforma del dispositivo admite el otorgamiento de permisos de 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 ()

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

Muestra
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

Verifica si un usuario determinado está en ejecución.

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)

Muestra 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 ()

Muestra si el dispositivo permite que los usuarios se inicien de forma visible 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 muestra listDisplayIdsForStartingVisibleBackgroundUsers() (que debe incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Muestra si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano.

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

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Prueba si la red Wi-Fi está habilitada.

Verifica si la red Wi-Fi está habilitada en el dispositivo. Es útil para confirmar el estado de Wi-Fi antes de las pruebas que no deben ejecutarse con Wi-Fi, p.ej., 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, como lo informa "dumpsys SurfaceFlinger".

Muestra
	Es la lista de pantallas. El valor predeterminado siempre muestra 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. Lanzará DeviceRuntimeException si el resultado del dispositivo no es el esperado.

Muestra
	la lista de IDs de usuario.

Arroja
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

Recopila y registra errores de ANR del dispositivo.

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

Muestra
`boolean`	Es verdadero si el registro se realizó correctamente; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Método auxiliar para tomar un informe de errores y registrarlo en los generadores de informes.

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

Muestra
`boolean`	Es verdadero si el registro se realizó correctamente; de lo contrario, es falso.

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 se arrojará, incluso si falla el registro.

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

mountDebugfs

public void mountDebugfs ()

Activa debugfs.

Arroja
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

Emite un comando para reiniciar el dispositivo y muestra el resultado cuando se completa el comando y cuando el dispositivo ya no es visible para adb.

Arroja
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Anula esta opción 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 de adición. No se garantiza que adb root esté habilitado en esta etapa.

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

postAdbUnrootAction

public void postAdbUnrootAction ()

Anula esta opción si el dispositivo necesita que se realicen algunas acciones específicas después de que adb quite el estado de raíz 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é inhabilitado en esta etapa.

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

postBootSetup

public void postBootSetup ()

Sigue las instrucciones para configurar el dispositivo y realizar pruebas después de cada inicio.

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.

Es posible que se deba llamar cuando el dispositivo se reinicie debido a otros eventos (p. ej., cuando se completa 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 corresponde, es la excepción final que genera el error de invocación.

preInvocationSetup

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

Pasos adicionales para la configuración requerida específica del dispositivo que se ejecutará 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 al que se extraen los archivos.
`userId`	`int`: El ID del usuario del que se extraerá la información

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

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 al que se extraen los archivos.

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

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. `false` en caso contrario.

Arroja
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

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

Parámetros
`remoteFilePath`	`String`: Es la ruta de acceso absoluta al archivo en el dispositivo.
`userId`	`int`: El 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 ERROR(/File) temporal local y muestra ese 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`: El ID del usuario del que se extraerá la información

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

Arroja
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

Recupera un archivo del dispositivo y muestra 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 conveniente para recuperar un archivo del almacenamiento externo del dispositivo, almacenarlo en un ERROR(/File) temporal local y mostrar una referencia a ese File.

Parámetros
`remoteFilePath`	`String`: Es la ruta de acceso al archivo en el dispositivo, en relación con el punto de activación 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`: La ruta de acceso absoluta del archivo del destino remoto
`excludedDirectories`	: Es un conjunto de nombres de directorios excluidos que no se deben enviar.

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

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`: La ruta de acceso absoluta del archivo del destino remoto

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

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`: La ruta de acceso absoluta del archivo del destino remoto
`userId`	`int`: Es el ID de usuario al que se enviará.

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

Arroja
`DeviceNotAvailableException`

pushFile

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

Es una variante de pushFile(File, String) que, de manera opcional, puede considerar evaluar la necesidad del proveedor de contenido.

Parámetros
`localFile`	`File`: Es el archivo local que se enviará.
`remoteFilePath`	`String`: 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. `false` en caso contrario.

Arroja
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

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

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

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

Arroja
`DeviceNotAvailableException`

pushFile

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

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

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

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

Arroja
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

Cómo enviar un archivo creado a partir de una cadena al dispositivo

Parámetros
`contents`	`String`: El contenido del archivo que se enviará
`remoteFilePath`	`String`: La ruta de acceso absoluta del archivo de destino remoto

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

Arroja
`DeviceNotAvailableException`

reiniciar

public void reboot (String reason)

Reinicia el dispositivo en modo ADB con un reason determinado para que se conserve después del reinicio.

Se bloquea hasta que el dispositivo esté disponible.

Para obtener el motivo del último reinicio, consulta la propiedad sys.boot.reason.

Parámetros
`reason`	`String`: Es el motivo del 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 bootloader.

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

Arroja
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

Reinicia el dispositivo en el modo fastbootd.

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.

Bloquea el dispositivo hasta que entre en modo de recuperación.

Arroja
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

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

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

Arroja
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

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

Se bloquea hasta que el dispositivo entra en 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 un método alternativo 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 un método alternativo a reboot() que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.

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

Arroja
`DeviceNotAvailableException`

rebootUserspace

public void rebootUserspace ()

Reinicia solo la parte del espacio de usuario del dispositivo.

Se bloquea hasta que el dispositivo esté disponible.

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

Arroja
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

Es un método alternativo a rebootUserspace() ()} que solo 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 False 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.

Se notificará a todos los IDeviceActionReceiver registrados 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 se pueda escribir en la partición del proveedor del dispositivo. Es posible que se reinicie el dispositivo.

Arroja
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Quita el administrador del dispositivo determinado en el usuario determinado y muestra true si se realiza correctamente, false de lo contrario.

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

Muestra
`boolean`	Es verdadero si se realiza 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 a un usuario determinado del dispositivo.

Parámetros
`userId`	`int`: Es el usuario que se quitará.

Muestra
`boolean`	Es verdadero si se quitó correctamente el usuario; de lo contrario, es falso.

Arroja
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

Restablece la marca de configuración del proveedor de contenido para volver a activarla.

runInstrumentationTests

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

Es un método conveniente 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`: Los objetos de escucha de resultados de prueba

Muestra
`boolean`	`true` si se completó el comando de prueba. `false` si no se completó, 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 de dispositivos.

Si se pierde la conexión con el dispositivo antes de que se complete la ejecución de prueba y la recuperación se realiza correctamente, se informará a todos los objetos de escucha sobre testRunFailed y se mostrará "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 la recuperación falla, se informará a todos los objetos de escucha que testRunFailed y se arrojará DeviceNotAvailableException.

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

Muestra
`boolean`	`true` si se completó el comando de prueba. `false` si no se completó debido a una excepción de comunicación del dispositivo, pero la recuperación se realizó 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`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inyecta 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: Para configurar la fecha en el dispositivo, se requiere acceso de raíz.

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

Arroja
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

Muestra
`boolean`	Es verdadero si se realiza 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, establece 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 o no.

setFastbootPath

public void setFastbootPath (String fastbootPath)

Establece la ruta de acceso al objeto binario de fastboot que se debe usar. Aún requiere que isFastbootEnabled() sea verdadero para que se habiliten 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 IDevice nuevo.

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 el retraso en ms.

setOptions

public void setOptions (TestDeviceOptions options)

Establece el TestDeviceOptions para el dispositivo

Parámetros
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

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

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

Muestra
`boolean`	Muestra `True` si el comando setprop se realizó correctamente; de lo contrario, muestra 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 encuentra un problema de comunicación del dispositivo. Se recomienda usar este método con moderación cuando sea necesario (por ejemplo, cuando el framework esté inactivo, etcétera).

Parámetros
`mode`	`ITestDevice.RecoveryMode`: Indica si el modo "Recuperar hasta que haya conexión" debe estar activado o no.

setSetting

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

Consulta setSetting(int, String, String, String) y realiza la acción 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 un reinicio. namespace debe ser una de las siguientes opciones: {"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 la administración de dispositivos, haz un seguimiento del número de serie que usamos como referencia del dispositivo.

Parámetros
`trackingSerial`	`String`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

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

Parámetros
`useFastbootErase`	`boolean`: `true` si se debe usar el borrado de fastboot o `false` si se debe usar el formato de fastboot.

startLogcat

public void startLogcat ()

Comienza a capturar el resultado de Logcat desde el dispositivo en segundo plano.

No tendrá efecto si ya se está capturando el resultado de Logcat. Los datos se pueden recuperar más adelante a través de 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 intercambio de prueba. Se borrará el dispositivo y se reiniciará.

Parámetros
`timeoutMs`	`int`

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

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 un NOOP.

Parámetros
`userId`	`int`: del usuario para 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 un NOOP. Es posible proporcionar una marca adicional para esperar a que la operación tenga efecto.

Parámetros
`userId`	`int`: del usuario para 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 para iniciar en segundo plano
`displayId`	`int`: Es la pantalla en la que se iniciará la visibilidad del usuario.
`waitFlag`	`boolean`: Hará que el comando espere hasta que se inicie y desbloquee el usuario.

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

Arroja
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

Cierra y borra el resultado del emulador.

stopLogcat

public void stopLogcat ()

Detén la captura del resultado de Logcat desde el dispositivo y descarta los datos de Logcat guardados actualmente.

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

stopTradeInModeTesting

public void stopTradeInModeTesting ()

Detén 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 es un NOOP. No se puede detener al usuario actual ni al del sistema.

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

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

Arroja
`DeviceNotAvailableException`

stopUser

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

Detener a un usuario determinado Es posible proporcionar marcas adicionales para esperar a que la operación tenga efecto y forzar la finalización del usuario. No se puede detener al usuario actual ni al 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`: Detendrá el usuario de forma forzosa.

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

Arroja
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

Cambia el dispositivo al modo adb-over-tcp.

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

Arroja
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Cambia el dispositivo al modo adb mediante USB.

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

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 userId nuevo 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`: Esperar antes de mostrar un valor falso para que falle el cambio de usuario.

Muestra
`boolean`	Es verdadero si el userId nuevo 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 enviarán al dispositivo los archivos "más nuevos" o inexistentes. Por lo tanto, la sobrecarga debería ser relativamente pequeña si el archivo establecido en el dispositivo ya está actualizado.

Se ignorarán los archivos ocultos (con nombres que comienzan 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 enviarán de forma recursiva.
`deviceFilePath`	`String`: Es la raíz de la ruta de acceso absoluta del archivo de destino remoto. Todos los directorios de esta ruta de acceso de archivo deben ser legibles. Es decir, si no tienes permisos de root en adb, no se enviará a /data/local/tmp.

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

Arroja
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

Toma un informe de errores y devuélvelo dentro de un objeto Bugreport para controlarlo. Muestra un valor nulo en caso de problemas. El archivo al que se hace referencia en el objeto Bugreport se debe limpiar 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 se realiza correctamente.

Arroja
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Desinstala un paquete de Android del dispositivo de 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 se realiza correctamente.

Arroja
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

Desbloquea el dispositivo si está en un estado 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 se devuelve este método.

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

Arroja
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

Desactiva debugfs.

Arroja
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

Bloquea hasta que se establezca la marca de inicio completo del dispositivo.

Parámetros
`timeOut`	`long`: Es el 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 sea responsivo y esté disponible para las pruebas. 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 sea responsivo 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 sea responsivo y esté disponible sin considerar la ruta de recuperación.

Parámetros
`waitTime`	`long`

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

Arroja
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

Bloquea el dispositivo hasta que sea visible a través de fastboot. Usa el tiempo de espera predeterminado.

Arroja
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

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

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

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

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

Bloquea el dispositivo para que esté en el estado "sideload de adb".

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

Muestra
`boolean`	`true` si el dispositivo se inicia en la transferencia lateral 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 esté en ADB.

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

Muestra
`boolean`	`true` si el dispositivo no está disponible antes de que venza el tiempo `false` de lo contrario

waitForDeviceOnline

public void waitForDeviceOnline ()

Bloquea hasta que el dispositivo sea 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. En su lugar, usa waitForDeviceAvailable().

Arroja
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

Bloquea hasta que el dispositivo sea visible a través de adb.

Ten en cuenta que es posible que el dispositivo no responda a los comandos cuando se complete. 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 del shell de adb.

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 del shell de adb dados.

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 realices 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 de 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 de ayuda para generar 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`

initializeConnection

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

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

Arroja
`DeviceNotAvailableException`
`TargetSetupError`

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 muestra "adb shell getprop".
`fastbootVar`	`String`: Es el nombre de la variable de fastboot equivalente que se consultará. Si es `null`, no se intentará 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 ()

Muestra si se están ejecutando las devoluciones de llamada de reinicio en este momento. Si es verdadero, se deben inhabilitar todas las APIs públicas para el reinicio.

Muestra
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Muestra true si el archivo local es más reciente que el archivo remoto. IFileEntry es precisa hasta el minuto, en caso de que los tiempos sean iguales, el archivo se considerará más reciente.

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 del 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 con fines de registro.
`action`	`NativeDevice.DeviceAction`: La acción que se realizará
`retryAttempts`	`int`: El reintento intenta realizar 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 el intento de recuperación falla o los intentos máximos se realizan sin éxito

postAdbReboot

protected void postAdbReboot ()

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

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 después del 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 reloj que se usará.

Parámetros
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Marca 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, luego, informa 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, luego, informa 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 informar a adb).

Parámetros
`operationDesc`	`String`: Es el nombre de la operación que está esperando un estado no disponible.
`time`	`long`: Es el tiempo que se espera a 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

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

Campos

DEBUGFS_PATH

SD_CARD

STORAGE_EMULATED

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

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

getAndroidIds

getApiLevel

getAppPackageInfo

getAppPackageInfos