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.

ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Subcategorías indirectas conocidas

IManagedTestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice

IManagedTestDevice	Es un ITestDevice cuyo ciclo de vida se administra.
LocalAndroidVirtualDevice	Clase para dispositivos virtuales locales que se ejecutan en el host de Tradefed.
ManagedRemoteDevice	Es un dispositivo que se ejecuta dentro de una máquina virtual que administramos de forma remota a través de una instancia de Tradefed dentro de la VM.
NativeDevice	Es la implementación predeterminada de un `ITestDevice` para dispositivos Android que no son de pila completa.
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).
TestDevice	Implementación de un `ITestDevice` para un dispositivo Android de pila completa

Proporciona una API confiable y de un nivel ligeramente superior a un IDevice de ddmlib.

Vuelve a intentar enviar comandos al dispositivo una cantidad configurable de veces y proporciona una interfaz de recuperación para los dispositivos que no responden.

Resumen

Clases anidadas
`class`	`ITestDevice.ApexInfo` Una clase struct simple para almacenar información sobre un solo APEX
`class`	`ITestDevice.MountPointInfo` Una clase struct simple para almacenar información sobre un solo punto de montaje

Métodos públicos
`abstract boolean`	`canSwitchToHeadlessSystemUser()` Devuelve si se permite cambiar al usuario SYSTEM sin interfaz gráfica.
`abstract boolean`	`checkConnectivity()` Comprueba que el dispositivo tenga conectividad de red.
`abstract boolean`	`clearErrorDialogs()` Intenta descartar los diálogos de error que se muestran actualmente en la IU del dispositivo.
`abstract void`	`clearLastConnectedWifiNetwork()` Borra la última red Wi-Fi a la que se conectó.
`abstract boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Se conecta a una red Wi-Fi.
`abstract boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Se conecta a una red Wi-Fi.
`abstract boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Se conecta a una red Wi-Fi.
`abstract boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` Se conecta a una red Wi-Fi.
`abstract 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.
`abstract 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.
`abstract int`	`createUser(String name)` Crea un usuario con un nombre determinado y marcas predeterminadas 0.
`abstract int`	`createUser(String name, boolean guest, boolean ephemeral)` Crea un usuario con un nombre determinado y las marcas proporcionadas
`abstract int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Crea un usuario con un nombre determinado y las marcas proporcionadas
`abstract int`	`createUserNoThrow(String name)` Crea un usuario con un nombre determinado y marcas predeterminadas 0.
`abstract void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Quita el `IDeviceActionReceiver` registrado.
`abstract void`	`disableKeyguard()` Intenta inhabilitar el bloqueo de teclado.
`abstract boolean`	`disableNetworkMonitor()` Inhabilita la supervisión de la red en el dispositivo.
`abstract boolean`	`disconnectFromWifi()` Se desconecta de una red Wi-Fi.
`abstract boolean`	`doesFileExist(String deviceFilePath, int userId)` Método de ayuda para determinar si existe un archivo en el dispositivo para un usuario determinado.
`abstract File`	`dumpHeap(String process, String devicePath)` Intenta volcar el montón de system_server.
`abstract boolean`	`enableNetworkMonitor()` Habilita la supervisión de la red en el dispositivo.
`abstract`	`getActiveApexes()` Recupera la información sobre los APEX activados en el dispositivo.
`abstract`	`getAllSettings(String namespace)` Devuelve pares clave-valor del espacio de nombres solicitado.
`abstract String`	`getAndroidId(int userId)` Busca y devuelve el android-id asociado a un userId. Devuelve null si no se encuentra.
`abstract`	`getAndroidIds()` Crea un mapa de los IDs de Android que coinciden con los IDs de usuario.
`abstract PackageInfo`	`getAppPackageInfo(String packageName)` Recupera información sobre un paquete instalado en el dispositivo.
`abstract`	`getAppPackageInfos()` Recupera información de los paquetes instalados en el dispositivo.
`abstract InputStreamSource`	`getBugreport()` Recupera un informe de errores del dispositivo.
`abstract InputStreamSource`	`getBugreportz()` Recupera un bugreportz del dispositivo.
`abstract DeviceFoldableState`	`getCurrentFoldableState()` Devuelve el estado actual de plegado del dispositivo o un valor nulo si se produjo algún problema.
`abstract int`	`getCurrentUser()` Devuelve el ID del usuario que se está ejecutando actualmente.
`abstract`	`getFoldableStates()` Devuelve la lista de estados de plegado del dispositivo.
`abstract`	`getInstalledPackageNames()` Recupera los nombres de los paquetes de aplicaciones presentes en el dispositivo.
`abstract String`	`getIpAddress()` Obtiene la dirección IP del dispositivo.
`abstract KeyguardControllerState`	`getKeyguardState()` Devuelve un objeto para obtener el estado actual de Keyguard o un valor nulo si no se admite.
`abstract Integer`	`getMainUserId()` Devuelve el ID del usuario principal.
`abstract`	`getMainlineModuleInfo()` Obtiene información sobre los módulos de la línea principal instalados en el dispositivo.
`abstract int`	`getMaxNumberOfRunningUsersSupported()` Obtiene la cantidad máxima de usuarios que se pueden ejecutar de forma simultánea.
`abstract int`	`getMaxNumberOfUsersSupported()` Obtiene la cantidad máxima de usuarios admitidos.
`abstract TestDeviceOptions`	`getOptions()` Recupera las opciones de prueba para el dispositivo.
`abstract Integer`	`getPrimaryUserId()` Este método dejó de estar disponible. getPrimaryUser dejó de estar disponible en el servicio UserManager. Usa `ERROR(/android.os.UserManager#getMainUserId())` para obtener el primer usuario completo o 0 para el sistema. Ten en cuenta que, para el sistema sin interfaz gráfica, no es un usuario completo.
`abstract InputStreamSource`	`getScreenshot(String format, boolean rescale)` Toma una captura de pantalla del dispositivo.
`abstract InputStreamSource`	`getScreenshot(long displayId)` Toma una captura de pantalla del dispositivo con el ID de pantalla determinado.
`abstract InputStreamSource`	`getScreenshot(String format)` Toma una captura de pantalla del dispositivo.
`abstract InputStreamSource`	`getScreenshot()` Toma una captura de pantalla del dispositivo.
`abstract String`	`getSetting(int userId, String namespace, String key)` Devuelve el valor del parámetro de configuración solicitado.
`abstract String`	`getSetting(String namespace, String key)` Consulta `getSetting(int, String, String)` y se realiza en el usuario del sistema.
`abstract`	`getUninstallablePackageNames()` Recupera los nombres de los paquetes de aplicaciones que se pueden desinstalar.
`abstract int`	`getUserFlags(int userId)` Busca y devuelve las marcas de un usuario determinado.
`abstract`	`getUserInfos()` Obtiene el mapa de useId a `UserInfo` en el dispositivo.
`abstract int`	`getUserSerialNumber(int userId)` Devuelve el número de serie asociado al userId si se encuentra; de lo contrario, devuelve -10000.
`abstract boolean`	`hasFeature(String feature)` Comprueba si una función está disponible en un dispositivo.
`abstract String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` Instala un paquete de Android en el dispositivo.
`abstract String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` Instala un paquete de Android en el dispositivo.
`abstract String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` Instala un paquete de Android en el dispositivo para un usuario determinado.
`abstract String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Instala un paquete de Android en el dispositivo para un usuario determinado.
`abstract boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` Instala APKs con el modo incremental.
`default String`	`installPackages( packageFiles, boolean reinstall, String... extraArgs)` Instalar una aplicación para Android compuesta por varios archivos APK (un paquete principal y paquetes divididos adicionales)
`default String`	`installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)` Instala una aplicación para Android compuesta por varios archivos APK (un paquete principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android.
`default String`	`installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)` Instala una aplicación para Android compuesta por varios archivos APK (un paquete principal y paquetes divididos adicionales) para un usuario determinado.
`default String`	`installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Instala una aplicación para Android compuesta por varios archivos APK (un paquete principal y paquetes divididos adicionales) para un usuario determinado.
`default String`	`installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)` Instala una aplicación para Android compuesta por varios archivos APK (un paquete principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android.
`default String`	`installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)` Instala una aplicación para Android compuesta por varios archivos APK (un paquete principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android.
`abstract boolean`	`isHeadlessSystemUserMode()` Devuelve si el dispositivo usa el modo de usuario del sistema sin interfaz gráfica.
`abstract boolean`	`isMainUserPermanentAdmin()` Devuelve si el usuario principal es un administrador permanente y no se puede borrar ni degradar a un estado que no sea de administrador.
`abstract boolean`	`isMultiUserSupported()` Determina si se admite la función de múltiples usuarios.
`abstract boolean`	`isPackageInstalled(String packageName, String userId)` Consulta el dispositivo para un nombre de paquete y un ID de usuario determinados para verificar si está instalado actualmente para ese usuario.
`abstract boolean`	`isPackageInstalled(String packageName)` Consulta el dispositivo para un nombre de paquete determinado y verifica si está instalado actualmente.
`abstract boolean`	`isUserRunning(int userId)` Comprueba si un usuario determinado está ejecutando la app.
`abstract boolean`	`isUserSecondary(int userId)` Devuelve si el usuario especificado es un usuario secundario según sus marcas.
`abstract boolean`	`isUserVisible(int userId)` Verifica si el usuario determinado es visible.
`abstract boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` Verifica si el usuario determinado es visible en la pantalla determinada.
`abstract boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` Devuelve si el dispositivo permite que los usuarios inicien la visibilidad en segundo plano en `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`abstract boolean`	`isVisibleBackgroundUsersSupported()` Devuelve si el dispositivo permite que los usuarios inicien la visibilidad en segundo plano.
`abstract boolean`	`isWifiEnabled()` Prueba si el Wi-Fi está habilitado.
`abstract`	`listDisplayIds()` Recopila la lista de IDs de pantallas disponibles en el dispositivo, según lo indica "dumpsys SurfaceFlinger".
`abstract`	`listDisplayIdsForStartingVisibleBackgroundUsers()` Obtiene la lista de pantallas que se pueden usar para `start a user visible in the background`.
`abstract`	`listUsers()` Obtiene la lista de usuarios del dispositivo.
`abstract boolean`	`logBugreport(String dataName, ITestLogger listener)` Método auxiliar para tomar un informe de errores y registrarlo para los reporteros.
`default void`	`notifySnapuserd(SnapuserdWaitPhase waitPhase)` Notifica al dispositivo que espere a que se complete snapuserd.
`abstract void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Registra un `IDeviceActionReceiver` para este dispositivo.
`abstract boolean`	`removeAdmin(String componentName, int userId)` Quita el administrador de dispositivos determinado del usuario determinado y devuelve `true` si se realiza correctamente o `false` si no se realiza correctamente.
`abstract void`	`removeOwners()` Quita todos los propietarios de perfiles de dispositivos existentes con el mejor esfuerzo.
`abstract boolean`	`removeUser(int userId)` Quita un usuario determinado del dispositivo.
`abstract boolean`	`setDeviceOwner(String componentName, int userId)` Establece un componente de administrador del dispositivo como propietario del dispositivo en el usuario determinado.
`abstract void`	`setSetting(String namespace, String key, String value)` Consulta `setSetting(int, String, String, String)` y se realiza en el usuario del sistema.
`abstract void`	`setSetting(int userId, String namespace, String key, String value)` Agrega un valor de configuración al espacio de nombres de un usuario determinado.
`abstract boolean`	`startUser(int userId)` Inicia un usuario determinado en segundo plano si está detenido.
`abstract boolean`	`startUser(int userId, boolean waitFlag)` Inicia un usuario determinado en segundo plano si está detenido.
`abstract 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).
`abstract boolean`	`stopUser(int userId)` Detiene a un usuario determinado.
`abstract boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Detiene a un usuario determinado.
`abstract boolean`	`switchUser(int userId)` Cambia a otro userId con un tiempo de espera predeterminado.
`abstract boolean`	`switchUser(int userId, long timeout)` Cambia a otro userId con el tiempo de espera proporcionado como fecha límite.
`abstract Bugreport`	`takeBugreport()` Toma un informe de errores y lo devuelve dentro de un objeto `Bugreport` para controlarlo.
`abstract String`	`uninstallPackage(String packageName)` Desinstala un paquete de Android del dispositivo.
`abstract String`	`uninstallPackageForUser(String packageName, int userId)` Desinstala un paquete de Android del dispositivo para un usuario determinado.
`default void`	`waitForSnapuserd(SnapuserdWaitPhase currentPhase)` Si es lo esperado, espera a que se complete snapuserd.

Métodos públicos

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

checkConnectivity

public abstract boolean checkConnectivity ()

Comprueba que el dispositivo tenga conectividad de red.

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

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

Arroja
`DeviceNotAvailableException`	si se pierde la conexión con el dispositivo y no se puede recuperar.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Se conecta a una red Wi-Fi.

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

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se conecta a una red Wi-Fi.

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se conecta a una red Wi-Fi.

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

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

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

Arroja
`DeviceNotAvailableException`	si se pierde la conexión con el dispositivo y no se puede recuperar.

connectToWifiNetwork

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

Se conecta a una red Wi-Fi.

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

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

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

Arroja
`DeviceNotAvailableException`	si se pierde la conexión con el dispositivo y no se puede recuperar.

connectToWifiNetworkIfNeeded

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

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

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

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

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

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

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

createUser

public abstract int createUser (String name)

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

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

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

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

createUser

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

Crea un usuario con un nombre determinado y las marcas proporcionadas

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

Muestra
`int`	ID del usuario creado

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

createUser

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

Crea un usuario con un nombre determinado y las marcas proporcionadas

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

Muestra
`int`	ID del usuario creado

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

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

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

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

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Quita el IDeviceActionReceiver registrado.

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

disableKeyguard

public abstract void disableKeyguard ()

Intenta inhabilitar el bloqueo de teclado.

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

Arroja
`DeviceNotAvailableException`

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

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

Arroja
`DeviceNotAvailableException`	si se pierde la conexión con el dispositivo y no se puede recuperar.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

Se desconecta de una red Wi-Fi.

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

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

Arroja
`DeviceNotAvailableException`	si se pierde la conexión con el dispositivo y no se puede recuperar.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

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

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

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

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

Arroja
`DeviceNotAvailableException`	si se pierde la conexión con el dispositivo y no se puede recuperar.

getActiveApexes

public abstract  getActiveApexes ()

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

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

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

getAllSettings

public abstract  getAllSettings (String namespace)

Devuelve pares clave-valor del espacio de nombres solicitado.

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

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

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

getAndroidId

public abstract String getAndroidId (int userId)

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

Parámetros
`userId`	`int`

Muestra
`String`

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

getAndroidIds

public abstract  getAndroidIds ()

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

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

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

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Parámetros
`packageName`	`String`

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

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

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

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

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

getBugreport

public abstract InputStreamSource getBugreport ()

Recupera un informe de errores del dispositivo.

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

Solo se admite para "adb version" > 1.0.36

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Muestra
`DeviceFoldableState`

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

getCurrentUser

public abstract int getCurrentUser ()

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

Muestra
`int`

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

getFoldableStates

public abstract  getFoldableStates ()

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

Muestra

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

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

getIpAddress

public abstract String getIpAddress ()

Obtiene la dirección IP del dispositivo.

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

Arroja
`DeviceNotAvailableException`	si se pierde la conexión con el dispositivo y no se puede recuperar.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.

getMainUserId

public abstract Integer getMainUserId ()

Devuelve el ID del usuario principal.

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

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceRuntimeException`	si el resultado del dispositivo no es el esperado.
`DeviceNotAvailableException`

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

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

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

getOptions

public abstract TestDeviceOptions getOptions ()

Recupera las opciones de prueba para el dispositivo.

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Este método dejó de estar disponible.
getPrimaryUser se dio de baja del servicio de UserManager. Usa ERROR(/android.os.UserManager#getMainUserId()) para obtener el primer usuario completo o 0 para el sistema. Ten en cuenta que, para el sistema sin interfaz gráfica, no es un usuario completo.

Devuelve el ID de usuario principal.

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

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceRuntimeException`	si el resultado del dispositivo no es el esperado.
`DeviceNotAvailableException`

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

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

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot ()

Toma una captura de pantalla del dispositivo.

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

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

getSetting

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

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

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

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

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

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

Muestra
`String`

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

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

getUserFlags

public abstract int getUserFlags (int userId)

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

Parámetros
`userId`	`int`

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

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

getUserInfos

public abstract  getUserInfos ()

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

Muestra
	Es la lista de objetos UserInfo.

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

Parámetros
`userId`	`int`

Muestra
`int`

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

hasFeature

public abstract boolean hasFeature (String feature)

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

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

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

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

installPackage

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

Instala un paquete de Android en el dispositivo.

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.

installPackage

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

Instala un paquete de Android en el dispositivo.

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

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.
`UnsupportedOperationException`	Si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

installPackageForUser

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

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

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.

installPackageForUser

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

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

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

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.
`UnsupportedOperationException`	Si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

installPackageWithIncrementalMode

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

Instala APKs con el modo incremental.

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

Muestra
`boolean`

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

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

Instalar una aplicación para Android compuesta por varios archivos APK (un paquete principal y paquetes divididos adicionales) Consulta "https://developer.android.com/studio/build/configure-apk-splits" para obtener información sobre cómo dividir el APK en varios archivos.

Parámetros
`packageFiles`	: Los archivos APK locales
`reinstall`	`boolean`: `true` si se debe realizar una reinstalación
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.
`UnsupportedOperationException`	Si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Instala una aplicación para Android compuesta por varios archivos APK (un paquete principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android. Consulta "https://developer.android.com/studio/build/configure-apk-splits" para obtener información sobre cómo dividir el APK en varios archivos.

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

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.
`UnsupportedOperationException`	Si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Instala una aplicación para Android compuesta por varios archivos APK (un paquete principal y paquetes divididos adicionales) para un usuario determinado. Consulta "https://developer.android.com/studio/build/configure-apk-splits" para obtener información sobre cómo dividir el APK en varios archivos.

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.
`UnsupportedOperationException`	Si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.
`UnsupportedOperationException`	Si la plataforma del dispositivo no admite el permiso de tiempo de ejecución

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Parámetros
`remoteApkPaths`	: Rutas de acceso a archivos APK remotos
`reinstall`	`boolean`: `true` si se debe realizar una reinstalación
`extraArgs`	`String`: Son argumentos adicionales opcionales que se pueden pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.
`UnsupportedOperationException`	Si la plataforma del dispositivo no admite el permiso de tiempo de ejecución

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

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

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.
`UnsupportedOperationException`	Si la plataforma del dispositivo no admite el permiso de tiempo de ejecución.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Parámetros
`packageName`	`String`

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

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

isUserRunning

public abstract boolean isUserRunning (int userId)

Comprueba si un usuario determinado está ejecutando la app.

Parámetros
`userId`	`int`

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

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

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Parámetros
`userId`	`int`

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

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

isUserVisible

public abstract 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 abstract 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 abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

isWifiEnabled

public abstract boolean isWifiEnabled ()

Prueba si el Wi-Fi está habilitado.

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

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

Arroja
`DeviceNotAvailableException`	si se pierde la conexión con el dispositivo y no se puede recuperar.

listDisplayIds

public abstract  listDisplayIds ()

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

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

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Muestra

Arroja
`DeviceNotAvailableException`

listUsers

public abstract  listUsers ()

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

Muestra
	Es la lista de IDs de usuarios.

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

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

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

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Notifica al dispositivo que espere a que se complete snapuserd.

Parámetros
`waitPhase`	`SnapuserdWaitPhase`

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver para este dispositivo.

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

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

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

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

removeOwners

public abstract void removeOwners ()

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

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

removeUser

public abstract boolean removeUser (int userId)

Quita un usuario determinado del dispositivo.

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

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

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

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

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

setSetting

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

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

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

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

setSetting

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

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

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

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

startUser

public abstract boolean startUser (int userId)

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

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

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

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

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

startVisibleBackgroundUser

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

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

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

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

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

Arroja
`DeviceNotAvailableException`

stopUser

public abstract boolean stopUser (int userId)

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

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

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

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

stopUser

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

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

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

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

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

switchUser

public abstract boolean switchUser (int userId)

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

Parámetros
`userId`	`int`

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

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

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

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

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

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

takeBugreport

public abstract Bugreport takeBugreport ()

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

Muestra
`Bugreport`

uninstallPackage

public abstract String uninstallPackage (String packageName)

Desinstala un paquete de Android del dispositivo.

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

Arroja
`DeviceNotAvailableException`	Si se pierde la conexión con el dispositivo y no se puede recuperar.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Si es lo esperado, espera a que se complete snapuserd.

Parámetros
`currentPhase`	`SnapuserdWaitPhase`

Arroja
`DeviceNotAvailableException`

ITestDevice

Resumen

Clases anidadas

Métodos públicos

Métodos públicos

canSwitchToHeadlessSystemUser

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

deregisterDeviceActionReceiver

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

dumpHeap

enableNetworkMonitor

getActiveApexes

getAllSettings

getAndroidId

getAndroidIds

getAppPackageInfo

getAppPackageInfos

getBugreport

getBugreportz

getCurrentFoldableState

getCurrentUser

getFoldableStates

getInstalledPackageNames

getIpAddress

getKeyguardState

getMainUserId

getMainlineModuleInfo

getMaxNumberOfRunningUsersSupported

getMaxNumberOfUsersSupported

getOptions

getPrimaryUserId

getScreenshot

getScreenshot

getScreenshot

getScreenshot

getSetting

getSetting

getUninstallablePackageNames

getUserFlags

getUserInfos

getUserSerialNumber

hasFeature

installPackage

installPackage

installPackageForUser

installPackageForUser

installPackageWithIncrementalMode

installPackages

installPackages

installPackagesForUser

installPackagesForUser

installRemotePackages

installRemotePackages

isHeadlessSystemUserMode

isMainUserPermanentAdmin

isMultiUserSupported

isPackageInstalled

isPackageInstalled

isUserRunning

isUserSecondary

isUserVisible

isUserVisibleOnDisplay

isVisibleBackgroundUsersOnDefaultDisplaySupported

isVisibleBackgroundUsersSupported

isWifiEnabled