INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

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

Resumen

Constantes

int UNKNOWN_API_LEVEL

Valor predeterminado cuando no se puede detectar el nivel de API

Métodos públicos

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Comprueba si una función es compatible actualmente según un nivel de compatibilidad mínimo.

abstract void clearLogcat()

Borra los datos de Logcat acumulados.

abstract void deleteFile(String deviceFilePath)

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

abstract void deleteFile(String deviceFilePath, int userId)

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

abstract 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.

abstract 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).

abstract boolean disableAdbRoot()

Desactiva el acceso raíz de adb.

abstract boolean doesFileExist(String deviceFilePath)

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

abstract boolean enableAdbRoot()

Activa el permiso de administrador de adb.

abstract String executeAdbCommand(long timeout, String... commandArgs)

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

abstract String executeAdbCommand(String... commandArgs)

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

abstract String executeAdbCommand(long timeout, envMap, String... commandArgs)

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

abstract CommandResult executeFastbootCommand(long timeout, String... commandArgs)

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

abstract CommandResult executeFastbootCommand(String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand( envVarMap, String... commandArgs)

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.

abstract String executeShellCommand(String command)

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

abstract 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.

abstract 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.

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

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

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

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

abstract CommandResult executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)

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

abstract CommandResult executeShellV2Command(String command, 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.

abstract CommandResult executeShellV2Command(String command, 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.

abstract CommandResult fastbootWipePartition(String partition)

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

abstract int getApiLevel()

Obtén el nivel de API del dispositivo.

abstract String getBasebandVersion()

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

abstract Integer getBattery()

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

abstract boolean getBooleanProperty(String name, boolean defaultValue)

Muestra el valor booleano de la propiedad determinada.

abstract getBootHistory()

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

abstract 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.

abstract String getBootloaderVersion()

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

abstract String getBuildAlias()

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

abstract String getBuildFlavor()

Recupera el tipo de compilación del dispositivo.

abstract String getBuildId()

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

abstract String getBuildSigningKeys()

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

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

abstract DeviceDescriptor getCachedDeviceDescriptor()

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

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

abstract String[] getChildren(String deviceFilePath)

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

abstract AbstractConnection getConnection()

Muestra la conexión asociada con el dispositivo.

abstract String getDeviceClass()

Obtén la clase del dispositivo.

abstract long getDeviceDate()

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

abstract DeviceDescriptor getDeviceDescriptor()

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

abstract 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.

abstract TestDeviceState getDeviceState()

Obtén el estado del dispositivo.

abstract long getDeviceTimeOffset(Date date)

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

abstract InputStreamSource getEmulatorOutput()

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

abstract long getExternalStoreFreeSpace()

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

abstract String getFastbootProductType()

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

abstract String getFastbootProductVariant()

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

abstract String getFastbootSerialNumber()

Muestra el número de serie del modo fastboot.

abstract String getFastbootVariable(String variableName)

Recupera el valor de la variable fastboot determinado del dispositivo.

abstract IFileEntry getFileEntry(String path)

Recupera una referencia a un archivo remoto en el dispositivo.

abstract IDevice getIDevice()

Devuelve una referencia al IDevice de ddmlib asociado.

abstract long getIntProperty(String name, long defaultValue)

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

abstract long getLastExpectedRebootTimeMillis()

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

abstract int getLaunchApiLevel()

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

abstract InputStreamSource getLogcat()

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

abstract InputStreamSource getLogcat(int maxBytes)

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

abstract InputStreamSource getLogcatDump()

Obtén un volcado del logcat actual del dispositivo.

abstract InputStreamSource getLogcatSince(long date)

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

abstract String getMountPoint(String mountName)

Muestra un punto de activación.

abstract 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.

abstract getMountPointInfo()

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

abstract long getPartitionFreeSpace(String partition)

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

abstract 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.

abstract String getProcessPid(String process)

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

abstract String getProductType()

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

abstract String getProductVariant()

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

abstract String getProperty(String name)

Recupera el valor de la propiedad determinada del dispositivo.

abstract ITestDevice.RecoveryMode getRecoveryMode()

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

abstract String getSerialNumber()

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

abstract getTombstones()

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

abstract long getTotalMemory()

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

default String getTrackingSerial()

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

abstract boolean getUseFastbootErase()

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

abstract boolean isAdbRoot()
abstract boolean isAdbTcp()
abstract boolean isAppEnumerationSupported()

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

abstract boolean isBypassLowTargetSdkBlockSupported()

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

abstract boolean isDebugfsMounted()

Verifica si debugfs está activado.

abstract boolean isDeviceEncrypted()

Muestra si el dispositivo está encriptado.

abstract boolean isDirectory(String deviceFilePath)

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

abstract boolean isEncryptionSupported()

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

abstract 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.

abstract boolean isHeadless()

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

abstract boolean isRuntimePermissionSupported()

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

abstract boolean isStateBootloaderOrFastbootd()

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

abstract boolean logAnrs(ITestLogger logger)

Recopila y registra errores de ANR del dispositivo.

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

Registra un mensaje en el logcat del dispositivo.

abstract void mountDebugfs()

Activa debugfs.

abstract void nonBlockingReboot()

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

abstract void postBootSetup()

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

default void postInvocationTearDown()

Este método dejó de estar disponible. Usa postInvocationTearDown(Throwable) en su lugar.

abstract void postInvocationTearDown(Throwable invocationException)

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

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

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

abstract boolean pullDir(String deviceFilePath, File localDir)

Extrae de forma recursiva el contenido del directorio del dispositivo.

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

Extrae de forma recursiva el contenido del directorio del dispositivo.

abstract File pullFile(String remoteFilePath, int userId)

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

abstract File pullFile(String remoteFilePath)

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

abstract boolean pullFile(String remoteFilePath, File localFile)

Recupera un archivo del dispositivo.

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

Recupera un archivo del dispositivo.

abstract String pullFileContents(String remoteFilePath)

Recupera un archivo del dispositivo y muestra su contenido.

abstract 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.

abstract boolean pushDir(File localDir, String deviceFilePath, int userId)

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

abstract boolean pushDir(File localDir, String deviceFilePath, excludedDirectories)

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

abstract boolean pushDir(File localDir, String deviceFilePath)

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

abstract boolean pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)

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

abstract boolean pushFile(File localFile, String deviceFilePath)

Envía un archivo al dispositivo.

abstract boolean pushFile(File localFile, String deviceFilePath, int userId)

Envía un archivo al dispositivo.

abstract boolean pushString(String contents, String deviceFilePath)

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

abstract void reboot()

Reinicia el dispositivo en modo ADB.

abstract void reboot(String reason)

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

abstract void rebootIntoBootloader()

Reinicia el dispositivo en el modo bootloader.

abstract void rebootIntoFastbootd()

Reinicia el dispositivo en modo fastbootd.

abstract void rebootIntoRecovery()

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

abstract 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.

abstract 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.

abstract 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.

abstract void rebootUntilOnline(String reason)

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

abstract void rebootUserspace()

Reinicia solo la parte del espacio de usuario del dispositivo.

abstract 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.

abstract void remountSystemReadOnly()

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

abstract void remountSystemWritable()

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

abstract void remountVendorReadOnly()

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

abstract void remountVendorWritable()

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

abstract 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.

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

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

abstract 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.

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

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

abstract void setDate(Date date)

Establece la fecha en el dispositivo.

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

abstract void setOptions(TestDeviceOptions options)

Establece el TestDeviceOptions para el dispositivo

abstract boolean setProperty(String propKey, String propValue)

Establece el valor de la propiedad determinada en el dispositivo.

abstract void setRecovery(IDeviceRecovery recovery)

Establece el IDeviceRecovery que se usará para este dispositivo.

abstract void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

abstract void setTrackingSerial(String trackingSerial)

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

abstract void setUseFastbootErase(boolean useFastbootErase)

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

abstract void startLogcat()

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

abstract void stopEmulatorOutput()

Cierra y borra el resultado del emulador.

abstract void stopLogcat()

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

abstract String switchToAdbTcp()

Cambia el dispositivo al modo adb-over-tcp.

abstract boolean switchToAdbUsb()

Cambia el dispositivo al modo adb mediante USB.

abstract boolean syncFiles(File localFileDir, String deviceFilePath)

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

abstract boolean unlockDevice()

Desbloquea el dispositivo si está en un estado encriptado.

abstract void unmountDebugfs()

Desactiva debugfs.

abstract boolean waitForBootComplete(long timeOut)

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

abstract boolean waitForDeviceAvailable()

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

abstract boolean waitForDeviceAvailable(long waitTime)

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

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

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

abstract void waitForDeviceBootloader()

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

abstract boolean waitForDeviceInRecovery(long waitTime)

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

abstract boolean waitForDeviceInSideload(long waitTime)

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

abstract boolean waitForDeviceNotAvailable(long waitTime)

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

abstract void waitForDeviceOnline()

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

abstract void waitForDeviceOnline(long waitTime)

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

abstract boolean waitForDeviceShell(long waitTime)

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

Constantes

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Valor predeterminado cuando no se puede detectar el nivel de API

Valor constante: -1 (0xffffffff)

Métodos públicos

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

clearLogcat

public abstract 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 producidos después de un punto determinado (por ejemplo, después de actualizar una nueva compilación del dispositivo, etcétera).

deleteFile

public abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

userId int: El ID del usuario del que se borrará

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestarted

public abstract 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
RuntimeException if device has abnormal boot reason
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract 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 actual del dispositivo en milisegundos se puede obtener con el método getDeviceDate().

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

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

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

Arroja
RuntimeException if device has abnormal boot reason
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableAdbRoot

public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

doesFileExist

public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

enableAdbRoot

public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

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.

commandArgs 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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
commandArgs 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

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.

commandArgs 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

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.

commandArgs String: El comando fastboot y los argumentos para ejecutar

Muestra
CommandResult El CommandResult que contiene el resultado del comando

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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
commandArgs String: El comando fastboot y los argumentos para ejecutar

Muestra
CommandResult El CommandResult que contiene el resultado del comando

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

Muestra
CommandResult El CommandResult que contiene el resultado del comando

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

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

commandArgs String: El comando fastboot y los argumentos para ejecutar

Muestra
CommandResult El CommandResult que contiene el resultado del comando

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

executeShellCommand

public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

executeShellCommand

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

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

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

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

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

timeUnit TimeUnit: Unidad de maxTimeToOutputShellResponse

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

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

executeShellCommand

public abstract 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 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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 si se pierde la conexión con el dispositivo y no se puede recuperar.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

Muestra
CommandResult El resultado en CommandResult.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                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
command String: Es el comando que se debe ejecutar.

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

Muestra
CommandResult El resultado en CommandResult.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

Parámetros
command 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                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á.

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

timeUnit TimeUnit: Unidad de maxTimeToOutputShellResponse

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

Muestra
CommandResult

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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á.

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 si se pierde la conexión con el dispositivo y no se puede recuperar.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                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
command String: Es el comando del shell de adb que se ejecutará.

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

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

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

timeUnit TimeUnit: Unidad de maxTimeToOutputShellResponse

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

Muestra
CommandResult

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                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
command String: Es el comando del shell de adb que se ejecutará.

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

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

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

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

timeUnit TimeUnit: Unidad de maxTimeToOutputShellResponse

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

Muestra
CommandResult

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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 espera que se use cuando el dispositivo ya está en modo fastboot.

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

Muestra
CommandResult El CommandResult que contiene el resultado del comando

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

getApiLevel

public abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

getBattery

public abstract 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 abstract 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 abstract  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 abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

timeUnit TimeUnit: La unidad de tiempo TimeUnit.

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

Arroja
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

Muestra
String La clave de firma si se encuentra, o un valor nulo de lo contrario.

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Muestra
DeviceDescriptor

getCachedDeviceDescriptor

public abstract 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 abstract String[] getChildren (String deviceFilePath)

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

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Muestra la conexión asociada con el dispositivo.

Muestra
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Obtén la clase del dispositivo.

Muestra
String la clase de dispositivo String.

getDeviceDate

public abstract long getDeviceDate ()

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

Muestra
long la fecha del dispositivo en formato de época

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract 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 abstract 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 abstract TestDeviceState getDeviceState ()

Obtén el estado del dispositivo.

Muestra
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

Parámetros
date Date

Muestra
long la diferencia en milisegundos

Arroja
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

Muestra
InputStreamSource resultado del emulador

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

Muestra
long la cantidad de espacio libre en KB

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

getFastbootProductType

public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

getFastbootProductVariant

public abstract 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 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Muestra el número de serie del modo fastboot.

Muestra
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Recupera el valor de la variable fastboot determinado del dispositivo.

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

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

Arroja
UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract 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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Devuelve una referencia al IDevice de ddmlib asociado.

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

Muestra
IDevice el IDevice

getIntProperty

public abstract 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

getLastExpectedRebootTimeMillis

public abstract 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 abstract int getLaunchApiLevel ()

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

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

Funciona en dos modos:

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

    Muestra
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

    Muestra
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

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

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

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

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

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

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

    Muestra
    InputStreamSource

    getMountPoint

    public abstract 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 abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Parámetros
    mountpoint String

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

    Arroja
    DeviceNotAvailableException

    getMountPointInfo

    public abstract  getMountPointInfo ()

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

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

    Arroja
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    getProcessByName

    public abstract 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 abstract String getProcessPid (String process)

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

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

    Muestra
    String

    Arroja
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

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

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

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

    Arroja
    DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar, o si no se puede determinar el tipo de producto

    getProductVariant

    public abstract String getProductVariant ()

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

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

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

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

    getProperty

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode

    public abstract 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

    getSerialNumber

    public abstract 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

    getTombstones

    public abstract  getTombstones ()

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

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

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

    Arroja
    DeviceNotAvailableException

    getTotalMemory

    public abstract 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

    getUseFastbootErase

    public abstract 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.

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Muestra
    boolean true si el dispositivo tiene actualmente permisos de administrador de adb, false de lo contrario.

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

    isAdbTcp

    public abstract boolean isAdbTcp ()

    Muestra
    boolean true si el dispositivo está conectado a adb-over-tcp, false de lo contrario.

    isAppEnumerationSupported

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Verifica si debugfs está activado.

    Muestra
    boolean true si se activa debugfs

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Muestra si el dispositivo está encriptado.

    Muestra
    boolean true si el dispositivo está encriptado.

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

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

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

    Parámetros
    deviceFilePath String

    Muestra
    boolean

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isExecutable

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

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

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

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

    Muestra
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Recopila y registra errores ANR del dispositivo.

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

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

    Arroja
    DeviceNotAvailableException

    logOnDevice

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

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

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

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

    format String: Es el formato del mensaje.

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

    mountDebugfs

    public abstract void mountDebugfs ()

    Activa debugfs.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    nonBlockingReboot

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

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

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

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

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

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

    postInvocationTearDown

    public void postInvocationTearDown ()

    Este método dejó de estar disponible.
    Usa postInvocationTearDown(Throwable) en su lugar.

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

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    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
    invocationException Throwable: Si corresponde, es la excepción final que genera el error de invocación.

    preInvocationSetup

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

    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: Es el IBuildInfo del dispositivo.

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

    Arroja
    com.android.tradefed.targetprep.TargetSetupError
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    pullDir

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

    Extrae de forma recursiva el contenido del directorio del dispositivo.

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

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

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

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

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

    pullFile

    public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    pullFile

    public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    pullFile

    public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    pullFile

    public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

    Recupera un archivo del dispositivo y muestra su contenido.

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

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

    Arroja
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                    int userId)

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

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

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

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

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

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

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                     excludedDirectories)

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

    Parámetros
    localDir 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

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

    Parámetros
    localDir 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    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á.

    deviceFilePath 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    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á.

    deviceFilePath 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    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á.

    deviceFilePath 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

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

    Parámetros
    contents String: El contenido del archivo que se enviará

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

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

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

    reiniciar

    public abstract void reboot ()

    Reinicia el dispositivo en modo ADB.

    Bloquea el dispositivo hasta que esté disponible.

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después del reinicio

    reiniciar

    public abstract void reboot (String reason)

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

    Bloquea el dispositivo hasta que esté disponible.

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

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

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después del reinicio

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Reinicia el dispositivo en el modo bootloader.

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

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

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Reinicia el dispositivo en modo fastbootd.

    Bloquea hasta que el dispositivo esté en modo fastbootd.

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

    rebootIntoRecovery

    public abstract 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 si el dispositivo no está disponible después del reinicio

    rebootIntoSideload

    public abstract 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 la transferencia.

    Arroja
    DeviceNotAvailableException Si el dispositivo no está en sideload después del reinicio

    rebootIntoSideload

    public abstract 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 Si el dispositivo no está en sideload después del reinicio

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

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

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después del reinicio

    rebootUntilOnline

    public abstract 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 de este reinicio o null si no se especifica ningún motivo.

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después del reinicio

    También:

    rebootUserspace

    public abstract void rebootUserspace ()

    Reinicia solo la parte del espacio de 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 si el dispositivo no está disponible después del reinicio

    rebootUserspaceUntilOnline

    public abstract 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 si el dispositivo no está disponible después del reinicio

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountSystemWritable

    public abstract void remountSystemWritable ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorReadOnly

    public abstract void remountVendorReadOnly ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    runInstrumentationTests

    public abstract 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 Si se pierde la conexión con el dispositivo y no se puede recuperar, es decir, si no se pudo completar el comando de prueba y la recuperación falló.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

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

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

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

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

    listeners : Los objetos de escucha de resultados de la prueba

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

    Arroja
    DeviceNotAvailableException Si se pierde la conexión con el dispositivo y no se puede recuperar, es decir, si no se pudo completar el comando de prueba y la recuperación falló.

    runInstrumentationTestsAsUser

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

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

    Parámetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public abstract 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

    setDate

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Establece el TestDeviceOptions para el dispositivo

    Parámetros
    options TestDeviceOptions

    setProperty

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

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

    Parámetros
    recovery IDeviceRecovery: el IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

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

    Parámetros
    trackingSerial String

    setUseFastbootErase

    public abstract 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 abstract void startLogcat ()

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

    No tendrá efecto si ya se está capturando el resultado de Logcat. Los datos se pueden recuperar más adelante a través de getLogcat.

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

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

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Cierra y borra el resultado del emulador.

    stopLogcat

    public abstract void stopLogcat ()

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

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

    switchToAdbTcp

    public abstract 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
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Cambia el dispositivo al modo adb mediante USB.

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

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

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

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

    Parámetros
    localFileDir File: Es el directorio de archivos local que contiene los archivos que se enviarán de forma recursiva.

    deviceFilePath String: Es la raíz de la ruta de acceso absoluta del archivo de destino remoto. Todos los directorios de 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 si se pierde la conexión con el dispositivo y no se puede recuperar.

    unlockDevice

    public abstract boolean unlockDevice ()

    Desbloquea el dispositivo si está en un estado encriptado.

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

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

    Arroja
    DeviceNotAvailableException si se pierde la conexión con el dispositivo y no se puede recuperar.
    UnsupportedOperationException si la encriptación no es compatible con el dispositivo.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Desactiva debugfs.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

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

    Parámetros
    timeOut long: Es el tiempo en milisegundos que se espera para que se establezca la marca.

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

    Espera a que el dispositivo sea responsivo y esté disponible para las pruebas. Usa el tiempo de espera predeterminado.

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

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

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

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

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

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

    Arroja
    DeviceNotAvailableException si el dispositivo sigue sin responder después de que venza waitTime.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Parámetros
    waitTime long

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

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

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

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

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

    waitForDeviceInRecovery

    public abstract 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 abstract boolean waitForDeviceInSideload (long waitTime)

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

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

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

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

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

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

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

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

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

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

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

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

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

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

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

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

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

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