Dispositivo nativo

public interface INativeDevice

com.android.tradefed.device.INativeDevice.


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

Reintenta los comandos del dispositivo hasta una cantidad configurable 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)

Comprobar si una función es compatible actualmente con un nivel mínimamente admitido

abstract void clearLogcat()

Borra todos los datos acumulados de logcat.

abstract void deleteFile(String deviceFilePath)

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

abstract void deleteFile(String deviceFilePath, int userId)

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

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

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

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Método de ayuda para verificar si el dispositivo se reinició de forma no definitiva desde la hora UTC desde la época del dispositivo y su ERROR(/TimeUnit).

abstract boolean disableAdbRoot()

Desactiva la raíz de adb.

abstract boolean doesFileExist(String deviceFilePath)

Es un método de ayuda para determinar si existe un archivo en el dispositivo.

abstract boolean enableAdbRoot()

Activa la raíz de adb.

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

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

abstract String executeAdbCommand(String... commandArgs)

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

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

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

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

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

abstract CommandResult executeFastbootCommand(String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

Es un método de ayuda 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)

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

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

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

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

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

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

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

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

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

abstract CommandResult fastbootWipePartition(String partition)

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

abstract int getApiLevel()

Obtén 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()

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

abstract boolean getBooleanProperty(String name, boolean defaultValue)

Muestra el valor booleano de la propiedad especificada.

abstract getBootHistory()

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

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

El método auxiliar recopila el mapa del historial de inicio con el tiempo de inicio y el motivo de inicio desde el tiempo determinado desde el ciclo de entrenamiento 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 el dispositivo está ejecutando actualmente.

abstract String getBuildFlavor()

Recupera la variante de compilación para el dispositivo.

abstract String getBuildId()

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

abstract String getBuildSigningKeys()

Devuelve el tipo de clave usado para firmar la imagen del dispositivo

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

abstract DeviceDescriptor getCachedDeviceDescriptor()

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

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

abstract String[] getChildren(String deviceFilePath)

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

abstract AbstractConnection getConnection()

Muestra la conexión asociada con el dispositivo.

abstract String getDeviceClass()

Obtén la clase de dispositivo.

abstract long getDeviceDate()

Muestra la fecha del dispositivo en milisegundos desde el ciclo de entrenamiento.

abstract DeviceDescriptor getDeviceDescriptor()

Muestra un DeviceDescriptor a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo en sí.

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Muestra un DeviceDescriptor a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo en sí.

abstract TestDeviceState getDeviceState()

Obtén el estado del dispositivo.

abstract long getDeviceTimeOffset(Date date)

Es una herramienta de ayuda para obtener la diferencia de hora entre el dispositivo y un ERROR(/Date) determinado.

abstract InputStreamSource getEmulatorOutput()

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

abstract long getExternalStoreFreeSpace()

Es un método de ayuda 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 de fastboot específico del dispositivo.

abstract IFileEntry getFileEntry(String path)

Recupera una referencia a un archivo remoto en el dispositivo.

abstract IDevice getIDevice()

Muestra una referencia al IDevice de ddmlib asociado.

abstract long getIntProperty(String name, long defaultValue)

Muestra el valor entero de la propiedad determinada del dispositivo.

abstract long getLastExpectedRebootTimeMillis()

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

abstract int getLaunchApiLevel()

Obtener el primer nivel de API iniciado en el dispositivo

abstract InputStreamSource getLogcat()

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

abstract InputStreamSource getLogcat(int maxBytes)

Captura una transmisión de instantáneas del último maxBytes de los datos de logcat capturados.

abstract InputStreamSource getLogcatDump()

Obtén un volcado del logcat actual del dispositivo.

abstract InputStreamSource getLogcatSince(long date)

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

abstract String getMountPoint(String mountName)

Muestra un punto de activación.

abstract ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

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

abstract getMountPointInfo()

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

abstract long getPartitionFreeSpace(String partition)

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

abstract ProcessInfo getProcessByName(String processName)

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

abstract String getProcessPid(String process)

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

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 de producto de este dispositivo.

abstract String getProperty(String name)

Recupera el valor de propiedad determinado del dispositivo.

abstract ITestDevice.RecoveryMode getRecoveryMode()

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

abstract String getSerialNumber()

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

abstract getTombstones()

Recupera y muestra la lista de tombstones 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.

abstract boolean getUseFastbootErase()

Determina si se debe usar el formato de fastboot o borrado de fastboot para limpiar una partición del dispositivo.

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

Cómo comprobar si la plataforma en el dispositivo admite la enumeración de apps

abstract boolean isBypassLowTargetSdkBlockSupported()

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

abstract boolean isDebugfsMounted()

Verifica si el elemento debugfs está activado.

abstract boolean isDeviceEncrypted()

Muestra si el dispositivo está encriptado.

abstract boolean isDirectory(String deviceFilePath)

Muestra el valor True si la ruta de acceso en el dispositivo es un directorio. De lo contrario, muestra false.

abstract boolean isEncryptionSupported()

Se devuelve si el dispositivo admite la encriptación.

abstract boolean isExecutable(String fullPath)

Muestra el valor True si la ruta de acceso al archivo en el dispositivo es ejecutable. De lo contrario, muestra false.

abstract boolean isHeadless()

Muestra true si el dispositivo no tiene interfaz gráfica (sin pantalla). De lo contrario, muestra false.

abstract boolean isRuntimePermissionSupported()

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

abstract boolean isStateBootloaderOrFastbootd()

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

abstract boolean logAnrs(ITestLogger logger)

Recopila y registra ANR del dispositivo.

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

Registra un mensaje en el logcat del dispositivo.

abstract void mountDebugfs()

Activa Debugfs.

abstract void nonBlockingReboot()

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

abstract void postBootSetup()

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

default void postInvocationTearDown()

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

abstract void postInvocationTearDown(Throwable invocationException)

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

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

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

abstract boolean pullDir(String deviceFilePath, File localDir)

Extrae contenido del directorio del dispositivo de manera recurrente.

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

Extrae contenido del directorio del dispositivo de manera recurrente.

abstract File pullFile(String remoteFilePath, int userId)

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

abstract File pullFile(String remoteFilePath)

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

abstract boolean pullFile(String remoteFilePath, File localFile)

Recupera un archivo fuera del dispositivo.

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

Recupera un archivo fuera del dispositivo.

abstract String pullFileContents(String remoteFilePath)

Recupera un archivo fuera del dispositivo y muestra el contenido.

abstract File pullFileFromExternal(String remoteFilePath)

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

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

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

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

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

abstract boolean pushDir(File localDir, String deviceFilePath)

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

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

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

abstract boolean pushFile(File localFile, String deviceFilePath)

Envía un archivo al dispositivo.

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

Envía un archivo al dispositivo.

abstract boolean pushString(String contents, String deviceFilePath)

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

abstract void reboot()

Reinicia el dispositivo en modo adb.

abstract void reboot(String reason)

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

abstract void rebootIntoBootloader()

Reinicia el dispositivo en el modo de bootloader.

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 transferencia de adb (ten en cuenta que se trata de un modo especial en recuperación).

Se bloquea hasta que el dispositivo entre en modo de transferencia

abstract void rebootIntoSideload()

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

Se bloquea hasta que el dispositivo entre en modo de transferencia

abstract void rebootUntilOnline()

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

abstract void rebootUntilOnline(String reason)

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

abstract void rebootUserspace()

Reinicia solo una parte del espacio del usuario del dispositivo.

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.

abstract void remountSystemReadOnly()

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

abstract void remountSystemWritable()

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

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

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 de dispositivos.

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

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

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

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

abstract void setDate(Date date)

Establece la fecha en el dispositivo

Nota: La configuración de la fecha en el dispositivo requiere permisos de administrador

abstract void setOptions(TestDeviceOptions options)

Establece el TestDeviceOptions para el dispositivo.

abstract boolean setProperty(String propKey, String propValue)

Establece el valor de la propiedad determinada en el dispositivo.

abstract void setRecovery(IDeviceRecovery recovery)

Configura el parámetro IDeviceRecovery que se usará en este dispositivo.

abstract void setRecoveryMode(ITestDevice.RecoveryMode mode)

Configura el modo de recuperación que se usará en el dispositivo.

abstract void setUseFastbootErase(boolean useFastbootErase)

Configura si quieres usar el formato de fastboot o borrado de fastboot para limpiar una partición del dispositivo.

abstract void startLogcat()

Comienza a capturar resultados de logcat del dispositivo en segundo plano.

abstract void stopEmulatorOutput()

Cierra y borra el resultado del emulador.

abstract void stopLogcat()

Detén la captura de resultados de logcat del dispositivo y descarta los datos de logcat guardados actualmente.

abstract String switchToAdbTcp()

Cambia el dispositivo al modo adb-over-tcp.

abstract boolean switchToAdbUsb()

Cambia el dispositivo al modo adb mediante USB.

abstract boolean syncFiles(File localFileDir, String deviceFilePath)

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

abstract boolean unlockDevice()

Desbloquea el dispositivo si está encriptado.

abstract void unmountDebugfs()

Desactiva Debugfs.

abstract boolean waitForBootComplete(long timeOut)

Se bloquea hasta que se establezca la marca de inicio completado 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 considerar la ruta de recuperación.

abstract void waitForDeviceBootloader()

Se bloquea hasta que el dispositivo sea visible mediante fastboot.

abstract boolean waitForDeviceInRecovery(long waitTime)

Bloquea el dispositivo en el estado de "recuperación de adb" (ten en cuenta que es distinto de IDeviceRecovery).

abstract boolean waitForDeviceInSideload(long waitTime)

Bloqueos para que el dispositivo tenga el estado "transferencia de adb"

abstract boolean waitForDeviceNotAvailable(long waitTime)

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

abstract void waitForDeviceOnline()

Se bloquea hasta que el dispositivo sea visible mediante adb.

abstract void waitForDeviceOnline(long waitTime)

Se bloquea hasta que el dispositivo sea visible mediante adb.

abstract boolean waitForDeviceShell(long waitTime)

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

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)

Comprobar si una función es compatible actualmente con un nivel mínimamente admitido Este método tiene en cuenta las funciones no publicadas aún, antes de que se suba el nivel de API.

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteLogcat

public abstract void clearLogcat ()

Borra todos los datos acumulados de logcat.

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

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Reinicio en segundo plano del dispositivo

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

Devuelve
boolean true si se reinició de forma no definitiva el dispositivo

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

Reinicio no definitiva desde el dispositivo

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

Devuelve
boolean true si se reinició de forma no definitiva el dispositivo

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

inhabilitarAdbRoot

public abstract boolean disableAdbRoot ()

Desactiva la raíz de adb.

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

Devuelve
boolean true si se realiza correctamente.

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

haceArchivoexist

public abstract boolean doesFileExist (String deviceFilePath)

Es un método de ayuda para determinar si existe un archivo en el dispositivo.

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

Devuelve
boolean true si el archivo ya 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 la raíz de adb. Si la configuración “enable-root” es “false”, registrará un mensaje y se mostrará sin habilitar la raíz.

Si habilitas la raíz de adb, es posible que el dispositivo se desconecte de adb. Este método se bloqueará hasta que el dispositivo esté disponible.

Devuelve
boolean true si se realiza correctamente.

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

EjecutarAdbCommand

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

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

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

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

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

Devuelve
String el stdout desde el 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.

EjecutarAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

Parámetros
commandArgs String: Es el comando adb y los argumentos para ejecutar.

Devuelve
String el stdout desde el 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.

EjecutarAdbCommand

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

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

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

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

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

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

Devuelve
String el stdout desde el 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.

EjecutarFastbootCommand

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

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

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

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

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

Devuelve
CommandResult el CommandResult, que contiene la salida del comando

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

EjecutarFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

Devuelve
CommandResult el CommandResult, que contiene la salida del comando

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

ejecutarLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

Devuelve
CommandResult el CommandResult, que contiene la salida del comando

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

ejecutarLongFastbootCommand

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.

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: Es el comando fastboot y los argumentos para ejecutar.

Devuelve
CommandResult el CommandResult, que contiene la salida del comando

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

Comando runShell

public abstract String executeShellCommand (String command)

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

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

Devuelve
String el resultado del shell

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

Comando runShell

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

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

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

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

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

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

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

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

Comando runShell

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

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

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

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

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

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

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

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

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

Comando runShell

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

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

Comando runShellV2

public abstract CommandResult executeShellV2Command (String command)

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

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

Devuelve
CommandResult El resultado en CommandResult.

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

Comando runShellV2

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

Es un método auxiliar que ejecuta un comando shell de adb y muestra los resultados como un CommandResult propagado correctamente con el resultado del estado del comando y stderr. stdout se dirige a la transmisión especificada.

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

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

Devuelve
CommandResult El resultado en CommandResult.

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

Comando runShellV2

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

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

Devuelve
CommandResult El resultado en CommandResult.

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

Comando runShellV2

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

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

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

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

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

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

Devuelve
CommandResult

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

Comando runShellV2

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

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

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

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

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

Devuelve
CommandResult

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

Comando runShellV2

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

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

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

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

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

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

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

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

Devuelve
CommandResult

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

Comando runShellV2

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

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

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

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

pipeToOutput OutputStream: ERROR(/OutputStream) donde se redireccionará el resultado 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; unidad como se especifica en timeUnit.

timeUnit TimeUnit: unidad para maxTimeToOutputShellResponse

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

Devuelve
CommandResult

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

fastbootWipePartition.

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

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

Devuelve
CommandResult el CommandResult, que contiene la salida del comando

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

getApiLevel.

public abstract int getApiLevel ()

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

Devuelve
int un número entero que indica el nivel de API del dispositivo

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

getBatería

public abstract Integer getBattery ()

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

Devuelve
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Muestra el valor booleano de la propiedad especificada.

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

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

Devuelve
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, de lo contrario, defaultValue.

Arroja
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

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

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

Arroja
DeviceNotAvailableException

getBootHistoryDesde

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

timeUnit TimeUnit: Es la unidad de tiempo TimeUnit.

Devuelve
Mapa de la hora de inicio (hora UTC en segundos desde la época) y el motivo del 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 [Fastboot mode], intentará recuperar la versión de fastboot).

Devuelve
String la versión del bootloader String o null si no se encuentra

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 el dispositivo está ejecutando actualmente.

El alias de compilación suele ser una string más legible que el ID de compilación (generalmente, 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.

Devuelve
String el alias de compilación o recurrir al ID de compilación 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.

Devuelve
String la variante de compilación o un valor nulo si no se pudo recuperar

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

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

Devuelve
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 usado para firmar la imagen del dispositivo

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Devuelve
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Devuelve
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Muestra la conexión asociada con el dispositivo.

Devuelve
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Obtén la clase de dispositivo.

Devuelve
String la clase de dispositivo String

getDeviceDate

public abstract long getDeviceDate ()

Muestra la fecha del dispositivo en milisegundos desde el ciclo de entrenamiento.

Devuelve
long la fecha del dispositivo en formato epoch.

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor.

public abstract DeviceDescriptor getDeviceDescriptor ()

Muestra un DeviceDescriptor a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo en sí.

Devuelve
DeviceDescriptor

getDeviceDescriptor.

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Muestra un DeviceDescriptor a partir de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo en sí.

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

Devuelve
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Obtén el estado del dispositivo.

Devuelve
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

Parámetros
date Date

Devuelve
long la diferencia en milisegundos

Arroja
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

Devuelve
InputStreamSource salida del emulador

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

Devuelve
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 un poco más segura que el método genérico getProductType(), ya que ITestDevice sabrá que debe recuperar el dispositivo en fastboot si este se encuentra en un estado incorrecto o no responde.

Devuelve
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 un poco más segura que el método genérico getProductType(), ya que ITestDevice sabrá que debe recuperar el dispositivo en fastboot si este se encuentra en un estado incorrecto o no responde.

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

Devuelve
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

Arroja
Excepción de operación no admitida
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 del archivo que se recuperará. Puede ser una ruta de acceso absoluta o una ruta de acceso relativa a "/" (es decir, se admite tanto la sintaxis "/system" como "system")

Devuelve
IFileEntry IFileEntry o null si no se puede encontrar el archivo en el path especificado.

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Muestra una referencia al IDevice de ddmlib asociado.

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

Devuelve
IDevice IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Muestra 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 muestra si la propiedad está vacía o no existe.

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

Arroja
DeviceNotAvailableException

getLastExpectedRestartTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Devuelve
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat.

public abstract InputStreamSource getLogcat ()

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

Funciona en dos modos:

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

    Devuelve
    InputStreamSource

  • getLogcat.

    public abstract InputStreamSource getLogcat (int maxBytes)

    Captura una transmisión de instantáneas del último maxBytes de los datos de logcat capturados.

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

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

    Devuelve
    InputStreamSource

    getLogcatDump.

    public abstract InputStreamSource getLogcatDump ()

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

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

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

    getLogcatdesde.

    public abstract InputStreamSource getLogcatSince (long date)

    Captura una transmisión de instantáneas de los datos capturados de logcat a partir de la fecha proporcionada. La hora en el dispositivo debe usarse como getDeviceDate().

    Parámetros
    date long: Indica en milisegundos desde el formato epoch en el que se inicia la instantánea hasta el presente. (puede obtenerse usando 'fecha +%s')

    Devuelve
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Muestra un punto de activación.

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

    PENDIENTE: Trasladar este comportamiento a IDevice#getMountPoint(String)

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

    Devuelve
    String el punto de activación o null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Parámetros
    mountpoint String

    Devuelve
    ITestDevice.MountPointInfo Un ERROR(/List) de MountPointInfo que contenga 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.

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

    Arroja
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

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

    Parámetros
    partition String

    Devuelve
    long la cantidad de espacio libre en KB

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

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

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

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

    Devuelve
    ProcessInfo ProcessInfo de processName determinado

    Arroja
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

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

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

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

    Devuelve
    String el nombre del tipo de producto String No será nulo

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

    getProductVariant

    public abstract String getProductVariant ()

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

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

    Devuelve
    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 propiedad determinado del dispositivo.

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode.

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

    Devuelve
    ITestDevice.RecoveryMode y el modo de recuperación que se usa actualmente para ese dispositivo.

    getSerialNumber

    public abstract String getSerialNumber ()

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

    Devuelve
    String el número de serie de String

    getTombstones

    public abstract  getTombstones ()

    Recupera y muestra la lista de tombstones de los dispositivos. Requiere permisos de administrador.

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

    Devuelve
    Una lista de archivos de tombstone, vacío si no hay tombstone.

    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.

    Devuelve
    long

    getUseFastbootBorra

    public abstract boolean getUseFastbootErase ()

    Determina si se debe usar el formato de fastboot o borrado de fastboot para limpiar una partición del dispositivo.

    Devuelve
    boolean true si se usará el borrado de fastboot o false si se usará el formato de fastboot.

    RaízAdB

    public abstract boolean isAdbRoot ()

    Devuelve
    boolean true si el dispositivo tiene raíz de adb. De lo contrario, es false.

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

    isAdbTcp

    public abstract boolean isAdbTcp ()

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

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

    Cómo comprobar si la plataforma en el dispositivo admite la enumeración de apps

    Devuelve
    boolean Es verdadero si se admite la enumeración de app. De lo contrario, es falso.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Verifica si el elemento debugfs está activado.

    Devuelve
    boolean true si se activa " debugfs"

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Muestra si el dispositivo está encriptado.

    Devuelve
    boolean Es true si el dispositivo está encriptado.

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

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

    Muestra el valor True si la ruta de acceso en el dispositivo es un directorio. De lo contrario, muestra false.

    Parámetros
    deviceFilePath String

    Devuelve
    boolean

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Compatible con la encriptación

    public abstract boolean isEncryptionSupported ()

    Se devuelve si el dispositivo admite la encriptación.

    Devuelve
    boolean Es true si el dispositivo es compatible con la encriptación.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Se puede ejecutar

    public abstract boolean isExecutable (String fullPath)

    Muestra el valor True si la ruta de acceso al archivo en el dispositivo es ejecutable. De lo contrario, muestra false.

    Parámetros
    fullPath String

    Devuelve
    boolean

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Sin interfaz gráfica

    public abstract boolean isHeadless ()

    Muestra true si el dispositivo no tiene interfaz gráfica (sin pantalla). De lo contrario, muestra false.

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

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

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

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

    Devuelve
    boolean

    LogAnrs.

    public abstract boolean logAnrs (ITestLogger logger)

    Recopila y registra ANR del dispositivo.

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

    Devuelve
    boolean Es verdadero si se realizó correctamente el registro. De lo contrario, es falso.

    Arroja
    DeviceNotAvailableException

    Dispositivo de acceso

    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á, incluso, si falla el registro.

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

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

    format String: Es el formato del mensaje.

    args Object: Son los argumentos que se reemplazarán mediante String.format().

    monteDebugfs

    public abstract void mountDebugfs ()

    Activa Debugfs.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    reinicio no bloqueado

    public abstract void nonBlockingReboot ()

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Configuración posterior al arranque

    public abstract void postBootSetup ()

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

    Se debe llamar una vez que el dispositivo se haya iniciado por completo o esté disponible

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

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

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

    TearDown después de la invocación

    public void postInvocationTearDown ()

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

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

    TearDown después de la invocación

    public abstract void postInvocationTearDown (Throwable invocationException)

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

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

    Configuración previa a la invocación

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

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

    Parámetros
    info IBuildInfo: El IBuildInfo del dispositivo.

    attributes MultiMap: 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 contenido del directorio del dispositivo de manera recurrente.

    Parámetros
    deviceFilePath String: La ruta de acceso absoluta al archivo de la fuente remota

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

    Devuelve
    boolean true si el archivo se extrajo correctamente. De lo 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 contenido del directorio del dispositivo de manera recurrente.

    Parámetros
    deviceFilePath String: La ruta de acceso absoluta al archivo de la fuente remota

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

    userId int: Es el ID de usuario desde el que se realizará la extracción.

    Devuelve
    boolean true si el archivo se extrajo correctamente. De lo contrario, false.

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

    Archivo pull

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

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

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

    userId int: Es el ID de usuario desde el que se realizará la extracción.

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

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

    Archivo pull

    public abstract File pullFile (String remoteFilePath)

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

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

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

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

    Archivo pull

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    Recupera un archivo fuera 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.

    Devuelve
    boolean Es true si el archivo se recuperó correctamente. De lo contrario, false.

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

    Archivo pull

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

    Recupera un archivo fuera 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: Es el ID de usuario desde el que se realizará la extracción.

    Devuelve
    boolean Es true si el archivo se recuperó correctamente. De lo 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 fuera del dispositivo y muestra el contenido.

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

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

    Arroja
    DeviceNotAvailableException

    extraerArchivoDeexterno

    public abstract File pullFileFromExternal (String remoteFilePath)

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

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

    Devuelve
    File Un ERROR(/File) con el contenido del archivo del dispositivo, o null si la copia falló por algún motivo (incluidos los 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 manera recurrente 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 al archivo del destino remoto.

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

    Devuelve
    boolean true si el archivo se envió correctamente. De lo 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 manera recurrente el contenido del directorio al dispositivo y, al mismo tiempo, excluye algunos directorios filtrados.

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

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

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

    Devuelve
    boolean true si el archivo se envió correctamente. De lo 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 manera recurrente 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 al archivo del destino remoto.

    Devuelve
    boolean true si el archivo se envió correctamente. De lo contrario, false.

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

    Archivo push

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

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

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

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

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

    Devuelve
    boolean true si el archivo se envió correctamente. De lo contrario, false.

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

    Archivo push

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Envía un archivo al dispositivo. De forma predeterminada, con 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.

    Devuelve
    boolean true si el archivo se envió correctamente. De lo contrario, false.

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

    Archivo push

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

    Envía un archivo al dispositivo. De forma predeterminada, con 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: El userId al que se enviará el mensaje

    Devuelve
    boolean true si el archivo se envió correctamente. De lo 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ío de archivo creado a partir de una cadena al dispositivo

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

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

    Devuelve
    boolean true si la cadena se envió correctamente. De lo 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 reiniciar el dispositivo

    reiniciar

    public abstract void reboot (String reason)

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

    Se bloquea hasta que el dispositivo esté disponible.

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

    Parámetros
    reason String: Es un motivo para el reinicio o null si no se especifica un motivo.

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    reiniciarIntoBootloader

    public abstract void rebootIntoBootloader ()

    Reinicia el dispositivo en el modo de bootloader.

    Se bloquea hasta que el dispositivo esté en el modo de bootloader.

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

    reiniciarIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Reinicia el dispositivo en el modo fastbootd.

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

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

    reinicio en la recuperación

    public abstract void rebootIntoRecovery ()

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

    Se bloquea hasta que el dispositivo entre en recuperación

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    reiniciarIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

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

    Se bloquea hasta que el dispositivo entre en modo de transferencia

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

    Arroja
    DeviceNotAvailableException si el dispositivo no está en side-load después de reiniciar.

    reiniciarIntoSideload

    public abstract void rebootIntoSideload ()

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

    Se bloquea hasta que el dispositivo entre en modo de transferencia

    Arroja
    DeviceNotAvailableException si el dispositivo no está en side-load después de reiniciar.

    reiniciarHastaEn línea

    public abstract void rebootUntilOnline ()

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

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    reiniciarHastaEn línea

    public abstract void rebootUntilOnline (String reason)

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

    Parámetros
    reason String: Es un motivo para el reinicio o null si no se especifica un motivo.

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    También:

    espacio de usuario de reinicio

    public abstract void rebootUserspace ()

    Reinicia solo una parte del espacio del usuario del dispositivo.

    Se bloquea hasta que el dispositivo esté disponible.

    ADVERTENCIA. En este momento, el reinicio del espacio del usuario está en desarrollo activo. Úsalo bajo tu responsabilidad.

    Arroja
    DeviceNotAvailableException si el dispositivo no está disponible después de reiniciar el dispositivo

    reiniciarelespaciodeusuarioHastaEn línea

    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 reiniciar el dispositivo

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

    Permite 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

    remountVendor (solo lectura)

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

    Permitir que se pueda escribir en la partición del proveedor en el dispositivo. 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: El IRemoteAndroidTestRunner que ejecuta las pruebas

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

    Devuelve
    boolean Es 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, no se pudo completar el comando de prueba o no se pudo completar la recuperación.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

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

    Si se pierde la conexión con el dispositivo antes de que se complete la ejecución de prueba y la recuperación se realiza correctamente, se informará a todos los objetos de escucha sobre testRunFailed y se mostrará el valor "false". No se volverá a ejecutar el comando de prueba. Los emisores 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: El IRemoteAndroidTestRunner que ejecuta las pruebas

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

    Devuelve
    boolean Es 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 la recuperación se realizó correctamente

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

    runInstrumentationTestsComoUsuario

    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

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    runInstrumentationTestsComoUsuario

    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

    Devuelve
    boolean

    Arroja
    DeviceNotAvailableException

    Configurar Fecha

    public abstract void setDate (Date date)

    Establece la fecha en el dispositivo

    Nota: La configuración de la fecha en el dispositivo requiere permisos de administrador

    Parámetros
    date Date: Especifica una fecha específica; se usará la fecha de host si null

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Establece el TestDeviceOptions para el dispositivo.

    Parámetros
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Establece el valor de la propiedad determinada en el dispositivo. Se requiere que la raíz de adb sea verdadera.

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

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

    Devuelve
    boolean Devuelve True si el comando setprop tuvo éxito; de lo contrario, muestra False.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Configura el parámetro IDeviceRecovery que se usará en este dispositivo. Se debe configurar cuando se asigna el dispositivo por primera vez.

    Parámetros
    recovery IDeviceRecovery: el IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Configura el modo de recuperación que se usará en el dispositivo.

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

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

    setUsarInicioRápidoBorrar

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Configura si quieres usar el formato de fastboot o borrado de fastboot para limpiar una partición del dispositivo.

    Parámetros
    useFastbootErase boolean: Es true si se debe usar el borrado de fastboot o false si se debe usar el formato de fastboot.

    startLogcat

    public abstract void startLogcat ()

    Comienza a capturar resultados de logcat del dispositivo en segundo plano.

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

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

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

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Cierra y borra el resultado del emulador.

    detenerLogcat

    public abstract void stopLogcat ()

    Detén la captura de resultados de logcat del dispositivo y descarta los datos de logcat guardados actualmente.

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

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

    Cambia el dispositivo al modo adb-over-tcp.

    Devuelve
    String el número de serie de TCP o null si no se pudo cambiar el dispositivo

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    cambiarAAdbusb

    public abstract boolean switchToAdbUsb ()

    Cambia el dispositivo al modo adb mediante USB.

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

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Archivos sincronizados

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

    Decide qué archivos enviar comparando las marcas de tiempo de los archivos locales con sus equivalentes remotos. Solo se enviarán al dispositivo los archivos "más nuevos" o que no existan. Por lo tanto, la sobrecarga debería ser relativamente pequeña si el archivo configurado en el 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 manera recurrente el contenido de /tmp/files a /sdcard/files.

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

    deviceFilePath String: Es la raíz de la ruta de acceso absoluta del archivo de destino remoto. Todos los directorios de esta ruta de acceso del archivo deben ser legibles. Es decir, no se podrá enviar a /data/local/tmp cuando adb no sea raíz.

    Devuelve
    boolean true si los archivos se sincronizaron correctamente. De lo contrario, false.

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

    desbloquearDispositivo

    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 las pruebas cuando se muestre este método.

    Devuelve
    boolean Es true si se ejecuta 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 ()

    Desactiva Debugfs.

    Arroja
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Se bloquea hasta que se establezca la marca de inicio completado del dispositivo.

    Parámetros
    timeOut long: Tiempo en ms para esperar a que se establezca la marca

    Devuelve
    boolean true si la marca de inicio completado 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. Usa el tiempo de espera predeterminado.

    Devuelve
    boolean Verdadero si el dispositivo está disponible. 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.

    Devuelve
    boolean Verdadero si el dispositivo está disponible. Falso si la recuperación está inhabilitada y no está disponible.

    Arroja
    DeviceNotAvailableException Si el dispositivo aún no responde después de que se acabe el tiempo de espera.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Parámetros
    waitTime long

    Devuelve
    boolean Verdadero si el dispositivo está disponible. 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 sea visible mediante fastboot. Usar 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 en el estado de "recuperación de adb" (ten en cuenta que es distinto de IDeviceRecovery).

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

    Devuelve
    boolean Es true si el dispositivo se inicia en recuperación antes de que finalice el tiempo. false por lo demás

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Bloqueos para que el dispositivo tenga el estado "transferencia de adb"

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

    Devuelve
    boolean Es true si el dispositivo se inicia en una transferencia antes de que finalice el tiempo. false por lo demás

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

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

    Devuelve
    boolean true si el dispositivo no está disponible antes de que se acabe el tiempo. false por lo demás

    waitForDeviceEn línea

    public abstract void waitForDeviceOnline ()

    Se bloquea hasta que el dispositivo sea visible mediante adb. Usa el tiempo de espera predeterminado

    Ten en cuenta que es posible que el dispositivo no responda a los comandos una vez completado. En su lugar, usa waitForDeviceAvailable().

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

    waitForDeviceEn línea

    public abstract void waitForDeviceOnline (long waitTime)

    Se bloquea hasta que el dispositivo sea visible mediante adb.

    Ten en cuenta que es posible que el dispositivo no responda a los comandos una vez completado. 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 shell adb básico.

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

    Devuelve
    boolean Es true si el dispositivo responde antes de que transcurra la waitTime.