Dispositivo nativo

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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


Implementación predeterminada de un dispositivo Android ITestDevice que no es de pila completa.

Resumen

Clases anidadas

class NativeDevice.AdbAction

Un ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) para ejecutar un comando “adb ....” del SO. 

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) para reiniciar un dispositivo. 

Constantes

int INVALID_USER_ID

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

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

la cantidad predeterminada de reintentos de comandos que se deben realizar

Campos

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

Constructores públicos

NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Crea un TestDevice.

Métodos públicos

void batchPrefetchStartupBuildProps()

Microoptimización (alrededor de 400 milisegundos) mediante la carga previa de todas las props que necesitamos, en lugar de llamar a "adb getprop" para cada una.

boolean canSwitchToHeadlessSystemUser()

Muestra si se le permite cambiar al usuario de SYSTEM sin interfaz gráfica.

boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Comprueba si una función es compatible actualmente con un nivel mínimamente compatible.

boolean checkConnectivity()

Verifica que el dispositivo tenga conectividad de red.

boolean clearErrorDialogs()

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

void clearLastConnectedWifiNetwork()

Borra la última red Wi-Fi conectada.

void clearLogcat()

Borra todos los datos acumulados de logcat.

boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Se conecta a una red Wi-Fi.

boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Se conecta a una red Wi-Fi.

boolean connectToWifiNetwork( wifiSsidToPsk)

Se conecta a una red Wi-Fi.

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

Se conecta a una red Wi-Fi.

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

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

boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

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

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

Crea un usuario con un nombre determinado y las marcas proporcionadas

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

Crea un usuario con un nombre determinado y las marcas proporcionadas

int createUser(String name)

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

int createUserNoThrow(String name)

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

void deleteFile(String deviceFilePath, int userId)

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

void deleteFile(String deviceFilePath)

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

void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Quita el IDeviceActionReceiver registrado.

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Método de ayuda para verificar si el dispositivo se reinició de forma no definitiva comparando el system_server actual con el ProcessInfo anterior de system_server.

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Es un método auxiliar para verificar si el dispositivo se reinició de forma suave desde la hora UTC desde la época del dispositivo y su ERROR(/TimeUnit).

boolean disableAdbRoot()

Desactiva el acceso raíz de adb.

void disableKeyguard()

Intenta inhabilitar el bloqueo de teclas.

boolean disableNetworkMonitor()

Inhabilita la supervisión de red en el dispositivo.

boolean disconnectFromWifi()

Se desconecta de una red Wi-Fi.

boolean doesFileExist(String deviceFilePath, int userId)

Es un método auxiliar para determinar si existe un archivo en el dispositivo para un usuario determinado.

boolean doesFileExist(String deviceFilePath)

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

File dumpHeap(String process, String devicePath)

Intenta volcar el montón desde system_server.

boolean enableAdbRoot()

Activa el permiso de administrador de adb.

boolean enableNetworkMonitor()

Habilita la supervisión de red en el dispositivo.

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

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

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

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

String executeAdbCommand(String... cmdArgs)

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

CommandResult executeFastbootCommand(String... cmdArgs)

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

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

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

CommandResult executeLongFastbootCommand(String... cmdArgs)

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

CommandResult executeLongFastbootCommand( envVarMap, String... cmdArgs)

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

String executeShellCommand(String command)

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

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

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

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

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

void executeShellCommand(String command, IShellOutputReceiver receiver)

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

CommandResult executeShellV2Command(String cmd)

Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un CommandResult propagado correctamente con el resultado del estado del comando, stdout y stderr.

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un CommandResult correctamente propagado con el resultado del estado del comando y stderr.

CommandResult executeShellV2Command(String cmd, File pipeAsInput)

Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como una CommandResult propagada correctamente con el resultado del estado del comando, stdout y stderr.

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

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

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

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

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

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

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

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

CommandResult fastbootWipePartition(String partition)

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

getActiveApexes()

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

getAllSettings(String namespace)

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

DeviceAllocationState getAllocationState()

Muestra el estado de asignación actual del dispositivo

String getAndroidId(int userId)

Busca y muestra el android-id asociado con un userId (valor nulo si no se encuentra).

getAndroidIds()

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

int getApiLevel()

Obtén el nivel de API del dispositivo.

PackageInfo getAppPackageInfo(String packageName)

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

getAppPackageInfos()

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

String getBasebandVersion()

Es un método conveniente para obtener la versión de banda base (radio) de este dispositivo.

Integer getBattery()

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

boolean getBooleanProperty(String name, boolean defaultValue)

Muestra el valor booleano de la propiedad determinada.

getBootHistory()

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

getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

El método de ayuda recopila el mapa del historial de inicio con el tiempo de inicio y el motivo desde el momento determinado desde la época del dispositivo y la unidad de tiempo especificada.

String getBootloaderVersion()

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

InputStreamSource getBugreport()

Recupera un informe de errores del dispositivo.

InputStreamSource getBugreportz()

Recupera un bugreportz del dispositivo.

String getBuildAlias()

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

String getBuildFlavor()

Recupera el tipo de compilación del dispositivo.

String getBuildId()

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

String getBuildSigningKeys()

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

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

DeviceDescriptor getCachedDeviceDescriptor()

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

DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

String[] getChildren(String path)

Es una alternativa al uso de IFileEntry que, a veces, no funciona debido a los permisos.

AbstractConnection getConnection()

La conexión actual asociada con el dispositivo.

ContentProviderHandler getContentProvider(int userId)

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

DeviceFoldableState getCurrentFoldableState()

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

int getCurrentUser()

Muestra el ID del usuario que se está ejecutando actualmente.

String getDeviceClass()

Obtén la clase de dispositivo.

long getDeviceDate()

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

DeviceDescriptor getDeviceDescriptor()

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

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

TestDeviceState getDeviceState()

Obtén el estado del dispositivo.

long getDeviceTimeOffset(Date date)

Es un elemento auxiliar para obtener la diferencia horaria entre el dispositivo y un ERROR(/Date) determinado.

InputStreamSource getEmulatorOutput()

Cómo obtener la transmisión de stdout y stderr del emulador

Process getEmulatorProcess()

Muestra el Process correspondiente a este emulador.

final File getExecuteShellCommandLog()

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

long getExternalStoreFreeSpace()

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

String getFastbootPath()

Muestra la ruta de acceso del objeto binario de fastboot que se usa.

String getFastbootProductType()

Es un método conveniente para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.

String getFastbootProductVariant()

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

String getFastbootSerialNumber()

Muestra el número de serie del modo fastboot.

String getFastbootVariable(String variableName)

Recupera el valor de la variable de fastboot específico del dispositivo.

String getFastbootVersion()

Muestra la cadena de versión del objeto binario de fastboot que se usa.

IFileEntry getFileEntry(String path)

Recupera una referencia a un archivo remoto en el dispositivo.

IFileEntry getFileEntry(FileListingService.FileEntry entry)

Es un asistente no oficial para obtener un FileEntry de una ruta no raíz.

getFoldableStates()

Muestra la lista de estados plegables en el dispositivo.

IDevice getIDevice()

Devuelve una referencia al IDevice de ddmlib asociado.

getInstalledPackageNames()

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

long getIntProperty(String name, long defaultValue)

Muestra el valor entero de la propiedad determinada desde el dispositivo.

String getIpAddress()

Obtiene la dirección IP del dispositivo.

KeyguardControllerState getKeyguardState()

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

long getLastExpectedRebootTimeMillis()

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

int getLaunchApiLevel()

Obtén el nivel de API que se lanzó por primera vez en el dispositivo.

InputStreamSource getLogcat()

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

InputStreamSource getLogcat(int maxBytes)

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

InputStreamSource getLogcatDump()

Obtén un volcado del logcat actual del dispositivo.

InputStreamSource getLogcatSince(long date)

Captura una transmisión de instantáneas de datos de Logcat capturados a partir de la fecha proporcionada.

String getMacAddress()

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

Integer getMainUserId()

Muestra el ID de usuario principal.

getMainlineModuleInfo()

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

int getMaxNumberOfRunningUsersSupported()

Obtén la cantidad máxima de usuarios que se ejecutan de forma simultánea.

int getMaxNumberOfUsersSupported()

Obtén la cantidad máxima de usuarios admitidos.

Process getMicrodroidProcess()
IDeviceStateMonitor getMonitor()

Devuelve el IDeviceStateMonitor asociado con el dispositivo.

String getMountPoint(String mountName)

Muestra un punto de activación.

ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

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

getMountPointInfo()

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

TestDeviceOptions getOptions()

Recupera las opciones de prueba del dispositivo.

long getPartitionFreeSpace(String partition)

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

Integer getPrimaryUserId()

Muestra el ID de usuario principal.

ProcessInfo getProcessByName(String processName)

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

String getProcessPid(String process)

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

String getProductType()

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

String getProductVariant()

Es un método de conveniencia para obtener la variante de producto de este dispositivo.

String getProperty(String name)

Recupera el valor de la propiedad determinada del dispositivo.

ITestDevice.RecoveryMode getRecoveryMode()

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

InputStreamSource getScreenshot(long displayId)

Toma una captura de pantalla del dispositivo con el ID de visualización determinado.

InputStreamSource getScreenshot(String format)

Toma una captura de pantalla del dispositivo.

InputStreamSource getScreenshot(String format, boolean rescale)

Toma una captura de pantalla del dispositivo.

InputStreamSource getScreenshot()

Toma una captura de pantalla del dispositivo.

String getSerialNumber()

Es un método conveniente para obtener el número de serie de este dispositivo.

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

Muestra el valor de la configuración solicitada.

String getSetting(String namespace, String key)

Consulta getSetting(int, String, String) y realiza la acción en el usuario del sistema.

String getSimOperator()

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

String getSimState()

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

getTombstones()

Recupera y muestra la lista de lápidas de los dispositivos.

long getTotalMemory()

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

String getTrackingSerial()

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

getUninstallablePackageNames()

Recupera los nombres de los paquetes de la aplicación que se pueden desinstalar.

boolean getUseFastbootErase()

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

int getUserFlags(int userId)

Busca y muestra las marcas de un usuario determinado.

getUserInfos()

Obtiene el mapa de useId a UserInfo en el dispositivo.

int getUserSerialNumber(int userId)

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

IManagedTestDevice.DeviceEventResponse handleAllocationEvent(DeviceEvent event)

Procesa el DeviceEvent determinado.

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

boolean hasFeature(String feature)

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

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

Instala un paquete de Android en el dispositivo.

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

Instala un paquete de Android en el dispositivo.

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

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

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

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

void invalidatePropertyCache()
boolean isAdbRoot()

boolean isAdbTcp()
boolean isAppEnumerationSupported()

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

boolean isBypassLowTargetSdkBlockSupported()

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

boolean isDebugfsMounted()

Verifica si el elemento debugfs está activado.

boolean isDeviceEncrypted()

Muestra si el dispositivo está encriptado.

boolean isDirectory(String path)

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

boolean isEnableAdbRoot()
boolean isEncryptionSupported()

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

boolean isExecutable(String fullPath)

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

boolean isFastbootEnabled()

Muestra si fastboot está disponible para el dispositivo.

boolean isHeadless()

Muestra verdadero si el dispositivo no tiene pantalla (sin pantalla); de lo contrario, muestra falso.

boolean isHeadlessSystemUserMode()

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

boolean isMainUserPermanentAdmin()

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

boolean isMultiUserSupported()

Determina si se admite multiusuario.

boolean isPackageInstalled(String packageName, String userId)

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

boolean isPackageInstalled(String packageName)

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

boolean isRuntimePermissionSupported()

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

boolean isStateBootloaderOrFastbootd()

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

boolean isUserRunning(int userId)

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

boolean isUserSecondary(int userId)

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

boolean isUserVisible(int userId)

Verifica si el usuario determinado es visible.

boolean isUserVisibleOnDisplay(int userId, int displayId)

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

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

Devuelve si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano en ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

boolean isVisibleBackgroundUsersSupported()

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

boolean isWifiEnabled()

Prueba si la red Wi-Fi está habilitada.

listDisplayIds()

Recopila la lista de IDs de pantallas disponibles en el dispositivo, como lo informa "dumpsys SurfaceFlinger".

listDisplayIdsForStartingVisibleBackgroundUsers()

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

listUsers()

Obtiene la lista de usuarios del dispositivo.

boolean logAnrs(ITestLogger logger)

Recopila y registra errores ANR del dispositivo.

boolean logBugreport(String dataName, ITestLogger listener)

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

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

Registra un mensaje en el logcat del dispositivo.

void mountDebugfs()

Activa debugfs.

void nonBlockingReboot()

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

void postAdbRootAction()

Anula esta opción si el dispositivo necesita que se realicen algunas acciones específicas después de adb root y antes de que el dispositivo vuelva a estar en línea.

void postAdbUnrootAction()

Anula esta opción si el dispositivo necesita que se realicen algunas acciones específicas después de que adb quite el estado de root y antes de que el dispositivo vuelva a estar en línea.

void postBootSetup()

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

void postInvocationTearDown(Throwable exception)

Hay pasos adicionales para la limpieza específica del dispositivo que se requiere, que se ejecutará una vez que se complete la invocación.

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

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

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

Extrae contenido del directorio del dispositivo de manera recurrente.

boolean pullDir(String deviceFilePath, File localDir)

Extrae de forma recursiva el contenido del directorio del dispositivo.

boolean pullFile(String remoteFilePath, File localFile)

Recupera un archivo fuera del dispositivo.

File pullFile(String remoteFilePath, int userId)

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

File pullFile(String remoteFilePath)

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

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

Recupera un archivo fuera del dispositivo.

String pullFileContents(String remoteFilePath)

Recupera un archivo del dispositivo y muestra su contenido.

File pullFileFromExternal(String remoteFilePath)

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

boolean pushDir(File localFileDir, String deviceFilePath, excludedDirectories)

Envía de manera recurrente el contenido del directorio al dispositivo y, al mismo tiempo, excluye algunos directorios filtrados.

boolean pushDir(File localFileDir, String deviceFilePath)

Envía de manera recurrente el contenido del directorio al dispositivo.

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

Envía de manera recurrente el contenido del directorio al dispositivo.

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

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

boolean pushFile(File localFile, String remoteFilePath)

Envía un archivo al dispositivo.

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

Envía un archivo al dispositivo.

boolean pushString(String contents, String remoteFilePath)

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

void reboot(String reason)

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

void reboot()

Reinicia el dispositivo en modo ADB.

void rebootIntoBootloader()

Reinicia el dispositivo en el modo bootloader.

void rebootIntoFastbootd()

Reinicia el dispositivo en modo fastbootd.

void rebootIntoRecovery()

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

void rebootIntoSideload()

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

Se bloquea hasta que el dispositivo entre en modo de transferencia

void rebootIntoSideload(boolean autoReboot)

Reinicia el dispositivo en el modo de transferencia de adb (ten en cuenta que se trata de un modo especial en recuperación).

Bloquea hasta que el dispositivo entre en modo de carga lateral.

void rebootUntilOnline()

Es un método alternativo a reboot() que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.

void rebootUntilOnline(String reason)

Es un método alternativo a reboot() que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.

void rebootUserspace()

Reinicia solo la parte del espacio de usuario del dispositivo.

void rebootUserspaceUntilOnline()

Es un método alternativo a rebootUserspace() ()} que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.

boolean recoverDevice()

Intenta recuperar la comunicación del dispositivo.

void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Registra un IDeviceActionReceiver para este dispositivo.

void remountSystemReadOnly()

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

void remountSystemWritable()

Haz que se pueda escribir en la partición del sistema del dispositivo.

void remountVendorReadOnly()

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

void remountVendorWritable()

Permitir que se pueda escribir en la partición del proveedor en el dispositivo.

boolean removeAdmin(String componentName, int userId)

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

void removeOwners()

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

boolean removeUser(int userId)

Quita a un usuario determinado del dispositivo.

void resetContentProviderSetup()

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

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

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

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

Ejecuta pruebas de instrumentación y proporciona recuperación de dispositivos.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)

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

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

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

void setConfiguration(IConfiguration configuration)

Inyecta el IConfiguration en uso.

final void setConnectionAvdInfo(GceAvdInfo avdInfo)
void setDate(Date date)

Establece la fecha en el dispositivo.

Nota: Para configurar la fecha en el dispositivo, se requiere acceso de raíz.

boolean setDeviceOwner(String componentName, int userId)

Establece un componente de administración de dispositivos como propietario para un usuario determinado.

void setDeviceState(TestDeviceState deviceState)

Actualiza el estado del dispositivo.

void setEmulatorOutputStream(SizeLimitedOutputStream output)

Para el emulador, establece SizeLimitedOutputStream para registrar el resultado

void setEmulatorProcess(Process p)

Establece el Process, cuando este dispositivo es un emulador.

void setFastbootEnabled(boolean fastbootEnabled)

Establece la opción de fastboot para el dispositivo.

void setFastbootPath(String fastbootPath)

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

void setIDevice(IDevice newDevice)

Actualiza el IDevice asociado con este ITestDevice.

void setLogStartDelay(int delay)

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

void setOptions(TestDeviceOptions options)

Establece el TestDeviceOptions para el dispositivo

boolean setProperty(String propKey, String propValue)

Establece el valor de la propiedad determinada en el dispositivo.

void setRecovery(IDeviceRecovery recovery)

Establece el IDeviceRecovery que se usará para este dispositivo.

void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

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

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

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

Agrega un valor de configuración al espacio de nombres de un usuario determinado.

void setTestLogger(ITestLogger testLogger)

Inyecta la instancia de ITestLogger

void setTrackingSerial(String trackingSerial)

Para la administración de dispositivos, haz un seguimiento del número de serie que usamos como referencia del dispositivo.

void setUseFastbootErase(boolean useFastbootErase)

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

void startLogcat()

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

boolean startUser(int userId)

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

boolean startUser(int userId, boolean waitFlag)

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

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

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

void stopEmulatorOutput()

Cierra y borra el resultado del emulador.

void stopLogcat()

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

boolean stopUser(int userId)

Detiene a un usuario determinado.

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

Detener a un usuario determinado

String switchToAdbTcp()

Cambia el dispositivo al modo adb-over-tcp.

boolean switchToAdbUsb()

Cambia el dispositivo al modo adb mediante USB.

boolean switchUser(int userId)

Cambia a otro userId con un tiempo de espera predeterminado.

boolean switchUser(int userId, long timeout)

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

boolean syncFiles(File localFileDir, String deviceFilePath)

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

Bugreport takeBugreport()

Toma un informe de errores y devuélvelo dentro de un objeto Bugreport para controlarlo.

String uninstallPackage(String packageName)

Desinstala un paquete de Android del dispositivo.

String uninstallPackageForUser(String packageName, int userId)

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

boolean unlockDevice()

Desbloquea el dispositivo si está encriptado.

void unmountDebugfs()

Desactiva debugfs.

boolean waitForBootComplete(long timeOut)

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

boolean waitForDeviceAvailable()

Espera a que el dispositivo sea responsivo y esté disponible para realizar pruebas.

boolean waitForDeviceAvailable(long waitTime)

Espera a que el dispositivo sea responsivo y esté disponible para realizar pruebas.

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Espera a que el dispositivo sea responsivo y esté disponible sin considerar la ruta de recuperación.

void waitForDeviceBootloader()

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

boolean waitForDeviceInRecovery(long waitTime)

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

boolean waitForDeviceInSideload(long waitTime)

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

boolean waitForDeviceNotAvailable(long waitTime)

Bloqueos para que el dispositivo no esté disponible, es decir, falta en adb

void waitForDeviceOnline()

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

void waitForDeviceOnline(long waitTime)

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

boolean waitForDeviceShell(long waitTime)

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

Métodos protegidos

void addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
String[] buildAdbShellCommand(String command, boolean forceExitStatusDetection)

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

void checkApiLevelAgainst(String feature, int strictMinLevel)
NativeDevice.RebootDeviceAction createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)

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

IRunUtil createRunUtil()
void doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)

Realiza un reinicio de adb.

void ensureRuntimePermissionSupported()

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

int getApiLevelSafe()
ITestLogger getLogger()
IRunUtil getRunUtil()

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

void initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
String internalGetProperty(String propName, String fastbootVar, String description)

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

boolean isInRebootCallback()

Muestra si las devoluciones de llamada de reinicio se están ejecutando actualmente o no.

boolean isNewer(File localFile, IFileEntry entry)

Muestra true si el archivo local es más reciente que el archivo remoto.

void notifyRebootEnded()

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

void notifyRebootStarted()

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

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

Realiza una acción en este dispositivo.

void postAdbReboot()

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

void prePostBootSetup()

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

boolean pullFileInternal(String remoteFilePath, File localFile)
void setClock(Clock clock)

Establece la instancia de reloj que se usará.

void setMicrodroidProcess(Process process)

Marca TestDevice como microdroid y establece su CID.

void setTestDeviceOptions( deviceOptions)
CommandResult simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)

Ejecuta un comando fastboot simple con variables de entorno y, además, informa el estado del comando.

CommandResult simpleFastbootCommand(long timeout, String[] fullCmd)

Ejecuta un comando fastboot simple y, luego, informa el estado del comando.

boolean waitForDeviceNotAvailable(String operationDesc, long time)

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

Constantes

INVALID_USER_ID

public static final int INVALID_USER_ID

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

Valor constante: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Valor constante: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

la cantidad predeterminada de reintentos de comandos que se deben realizar

Valor constante: 2 (0x00000002)

Campos

RUTA_DE_BUGFS

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Constructores públicos

Dispositivo nativo

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

Crea un TestDevice.

Parámetros
device IDevice: El IDevice asociado

stateMonitor IDeviceStateMonitor: Es el mecanismo IDeviceStateMonitor que se usará.

allocationMonitor IDeviceMonitor: El IDeviceMonitor para informar sobre los cambios de estado de asignación. Puede ser nulo

Métodos públicos

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Microoptimización (alrededor de 400 milis) mediante la carga previa de todas las props que necesitamos, en lugar de llamar a "adb getprop" para cada una; es decir, obtener todas las propiedades es tan rápido como recuperar una. Elementos como device.getApiLevel(), checkApiLevelAgainstNextRelease y getBuildAlias llaman a "adb getprop" en segundo plano. Los recuperamos en una llamada y llamamos a NativeDevice.setProperty. Incluso si no hacemos esto, NativeDevice llamará a setProperty y almacenará en caché el resultado para llamadas futuras. Solo lo hacemos un poco antes. Si el dispositivo está en modo de recuperación o hay otros errores para recuperar los elementos, los ignoramos.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Muestra
boolean

Arroja
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

Arroja
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity ()

Verifica que el dispositivo tenga conectividad de red.

Muestra
boolean true si el dispositivo tiene una conexión de red que funciona, false de lo contrario.

Arroja
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

Muestra
boolean true si no hay diálogos o si se borraron correctamente. false en caso contrario.

Arroja
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

Borra los datos de Logcat acumulados.

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

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Se conecta a una red Wi-Fi.

Activa el Wi-Fi y 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 SSID de Wi-Fi a contraseñas.

scanSsid boolean: Indica si se deben buscar SSID ocultos de esta red.

Muestra
boolean true si se conecta correctamente a la red Wi-Fi. false de lo contrario

Arroja
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Se conecta a una red Wi-Fi.

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

Parámetros
wifiSsid String: El SSID de Wi-Fi al que te conectarás

wifiPsk String: La frase de contraseña del PSK o un valor nulo si no está encriptada

Muestra
boolean true si se conectó correctamente a la red Wi-Fi. false otherwise

Arroja
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Se conecta a una red Wi-Fi.

Activa la red Wi-Fi y la bloquea hasta que se establezca una conexión correcta con una de las redes Wi-Fi que se 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 SSID de Wi-Fi a contraseñas.

Muestra
boolean true si se conecta correctamente a la red Wi-Fi. false de lo contrario

Arroja
DeviceNotAvailableException

connectToWifiNetwork

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

Se conecta a una red Wi-Fi.

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

Parámetros
wifiSsid String: El SSID de Wi-Fi al que te conectarás

wifiPsk String: La frase de contraseña del PSK o un valor nulo si no está encriptada

scanSsid boolean: Indica si se debe buscar un SSID oculto de esta red.

Muestra
boolean true si se conectó correctamente a la red Wi-Fi. false otherwise

Arroja
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

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

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

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

Muestra
boolean true si se conectó correctamente a la red Wi-Fi. false otherwise

Arroja
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Muestra
boolean true si se conectó correctamente a la red Wi-Fi. false otherwise

Arroja
DeviceNotAvailableException

createUser

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

Crea un usuario con un nombre determinado y las marcas proporcionadas

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

guest boolean: Habilita la marca de usuario --guest durante la creación.

ephemeral boolean: Habilita la marca del usuario --ephemeral durante la creación.

Muestra
int ID del usuario creado

Arroja
DeviceNotAvailableException

createUser

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

Crea un usuario con un nombre determinado y las marcas proporcionadas

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

guest boolean: Habilita la marca de usuario --guest durante la creación.

ephemeral boolean: Habilita la marca del usuario --ephemeral durante la creación.

forTesting boolean: Habilita la marca de prueba --for-testing durante la creación

Muestra
int ID del usuario creado

Arroja
DeviceNotAvailableException

createUser

public int createUser (String name)

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

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

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

Arroja
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

Arroja
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

userId int: Es el ID de usuario del que se borrará.

Arroja
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath)

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

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

Arroja
DeviceNotAvailableException

anular el registro deDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Quita el IDeviceActionReceiver registrado.

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

Reinicio en segundo plano del dispositivo

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

Arroja
DeviceNotAvailableException

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

Parámetros
utcEpochTime long: Es la hora del dispositivo en segundos desde la época.

timeUnit TimeUnit: Es la unidad de tiempo TimeUnit para el utcEpochTime determinado.

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

Arroja
DeviceNotAvailableException

inhabilitarAdbRoot

public boolean disableAdbRoot ()

Desactiva el acceso raíz de adb.

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

Muestra
boolean true si se realiza correctamente.

Arroja
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

Intenta inhabilitar el bloqueo de teclas.

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

Arroja
DeviceNotAvailableException

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Inhabilita la supervisión de red en el dispositivo.

Muestra
boolean Es true si la supervisión se inhabilitó correctamente. false si falló.

Arroja
DeviceNotAvailableException

disconnectFromWifi

public boolean disconnectFromWifi ()

Se desconecta de una red Wi-Fi.

Quita todas las redes de la lista de redes conocidas e inhabilita el Wi-Fi.

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

Arroja
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Es un método auxiliar para determinar si existe un archivo en el dispositivo para un usuario determinado.

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

userId int: Es el ID de usuario con el que se debe verificar la existencia del archivo.

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

Arroja
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

Arroja
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Intenta volcar el montón desde system_server. El llamador es responsable de limpiar el archivo volcado.

Parámetros
process String: Es el nombre del proceso del dispositivo en el que se volcará el heap.

devicePath String: Es la ruta de acceso en el dispositivo donde se debe colocar el volcado. Debe ser una ubicación donde los permisos lo permitan.

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

Arroja
DeviceNotAvailableException

enableAdbRoot

public boolean enableAdbRoot ()

Activa el permiso de administrador de adb. Si el parámetro de configuración "enable-root" es "false", se registrará un mensaje y se mostrará sin habilitar el permiso de administrador.

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

Muestra
boolean true si se realiza correctamente.

Arroja
DeviceNotAvailableException

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Habilita la supervisión de red en el dispositivo.

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

Arroja
DeviceNotAvailableException

executeAdbCommand

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

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

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

Parámetros
timeout long: Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Es 0L si no hay tiempo de espera.

cmdArgs String: Es el comando adb y los argumentos para ejecutar.

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

Arroja
DeviceNotAvailableException

executeAdbCommand

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

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

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

Parámetros
timeout long: Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Es 0L si no hay tiempo de espera.

envMap : Es el entorno que se establecerá para el comando.

cmdArgs String: El comando adb y los argumentos para ejecutar

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

Arroja
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

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

Arroja
DeviceNotAvailableException

EjecutarFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

Parámetros
cmdArgs String: Es el comando fastboot y los argumentos para ejecutar.

Muestra
CommandResult El CommandResult que contiene el resultado del comando

Arroja
DeviceNotAvailableException

executeFastbootCommand

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

Es un método de ayuda que ejecuta un comando fastboot como un comando del sistema.

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

Parámetros
timeout long: Es el tiempo en milisegundos antes de que venza el comando

cmdArgs String: Es el comando fastboot y los argumentos para ejecutar.

Muestra
CommandResult El CommandResult que contiene el resultado del comando

Arroja
DeviceNotAvailableException

ejecutarLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

Parámetros
cmdArgs String: Es el comando fastboot y los argumentos para ejecutar.

Muestra
CommandResult El CommandResult que contiene el resultado del comando

Arroja
DeviceNotAvailableException

executeLongFastbootCommand

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

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

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

Parámetros
envVarMap : Las variables de entorno del sistema con las que se ejecuta el comando fastboot

cmdArgs String: El comando fastboot y los argumentos para ejecutar

Muestra
CommandResult El CommandResult que contiene el resultado del comando

Arroja
DeviceNotAvailableException

executeShellCommand

public String executeShellCommand (String command)

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

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

Muestra
String el resultado del shell

Arroja
DeviceNotAvailableException

executeShellCommand

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

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

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

receiver IShellOutputReceiver: Es el IShellOutputReceiver al que se dirigirá el resultado de la shell.

maxTimeToOutputShellResponse long: Es la cantidad máxima de tiempo durante la cual el comando puede no mostrar ninguna respuesta. La unidad se especifica en timeUnit.

timeUnit TimeUnit: Unidad de maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si se realiza retryAttempts sin éxito.

Arroja
DeviceNotAvailableException

executeShellCommand

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

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

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

receiver IShellOutputReceiver: Es el IShellOutputReceiver al que se dirigirá el resultado de la shell.

maxTimeoutForCommand long: Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en timeUnit.

maxTimeToOutputShellResponse long: Es la cantidad máxima de tiempo durante la cual el comando puede no mostrar ninguna respuesta. La unidad se especifica en timeUnit.

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si se realiza retryAttempts sin éxito.

Arroja
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

receiver IShellOutputReceiver: Es el IShellOutputReceiver al que se dirigirá el resultado de la shell.

Arroja
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un CommandResult propagado correctamente con el resultado del estado del comando, stdout y stderr.

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

Muestra
CommandResult El resultado en CommandResult.

Arroja
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

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

pipeToOutput OutputStream: ERROR(/OutputStream), donde se redireccionará el resultado estándar, o bien nulo.

Muestra
CommandResult El resultado en CommandResult.

Arroja
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como una CommandResult propagada correctamente con el resultado del estado del comando, stdout y stderr.

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

pipeAsInput File: Es un ERROR(/File) que se pasará como entrada al comando o será nulo.

Muestra
CommandResult El resultado en CommandResult.

Arroja
DeviceNotAvailableException

Comando runShellV2

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

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

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

maxTimeoutForCommand long: Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en timeUnit.

timeUnit TimeUnit: Unidad de maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponseException si retryAttempts se ejecuta sin éxito.

Muestra
CommandResult

Arroja
DeviceNotAvailableException

Comando runShellV2

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

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

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

maxTimeoutForCommand long: Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en timeUnit.

timeUnit TimeUnit: Unidad de maxTimeToOutputShellResponse

Muestra
CommandResult

Arroja
DeviceNotAvailableException

Comando runShellV2

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

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

Parámetros
cmd String: Es el comando del shell de adb que se ejecutará.

pipeAsInput File: Es un ERROR(/File) que se pasará como entrada al comando o será nulo.

pipeToOutput OutputStream: ERROR(/OutputStream), donde se redireccionará el resultado estándar, o bien nulo.

maxTimeoutForCommand long: Es el tiempo de espera máximo para que se complete el comando; unidad como se especifica en timeUnit.

timeUnit TimeUnit: Unidad de maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponseException si retryAttempts se ejecuta sin éxito.

Muestra
CommandResult

Arroja
DeviceNotAvailableException

Comando runShellV2

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

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

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

pipeAsInput File: Es un ERROR(/File) que se pasará como entrada al comando o será nulo.

pipeToOutput OutputStream: ERROR(/OutputStream), donde se redireccionará el resultado estándar, o bien nulo.

pipeToError OutputStream: ERROR(/OutputStream), donde se redireccionará el error estándar, o nulo.

maxTimeoutForCommand long: Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en timeUnit.

timeUnit TimeUnit: Unidad de maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponseException si retryAttempts se ejecuta sin éxito.

Muestra
CommandResult

Arroja
DeviceNotAvailableException

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

Se debe usar cuando el dispositivo ya está en Modo fastboot [Fastboot mode].

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

Muestra
CommandResult El CommandResult que contiene el resultado del comando

Arroja
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

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

Arroja
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

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

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

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

Arroja
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

Muestra el estado de asignación actual del dispositivo

Muestra
DeviceAllocationState

getAndroidId

public String getAndroidId (int userId)

Busca y muestra el android-id asociado con un userId (valor nulo si no se encuentra).

Parámetros
userId int

Muestra
String

Arroja
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

Crea un mapa de los ID de Android encontrados que coincidan con los ID de usuario. No hay un seguro 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 el valor nulo.

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

Arroja
DeviceNotAvailableException

getApiLevel

public int getApiLevel ()

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

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

Arroja
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

Parámetros
packageName String

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

Arroja
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

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

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

Arroja
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

Es un método conveniente para obtener la versión de banda base (radio) de este dispositivo. La obtención de la versión de radio es específica del dispositivo, por lo que es posible que no muestre la información correcta de todos los dispositivos. Este método se basa en la propiedad gsm.version.baseband para mostrar la información de versión correcta. Esto no es preciso para algunos dispositivos CDMA, y es posible que la versión que se muestra aquí no coincida con la versión informada por fastboot ni muestre la versión de la radio CDMA. TL;DR este método solo informa la versión precisa si la propiedad gsm.version.baseband es la misma que la versión que muestra fastboot getvar version-baseband.

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

Arroja
DeviceNotAvailableException

getBattery

public Integer getBattery ()

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

Muestra
Integer

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Muestra el valor booleano de la propiedad determinada.

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

defaultValue boolean: Es el valor predeterminado que se muestra si la propiedad está vacía o no existe.

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

Arroja
DeviceNotAvailableException

getBootHistory

public  getBootHistory ()

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

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

Arroja
DeviceNotAvailableException

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

Parámetros
utcEpochTime long: Es el tiempo del dispositivo desde el ciclo de entrenamiento.

timeUnit TimeUnit: La unidad de tiempo TimeUnit.

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

Arroja
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

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

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

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

Arroja
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

Recupera un informe de errores del dispositivo.

Se garantiza que la implementación de esta función seguirá funcionando en un dispositivo sin una tarjeta SD (o cuando la tarjeta SD aún no está activada).

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

getBugreportz

public InputStreamSource getBugreportz ()

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

Solo es compatible con "adb version" > 1.0.36.

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

getBuildAlias

public String getBuildAlias ()

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

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

Muestra
String el alias de compilación o el ID de compilación si no se pudo recuperar

Arroja
DeviceNotAvailableException

getBuildFlavor.

public String getBuildFlavor ()

Recupera el tipo de compilación del dispositivo.

Muestra
String el tipo de compilación o nulo si no se pudo recuperar

Arroja
DeviceNotAvailableException

getBuildId

public String getBuildId ()

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

Muestra
String el ID de compilación o IBuildInfo#UNKNOWN_BUILD_ID si no se pudo recuperar

Arroja
DeviceNotAvailableException

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

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

Arroja
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Muestra
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Muestra
DeviceDescriptor

getChildren

public String[] getChildren (String path)

Es una alternativa al uso de IFileEntry que, a veces, no funciona debido a los permisos.

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

Muestra
String[] Array de cadena que contiene todo el archivo de una ruta de acceso en el dispositivo.

Arroja
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

La conexión actual asociada con el dispositivo.

Muestra
AbstractConnection

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

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

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

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

Muestra
ContentProviderHandler

Arroja
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Muestra
DeviceFoldableState

Arroja
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Muestra el ID del usuario en ejecución actual. En caso de error, muestra -10000.

Muestra
int

Arroja
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

Obtén la clase del dispositivo.

Muestra
String la clase de dispositivo String.

getDeviceDate

public long getDeviceDate ()

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

Muestra
long la fecha del dispositivo en formato de época

Arroja
DeviceNotAvailableException

getDeviceDescriptor.

public DeviceDescriptor getDeviceDescriptor ()

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

Muestra
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Muestra
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

Obtén el estado del dispositivo.

Muestra
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Es una herramienta de ayuda para obtener la diferencia de hora entre el dispositivo y un ERROR(/Date) determinado. Usa el tiempo de época a nivel interno.

Parámetros
date Date

Muestra
long la diferencia en milisegundos

Arroja
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

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

Muestra
InputStreamSource resultado del emulador

getEmulatorProcess

public Process getEmulatorProcess ()

Muestra el Process correspondiente a este emulador.

Muestra
Process el Process o null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

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

Muestra
File

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

Muestra
long la cantidad de espacio libre en KB

Arroja
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

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

Muestra
String

getFastbootProductType

public String getFastbootProductType ()

Es un método conveniente para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.

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

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

Arroja
DeviceNotAvailableException

getFastbootProductVariant

public String getFastbootProductVariant ()

Es un método conveniente para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.

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

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

Arroja
DeviceNotAvailableException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Devuelve el número de serie del modo fastboot.

Muestra
String

getFastbootVariable

public String getFastbootVariable (String variableName)

Recupera el valor de la variable de fastboot específico del dispositivo.

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

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

Arroja
DeviceNotAvailableException

getFastbootVersion

public String getFastbootVersion ()

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

Muestra
String

getFileEntry

public IFileEntry getFileEntry (String path)

Recupera una referencia a un archivo remoto en el dispositivo.

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

Muestra
IFileEntry el IFileEntry o null si no se puede encontrar el archivo en path determinado

Arroja
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

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

Muestra
IFileEntry Un FileEntryWrapper que representa el FileEntry.

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

Muestra

Arroja
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

Devuelve una referencia al IDevice de ddmlib asociado.

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

Muestra
IDevice IDevice

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

Arroja
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Muestra el valor entero de la propiedad determinada desde el dispositivo.

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

defaultValue long: Es el valor predeterminado que se muestra si la propiedad está vacía o no existe.

Muestra
long el valor de la propiedad o defaultValue si la propiedad está vacía, no existe o no tiene un valor de número entero

Arroja
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

Obtiene la dirección IP del dispositivo.

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

Arroja
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

Arroja
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

Muestra
long

getLaunchApiLevel

public int getLaunchApiLevel ()

Obtener el primer nivel de API iniciado en el dispositivo La configuración predeterminada es UNKNOWN_API_LEVEL.

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

Arroja
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

Captura una transmisión de instantáneas de los datos de Logcat.

Funciona en dos modos:

  • Si el logcat se está capturando en segundo plano, mostrará hasta TestDeviceOptions.getMaxLogcatDataSize() bytes del contenido actual de la captura de logcat en segundo plano.
  • De lo contrario, se mostrará un volcado estático de los datos de logcat si el dispositivo está respondiendo.

    Muestra
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

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

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

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

    Muestra
    InputStreamSource

    getLogcatDump

    public InputStreamSource getLogcatDump ()

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

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

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

    getLogcatSince

    public InputStreamSource getLogcatSince (long date)

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

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

    Muestra
    InputStreamSource

    getMacAddress

    public String getMacAddress ()

    Devuelve la dirección MAC del dispositivo, nula si no se puede consultar desde el dispositivo.

    Muestra
    String

    getMainUserId

    public Integer getMainUserId ()

    Muestra el ID de usuario principal.

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

    Arroja
    DeviceNotAvailableException

    getMainlineModuleInfo

    public  getMainlineModuleInfo ()

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

    Muestra
    Hay ERROR(/Set) de String módulos de línea principales instalados en el dispositivo actualmente.

    Arroja
    DeviceNotAvailableException

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

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

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

    Arroja
    DeviceNotAvailableException

    getMaxNumberOfUsersSupported

    public int getMaxNumberOfUsersSupported ()

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

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

    Arroja
    DeviceNotAvailableException

    getMicrodroidProcess

    public Process getMicrodroidProcess ()

    Muestra
    Process Muestra el proceso de la VM de Microdroid. Si TestDevice no es un Microdroid, muestra un valor nulo.

    getMonitor

    public IDeviceStateMonitor getMonitor ()

    Muestra el IDeviceStateMonitor asociado con el dispositivo.

    Muestra
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

    Muestra un punto de activación.

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

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

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

    Muestra
    String el punto de activación o null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Parámetros
    mountpoint String

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

    Arroja
    DeviceNotAvailableException

    getMountPointInfo

    public  getMountPointInfo ()

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

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

    Arroja
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

    Recupera las opciones de prueba del dispositivo.

    Muestra
    TestDeviceOptions TestDeviceOptions relacionado con el dispositivo de prueba.

    getPartitionFreeSpace

    public long getPartitionFreeSpace (String partition)

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

    Parámetros
    partition String

    Muestra
    long la cantidad de espacio libre en KB

    Arroja
    DeviceNotAvailableException

    getPrimaryUserId

    public Integer getPrimaryUserId ()

    Muestra el ID de usuario principal.

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

    Arroja
    DeviceNotAvailableException

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

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

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

    Muestra
    ProcessInfo ProcessInfo del proceso processName determinado

    Arroja
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

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

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

    Muestra
    String

    Arroja
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

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

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

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

    Arroja
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

    Es un método de conveniencia para obtener la variante de producto de este dispositivo.

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

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

    Arroja
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

    Recupera el valor de la propiedad determinada del dispositivo.

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

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

    Arroja
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

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

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

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

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

    Arroja
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format)

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

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

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

    Arroja
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

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

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

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

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

    Arroja
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot ()

    Toma una captura de pantalla del dispositivo.

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

    Arroja
    DeviceNotAvailableException

    getSerialNumber

    public String getSerialNumber ()

    Es un método conveniente para obtener el número de serie de este dispositivo.

    Muestra
    String el número de serie String

    getSetting

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

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

    Parámetros
    userId int

    namespace String

    key String

    Muestra
    String el valor asociado con el espacio de nombres:clave de un usuario. Es nulo si no se encuentra.

    Arroja
    DeviceNotAvailableException

    getSetting

    public String getSetting (String namespace, 
                    String key)

    Consulta getSetting(int, String, String) y realiza la acción en el usuario del sistema.

    Parámetros
    namespace String

    key String

    Muestra
    String

    Arroja
    DeviceNotAvailableException

    getSimOperator

    public String getSimOperator ()

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

    Muestra
    String

    getSimState

    public String getSimState ()

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

    Muestra
    String

    getTombstones

    public  getTombstones ()

    Recupera y muestra la lista de lápidas de los dispositivos. Requiere permisos de administrador.

    es el mejor esfuerzo, de modo que, si una tombstone no se puede extraer por algún motivo, no estará en la lista. Solo un DeviceNotAvailableException finalizará el método antes de tiempo.

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

    Arroja
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

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

    Muestra
    long

    getTrackingSerial

    public String getTrackingSerial ()

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

    Muestra
    String

    getUninstallablePackageNames

    public  getUninstallablePackageNames ()

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

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

    Arroja
    DeviceNotAvailableException

    getUseFastbootBorrar

    public boolean getUseFastbootErase ()

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

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

    getUserFlags

    public int getUserFlags (int userId)

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

    Parámetros
    userId int

    Muestra
    int las marcas asociadas con el userId proporcionado si se encuentra, -10000 en cualquier otro caso

    Arroja
    DeviceNotAvailableException

    getUserInfos

    public  getUserInfos ()

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

    Muestra
    la lista de objetos UserInfo.

    Arroja
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

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

    Parámetros
    userId int

    Muestra
    int

    Arroja
    DeviceNotAvailableException

    handleAllocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Procesa el DeviceEvent determinado. Es posible que transfiera el dispositivo a un estado nuevo. Informará a IDeviceMonitor sobre cualquier transición de estado.

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

    Parámetros
    event DeviceEvent

    Muestra
    IManagedTestDevice.DeviceEventResponse

    hasFeature

    public boolean hasFeature (String feature)

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

    Parámetros
    feature String: Corresponde al formato que debe ser directamente "feature:" o "".

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

    Arroja
    DeviceNotAvailableException

    installPackage

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

    Instala un paquete de Android en el dispositivo.

    Parámetros
    packageFile File: Es el archivo APK que se instalará.

    reinstall boolean: Es la true si se debe reinstalar el sistema.

    extraArgs String: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para conocer las opciones disponibles.

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

    Arroja
    DeviceNotAvailableException

    installPackage

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

    Instala un paquete de Android en el dispositivo.

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

    Parámetros
    packageFile File: Es el archivo APK que se instalará.

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

    grantPermissions boolean: Si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación.

    extraArgs String: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

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

    Arroja
    DeviceNotAvailableException

    instalarPackageForUser

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

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

    Parámetros
    packageFile File: Es el archivo APK que se instalará.

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

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

    extraArgs String: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

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

    Arroja
    DeviceNotAvailableException

    instalarPackageForUser

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

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

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

    Parámetros
    packageFile File: Es el archivo APK que se instalará.

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

    grantPermissions boolean: Indica si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación.

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

    extraArgs String: Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles.

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

    Arroja
    DeviceNotAvailableException

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

    Muestra
    boolean

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

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

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

    Arroja
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

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

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

    Arroja
    DeviceNotAvailableException

    isDebugfsMounted

    public boolean isDebugfsMounted ()

    Verifica si debugfs está activado.

    Muestra
    boolean true si se activa debugfs

    Arroja
    DeviceNotAvailableException

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

    Muestra si el dispositivo está encriptado.

    Muestra
    boolean true si el dispositivo está encriptado.

    Arroja
    DeviceNotAvailableException

    isDirectory

    public boolean isDirectory (String path)

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

    Parámetros
    path String

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    isEnableAdbRoot

    public boolean isEnableAdbRoot ()

    Muestra
    boolean true si se debe habilitar el permiso de administrador de adb en el dispositivo

    isEncryptionSupported

    public boolean isEncryptionSupported ()

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

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

    Arroja
    DeviceNotAvailableException

    isExecutable

    public boolean isExecutable (String fullPath)

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

    Parámetros
    fullPath String

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    isFastbootEnabled

    public boolean isFastbootEnabled ()

    Muestra si fastboot está disponible para el dispositivo.

    Muestra
    boolean

    isHeadless

    public boolean isHeadless ()

    Muestra verdadero si el dispositivo no tiene pantalla (sin pantalla); de lo contrario, muestra falso.

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    isHeadlessSystemUserMode

    public boolean isHeadlessSystemUserMode ()

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

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    isMainUserPermanentAdmin

    public boolean isMainUserPermanentAdmin ()

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

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    Compatibilidad con múltiples usuarios

    public boolean isMultiUserSupported ()

    Determina si se admite el modo multiusuario.

    Muestra
    boolean Es verdadero si se admite el uso multiusuario; de lo contrario, es falso.

    Arroja
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

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

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

    userId String: Es el ID de usuario para el que estamos verificando que se haya instalado el paquete. Si es nulo, se usará el usuario principal cero.

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

    Arroja
    DeviceNotAvailableException

    PaqueteInstalado

    public boolean isPackageInstalled (String packageName)

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

    Parámetros
    packageName String

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

    Arroja
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

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

    Muestra
    boolean Es verdadero si se admite el permiso de tiempo de ejecución. De lo contrario, es falso.

    Arroja
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

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

    Muestra
    boolean

    isUserRunning

    public boolean isUserRunning (int userId)

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

    Parámetros
    userId int

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

    Arroja
    DeviceNotAvailableException

    isUserSecondary

    public boolean isUserSecondary (int userId)

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

    Parámetros
    userId int

    Muestra
    boolean true si el usuario es secundario; de lo contrario, false

    Arroja
    DeviceNotAvailableException

    isUserVisible

    public boolean isUserVisible (int userId)

    Verifica si el usuario determinado es visible.

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

    Parámetros
    userId int

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    isUserVisibleOnDisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

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

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

    Parámetros
    userId int

    displayId int

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    isVisibleBackgroundUsersOnDefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

    Devuelve si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano en ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

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

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    isVisibleBackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

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

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

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    ¿Tiene Wi-Fi habilitado?

    public boolean isWifiEnabled ()

    Prueba si la red Wi-Fi está habilitada.

    Verifica si la red Wi-Fi está habilitada en el dispositivo. Es útil para confirmar el estado de Wi-Fi antes de las pruebas que no deben ejecutarse con Wi-Fi, p.ej., pruebas de datos móviles.

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

    Arroja
    DeviceNotAvailableException

    listDisplayIds

    public  listDisplayIds ()

    Recopila la lista de ID de pantallas disponibles en el dispositivo según lo informa "dumpsys SurfaceFlinger".

    Muestra
    Es la lista de pantallas. El valor predeterminado siempre muestra la pantalla predeterminada 0.

    Arroja
    DeviceNotAvailableException

    listDisplayIdsForStartingVisibleBackgroundUsers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    Muestra

    Arroja
    DeviceNotAvailableException

    usuarios de la lista

    public  listUsers ()

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

    Muestra
    la lista de IDs de usuario.

    Arroja
    DeviceNotAvailableException

    LogAnrs.

    public boolean logAnrs (ITestLogger logger)

    Recopila y registra errores ANR del dispositivo.

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

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

    Arroja
    DeviceNotAvailableException

    informe de errores de registro

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Es un método de ayuda para tomar un informe de errores y registrarlo en los generadores.

    Parámetros
    dataName String: Es el nombre con el que se informará el informe de errores.

    listener ITestLogger: Un ITestLogger para registrar el informe de errores.

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

    Dispositivo de acceso

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

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

    Parámetros
    tag String: Es la etiqueta con la que registramos nuestro mensaje en el logcat.

    level Log.LogLevel: Es el nivel de depuración del mensaje en el logcat.

    format String: Es el formato del mensaje.

    args Object: Los argumentos que se reemplazarán a través de String.format().

    mountDebugfs

    public void mountDebugfs ()

    Activa debugfs.

    Arroja
    DeviceNotAvailableException

    reinicio no bloqueado

    public void nonBlockingReboot ()

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

    Arroja
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postAdbUnrootAction

    public void postAdbUnrootAction ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public void postBootSetup ()

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

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

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

    Es posible que deba llamarse cuando se reinicia el dispositivo debido a otros eventos (p. ej., cuando se completó un comando de actualización de fastboot).

    Arroja
    DeviceNotAvailableException

    postInvocationTearDown

    public void postInvocationTearDown (Throwable exception)

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

    Parámetros
    exception Throwable: Si existe, la excepción final que generó el error de invocación.

    Configuración previa a la invocación

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

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

    Parámetros
    info IBuildInfo: El IBuildInfo del dispositivo.

    attributes MultiMap: Son los atributos almacenados en el contexto de invocación.

    Arroja
    DeviceNotAvailableException
    TargetSetupError

    pullDir

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

    Extrae de forma recursiva el contenido del directorio del dispositivo.

    Parámetros
    deviceFilePath String: Es la ruta de acceso absoluta del archivo de la fuente remota.

    localDir File: El directorio local al que se extraerán archivos

    userId int: El ID del usuario del que se extraerá la información

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

    Arroja
    DeviceNotAvailableException

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Extrae de forma recursiva el contenido del directorio del dispositivo.

    Parámetros
    deviceFilePath String: Es la ruta de acceso absoluta del archivo de la fuente remota.

    localDir File: Es el directorio local al que se extraen los archivos.

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

    Arroja
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Recupera un archivo del dispositivo.

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

    localFile File: Es el archivo local en el que se almacenará el contenido. Si no está vacío, se reemplazará el contenido.

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

    Arroja
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath, 
                    int userId)

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

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

    userId int: El ID del usuario del que se extraerá la información

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

    Arroja
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

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

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

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

    Arroja
    DeviceNotAvailableException

    pullFile

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

    Recupera un archivo del dispositivo.

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

    localFile File: Es el archivo local en el que se almacenará el contenido. Si no está vacío, se reemplazará el contenido.

    userId int: El ID del usuario del que se extraerá la información

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

    Arroja
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    Recupera un archivo fuera del dispositivo y muestra el contenido.

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

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

    Arroja
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

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

    Parámetros
    remoteFilePath String: Es la ruta de acceso al archivo en el dispositivo, en relación con el punto de activación del almacenamiento externo del dispositivo.

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

    Arroja
    DeviceNotAvailableException

    PushDir

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

    Envía de manera recurrente el contenido del directorio al dispositivo y, al mismo tiempo, excluye algunos directorios filtrados.

    Parámetros
    localFileDir File: Es el directorio local que se enviará.

    deviceFilePath String: La ruta de acceso absoluta del archivo del destino remoto

    excludedDirectories : Es un conjunto de nombres de directorios excluidos que no se deben enviar.

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

    Arroja
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

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

    Parámetros
    localFileDir File: Es el directorio local que se enviará.

    deviceFilePath String: La ruta de acceso absoluta del archivo del destino remoto

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

    Arroja
    DeviceNotAvailableException

    pushDir

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

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

    Parámetros
    localFileDir File: Es el directorio local que se enviará.

    deviceFilePath String: Es la ruta de acceso absoluta al archivo del destino remoto.

    userId int: Es el ID de usuario al que se enviará el mensaje.

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

    Arroja
    DeviceNotAvailableException

    pushFile

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

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

    Parámetros
    localFile File: Es el archivo local que se enviará.

    remoteFilePath String: Es la ruta de acceso absoluta del archivo de destino remoto.

    evaluateContentProviderNeeded boolean: Indica si se debe verificar si necesitamos el proveedor de contenido.

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

    Arroja
    DeviceNotAvailableException

    Archivo push

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

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

    Parámetros
    localFile File: Es el archivo local que se enviará.

    remoteFilePath String: Es la ruta de acceso absoluta del archivo de destino remoto.

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

    Arroja
    DeviceNotAvailableException

    Archivo push

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

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

    Parámetros
    localFile File: Es el archivo local que se enviará.

    remoteFilePath String: Es la ruta de acceso absoluta del archivo de destino remoto.

    userId int: Es el userId al que se enviará.

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

    Arroja
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

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

    Parámetros
    contents String: Es el contenido del archivo que se enviará.

    remoteFilePath String: Es la ruta de acceso absoluta del archivo de destino remoto.

    Muestra
    boolean true si la cadena se envió correctamente. De lo contrario, false.

    Arroja
    DeviceNotAvailableException

    reiniciar

    public void reboot (String reason)

    Reinicia el dispositivo en modo adb con el reason determinado para que persista durante el reinicio.

    Se bloquea hasta que el dispositivo esté disponible.

    El motivo del último reinicio se puede obtener consultando la propiedad sys.boot.reason.

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

    Arroja
    DeviceNotAvailableException

    reiniciar

    public void reboot ()

    Reinicia el dispositivo en modo ADB.

    Se bloquea hasta que el dispositivo esté disponible.

    Arroja
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    Reinicia el dispositivo en el modo bootloader.

    Bloquea el dispositivo hasta que esté en modo de bootloader.

    Arroja
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    Reinicia el dispositivo en modo fastbootd.

    Se bloquea hasta que el dispositivo esté en modo de inicio rápido.

    Arroja
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

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

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

    Arroja
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

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

    Bloquea hasta que el dispositivo entre en modo de carga lateral.

    Arroja
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

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

    Bloquea hasta que el dispositivo entre en modo de carga lateral.

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

    Arroja
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

    Una alternativa a reboot() que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb

    Arroja
    DeviceNotAvailableException

    reiniciarHastaEn línea

    public void rebootUntilOnline (String reason)

    Es un método alternativo a reboot() que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.

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

    Arroja
    DeviceNotAvailableException

    espacio de usuario de reinicio

    public void rebootUserspace ()

    Reinicia solo una parte del espacio del usuario del dispositivo.

    Bloquea el dispositivo hasta que esté disponible.

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

    Arroja
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

    Es un método alternativo a rebootUserspace() ()} que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.

    Arroja
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Intenta recuperar la comunicación con el dispositivo.

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

    Arroja
    DeviceNotAvailableException si el dispositivo ya no está disponible

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Registra un IDeviceActionReceiver para este dispositivo.

    Se notificará a todos los IDeviceActionReceiver registrados antes de que comience una acción del dispositivo y después de que finalice.

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

    remountSystemReadOnly

    public void remountSystemReadOnly ()

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

    Arroja
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

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

    Arroja
    DeviceNotAvailableException

    remountVendor (solo lectura)

    public void remountVendorReadOnly ()

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

    Arroja
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

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

    Arroja
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

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

    Parámetros
    componentName String: Es el administrador de dispositivos que se quitará.

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

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

    Arroja
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

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

    Arroja
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    Quita a un usuario determinado del dispositivo.

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

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

    Arroja
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

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

    runInstrumentationTests

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

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

    Parámetros
    runner IRemoteAndroidTestRunner: Es el IRemoteAndroidTestRunner que ejecuta las pruebas.

    listeners ITestLifeCycleReceiver: Los objetos de escucha de resultados de prueba

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

    Arroja
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Ejecuta pruebas de instrumentación y proporciona recuperación de dispositivos.

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

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

    Parámetros
    runner IRemoteAndroidTestRunner: Es el IRemoteAndroidTestRunner que ejecuta las pruebas.

    listeners : Son los objetos de escucha del resultado de la prueba.

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

    Arroja
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

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

    Parámetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    runInstrumentationTestsComoUsuario

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

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

    Parámetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Inyecta el IConfiguration en uso.

    Parámetros
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Parámetros
    avdInfo GceAvdInfo

    Configurar Fecha

    public void setDate (Date date)

    Establece la fecha en el dispositivo.

    Nota: Para configurar la fecha en el dispositivo, se requiere acceso de raíz.

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

    Arroja
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

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

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

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

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

    Arroja
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Actualiza el estado del dispositivo.

    Parámetros
    deviceState TestDeviceState: el TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    Para el emulador, establece SizeLimitedOutputStream para registrar el resultado

    Parámetros
    output SizeLimitedOutputStream: Para registrar el resultado

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Establece el Process, cuando este dispositivo es un emulador.

    Parámetros
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

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

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

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Establece la ruta de acceso al objeto binario de fastboot que se debe usar. Aún requiere que isFastbootEnabled() sea verdadero para que se habiliten las funciones de Fastboot.

    Parámetros
    fastbootPath String

    SetIDevice

    public void setIDevice (IDevice newDevice)

    Actualiza el IDevice asociado con este ITestDevice.

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

    Parámetros
    newDevice IDevice: el IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

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

    Parámetros
    delay int: Es el retraso en ms.

    setOptions

    public void setOptions (TestDeviceOptions options)

    Establece el TestDeviceOptions para el dispositivo

    Parámetros
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

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

    Parámetros
    propKey String: Es la clave que se establecerá.

    propValue String: Es el valor de la propiedad que se establecerá.

    Muestra
    boolean Muestra True si el comando setprop se realizó correctamente; de lo contrario, muestra False.

    Arroja
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

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

    Parámetros
    recovery IDeviceRecovery: el IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

    setSetting

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

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

    Parámetros
    namespace String

    key String

    value String

    Arroja
    DeviceNotAvailableException

    setSetting

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

    Agrega un valor de configuración al espacio de nombres de un usuario determinado. Algunos parámetros de configuración solo estarán disponibles después de un reinicio. namespace debe ser una de las siguientes opciones: {"system", "secure", "global"}

    Parámetros
    userId int

    namespace String

    key String

    value String

    Arroja
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Inyecta la instancia de ITestLogger

    Parámetros
    testLogger ITestLogger

    setTrackingSerial

    public void setTrackingSerial (String trackingSerial)

    Para la administración de dispositivos, realiza un seguimiento del número de serie que usamos para referirnos al dispositivo.

    Parámetros
    trackingSerial String

    setUsarInicioRápidoBorrar

    public void setUseFastbootErase (boolean useFastbootErase)

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

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

    startLogcat

    public void startLogcat ()

    Comienza a capturar resultados de logcat del dispositivo en segundo plano.

    No tendrá efecto si ya se está capturando el resultado de Logcat. Los datos se pueden recuperar más adelante a través de getLogcat.

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

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

    Usuario de inicio

    public boolean startUser (int userId)

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

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

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

    Arroja
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

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

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

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

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

    Arroja
    DeviceNotAvailableException

    startVisibleBackgroundUser

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

    Inicia un usuario determinado en segundo plano, visible en la pantalla determinada (es decir, le permite al usuario iniciar actividades en esa pantalla).

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

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

    displayId int: Es la pantalla en la que se iniciará el usuario visible.

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

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

    Arroja
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Cierra y borra el resultado del emulador.

    stopLogcat

    public void stopLogcat ()

    Detén la captura de resultados de logcat del dispositivo y descarta los datos de logcat guardados actualmente.

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

    stopUser

    public boolean stopUser (int userId)

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

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

    Muestra
    boolean Es verdadero si se detuvo al usuario correctamente.

    Arroja
    DeviceNotAvailableException

    stopUser

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

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

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

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

    forceFlag boolean: Detendrá el usuario de forma forzosa.

    Muestra
    boolean Es verdadero si se detuvo al usuario correctamente.

    Arroja
    DeviceNotAvailableException

    cambiarAAdbTcp

    public String switchToAdbTcp ()

    Cambia el dispositivo al modo adb-over-tcp.

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

    Arroja
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

    Cambia el dispositivo al modo adb mediante USB.

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

    Arroja
    DeviceNotAvailableException

    Cambiar de usuario

    public boolean switchUser (int userId)

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

    Parámetros
    userId int

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

    Arroja
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId, 
                    long timeout)

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

    Parámetros
    userId int

    timeout long: Esperar antes de mostrar un valor falso para que falle el cambio de usuario.

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

    Arroja
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

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

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

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

    Parámetros
    localFileDir File: Es el directorio de archivos local que contiene los archivos que se enviarán de forma recursiva.

    deviceFilePath String: Es la raíz de la ruta de acceso absoluta del archivo de destino remoto. Todos los directorios de esa ruta de acceso de archivo deben ser legibles. Es decir, si envías a /data/local/tmp cuando adb no tiene permisos de raíz, se producirá un error.

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

    Arroja
    DeviceNotAvailableException

    informe de errores de toma

    public Bugreport takeBugreport ()

    Toma un informe de errores y devuélvelo dentro de un objeto Bugreport para controlarlo. Muestra un valor nulo en caso de que haya un problema. El archivo al que se hace referencia en el objeto del informe de errores se debe limpiar a través de Bugreport.close().

    Muestra
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

    Desinstala un paquete de Android del dispositivo.

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

    Muestra
    String una String con un código de error, o null si se ejecuta de forma correcta.

    Arroja
    DeviceNotAvailableException

    desinstalarPaqueteParaUsuario

    public String uninstallPackageForUser (String packageName, 
                    int userId)

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

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

    userId int: Es el ID de usuario entero para el que se desinstalará.

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

    Arroja
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

    Desbloquea el dispositivo si está en estado encriptado.

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

    Muestra
    boolean Es true si se ejecuta correctamente o si el dispositivo no está encriptado.

    Arroja
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Desactiva Debugfs.

    Arroja
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

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

    Parámetros
    timeOut long: Es el tiempo en milisegundos que se espera para que se establezca la marca.

    Muestra
    boolean true si la marca de inicio completado del dispositivo se establece dentro del tiempo de espera

    Arroja
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Espera a que el dispositivo sea responsivo y esté disponible para realizar pruebas. Usa el tiempo de espera predeterminado.

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

    Arroja
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    Espera a que el dispositivo sea responsivo y esté disponible para realizar pruebas.

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

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

    Arroja
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Parámetros
    waitTime long

    Muestra
    boolean Verdadero si el dispositivo está disponible. Falso si no lo está.

    Arroja
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

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

    Arroja
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

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

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

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

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

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

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

    Muestra
    boolean true si el dispositivo se inicia en la transferencia lateral antes de que venza el tiempo. false por lo demás

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

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

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

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

    waitForDeviceEn línea

    public void waitForDeviceOnline ()

    Se bloquea hasta que el dispositivo sea visible mediante adb. Usa el tiempo de espera predeterminado

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

    Arroja
    DeviceNotAvailableException

    waitForDeviceEn línea

    public void waitForDeviceOnline (long waitTime)

    Se bloquea hasta que el dispositivo sea visible mediante adb.

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

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

    Arroja
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

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

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

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

    Métodos protegidos

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Parámetros
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

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

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

    Parámetros
    command String

    forceExitStatusDetection boolean

    Muestra
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Parámetros
    feature String

    strictMinLevel int

    createRestartDeviceAction

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

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

    Parámetros
    rebootMode NativeDevice.RebootMode: Es un modo de este reinicio.

    reason String: Para este reinicio.

    Muestra
    NativeDevice.RebootDeviceAction el RebootDeviceAction creado.

    createRunUtil

    protected IRunUtil createRunUtil ()

    Muestra
    IRunUtil

    doAdbReboot

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

    Realiza un reinicio de adb.

    Parámetros
    rebootMode NativeDevice.RebootMode: Es un modo de este reinicio.

    reason String: Para este reinicio.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    Muestra
    int

    getLogger

    protected ITestLogger getLogger ()

    Muestra
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

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

    Muestra
    IRunUtil

    inicializarConnection

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

    Parámetros
    info IBuildInfo

    attributes MultiMap

    Arroja
    DeviceNotAvailableException
    TargetSetupError

    internalGetProperty

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

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

    Parámetros
    propName String: Es el nombre de la propiedad del dispositivo que muestra "adb shell getprop".

    fastbootVar String: Es el nombre de la variable de fastboot equivalente que se consultará. Si es null, no se intentará la consulta de fastboot.

    description String: Es una descripción simple de la variable. La primera letra debe estar en mayúscula.

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

    Arroja
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

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

    Muestra
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

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

    Parámetros
    localFile File

    entry IFileEntry

    Muestra
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    realice una acción en el dispositivo

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

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

    Parámetros
    actionDescription String: Es una descripción breve de la acción que se realizará. Solo se usa con fines de registro.

    action NativeDevice.DeviceAction: Es la acción que se realizará.

    retryAttempts int: El reintento intenta realizar la acción si falla, pero la recuperación se realiza correctamente.

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

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

    relanzamiento de post abierto

    protected void postAdbReboot ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prePostBootSetup

    protected void prePostBootSetup ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileInterno

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Parámetros
    remoteFilePath String

    localFile File

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    setClock

    protected void setClock (Clock clock)

    Establece la instancia de reloj que se usará.

    Parámetros
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Marca el TestDevice como microdroid y establece su CID.

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

    setTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    Parámetros
    deviceOptions

    simpleFastbootCommand

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

    Ejecuta un comando fastboot simple con variables de entorno y, luego, informa el estado del comando.

    Parámetros
    timeout long

    envVarMap

    fullCmd String

    Muestra
    CommandResult

    simpleFastbootCommand

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

    Ejecuta un comando fastboot simple y, luego, informa el estado del comando.

    Parámetros
    timeout long

    fullCmd String

    Muestra
    CommandResult

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

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

    Parámetros
    operationDesc String: Es el nombre de la operación que está esperando un estado no disponible.

    time long: Es el tiempo que se debe esperar hasta que ocurra un evento no disponible.

    Muestra
    boolean Es verdadero si el dispositivo no está disponible.