INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

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

Resumen

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 con un nivel de compatibilidad mínimo.

abstract void clearLogcat()

Borra los datos de logcat acumulados.

abstract void deleteFile(String deviceFilePath)

Método auxiliar para borrar un archivo o directorio en el dispositivo.

abstract void deleteFile(String deviceFilePath, int userId)

Método auxiliar para borrar un archivo o directorio en el dispositivo.

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

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

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Método de ayuda para verificar si el dispositivo se reinició de forma parcial 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 acceso raíz de adb.

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

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

abstract String executeAdbCommand(String... commandArgs)

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

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

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

abstract CommandResult executeAdbV2Command(long timeout, envMap, String... commandArgs)

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

abstract CommandResult executeAdbV2Command(String... commandArgs)

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

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

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

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

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

abstract CommandResult executeFastbootCommand(String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

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

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

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)

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 de 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 de 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 especificado y vuelve a intentarlo varias veces si falla.

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

Método auxiliar que ejecuta un comando shell de adb y devuelve los resultados como un objeto CommandResult correctamente completado con el resultado del estado del comando y stderr.

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

Método auxiliar que ejecuta un comando shell de adb y devuelve los resultados como un objeto CommandResult completado 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 de 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 de 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 de 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 de adb shell, con más parámetros para controlar el comportamiento del comando.

abstract CommandResult fastbootWipePartition(String partition)

Método auxiliar que borra una partición del dispositivo.

abstract int getApiLevel()

Obtiene el nivel de API del dispositivo.

abstract String getBasebandVersion()

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

abstract Integer getBattery()

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

abstract boolean getBooleanProperty(String name, boolean defaultValue)

Devuelve el valor booleano de la propiedad determinada.

abstract getBootHistory()

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

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

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

abstract String getBootloaderVersion()

Método de conveniencia 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 la variante de compilación para el dispositivo.

abstract String getBuildId()

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

abstract String getBuildSigningKeys()

Devuelve el tipo de clave que se usó para firmar la imagen del dispositivo.

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

abstract DeviceDescriptor getCachedDeviceDescriptor()

Devuelve un objeto DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, devuelve el objeto DeviceDescriptor actual.

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Devuelve un objeto DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, devuelve el objeto DeviceDescriptor actual.

abstract String[] getChildren(String deviceFilePath)

Alternativa al uso de IFileEntry que, a veces, no funciona debido a los permisos.

abstract AbstractConnection getConnection()

Devuelve la conexión asociada al dispositivo.

abstract String getDeviceClass()

Obtiene la clase del dispositivo.

abstract long getDeviceDate()

Devuelve la fecha del dispositivo en milisegundos desde el ciclo.

abstract DeviceDescriptor getDeviceDescriptor()

Devuelve un DeviceDescriptor a partir 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 a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo real.

abstract TestDeviceState getDeviceState()

Obtiene el estado del dispositivo.

abstract long getDeviceTimeOffset(Date date)

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

abstract InputStreamSource getEmulatorOutput()

Obtén el flujo de stdout y stderr del emulador

abstract long getExternalStoreFreeSpace()

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

abstract String getFastbootProductType()

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

abstract String getFastbootProductVariant()

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

abstract String getFastbootSerialNumber()

Devuelve el número de serie del modo fastboot.

abstract String getFastbootVariable(String variableName)

Recupera el valor de la variable fastboot determinada del dispositivo.

abstract IFileEntry getFileEntry(String path)

Recupera una referencia a un archivo remoto en el dispositivo.

abstract IDevice getIDevice()

Devuelve una referencia al objeto IDevice de ddmlib asociado.

abstract long getIntProperty(String name, long defaultValue)

Devuelve el valor entero de la propiedad determinada del dispositivo.

abstract long getLastExpectedRebootTimeMillis()

Devuelve la última vez que las APIs de Tradefed activaron un reinicio en milisegundos desde la EPOCH, según lo que devuelve System.currentTimeMillis().

abstract int getLaunchApiLevel()

Obtiene el primer nivel de API que se lanzó en el dispositivo.

abstract InputStreamSource getLogcat()

Toma una transmisión de instantáneas de los datos de logcat.

abstract InputStreamSource getLogcat(int maxBytes)

Toma una transmisión de instantáneas de los últimos maxBytes de los datos de logcat capturados.

abstract InputStreamSource getLogcatDump()

Obtén un volcado del logcat actual del dispositivo.

abstract InputStreamSource getLogcatSince(long date)

Toma una transmisión de instantáneas de los datos de logcat capturados a partir de la fecha proporcionada.

abstract String getMountPoint(String mountName)

Devuelve un punto de activación.

abstract ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

Devuelve un MountPointInfo que corresponde a la ruta de acceso del punto de montaje especificado o null si esa ruta de acceso no tiene nada montado o no aparece en /proc/mounts como un punto de montaje.

abstract getMountPointInfo()

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

abstract long getPartitionFreeSpace(String partition)

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

abstract ProcessInfo getProcessByName(String processName)

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

abstract String getProcessPid(String process)

Devuelve el PID del servicio o null si algo salió mal.

abstract String getProductType()

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

abstract String getProductVariant()

Método de conveniencia para obtener la variante del producto de este dispositivo.

abstract String getProperty(String name)

Recupera el valor de la propiedad determinado del dispositivo.

abstract ITestDevice.RecoveryMode getRecoveryMode()

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

abstract String getSerialNumber()

Método de conveniencia para obtener el número de serie de este dispositivo.

abstract getTombstones()

Recupera y devuelve la lista de marcas de eliminación de los dispositivos.

abstract long getTotalMemory()

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

default String getTrackingSerial()

Se obtiene el número de serie que se usa para hacer un seguimiento del dispositivo con fines de administración.

abstract boolean getUseFastbootErase()

Obtiene si se debe usar fastboot erase o fastboot format para borrar una partición en el 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()

Comprueba si la plataforma del dispositivo admite la omisión del bloqueo del SDK de destino bajo en las instalaciones de apps

abstract boolean isDebugfsMounted()

Verifica si debugfs está montado.

abstract boolean isDeviceEncrypted()

Devuelve si el dispositivo está encriptado.

abstract boolean isDirectory(String deviceFilePath)

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

abstract boolean isEncryptionSupported()

Devuelve si el dispositivo admite la encriptación.

abstract boolean isExecutable(String fullPath)

Devuelve True si la ruta de acceso al archivo en el dispositivo es un archivo ejecutable; de lo contrario, devuelve False.

abstract boolean isHeadless()

Devuelve verdadero si el dispositivo no tiene pantalla y falso en caso contrario.

abstract boolean isRuntimePermissionSupported()

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

abstract boolean isStateBootloaderOrFastbootd()

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

abstract boolean logAnrs(ITestLogger logger)

Recopila y registra los errores 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()

Envía un comando para reiniciar el dispositivo y regresa 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 para las pruebas después de cada arranque.

default void postInvocationTearDown()

Este método dejó de estar disponible. En su lugar, usa postInvocationTearDown(Throwable).

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)

Son pasos adicionales para la configuración requerida específica del dispositivo que se ejecutarán 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 objeto ERROR(/File) temporal local y devuelve ese objeto File.

abstract File pullFile(String remoteFilePath)

Recupera un archivo del dispositivo, lo almacena en un objeto ERROR(/File) temporal local y devuelve ese objeto 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 devuelve su contenido.

abstract File pullFileFromExternal(String remoteFilePath)

Es un método de conveniencia para recuperar un archivo del almacenamiento externo del dispositivo, almacenarlo en un ERROR(/File) temporal local y devolver 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)

Variante de pushFile(File, String) que puede considerar de forma opcional la evaluación de 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 al dispositivo el archivo creado a partir de una cadena

abstract void reboot()

Reinicia el dispositivo en modo adb.

abstract void reboot(String reason)

Reinicia el dispositivo en modo adb con el reason determinado para que persista después del reinicio.

abstract void rebootIntoBootloader()

Reinicia el dispositivo en el modo de cargador de arranque.

abstract void rebootIntoFastbootd()

Reinicia el dispositivo en el 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 de carga lateral de adb (ten en cuenta que este es un modo especial en recuperación).

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

abstract void rebootIntoSideload()

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

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

abstract void rebootUntilOnline()

Es una alternativa 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()

Solo reinicia la parte del espacio del usuario del dispositivo.

abstract void rebootUserspaceUntilOnline()

Es una alternativa 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 en el 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 la partición del proveedor en el dispositivo sea grabable.

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

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

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

Ejecuta pruebas de instrumentación y proporciona recuperación del dispositivo.

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: Establecer la fecha en el dispositivo requiere acceso de administrador.

abstract void setOptions(TestDeviceOptions options)

Cómo configurar el TestDeviceOptions para el dispositivo

abstract boolean setProperty(String propKey, String propValue)

Establece el valor de propiedad determinado 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 fines de administración de dispositivos, se hace un seguimiento del número de serie que usamos para hacer referencia al dispositivo.

abstract void setUseFastbootErase(boolean useFastbootErase)

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

abstract void startLogcat()

Comienza a capturar el resultado de logcat del dispositivo en segundo plano.

abstract boolean startTradeInModeTesting(int timeoutMs)

Habilita el modo de prueba de intercambio.

abstract void stopEmulatorOutput()

Cierra y borra el resultado del emulador.

abstract void stopLogcat()

Deja de capturar el resultado de Logcat del dispositivo y descarta los datos de Logcat guardados actualmente.

abstract void stopTradeInModeTesting()

Detener la prueba del modo de intercambio

abstract String switchToAdbTcp()

Cambia el dispositivo al modo adb-over-tcp.

abstract boolean switchToAdbUsb()

Cambia el dispositivo al modo adb a través de 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á encriptado.

abstract void unmountDebugfs()

Desmonta debugfs.

abstract boolean waitForBootComplete(long timeOut)

Se bloquea hasta que se establece la marca de inicio completo del dispositivo.

abstract boolean waitForDeviceAvailable()

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

abstract boolean waitForDeviceAvailable(long waitTime)

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

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Espera a que el dispositivo responda y esté disponible sin tener en cuenta la ruta de recuperación.

abstract void waitForDeviceBootloader()

Se bloquea hasta que el dispositivo esté 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 es diferente de IDeviceRecovery).

abstract boolean waitForDeviceInSideload(long waitTime)

Bloqueos para que el dispositivo esté en el estado "adb sideload"

abstract boolean waitForDeviceNotAvailable(long waitTime)

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

abstract void waitForDeviceOnline()

Se bloquea hasta que el dispositivo esté visible a través de adb.

abstract void waitForDeviceOnline(long waitTime)

Se bloquea hasta que el dispositivo esté visible a través de adb.

abstract boolean waitForDeviceShell(long waitTime)

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

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 se admite actualmente en un nivel de compatibilidad mínimo. Este método tiene en cuenta las funciones que aún no se lanzaron antes de que se aumente el nivel de API.

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

Muestra
boolean Es verdadero si se admite el nivel. 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 los que deseas asegurarte de que ITestDevice.getLogcat() solo devuelva datos de registro producidos después de un punto determinado (por ejemplo, después de escribir una nueva compilación del dispositivo, etcétera).

deleteFile

public abstract void deleteFile (String deviceFilePath)

Método auxiliar para borrar un archivo o directorio en el 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)

Método auxiliar para borrar un archivo o directorio en el dispositivo.

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

userId int: ID del usuario que se borrará de

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 parcial comparando el system_server actual con el system_server anterior ProcessInfo. Usa getProcessByName(String) para obtener ProcessInfo.

Parámetros
prevSystemServerProcess ProcessInfo: Es el proceso system_server anterior ProcessInfo.

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

Arroja
RuntimeException Si el dispositivo tiene un motivo de inicio anormal
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

Arroja
RuntimeException Si el dispositivo tiene un motivo de inicio anormal
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableAdbRoot

public abstract boolean disableAdbRoot ()

Desactiva el acceso raíz de adb.

Si inhabilitas adb root, es posible que el dispositivo se desconecte de adb. Este método se bloqueará hasta que el dispositivo esté disponible.

Muestra
boolean true si la operación 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 verificará.

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

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

Activa el acceso raíz de adb. Si el parámetro de configuración "enable-root" es "false", se registrará un mensaje y se devolverá sin habilitar el acceso de administrador.

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

Muestra
boolean true si la operación 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)

Método auxiliar que ejecuta un comando de 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 una mejor detección de errores y rendimiento.

Parámetros
timeout long: Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Se establece en 0 L para que no haya tiempo de espera.

commandArgs String: El comando de adb y los argumentos para ejecutar

Muestra
String 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 auxiliar que ejecuta un comando de adb como un comando del sistema.

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

Parámetros
commandArgs String: El comando y los argumentos de adb que se ejecutarán

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

Método auxiliar que ejecuta un comando de 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 una mejor detección de errores y rendimiento.

Parámetros
timeout long: Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Se establece en 0 L para que no haya tiempo de espera.

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

commandArgs String: El comando y los argumentos de adb que se ejecutarán

Muestra
String 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.

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... commandArgs)

Método auxiliar que ejecuta un comando de 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 una mejor detección de errores y rendimiento.

Parámetros
timeout long: Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Se establece en 0 L para que no haya tiempo de espera.

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

commandArgs String: El comando y los argumentos de adb que se ejecutarán

Muestra
CommandResult Es el CommandResult que contiene el resultado del comando.

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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

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

Parámetros
commandArgs String: El comando y los argumentos de adb que se ejecutarán

Muestra
CommandResult Es el CommandResult que contiene el resultado del comando.

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

executeAdbV2Command

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

Método auxiliar que ejecuta un comando de 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 una mejor detección de errores y rendimiento.

Parámetros
timeout long: Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Se establece en 0 L para que no haya tiempo de espera.

commandArgs String: El comando de adb y los argumentos para ejecutar

Muestra
CommandResult Es 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 (long timeout, 
                String... commandArgs)

Método auxiliar que ejecuta un comando de 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 caduque el comando.

commandArgs String: El comando y los argumentos de fastboot que se ejecutarán

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 de 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 y los argumentos de fastboot que se ejecutarán

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)

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

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

Parámetros
commandArgs String: El comando y los argumentos de fastboot que se ejecutarán

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)

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

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

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

commandArgs String: El comando y los argumentos de fastboot que se ejecutarán

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)

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

Muestra
String el resultado de la 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 de adb shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
command String: Es el comando de adb shell 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 se permite que el comando no genere ninguna respuesta. La unidad se especifica en timeUnit.

timeUnit TimeUnit: Unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se reintentará el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si retryAttempts se realizan 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 de adb shell, con más parámetros para controlar el comportamiento del comando.

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

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

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

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

timeUnit TimeUnit: Unidad para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se reintentará el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si las retryAttempts se realizan 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 especificado y vuelve a intentarlo varias veces si falla.

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

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

receiver IShellOutputReceiver: Es el IShellOutputReceiver al que se dirige 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 de ayuda que ejecuta un comando shell de adb y devuelve los resultados como un CommandResult completado correctamente con el resultado del estado del comando, stdout y stderr.

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

Muestra
CommandResult Es 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 devuelve los resultados como un CommandResult completado 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) en el que se redireccionará la salida estándar o nulo.

Muestra
CommandResult Es 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 shell de adb y devuelve los resultados como un CommandResult completado 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 canalizará como entrada para el comando o será nulo.

Muestra
CommandResult Es 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 de adb shell, con más parámetros para controlar el comportamiento del comando.

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

retryAttempts int: Es la cantidad máxima de veces que se reintentará el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si las retryAttempts se realizan 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 de adb shell, con más parámetros para controlar el comportamiento del comando.

Parámetros
command String: Es el comando de adb shell 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 para 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 de adb shell, con más parámetros para controlar el comportamiento del comando.

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

pipeAsInput File: Es un ERROR(/File) que se canalizará como entrada para el comando o será nulo.

pipeToOutput OutputStream: ERROR(/OutputStream) en el que se redireccionará la salida 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 para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se reintentará el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si las retryAttempts se realizan 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 de adb shell, con más parámetros para controlar el comportamiento del comando.

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

pipeAsInput File: Es un ERROR(/File) que se canalizará como entrada para el comando o será nulo.

pipeToOutput OutputStream: ERROR(/OutputStream) donde se redireccionará la salida estándar o 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 para maxTimeToOutputShellResponse

retryAttempts int: Es la cantidad máxima de veces que se reintentará el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si las retryAttempts se realizan 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 auxiliar que borra una partición del dispositivo.

Si getUseFastbootErase() es true, se usará fastboot erase para borrar 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 ()

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

Muestra
int Es 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 de conveniencia 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 devuelva la información correcta para todos los dispositivos. Este método se basa en la propiedad gsm.version.baseband para devolver la información de versión correcta. Esto no es preciso para algunos dispositivos CDMA, y es posible que la versión que se devuelve aquí no coincida con la versión que se informa desde fastboot ni devuelva la versión de la radio CDMA. En resumen, este método solo informa la versión correcta si la propiedad gsm.version.baseband es la misma que la versión que devuelve 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 ()

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

Muestra
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Devuelve el valor booleano de la propiedad determinada.

Parámetros
name String: El nombre de la propiedad

defaultValue boolean: Es el valor predeterminado que se devuelve 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 la hora y el motivo del inicio.

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

Arroja
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Método auxiliar que recopila el mapa del historial de inicio con la hora y el motivo del inicio desde el momento determinado desde la época del dispositivo y la unidad de tiempo especificada. El utcEpochTime del dispositivo actual 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: Es la unidad de tiempo TimeUnit.

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

Arroja
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

Se intentará recuperar la versión del bootloader del estado actual del dispositivo. (es decir, si el dispositivo está en modo fastboot, 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.

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

Muestra
String Alias de compilación o ID de compilación de resguardo si no se pudo recuperar

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Recupera la variante de compilación para el dispositivo.

Muestra
String Es el sabor 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 ()

Devuelve el tipo de clave que se usó para firmar la imagen del dispositivo.

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Devuelve un objeto DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, devuelve el objeto DeviceDescriptor actual.

Muestra
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Devuelve un objeto DeviceDescriptor almacenado en caché si el dispositivo está asignado; de lo contrario, devuelve el objeto DeviceDescriptor actual.

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

Muestra
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

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 en la que se realizará la búsqueda.

Muestra
String[] Es un array de cadenas que contiene todos los archivos de una ruta de acceso en el dispositivo.

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Devuelve la conexión asociada al dispositivo.

Muestra
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Obtiene la clase del dispositivo.

Muestra
String la clase de dispositivo String

getDeviceDate

public abstract long getDeviceDate ()

Devuelve la fecha del dispositivo en milisegundos desde el ciclo.

Muestra
long Es la fecha del dispositivo en formato de época.

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

Muestra
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Obtiene el estado del dispositivo.

Muestra
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Es un asistente para obtener la diferencia horaria entre el dispositivo y un ERROR(/Date) determinado. Usa la hora de Epoch de forma interna.

Parámetros
date Date

Muestra
long La diferencia en milisegundos

Arroja
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Obtén el flujo de stdout y stderr del emulador

Muestra
InputStreamSource Resultado del emulador

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

Muestra
long La cantidad de espacio libre en KB

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

getFastbootProductType

public abstract String getFastbootProductType ()

Método de conveniencia 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 se encuentra en un estado incorrecto o no responde.

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Método de conveniencia 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 se encuentra en un estado incorrecto o no responde.

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

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Devuelve el número de serie del modo fastboot.

Muestra
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Recupera el valor de la variable fastboot determinada del dispositivo.

Parámetros
variableName String: 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 IFileEntry o null si no se encuentra el archivo en el path determinado

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Devuelve una referencia al objeto IDevice de ddmlib asociado.

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

Muestra
IDevice el IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Devuelve el valor entero de la propiedad determinada del dispositivo.

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

defaultValue long: Es el valor predeterminado que se devuelve 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 entero.

Arroja
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Devuelve la última vez que las APIs de Tradefed activaron un reinicio en milisegundos desde la EPOCH, según lo que devuelve System.currentTimeMillis().

Muestra
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

Muestra
int Es un número entero que indica el primer nivel de API del dispositivo que se lanzó.

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

Toma una transmisión de instantáneas de los datos de logcat.

Funciona en dos modos:

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

    Muestra
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    Toma una transmisión de instantáneas de los últimos maxBytes de los datos de logcat capturados.

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

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

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

    Muestra
    InputStreamSource un InputStreamSource de los datos de Logcat Se devuelve un flujo vacío si no se pueden capturar datos de logcat.

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

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

    Parámetros
    date long: Es el formato de milisegundos desde el ciclo de entrenamiento de cuándo comenzar la instantánea hasta el presente. (se puede obtener con "date +%s")

    Muestra
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Devuelve un punto de activación.

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

    PENDIENTE: Mover este comportamiento a IDevice.getMountPoint(String)

    Parámetros
    mountName String: el nombre del punto de montaje

    Muestra
    String El punto de activación o null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Devuelve un MountPointInfo que corresponde a la ruta de acceso del punto de montaje especificado o null si esa ruta de acceso no tiene nada montado o no aparece en /proc/mounts como un punto de montaje.

    Parámetros
    mountpoint String

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

    Arroja
    DeviceNotAvailableException

    getMountPointInfo

    public abstract  getMountPointInfo ()

    Devuelve 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 en "/proc/mounts"

    Arroja
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

    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 auxiliar ejecuta los comandos "pidof" y "stat", y devuelve el objeto ProcessInfo con el PID y la hora de inicio del proceso determinado.

    Parámetros
    processName String: Es el nombre del proceso como una cadena.

    Muestra
    ProcessInfo ProcessInfo del proceso dado processName

    Arroja
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Devuelve el PID del servicio o null si algo salió mal.

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

    Muestra
    String

    Arroja
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

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

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

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

    Método de conveniencia 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 determinado 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 ()

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

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

    getSerialNumber

    public abstract String getSerialNumber ()

    Método de conveniencia para obtener el número de serie de este dispositivo.

    Muestra
    String El número de serie String

    getTombstones

    public abstract  getTombstones ()

    Recupera y devuelve la lista de marcas de eliminación de los dispositivos. Requiere acceso raíz.

    El método es de mejor esfuerzo, por lo que, si no se puede extraer una lápida por algún motivo, no aparecerá en la lista. Solo un DeviceNotAvailableException finalizará el método de forma anticipada.

    Muestra
    Es una lista de archivos de marcadores de posición, que está vacía si no hay marcadores de posición.

    Arroja
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

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

    Muestra
    long

    getTrackingSerial

    public String getTrackingSerial ()

    Obtiene el número de serie que se usa para hacer un seguimiento del dispositivo con fines de administración.

    Muestra
    String

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Obtiene si se debe usar fastboot erase o fastboot format para borrar una partición en el dispositivo.

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

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Muestra
    boolean true si el dispositivo tiene acceso raíz 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; de lo contrario, false

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

    Comprueba si la plataforma del dispositivo admite la omisión del bloqueo del SDK de destino bajo en las instalaciones de apps

    Muestra
    boolean Es verdadero si se admite la omisión del 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á montado.

    Muestra
    boolean true si se activó debugfs

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

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

    Devuelve True si la ruta de acceso en el dispositivo es un directorio; de lo contrario, devuelve False.

    Parámetros
    deviceFilePath String

    Muestra
    boolean

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

    Devuelve si el dispositivo admite la encriptación.

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isExecutable

    public abstract boolean isExecutable (String fullPath)

    Devuelve True si la ruta de acceso al archivo en el dispositivo es un archivo ejecutable; de lo contrario, devuelve False.

    Parámetros
    fullPath String

    Muestra
    boolean

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

    Devuelve verdadero si el dispositivo no tiene pantalla y falso en caso contrario.

    Muestra
    boolean

    Arroja
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

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

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

    Muestra
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Recopila y registra los errores ANR del dispositivo.

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

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

    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 arrojará una excepción incluso si falla el registro.

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

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

    format String: Es el formato del mensaje.

    args Object: Son 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 ()

    Envía un comando para reiniciar el dispositivo y regresa 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 para las pruebas después de cada arranque.

    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.

    Se puede llamar cuando el dispositivo se reinicia debido a otros eventos (p. ej., cuando se completó 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.
    En su lugar, usa postInvocationTearDown(Throwable).

    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 hay alguna, es la excepción final que se generó por la falla 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án 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 en el que se extraerán los archivos.

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

    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 en el que se extraerán los archivos.

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

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

    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 objeto ERROR(/File) temporal local y devuelve ese objeto File.

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

    userId int: 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 objeto ERROR(/File) temporal local y devuelve ese objeto 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. En caso contrario, false.

    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: ID del usuario del que se extraerá la información

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

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

    Parámetros
    remoteFilePath String: Es la ruta de acceso al archivo en el dispositivo, relativa al punto de montaje 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: Es la ruta de acceso absoluta del archivo del destino remoto.

    userId int: ID del usuario al que se enviará la notificación push

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

    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: Es la ruta de acceso absoluta del archivo del destino remoto.

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

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

    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: Es la ruta de acceso absoluta del archivo del destino remoto.

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

    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)

    Variante de pushFile(File, String) que puede considerar de forma opcional la evaluación de 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. En caso contrario, false.

    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, se 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. En caso contrario, false.

    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, se 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 ID de usuario al que se enviará la notificación push.

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

    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 al dispositivo el archivo creado a partir de una cadena

    Parámetros
    contents String: 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. En caso contrario, false.

    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.

    Se bloquea hasta que el dispositivo esté disponible.

    Arroja
    DeviceNotAvailableException Si el dispositivo no está disponible después de reiniciarlo

    reiniciar

    public abstract void reboot (String reason)

    Reinicia el dispositivo en modo adb con el reason determinado para que persista después del reinicio.

    Se bloquea hasta que el dispositivo esté disponible.

    La razón del último reinicio se puede obtener consultando la propiedad sys.boot.reason.

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

    Arroja
    DeviceNotAvailableException Si el dispositivo no está disponible después de reiniciarlo

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Reinicia el dispositivo en el modo de cargador de arranque.

    Se bloquea hasta que el dispositivo 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 el modo fastbootd.

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

    Se bloquea hasta que el dispositivo entra en el modo de recuperación

    Arroja
    DeviceNotAvailableException Si el dispositivo no está disponible después de reiniciarlo

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

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

    Se bloquea hasta que el dispositivo entra en el 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 carga lateral después del reinicio

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

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

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

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

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

    Es una alternativa 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 de reiniciarlo

    rebootUntilOnline

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

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

    Arroja
    DeviceNotAvailableException Si el dispositivo no está disponible después de reiniciarlo

    También:

    rebootUserspace

    public abstract void rebootUserspace ()

    Solo reinicia la parte del espacio del usuario del dispositivo.

    Se bloquea hasta que el dispositivo esté disponible.

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

    Arroja
    DeviceNotAvailableException Si el dispositivo no está disponible después de reiniciarlo

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

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

    Arroja
    DeviceNotAvailableException Si el dispositivo no está disponible después de reiniciarlo

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

    Haz que la partición del sistema en el 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 la partición del proveedor en el dispositivo sea grabable. Es posible que se reinicie el dispositivo.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    runInstrumentationTests

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

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

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

    listeners ITestLifeCycleReceiver: Son los objetos de escucha de los resultados de la prueba.

    Muestra
    boolean true si se completó el comando de prueba. false si no se pudo completar, 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 falló la recuperación

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Ejecuta pruebas de instrumentación y proporciona recuperación del dispositivo.

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

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

    listeners : Son los objetos de escucha de los resultados de la prueba.

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

    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: Establecer la fecha en el dispositivo requiere acceso de administrador.

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Cómo configurar el TestDeviceOptions para el dispositivo

    Parámetros
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

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

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

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

    Muestra
    boolean Devuelve True si el comando setprop se ejecutó correctamente; de lo contrario, devuelve 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 detecta un problema de comunicación del dispositivo. Se recomienda usar este método solo con moderación cuando sea necesario (por ejemplo, cuando el framework no funciona, etc.).

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

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

    Para fines de administración de dispositivos, se hace un seguimiento del número de serie que usamos para hacer referencia al dispositivo.

    Parámetros
    trackingSerial String

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

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

    Parámetros
    useFastbootErase boolean: true si se debe usar fastboot erase o false si se debe usar fastboot format.

    startLogcat

    public abstract void startLogcat ()

    Comienza a capturar el resultado de logcat del dispositivo en segundo plano.

    No tendrá efecto si ya se está capturando el registro de logcat. Los datos se pueden recuperar más tarde con getLogcat.

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

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

    startTradeInModeTesting

    public abstract boolean startTradeInModeTesting (int timeoutMs)

    Habilita el modo de prueba de intercambio. Se borrará el dispositivo y se reiniciará.

    Parámetros
    timeoutMs int

    Muestra
    boolean Es verdadero si la operación se realizó correctamente y falso en caso contrario.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Cierra y borra el resultado del emulador.

    stopLogcat

    public abstract void stopLogcat ()

    Deja de capturar el resultado de Logcat del dispositivo y descarta los datos de Logcat guardados actualmente.

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

    stopTradeInModeTesting

    public abstract void stopTradeInModeTesting ()

    Detener la prueba del modo de intercambio Se reiniciará el dispositivo.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

    Cambia el dispositivo al modo adb-over-tcp.

    Muestra
    String El número de serie de 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 a través de USB.

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

    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 transferirán al dispositivo los archivos "más nuevos" o los que no existan. Por lo tanto, la sobrecarga debería ser relativamente pequeña si el conjunto de archivos del dispositivo ya está actualizado.

    Se ignorarán los archivos ocultos (con nombres que comiencen 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 deben enviar 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 al archivo deben ser legibles. Es decir, si se intenta enviar a /data/local/tmp cuando adb no es root, se producirá un error.

    Muestra
    boolean true si los archivos se sincronizaron correctamente. En caso contrario, false.

    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á 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 este método muestre un valor de retorno.

    Muestra
    boolean true si la operación 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 el dispositivo no admite la encriptación

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Desmonta debugfs.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Se bloquea hasta que se establece la marca de inicio completo del dispositivo.

    Parámetros
    timeOut long: 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 responda y esté disponible para las pruebas. Se 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 responda 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 vence waitTime.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Espera a que el dispositivo responda y esté disponible sin tener en cuenta 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 ()

    Se bloquea hasta que el dispositivo esté 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 es diferente de IDeviceRecovery).

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

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

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Bloqueos para que el dispositivo esté en el estado "adb sideload"

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

    Muestra
    boolean true si el dispositivo se inicia en la transferencia 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 aparezca en adb.

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

    Muestra
    boolean true si el dispositivo deja de estar disponible antes de que venza el tiempo false de lo contrario

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

    Se bloquea hasta que el dispositivo esté 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 el proceso. 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)

    Se bloquea hasta que el dispositivo esté visible a través de adb.

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

    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