Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

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

Resumen

Clases anidadas

class ITestDevice.ApexInfo

Una clase de estructura simple para almacenar información sobre un solo APEX

class ITestDevice.MountPointInfo

Una clase de estructura simple para almacenar información sobre un solo punto de montaje

enum ITestDevice.RecoveryMode

Métodos públicos

abstract boolean checkConnectivity ()

Verifique que el dispositivo tenga conectividad de red.

abstract boolean clearErrorDialogs ()

Intente descartar los cuadros de diálogo de error que se muestran actualmente en la interfaz de usuario del dispositivo.

abstract void clearLastConnectedWifiNetwork ()

Borra la última red wifi conectada.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Se conecta a una red wifi.

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

Se conecta a una red wifi.

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

Una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo actualmente no tiene conectividad de red.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

Una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo actualmente no tiene conectividad de red.

abstract int createUser (String name)

Cree un usuario con un nombre dado y banderas predeterminadas 0.

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

Cree un usuario con un nombre de pila y las banderas proporcionadas

abstract int createUserNoThrow (String name)

Cree un usuario con un nombre dado y banderas predeterminadas 0.

abstract void disableKeyguard ()

Intenta desactivar el bloqueo del teclado.

abstract boolean disableNetworkMonitor ()

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

abstract boolean disconnectFromWifi ()

Se desconecta de una red wifi.

abstract File dumpHeap (String process, String devicePath)

Intente volcar el montón desde system_server.

abstract boolean enableNetworkMonitor ()

Habilita el monitoreo de la red en el dispositivo.

abstract getActiveApexes ()

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

Busque y devuelva el ID de Android asociado a un ID de usuario, nulo si no se encuentra.

abstract getAndroidIds ()

Cree un mapa de los ID de Android encontrados que coincidan con los ID de usuario.

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract int getCurrentUser ()

Devuelve la identificación del usuario en ejecución actual.

abstract getInstalledPackageNames ()

Obtenga 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 del bloqueo de teclas o nulo si no se admite.

abstract int getMaxNumberOfRunningUsersSupported ()

Obtenga el número máximo de usuarios que se ejecutan simultáneamente.

abstract int getMaxNumberOfUsersSupported ()

Obtenga el número máximo de usuarios admitidos.

abstract TestDeviceOptions getOptions ()

Obtenga las opciones de prueba para el dispositivo.

abstract Integer getPrimaryUserId ()

Devuelve el ID de usuario principal.

abstract InputStreamSource getScreenshot ()

Toma una captura de pantalla del dispositivo.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

Toma una captura de pantalla del dispositivo.

abstract InputStreamSource getScreenshot (int displayId)

Toma una captura de pantalla del dispositivo con la identificación de pantalla dada.

abstract InputStreamSource getScreenshot (String format)

Toma una captura de pantalla del dispositivo.

abstract String getSetting (String namespace, String key)

Ver getSetting(int, String, String) y realizado en el usuario del sistema.

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

Devuelve el valor de la configuración solicitada.

abstract getUninstallablePackageNames ()

Obtenga los nombres de los paquetes de aplicaciones que se pueden desinstalar.

abstract int getUserFlags (int userId)

Busque y devuelva las banderas 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 lo encuentra, -10000 en cualquier otro caso.

abstract boolean hasFeature (String feature)

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

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

Instale un paquete de Android en el dispositivo.

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

Instale un paquete de Android en el dispositivo.

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

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

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

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

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y otros paquetes divididos adicionales).

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

Instale una aplicación de Android formada por varios archivos APK (uno principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android.

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y un paquete dividido adicional) para un usuario determinado.

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y un paquete dividido adicional) para un usuario determinado.

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

Instale una aplicación de Android formada por varios archivos APK (uno principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android.

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

Instale una aplicación de Android compuesta por varios archivos APK (un paquete principal y uno adicional) que se encuentran en el dispositivo Android.

abstract boolean isMultiUserSupported ()

Determina si se admite multiusuario.

abstract boolean isPackageInstalled (String packageName)

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

abstract boolean isPackageInstalled (String packageName, String userId)

Consulte el dispositivo para obtener un nombre de paquete dado y una identificación de usuario dada para verificar si está instalado actualmente o no para ese usuario.

abstract boolean isUserRunning (int userId)

Compruebe si un usuario determinado se está ejecutando.

abstract boolean isUserSecondary (int userId)

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

abstract boolean isWifiEnabled ()

Prueba si el wifi está habilitado.

abstract listDisplayIds ()

Recopile la lista de ID de pantallas disponibles en el dispositivo según lo informado por "dumpsys SurfaceFlinger".

abstract listUsers ()

Obtiene la lista de usuarios del dispositivo.

abstract boolean removeAdmin (String componentName, int userId)

Elimine el administrador de dispositivo dado en el usuario dado y devuelva true si tiene éxito, false caso contrario.

abstract void removeOwners ()

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

abstract boolean removeUser (int userId)

Elimina a un usuario determinado del dispositivo.

abstract boolean setDeviceOwner (String componentName, int userId)

Establezca un componente de administración de dispositivo como propietario del dispositivo en un usuario determinado.

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

Ver setSetting(int, String, String, String) y realizado en el usuario del sistema.

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

Agregue 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 actualmente.

abstract boolean startUser (int userId, boolean waitFlag)

Inicia un usuario determinado en segundo plano si está detenido actualmente.

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

Detener a un usuario determinado.

abstract boolean stopUser (int userId)

Detiene a un usuario determinado.

abstract boolean switchUser (int userId)

Cambie a otro ID de usuario con un tiempo de espera predeterminado.

abstract boolean switchUser (int userId, long timeout)

Cambie a otro userId con el tiempo de espera proporcionado como fecha límite.

abstract String uninstallPackage (String packageName)

Desinstale un paquete de Android del dispositivo.

Métodos públicos

checkConnectivity

public abstract boolean checkConnectivity ()

Verifique que el dispositivo tenga conectividad de red.

Devoluciones
boolean true si el dispositivo tiene una conexión de red en funcionamiento, false general.

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Intente descartar los cuadros de diálogo de error que se muestran actualmente en la interfaz de usuario del dispositivo.

Devoluciones
boolean true si no había cuadros de diálogo presentes o si los cuadros de diálogo se borraron correctamente. false contrario.

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Borra la última red wifi conectada. Se debe llamar al iniciar una nueva invocación para evitar conectarse a la red wifi utilizada en la prueba anterior después de reiniciar el dispositivo.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se conecta a una red wifi.

Enciende wifi y bloquea hasta que se establece una conexión exitosa a la red wifi especificada. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

Parámetros
wifiSsid String : el ssid wifi al que conectarse

wifiPsk String : contraseña de PSK o nula si no está encriptada

Devoluciones
boolean true si se conecta a la red wifi correctamente. false contrario

Lanza
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 wifi.

Enciende wifi y bloquea hasta que se establece una conexión exitosa a la red wifi especificada. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se ITestDevice#disconnectFromWifi() o ITestDevice#clearLastConnectedWifiNetwork() .

Parámetros
wifiSsid String : el ssid wifi al que conectarse

wifiPsk String : contraseña de PSK o nula si no está encriptada

scanSsid boolean : si se debe buscar SSID oculto para esta red.

Devoluciones
boolean true si se conecta a la red wifi correctamente. false contrario

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

Una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo actualmente no tiene conectividad de red.

Parámetros
scanSsid boolean : si se debe buscar SSID oculto para esta red

Devoluciones
boolean true si se conecta a la red wifi correctamente. false contrario

Lanza
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Una variante de connectToWifiNetwork(String, String) que solo se conecta si el dispositivo actualmente no tiene conectividad de red.

Devoluciones
boolean true si se conecta a la red wifi correctamente. false contrario

Lanza
DeviceNotAvailableException

crear usuario

public abstract int createUser (String name)

Cree un usuario con un nombre dado y banderas predeterminadas 0.

Parámetros
name String : del usuario para crear en el dispositivo

Devoluciones
int el entero para el ID de usuario creado

Lanza
DeviceNotAvailableException

crear usuario

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

Cree un usuario con un nombre de pila y las banderas proporcionadas

Parámetros
name String : del usuario para crear en el dispositivo

guest boolean : habilita el indicador de usuario - invitado durante la creación

ephemeral boolean : habilita el indicador de usuario - efímero durante la creación

Devoluciones
int id del usuario creado

Lanza
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

Cree un usuario con un nombre dado y banderas predeterminadas 0.

Parámetros
name String : del usuario para crear en el dispositivo

Devoluciones
int el entero para el ID de usuario creado o -1 para el error.

Lanza
DeviceNotAvailableException

desactivar Keyguard

public abstract void disableKeyguard ()

Intenta desactivar el bloqueo del teclado.

Primero espere a que el envío de entrada esté listo, esto sucede casi al mismo tiempo cuando el dispositivo informa BOOT_COMPLETE, aparentemente de forma asincrónica, porque la implementación del marco actual tiene una condición de carrera ocasional. Luego, se envía el comando para descartar el bloqueo de teclas (funciona solo en los que no son seguros)

Lanza
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

Devoluciones
boolean true si la supervisión se deshabilita correctamente. false si falló.

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

desconectarFromWifi

public abstract boolean disconnectFromWifi ()

Se desconecta de una red wifi.

Elimina todas las redes de la lista de redes conocidas y desactiva el wifi.

Devoluciones
boolean true si se desconecta de la red wifi correctamente. false si falla la desconexión.

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

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Intente volcar el montón desde system_server. Es responsabilidad de la persona que llama limpiar el archivo volcado.

Parámetros
process String : el nombre del proceso del dispositivo en el que se va a realizar el volcado.

devicePath String : la ruta en el dispositivo donde colocar el volcado. Esta debe ser una ubicación donde los permisos lo permitan.

Devoluciones
File el ERROR(/File) contiene el informe. Nulo si algo falló.

Lanza
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Habilita el monitoreo de la red en el dispositivo.

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

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

getActiveApexes

public abstract  getActiveApexes ()

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

Devoluciones
ERROR(/Set) de ApexInfo actualmente activado en el dispositivo

Lanza
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

Devuelve pares clave-valor del espacio de nombres solicitado.

Parámetros
namespace String : debe ser una de {"system", "secure", "global"}

Devoluciones
el mapa de pares clave-valor. Nulo si no se admite el espacio de nombres.

Lanza
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Busque y devuelva el ID de Android asociado a un ID de usuario, nulo si no se encuentra.

Parámetros
userId int

Devoluciones
String

Lanza
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Cree un mapa de los ID de Android encontrados que coincidan con los ID 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 ID de usuario pueden coincidir con nulos.

Devoluciones
Mapa de identificadores de Android encontrados que coinciden con los identificadores de usuario.

Lanza
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Parámetros
packageName String

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

Lanza
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Devuelve la identificación del usuario en ejecución actual.

Devoluciones
int

Lanza
DeviceNotAvailableException
DeviceRuntimeException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

Devoluciones
ERROR(/Set) de los nombres de paquetes deString instalados actualmente en el dispositivo.

Lanza
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Obtiene la dirección IP del dispositivo.

Devoluciones
String la dirección IP del dispositivo, o null si el dispositivo no tiene dirección IP

Lanza
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 del bloqueo de teclas o nulo si no se admite.

Devoluciones
KeyguardControllerState un KeyguardControllerState contiene una instantánea del estado del keyguard y devuelve Null si la consulta Keyguard no es compatible.

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Obtenga el número máximo de usuarios que se ejecutan simultáneamente. El valor predeterminado es 0.

Devoluciones
int un número entero que indica el número de usuarios que se ejecutan simultáneamente

Lanza
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Obtenga el número máximo de usuarios admitidos. El valor predeterminado es 0.

Devoluciones
int un número entero que indica el número de usuarios admitidos

Lanza
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Obtenga las opciones de prueba para el dispositivo.

Devoluciones
TestDeviceOptions TestDeviceOptions relacionadas con el dispositivo bajo prueba.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Devuelve el ID de usuario principal.

Devoluciones
Integer el ID de usuario del usuario principal si hay uno, y nulo si no hay un usuario principal.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException si la salida del dispositivo no es la esperada.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Toma una captura de pantalla del dispositivo.

Devoluciones
InputStreamSource un InputStreamSource de la captura de pantalla en formato png, o null si la captura de pantalla no se realizó correctamente.

Lanza
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

Parámetros
format String : PNG, JPEG compatible

rescale boolean : si se debe cambiar la escala de la captura de pantalla para reducir el tamaño de la imagen resultante

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

Lanza
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (int displayId)

Toma una captura de pantalla del dispositivo con la identificación de pantalla dada. El formato es PNG.

TODO: amplíe las implementaciones anteriores para admitir 'formato' y 'reescalar'

Parámetros
displayId int : el ID de visualización de la pantalla para obtener la captura de pantalla.

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

Lanza
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

Toma una captura de pantalla del dispositivo. Se recomienda utilizar getScreenshot (formato) en su lugar con codificación JPEG para tamaños más pequeños

Parámetros
format String : PNG, JPEG compatible

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

Lanza
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

Ver getSetting(int, String, String) y realizado en el usuario del sistema.

Parámetros
namespace String

key String

Devoluciones
String

Lanza
DeviceNotAvailableException

getSetting

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

Devuelve el valor de la configuración solicitada. el espacio de nombres debe ser uno de los siguientes: {"system", "secure", "global"}

Parámetros
userId int

namespace String

key String

Devoluciones
String el valor asociado con el espacio de nombres: clave de un usuario. Nulo si no se encuentra.

Lanza
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Obtenga los nombres de los paquetes de aplicaciones que se pueden desinstalar. Esto se define actualmente como paquetes que no son del sistema y paquetes del sistema actualizados.

Devoluciones
ERROR(/Set) de nombres de paquetes deString desinstalables instalados actualmente en el dispositivo.

Lanza
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Busque y devuelva las banderas de un usuario determinado. Los indicadores se definen en la clase "android.content.pm.UserInfo" del proyecto de código abierto de Android.

Parámetros
userId int

Devoluciones
int los indicadores asociados con el userId proporcionado si se encuentran, -10000 en cualquier otro caso.

Lanza
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Obtiene el mapa de useId a UserInfo en el dispositivo. DeviceRuntimeException si la salida del dispositivo no es la esperada.

Devoluciones
la lista de objetos UserInfo.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Devuelve el número de serie asociado al userId si lo encuentra, -10000 en cualquier otro caso.

Parámetros
userId int

Devoluciones
int

Lanza
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

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

Parámetros
feature String : qué formato debe ser "característica: ".

Devoluciones
boolean Verdadero si se encuentra la característica, falso en caso contrario.

Lanza
DeviceNotAvailableException

paquete de instalación

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

Instale un paquete de Android en el dispositivo.

Parámetros
packageFile File : el archivo apk para instalar

reinstall boolean : true si se debe realizar una reinstalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm install --help' para conocer las opciones disponibles.

Devoluciones
String unaString con un código de error, o null si tiene éxito.

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

paquete de instalación

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

Instale un paquete de Android en el dispositivo.

Nota: Solo los casos de uso que requieran un control explícito para otorgar permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

Parámetros
packageFile File : el archivo apk para instalar

reinstall boolean : true si se debe realizar una reinstalación

grantPermissions boolean : si todos los permisos de tiempo de ejecución deben otorgarse en el momento de la instalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm install --help' para conocer las opciones disponibles.

Devoluciones
String unaString con un código de error, o null si tiene éxito.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si la plataforma en el dispositivo no admite el permiso de tiempo de ejecución.

installPackageForUser

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

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

Nota: Solo los casos de uso que requieran un control explícito para otorgar permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

Parámetros
packageFile File : el archivo apk para instalar

reinstall boolean : true si se debe realizar una reinstalación

grantPermissions boolean : si todos los permisos de tiempo de ejecución deben otorgarse en el momento de la instalación

userId int : el ID de usuario entero para el que instalar.

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm install --help' para conocer las opciones disponibles.

Devoluciones
String unaString con un código de error, o null si tiene éxito.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si la plataforma en el dispositivo no admite el permiso de tiempo de ejecución.

installPackageForUser

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

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

Parámetros
packageFile File : el archivo apk para instalar

reinstall boolean : true si se debe realizar una reinstalación

userId int : el ID de usuario entero para el que instalar.

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm install --help' para conocer las opciones disponibles.

Devoluciones
String unaString con un código de error, o null si tiene éxito.

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

installPackages

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y otros paquetes divididos adicionales). Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber cómo dividir apk en varios archivos.

Parámetros
packageFiles : los archivos apk locales

reinstall boolean : true si se debe realizar una reinstalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm install --help' para conocer las opciones disponibles.

Devoluciones
String unaString con un código de error, o null si tiene éxito.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si el permiso de tiempo de ejecución no es compatible con la plataforma en el dispositivo.

installPackages

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

Instale una aplicación de Android formada por varios archivos APK (uno principal y paquetes divididos adicionales) que se encuentran en el dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber cómo dividir apk en varios archivos.

Nota: Solo los casos de uso que requieran un control explícito para otorgar permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

Parámetros
packageFiles : las rutas de archivo apk remotas para instalar

reinstall boolean : true si se debe realizar una reinstalación

grantPermissions boolean : si todos los permisos de tiempo de ejecución deben otorgarse en el momento de la instalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm install --help' para conocer las opciones disponibles.

Devoluciones
String unaString con un código de error, o null si tiene éxito.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si la plataforma en el dispositivo no admite el permiso de tiempo de ejecución.

installPackagesForUser

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y un paquete dividido adicional) para un usuario determinado. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber cómo dividir apk en varios archivos.

Nota: Solo los casos de uso que requieran un control explícito para otorgar permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

Parámetros
packageFiles : los archivos apk locales

reinstall boolean : true si se debe realizar una reinstalación

grantPermissions boolean : si todos los permisos de tiempo de ejecución deben otorgarse en el momento de la instalación

userId int : el ID de usuario entero para el que instalar.

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm install --help' para conocer las opciones disponibles.

Devoluciones
String unaString con un código de error, o null si tiene éxito.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si la plataforma en el dispositivo no admite el permiso de tiempo de ejecución.

installPackagesForUser

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

Instale una aplicación de Android compuesta por varios archivos APK (uno principal y un paquete dividido adicional) para un usuario determinado. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber cómo dividir apk en varios archivos.

Parámetros
packageFiles : los archivos apk locales

reinstall boolean : true si se debe realizar una reinstalación

userId int : el ID de usuario entero para el que instalar.

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm install --help' para conocer las opciones disponibles.

Devoluciones
String unaString con un código de error, o null si tiene éxito.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si la plataforma en el dispositivo no admite el permiso de tiempo de ejecución.

installRemotePackages

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

Instale una aplicación de Android hecha de varios archivos APK (uno principal y un paquete extra dividido) que se encuentran en el dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber cómo dividir apk en varios archivos.

Nota: Solo los casos de uso que requieran un control explícito para otorgar permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.

Parámetros
remoteApkPaths : las rutas remotas del archivo apk

reinstall boolean : true si se debe realizar una reinstalación

grantPermissions boolean : si todos los permisos de tiempo de ejecución deben otorgarse en el momento de la instalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm install --help' para conocer las opciones disponibles.

Devoluciones
String unaString con un código de error, o null si tiene éxito.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si la plataforma en el dispositivo no admite el permiso de tiempo de ejecución.

installRemotePackages

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

Instale una aplicación de Android compuesta por varios archivos APK (un paquete principal y uno adicional) que se encuentran en el dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber cómo dividir apk en varios archivos.

Parámetros
remoteApkPaths : las rutas remotas del archivo apk

reinstall boolean : true si se debe realizar una reinstalación

extraArgs String : argumentos adicionales opcionales para pasar. Consulte 'adb shell pm install --help' para conocer las opciones disponibles.

Devoluciones
String unaString con un código de error, o null si tiene éxito.

Lanza
DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
UnsupportedOperationException si la plataforma en el dispositivo no admite el permiso de tiempo de ejecución.

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Determina si se admite multiusuario.

Devoluciones
boolean Verdadero si se admite multiusuario, falso en caso contrario

Lanza
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Parámetros
packageName String

Devoluciones
boolean Verdadero si se informa que el paquete está instalado. Falso de lo contrario.

Lanza
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Consulte el dispositivo para obtener un nombre de paquete dado y una identificación de usuario dada para verificar si está instalado actualmente o no para ese usuario.

Parámetros
packageName String : el paquete que estamos comprobando si está instalado.

userId String : el ID de usuario que estamos comprobando que el paquete está instalado. Si es nulo, se utilizará el usuario primario cero.

Devoluciones
boolean Verdadero si se informa que el paquete está instalado. Falso de lo contrario.

Lanza
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Compruebe si un usuario determinado se está ejecutando.

Parámetros
userId int

Devoluciones
boolean Verdadero si el usuario está ejecutando, falso en todos los demás casos.

Lanza
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Parámetros
userId int

Devoluciones
boolean Es verdadero si el usuario es secundario, falso en caso contrario.

Lanza
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Prueba si wifi está habilitado.

Comprueba si el wifi está habilitado en el dispositivo. Útil para afirmar el estado de wifi antes de pruebas que no deberían ejecutarse con wifi, por ejemplo, pruebas de datos móviles.

Devoluciones
boolean true si wifi está habilitado. false si está deshabilitado

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

listDisplayIds

public abstract  listDisplayIds ()

Recopile la lista de ID de pantallas disponibles en el dispositivo según lo informado por "dumpsys SurfaceFlinger".

Devoluciones
La lista de pantallas. Default siempre devuelve la pantalla predeterminada 0.

Lanza
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Obtiene la lista de usuarios del dispositivo. DeviceRuntimeException si la salida del dispositivo no es la esperada.

Devoluciones
la lista de identificadores de usuario.

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException
DeviceNotAvailableException

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Elimine el administrador de dispositivo dado en el usuario dado y devuelva true si tiene éxito, false caso contrario.

Parámetros
componentName String : del administrador del dispositivo que se eliminará.

userId int : del usuario en el que vive el administrador del dispositivo.

Devoluciones
boolean Verdadero si tiene éxito, falso en caso contrario.

Lanza
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

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

Lanza
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Elimina a un usuario determinado del dispositivo.

Parámetros
userId int : del usuario para eliminar

Devoluciones
boolean Es verdadero si logramos eliminar al usuario, falso en caso contrario.

Lanza
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Establezca un componente de administración de dispositivo como propietario del dispositivo en un usuario determinado.

Parámetros
componentName String : del administrador del dispositivo para ser propietario del dispositivo.

userId int : del usuario en el que vive el propietario del dispositivo.

Devoluciones
boolean Verdadero si tiene éxito, falso en caso contrario.

Lanza
DeviceNotAvailableException

setSetting

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

Ver setSetting(int, String, String, String) y realizado en el usuario del sistema.

Parámetros
namespace String

key String

value String

Lanza
DeviceNotAvailableException

setSetting

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

Agregue un valor de configuración al espacio de nombres de un usuario determinado. Algunas configuraciones solo estarán disponibles después de reiniciar. el espacio de nombres debe ser uno de los siguientes: {"system", "secure", "global"}

Parámetros
userId int

namespace String

key String

value String

Lanza
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

Inicia un usuario determinado en segundo plano si está detenido actualmente. Si el usuario ya se está ejecutando en segundo plano, este método es un NOOP.

Parámetros
userId int : del usuario para comenzar en segundo plano

Devoluciones
boolean Es true si el usuario se inició correctamente en segundo plano.

Lanza
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

Parámetros
userId int : del usuario para comenzar en segundo plano

waitFlag boolean : hará que el comando espere hasta que el usuario se inicie y desbloquee.

Devoluciones
boolean Es true si el usuario se inició correctamente en segundo plano.

Lanza
DeviceNotAvailableException

stopUser

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

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

Parámetros
userId int : del usuario para detener.

waitFlag boolean : hará que el comando espere hasta que el usuario se detenga.

forceFlag boolean : forzará la detención del usuario.

Devoluciones
boolean Es verdadero si el usuario se detuvo correctamente.

Lanza
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Detiene a un usuario determinado. Si el usuario ya está detenido, este método es un NOOP. No se puede detener al usuario actual y del sistema.

Parámetros
userId int : del usuario para detener.

Devoluciones
boolean Es verdadero si el usuario se detuvo correctamente.

Lanza
DeviceNotAvailableException

cambiar de usuario

public abstract boolean switchUser (int userId)

Cambie a otro ID de usuario con un tiempo de espera predeterminado. switchUser(int, long) .

Parámetros
userId int

Devoluciones
boolean Verdadero si el nuevo userId coincide con el proveedor de userId. Falso de lo contrario.

Lanza
DeviceNotAvailableException

cambiar de usuario

public abstract boolean switchUser (int userId, 
                long timeout)

Cambie a otro userId con el tiempo de espera proporcionado como fecha límite. Intente desactivar el bloqueo de teclas después de que el cambio de usuario sea exitoso.

Parámetros
userId int

timeout long : esperar antes de devolver falso para el cambio de usuario fallido.

Devoluciones
boolean Verdadero si el nuevo userId coincide con el proveedor de userId. Falso de lo contrario.

Lanza
DeviceNotAvailableException

desinstalarPaquete

public abstract String uninstallPackage (String packageName)

Desinstale un paquete de Android del dispositivo.

Parámetros
packageName String : el paquete de Android para desinstalar

Devoluciones
String unaString con un código de error, o null si tiene éxito.

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