Dispositivo nativo
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
Objeto java.lang. | |
↳ | com.android.tradefed.device.NativeDevice |
Implementación predeterminada de un dispositivo Android ITestDevice
que no es de pila completa.
Resumen
Clases anidadas | |
---|---|
class |
NativeDevice.AdbAction
Un |
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
Constantes | |
---|---|
int |
INVALID_USER_ID
Valor que se muestra para cualquier ID de usuario no válido o no encontrado: UserHandle definió el valor -10000 |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
la cantidad predeterminada de reintentos de comandos que se deben realizar |
Campos | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
Constructores públicos | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Crea un |
Métodos públicos | |
---|---|
void
|
batchPrefetchStartupBuildProps()
Microoptimización (alrededor de 400 milisegundos) mediante la carga previa de todas las props que necesitamos, en lugar de llamar a "adb getprop" para cada una. |
boolean
|
canSwitchToHeadlessSystemUser()
Muestra si se le permite cambiar al usuario de SYSTEM sin interfaz gráfica. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Comprueba si una función es compatible actualmente con un nivel mínimamente compatible. |
boolean
|
checkConnectivity()
Verifica que el dispositivo tenga conectividad de red. |
boolean
|
clearErrorDialogs()
Intenta descartar los diálogos de error que se muestran actualmente en la IU del dispositivo. |
void
|
clearLastConnectedWifiNetwork()
Borra la última red Wi-Fi conectada. |
void
|
clearLogcat()
Borra todos los datos acumulados de logcat. |
boolean
|
connectToWifiNetwork(
Se conecta a una red Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Se conecta a una red Wi-Fi. |
boolean
|
connectToWifiNetwork(
Se conecta a una red Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Se conecta a una red Wi-Fi. |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
Es una variante de |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
Es una variante de |
int
|
createUser(String name, boolean guest, boolean ephemeral)
Crea un usuario con un nombre determinado y las marcas proporcionadas |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Crea un usuario con un nombre determinado y las marcas proporcionadas |
int
|
createUser(String name)
Crea un usuario con un nombre determinado y las marcas predeterminadas 0. |
int
|
createUserNoThrow(String name)
Crea un usuario con un nombre determinado y las marcas predeterminadas 0. |
void
|
deleteFile(String deviceFilePath, int userId)
Es un método auxiliar para borrar un archivo o directorio del dispositivo. |
void
|
deleteFile(String deviceFilePath)
Es un método auxiliar para borrar un archivo o directorio del dispositivo. |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Quita el |
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 |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Es un método auxiliar para verificar si el dispositivo se reinició de forma suave desde la hora UTC desde la época del dispositivo y su |
boolean
|
disableAdbRoot()
Desactiva el acceso raíz de adb. |
void
|
disableKeyguard()
Intenta inhabilitar el bloqueo de teclas. |
boolean
|
disableNetworkMonitor()
Inhabilita la supervisión de red en el dispositivo. |
boolean
|
disconnectFromWifi()
Se desconecta de una red Wi-Fi. |
boolean
|
doesFileExist(String deviceFilePath, int userId)
Es un método auxiliar para determinar si existe un archivo en el dispositivo para un usuario determinado. |
boolean
|
doesFileExist(String deviceFilePath)
Método auxiliar para determinar si existe un archivo en el dispositivo. |
File
|
dumpHeap(String process, String devicePath)
Intenta volcar el montón desde system_server. |
boolean
|
enableAdbRoot()
Activa el permiso de administrador de adb. |
boolean
|
enableNetworkMonitor()
Habilita la supervisión de red en el dispositivo. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
Es un método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado. |
String
|
executeAdbCommand(long timeout,
Es un método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado. |
String
|
executeAdbCommand(String... cmdArgs)
Es un método de ayuda que ejecuta un comando adb como un comando del sistema. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
Método auxiliar que ejecuta un comando fastboot como un comando del sistema con un tiempo de espera predeterminado de 2 minutos. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
Método de ayuda que ejecuta un comando fastboot como un comando del sistema. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
Es un método auxiliar que ejecuta un comando fastboot de larga duración como un comando del sistema. |
CommandResult
|
executeLongFastbootCommand(
Es un método auxiliar que ejecuta un comando fastboot de larga duración como un comando del sistema con variables de entorno del sistema. |
String
|
executeShellCommand(String command)
Es un método de ayuda que ejecuta un comando shell de adb y muestra el resultado como un |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando adb shell, con más parámetros para controlar el comportamiento del comando. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Ejecuta el comando adb shell determinado y vuelve a intentarlo varias veces si falla. |
CommandResult
|
executeShellV2Command(String cmd)
Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un |
CommandResult
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como una |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando shell de adb, con más parámetros para controlar el comportamiento del comando. |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Ejecuta un comando adb shell, con más parámetros para controlar el comportamiento del comando. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando adb shell, con más parámetros para controlar el comportamiento del comando. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando adb shell, con más parámetros para controlar el comportamiento del comando. |
CommandResult
|
fastbootWipePartition(String partition)
Es un método auxiliar que borra una partición del dispositivo. |
|
getActiveApexes()
Recupera la información sobre los APEX activados en el dispositivo. |
|
getAllSettings(String namespace)
Muestra los pares clave-valor del espacio de nombres solicitado. |
DeviceAllocationState
|
getAllocationState()
Muestra el estado de asignación actual del dispositivo |
String
|
getAndroidId(int userId)
Busca y muestra el android-id asociado con un userId (valor nulo si no se encuentra). |
|
getAndroidIds()
Crea un mapa de los ID de Android encontrados que coincidan con los ID de usuario. |
int
|
getApiLevel()
Obtén el nivel de API del dispositivo. |
PackageInfo
|
getAppPackageInfo(String packageName)
Recupera información sobre un paquete instalado en el dispositivo. |
|
getAppPackageInfos()
Recupera información de los paquetes instalados en el dispositivo. |
String
|
getBasebandVersion()
Es un método conveniente para obtener la versión de banda base (radio) de este dispositivo. |
Integer
|
getBattery()
Muestra el nivel de batería actual de un dispositivo o nulo si el nivel de batería no está disponible. |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Muestra el valor booleano de la propiedad determinada. |
|
getBootHistory()
El método auxiliar recopila el mapa del historial de inicio con el tiempo de inicio y el motivo. |
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
El método de ayuda recopila el mapa del historial de inicio con el tiempo de inicio y el motivo desde el momento determinado desde la época del dispositivo y la unidad de tiempo especificada. |
String
|
getBootloaderVersion()
Es un método conveniente para obtener la versión del bootloader de este dispositivo. |
InputStreamSource
|
getBugreport()
Recupera un informe de errores del dispositivo. |
InputStreamSource
|
getBugreportz()
Recupera un bugreportz del dispositivo. |
String
|
getBuildAlias()
Recupera el alias de la compilación que se está ejecutando en el dispositivo. |
String
|
getBuildFlavor()
Recupera el tipo de compilación del dispositivo. |
String
|
getBuildId()
Recupera la compilación que se está ejecutando en el dispositivo. |
String
|
getBuildSigningKeys()
Muestra el tipo de clave que se usa para firmar la imagen del dispositivo. Por lo general, los dispositivos Android se pueden firmar con claves de prueba (como en AOSP) o claves de lanzamiento (controladas por los fabricantes de dispositivos individuales). |
DeviceDescriptor
|
getCachedDeviceDescriptor()
Muestra un |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Muestra un |
String[]
|
getChildren(String path)
Es una alternativa al uso de |
AbstractConnection
|
getConnection()
La conexión actual asociada con el dispositivo. |
ContentProviderHandler
|
getContentProvider(int userId)
Muestra |
DeviceFoldableState
|
getCurrentFoldableState()
Devuelve el estado plegable actual del dispositivo o un valor nulo si se produjeron algunos problemas. |
int
|
getCurrentUser()
Muestra el ID del usuario que se está ejecutando actualmente. |
String
|
getDeviceClass()
Obtén la clase de dispositivo. |
long
|
getDeviceDate()
Muestra la fecha del dispositivo en milisegundos desde la época. |
DeviceDescriptor
|
getDeviceDescriptor()
Devuelve un |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Devuelve un |
TestDeviceState
|
getDeviceState()
Obtén el estado del dispositivo. |
long
|
getDeviceTimeOffset(Date date)
Es un elemento auxiliar para obtener la diferencia horaria entre el dispositivo y un |
InputStreamSource
|
getEmulatorOutput()
Cómo obtener la transmisión de stdout y stderr del emulador |
Process
|
getEmulatorProcess()
Muestra el |
final
File
|
getExecuteShellCommandLog()
El registro que contiene todos los registros de |
long
|
getExternalStoreFreeSpace()
Es un método de ayuda para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo. |
String
|
getFastbootPath()
Muestra la ruta de acceso del objeto binario de fastboot que se usa. |
String
|
getFastbootProductType()
Es un método conveniente para obtener el tipo de producto de este dispositivo cuando está en modo fastboot. |
String
|
getFastbootProductVariant()
Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo fastboot. |
String
|
getFastbootSerialNumber()
Muestra el número de serie del modo fastboot. |
String
|
getFastbootVariable(String variableName)
Recupera el valor de la variable de fastboot específico del dispositivo. |
String
|
getFastbootVersion()
Muestra la cadena de versión del objeto binario de fastboot que se usa. |
IFileEntry
|
getFileEntry(String path)
Recupera una referencia a un archivo remoto en el dispositivo. |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Es un asistente no oficial para obtener un |
|
getFoldableStates()
Muestra la lista de estados plegables en el dispositivo. |
IDevice
|
getIDevice()
Devuelve una referencia al |
|
getInstalledPackageNames()
Recupera los nombres de paquetes de aplicaciones presentes en el dispositivo. |
long
|
getIntProperty(String name, long defaultValue)
Muestra el valor entero de la propiedad determinada desde el dispositivo. |
String
|
getIpAddress()
Obtiene la dirección IP del dispositivo. |
KeyguardControllerState
|
getKeyguardState()
Muestra un objeto para obtener el estado actual del protector de pantalla o nulo si no es compatible. |
long
|
getLastExpectedRebootTimeMillis()
Muestra la última vez que las APIs de Tradefed activaron un reinicio en milisegundos desde EPOCH, como lo muestra |
int
|
getLaunchApiLevel()
Obtén el nivel de API que se lanzó por primera vez en el dispositivo. |
InputStreamSource
|
getLogcat()
Captura un flujo de instantáneas de los datos de Logcat. |
InputStreamSource
|
getLogcat(int maxBytes)
Captura un flujo de instantáneas de los últimos |
InputStreamSource
|
getLogcatDump()
Obtén un volcado del logcat actual del dispositivo. |
InputStreamSource
|
getLogcatSince(long date)
Captura una transmisión de instantáneas de datos de Logcat capturados a partir de la fecha proporcionada. |
String
|
getMacAddress()
Muestra la dirección MAC del dispositivo, un valor nulo si no se puede consultar desde el dispositivo. |
Integer
|
getMainUserId()
Muestra el ID de usuario principal. |
|
getMainlineModuleInfo()
Obtén información sobre los módulos principales instalados en el dispositivo. |
int
|
getMaxNumberOfRunningUsersSupported()
Obtén la cantidad máxima de usuarios que se ejecutan de forma simultánea. |
int
|
getMaxNumberOfUsersSupported()
Obtén la cantidad máxima de usuarios admitidos. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Devuelve el |
String
|
getMountPoint(String mountName)
Muestra un punto de activación. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Muestra un |
|
getMountPointInfo()
Muestra una versión analizada de la información en /proc/mounts en el dispositivo. |
TestDeviceOptions
|
getOptions()
Recupera las opciones de prueba del dispositivo. |
long
|
getPartitionFreeSpace(String partition)
Método de ayuda para determinar la cantidad de espacio libre en la partición del dispositivo. |
Integer
|
getPrimaryUserId()
Muestra el ID de usuario principal. |
ProcessInfo
|
getProcessByName(String processName)
El método de ayuda ejecuta los comandos "pidof" y "stat" y muestra el objeto |
String
|
getProcessPid(String process)
Muestra el pid del servicio o nulo si se produjo un error. |
String
|
getProductType()
Es un método conveniente para obtener el tipo de producto de este dispositivo. |
String
|
getProductVariant()
Es un método de conveniencia para obtener la variante de producto de este dispositivo. |
String
|
getProperty(String name)
Recupera el valor de la propiedad determinada del dispositivo. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Obtén el modo de recuperación que se usa actualmente para el dispositivo. |
InputStreamSource
|
getScreenshot(long displayId)
Toma una captura de pantalla del dispositivo con el ID de visualización determinado. |
InputStreamSource
|
getScreenshot(String format)
Toma una captura de pantalla del dispositivo. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Toma una captura de pantalla del dispositivo. |
InputStreamSource
|
getScreenshot()
Toma una captura de pantalla del dispositivo. |
String
|
getSerialNumber()
Es un método conveniente para obtener el número de serie de este dispositivo. |
String
|
getSetting(int userId, String namespace, String key)
Muestra el valor de la configuración solicitada. |
String
|
getSetting(String namespace, String key)
Consulta |
String
|
getSimOperator()
Muestra el operador de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible. |
String
|
getSimState()
Muestra el estado de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible. |
|
getTombstones()
Recupera y muestra la lista de lápidas de los dispositivos. |
long
|
getTotalMemory()
Muestra el tamaño total de la memoria física en bytes o -1 en caso de error interno. |
String
|
getTrackingSerial()
Para la administración de dispositivos, obtén el número de serie que se usa para hacer un seguimiento del dispositivo. |
|
getUninstallablePackageNames()
Recupera los nombres de los paquetes de la aplicación que se pueden desinstalar. |
boolean
|
getUseFastbootErase()
Obtén información para usar el comando fastboot erase o fastboot format para limpiar una partición del dispositivo. |
int
|
getUserFlags(int userId)
Busca y muestra las marcas de un usuario determinado. |
|
getUserInfos()
Obtiene el mapa de useId a |
int
|
getUserSerialNumber(int userId)
Devuelve el número de serie asociado al userId si se encuentra, -10000 en cualquier otro caso. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Procesa el DeviceEvent determinado. Procesa el DeviceEvent, que puede o no migrar este dispositivo a un nuevo estado de asignación. |
boolean
|
hasFeature(String feature)
Comprueba si una función está disponible en un dispositivo. |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Instala un paquete de Android en el dispositivo. |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Instala un paquete de Android en el dispositivo. |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Instala un paquete de Android en el dispositivo de un usuario determinado. |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instala un paquete de Android en el dispositivo de un usuario determinado. |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
Verifica si la plataforma del dispositivo admite la enumeración de apps |
boolean
|
isBypassLowTargetSdkBlockSupported()
Verifica si la plataforma del dispositivo admite omitir el bloqueo de SDK de destino bajo en las instalaciones de apps |
boolean
|
isDebugfsMounted()
Verifica si el elemento debugfs está activado. |
boolean
|
isDeviceEncrypted()
Muestra si el dispositivo está encriptado. |
boolean
|
isDirectory(String path)
Muestra True si la ruta de acceso en el dispositivo es un directorio y False en caso contrario. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Muestra si la encriptación es compatible con el dispositivo. |
boolean
|
isExecutable(String fullPath)
Muestra verdadero si la ruta de acceso del archivo en el dispositivo es un archivo ejecutable; de lo contrario, muestra falso. |
boolean
|
isFastbootEnabled()
Muestra si fastboot está disponible para el dispositivo. |
boolean
|
isHeadless()
Muestra verdadero si el dispositivo no tiene pantalla (sin pantalla); de lo contrario, muestra falso. |
boolean
|
isHeadlessSystemUserMode()
Muestra si el dispositivo usa el modo de usuario del sistema sin interfaz gráfica. |
boolean
|
isMainUserPermanentAdmin()
Muestra si el usuario principal es un administrador permanente y no se puede borrar ni cambiar a un estado que no sea de administrador. |
boolean
|
isMultiUserSupported()
Determina si se admite multiusuario. |
boolean
|
isPackageInstalled(String packageName, String userId)
Consulta el dispositivo para un nombre de paquete y un ID de usuario determinados para verificar si está instalado o no para ese usuario. |
boolean
|
isPackageInstalled(String packageName)
Consulta el dispositivo para un nombre de paquete determinado y comprueba si está instalado o no. |
boolean
|
isRuntimePermissionSupported()
Verifica si la plataforma del dispositivo admite el otorgamiento de permisos de tiempo de ejecución |
boolean
|
isStateBootloaderOrFastbootd()
Muestra verdadero si el dispositivo está en |
boolean
|
isUserRunning(int userId)
Verifica si un usuario determinado está en ejecución. |
boolean
|
isUserSecondary(int userId)
Muestra si el usuario especificado es un usuario secundario según sus marcas. |
boolean
|
isUserVisible(int userId)
Verifica si el usuario determinado es visible. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Comprueba si el usuario determinado es visible en la pantalla determinada. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Devuelve si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano en |
boolean
|
isVisibleBackgroundUsersSupported()
Muestra si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano. |
boolean
|
isWifiEnabled()
Prueba si la red Wi-Fi está habilitada. |
|
listDisplayIds()
Recopila la lista de IDs de pantallas disponibles en el dispositivo, como lo informa "dumpsys SurfaceFlinger". |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Obtiene la lista de pantallas que se pueden usar para |
|
listUsers()
Obtiene la lista de usuarios del dispositivo. |
boolean
|
logAnrs(ITestLogger logger)
Recopila y registra errores ANR del dispositivo. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Método auxiliar para tomar un informe de errores y registrarlo en los generadores de informes. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Registra un mensaje en el logcat del dispositivo. |
void
|
mountDebugfs()
Activa debugfs. |
void
|
nonBlockingReboot()
Emite un comando para reiniciar el dispositivo y muestra el resultado cuando se completa el comando y cuando el dispositivo ya no es visible para adb. |
void
|
postAdbRootAction()
Anula esta opción si el dispositivo necesita que se realicen algunas acciones específicas después de adb root y antes de que el dispositivo vuelva a estar en línea. |
void
|
postAdbUnrootAction()
Anula esta opción si el dispositivo necesita que se realicen algunas acciones específicas después de que adb quite el estado de root y antes de que el dispositivo vuelva a estar en línea. |
void
|
postBootSetup()
Sigue las instrucciones para configurar el dispositivo y realizar pruebas después de cada inicio. |
void
|
postInvocationTearDown(Throwable exception)
Hay pasos adicionales para la limpieza específica del dispositivo que se requiere, que se ejecutará una vez que se complete la invocación. |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Pasos adicionales para la configuración requerida específica del dispositivo que se ejecutará en este antes del flujo de invocación. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Extrae contenido del directorio del dispositivo de manera recurrente. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Extrae de forma recursiva el contenido del directorio del dispositivo. |
boolean
|
pullFile(String remoteFilePath, File localFile)
Recupera un archivo fuera del dispositivo. |
File
|
pullFile(String remoteFilePath, int userId)
Recupera un archivo del dispositivo, lo almacena en un |
File
|
pullFile(String remoteFilePath)
Recupera un archivo fuera del dispositivo, lo almacena en un |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Recupera un archivo fuera del dispositivo. |
String
|
pullFileContents(String remoteFilePath)
Recupera un archivo del dispositivo y muestra su contenido. |
File
|
pullFileFromExternal(String remoteFilePath)
Es un método conveniente para recuperar un archivo del almacenamiento externo del dispositivo, almacenarlo en un |
boolean
|
pushDir(File localFileDir, String deviceFilePath,
Envía de manera recurrente el contenido del directorio al dispositivo y, al mismo tiempo, excluye algunos directorios filtrados. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
Envía de manera recurrente el contenido del directorio al dispositivo. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
Envía de manera recurrente el contenido del directorio al dispositivo. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Es una variante de |
boolean
|
pushFile(File localFile, String remoteFilePath)
Envía un archivo al dispositivo. |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
Envía un archivo al dispositivo. |
boolean
|
pushString(String contents, String remoteFilePath)
Envía un archivo creado a partir de una cadena al dispositivo |
void
|
reboot(String reason)
Reinicia el dispositivo en modo ADB con un |
void
|
reboot()
Reinicia el dispositivo en modo ADB. |
void
|
rebootIntoBootloader()
Reinicia el dispositivo en el modo bootloader. |
void
|
rebootIntoFastbootd()
Reinicia el dispositivo en modo fastbootd. |
void
|
rebootIntoRecovery()
Reinicia el dispositivo en el modo de recuperación de adb. |
void
|
rebootIntoSideload()
Reinicia el dispositivo en el modo sideload de adb (ten en cuenta que este es un modo especial en la recuperación). Se bloquea hasta que el dispositivo entre en modo de transferencia |
void
|
rebootIntoSideload(boolean autoReboot)
Reinicia el dispositivo en el modo de transferencia de adb (ten en cuenta que se trata de un modo especial en recuperación). Bloquea hasta que el dispositivo entre en modo de carga lateral. |
void
|
rebootUntilOnline()
Es un método alternativo a |
void
|
rebootUntilOnline(String reason)
Es un método alternativo a |
void
|
rebootUserspace()
Reinicia solo la parte del espacio de usuario del dispositivo. |
void
|
rebootUserspaceUntilOnline()
Es un método alternativo a |
boolean
|
recoverDevice()
Intenta recuperar la comunicación del dispositivo. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Registra un |
void
|
remountSystemReadOnly()
Haz que la partición del sistema en el dispositivo sea de solo lectura. |
void
|
remountSystemWritable()
Haz que se pueda escribir en la partición del sistema del dispositivo. |
void
|
remountVendorReadOnly()
Haz que la partición del proveedor en el dispositivo sea de solo lectura. |
void
|
remountVendorWritable()
Permitir que se pueda escribir en la partición del proveedor en el dispositivo. |
boolean
|
removeAdmin(String componentName, int userId)
Quita el administrador del dispositivo determinado en el usuario determinado y muestra |
void
|
removeOwners()
Quita todos los propietarios de perfiles de dispositivos existentes con el mejor esfuerzo. |
boolean
|
removeUser(int userId)
Quita a un usuario determinado del dispositivo. |
void
|
resetContentProviderSetup()
Restablece la marca de configuración del proveedor de contenido para volver a activarla. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Método de conveniencia para realizar |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Ejecuta pruebas de instrumentación y proporciona recuperación de dispositivos. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Es igual que |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Es igual que |
void
|
setConfiguration(IConfiguration configuration)
Inyecta el |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
Establece la fecha en el dispositivo. Nota: Para configurar la fecha en el dispositivo, se requiere acceso de raíz. |
boolean
|
setDeviceOwner(String componentName, int userId)
Establece un componente de administración de dispositivos como propietario para un usuario determinado. |
void
|
setDeviceState(TestDeviceState deviceState)
Actualiza el estado del dispositivo. |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
Para el emulador, establece |
void
|
setEmulatorProcess(Process p)
Establece el |
void
|
setFastbootEnabled(boolean fastbootEnabled)
Establece la opción de fastboot para el dispositivo. |
void
|
setFastbootPath(String fastbootPath)
Establece la ruta de acceso al objeto binario de fastboot que se debe usar. |
void
|
setIDevice(IDevice newDevice)
Actualiza el IDevice asociado con este ITestDevice. |
void
|
setLogStartDelay(int delay)
Establece el tiempo en ms que se debe esperar antes de iniciar la captura de logcat para un dispositivo en línea. |
void
|
setOptions(TestDeviceOptions options)
Establece el |
boolean
|
setProperty(String propKey, String propValue)
Establece el valor de la propiedad determinada en el dispositivo. |
void
|
setRecovery(IDeviceRecovery recovery)
Establece el |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Establece el modo de recuperación actual que se usará para el dispositivo. |
void
|
setSetting(String namespace, String key, String value)
Consulta |
void
|
setSetting(int userId, String namespace, String key, String value)
Agrega un valor de configuración al espacio de nombres de un usuario determinado. |
void
|
setTestLogger(ITestLogger testLogger)
Inyecta la instancia de |
void
|
setTrackingSerial(String trackingSerial)
Para la administración de dispositivos, haz un seguimiento del número de serie que usamos como referencia del dispositivo. |
void
|
setUseFastbootErase(boolean useFastbootErase)
Establece si quieres usar el comando fastboot erase o fastboot format para limpiar una partición del dispositivo. |
void
|
startLogcat()
Comienza a capturar el resultado de Logcat desde el dispositivo en segundo plano. |
boolean
|
startUser(int userId)
Inicia un usuario determinado en segundo plano si está detenido. |
boolean
|
startUser(int userId, boolean waitFlag)
Inicia un usuario determinado en segundo plano si está detenido. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Inicia un usuario determinado en segundo plano, visible en la pantalla determinada (es decir, permite que el usuario inicie actividades en esa pantalla). |
void
|
stopEmulatorOutput()
Cierra y borra el resultado del emulador. |
void
|
stopLogcat()
Detén la captura del resultado de Logcat desde el dispositivo y descarta los datos de Logcat guardados actualmente. |
boolean
|
stopUser(int userId)
Detiene a un usuario determinado. |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Detener a un usuario determinado |
String
|
switchToAdbTcp()
Cambia el dispositivo al modo adb-over-tcp. |
boolean
|
switchToAdbUsb()
Cambia el dispositivo al modo adb mediante USB. |
boolean
|
switchUser(int userId)
Cambia a otro userId con un tiempo de espera predeterminado. |
boolean
|
switchUser(int userId, long timeout)
Cambia a otro userId con el tiempo de espera proporcionado como fecha límite. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Sincroniza de forma incremental el contenido de un directorio de archivos local con el dispositivo. |
Bugreport
|
takeBugreport()
Toma un informe de errores y devuélvelo dentro de un objeto |
String
|
uninstallPackage(String packageName)
Desinstala un paquete de Android del dispositivo. |
String
|
uninstallPackageForUser(String packageName, int userId)
Desinstala un paquete de Android del dispositivo de un usuario determinado. |
boolean
|
unlockDevice()
Desbloquea el dispositivo si está encriptado. |
void
|
unmountDebugfs()
Desactiva debugfs. |
boolean
|
waitForBootComplete(long timeOut)
Bloquea hasta que se establezca la marca de inicio completo del dispositivo. |
boolean
|
waitForDeviceAvailable()
Espera a que el dispositivo sea responsivo y esté disponible para realizar pruebas. |
boolean
|
waitForDeviceAvailable(long waitTime)
Espera a que el dispositivo sea responsivo y esté disponible para realizar pruebas. |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Espera a que el dispositivo sea responsivo y esté disponible sin considerar la ruta de recuperación. |
void
|
waitForDeviceBootloader()
Bloquea el dispositivo hasta que sea visible a través de fastboot. |
boolean
|
waitForDeviceInRecovery(long waitTime)
Bloquea el dispositivo para que esté en el estado "adb recovery" (ten en cuenta que esto es distinto de |
boolean
|
waitForDeviceInSideload(long waitTime)
Bloquea el dispositivo para que esté en el estado "sideload de adb". |
boolean
|
waitForDeviceNotAvailable(long waitTime)
Bloqueos para que el dispositivo no esté disponible, es decir, falta en adb |
void
|
waitForDeviceOnline()
Bloquea hasta que el dispositivo sea visible a través de adb. |
void
|
waitForDeviceOnline(long waitTime)
Bloquea hasta que el dispositivo sea visible a través de adb. |
boolean
|
waitForDeviceShell(long waitTime)
Espera a que el dispositivo responda a un comando básico del shell de adb. |
Métodos protegidos | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
Compila el comando del SO para la sesión y los argumentos del comando adb shell dados. |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
Crea un |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
Realiza un reinicio de adb. |
void
|
ensureRuntimePermissionSupported()
método auxiliar para generar una excepción si no se admite el permiso de tiempo de ejecución |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
Obtén la instancia de |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
|
String
|
internalGetProperty(String propName, String fastbootVar, String description)
Recupera una propiedad del dispositivo, de la caché de ddmlib de forma predeterminada, y recurre a "adb shell getprop" o "fastboot getvar" según si el dispositivo está en Fastboot o no. |
boolean
|
isInRebootCallback()
Muestra si las devoluciones de llamada de reinicio se están ejecutando actualmente o no. |
boolean
|
isNewer(File localFile, IFileEntry entry)
Muestra |
void
|
notifyRebootEnded()
Notifica a todos los |
void
|
notifyRebootStarted()
Notifica a todos los |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Realiza una acción en este dispositivo. |
void
|
postAdbReboot()
Son posibles acciones adicionales que se pueden realizar después de un reinicio. |
void
|
prePostBootSetup()
Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) anule este método para una configuración posterior al inicio específica. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
Establece la instancia de reloj que se usará. |
void
|
setMicrodroidProcess(Process process)
Marca TestDevice como microdroid y establece su CID. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
Ejecuta un comando fastboot simple con variables de entorno y, además, informa el estado del comando. |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
Ejecuta un comando fastboot simple y, luego, informa el estado del comando. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
Espera a que el dispositivo deje de estar disponible (deje de informar a adb). |
Constantes
INVALID_USER_ID
public static final int INVALID_USER_ID
Valor que se muestra para cualquier ID de usuario no válido o no encontrado: UserHandle definió el valor -10000.
Valor constante: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Valor constante: 5000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
la cantidad predeterminada de reintentos de comandos que se deben realizar
Valor constante: 2 (0x00000002)
Campos
RUTA_DE_BUGFS
public static final String DEBUGFS_PATH
SD_CARD
protected static final String SD_CARD
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
Constructores públicos
Dispositivo nativo
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Crea un TestDevice
.
Parámetros | |
---|---|
device |
IDevice : El IDevice asociado |
stateMonitor |
IDeviceStateMonitor : Es el mecanismo IDeviceStateMonitor que se usará. |
allocationMonitor |
IDeviceMonitor : El IDeviceMonitor para informar sobre los cambios de estado de asignación.
Puede ser nulo |
Métodos públicos
batchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Microoptimización (alrededor de 400 milis) mediante la carga previa de todas las props que necesitamos, en lugar de llamar a "adb getprop" para cada una; es decir, obtener todas las propiedades es tan rápido como recuperar una. Elementos como device.getApiLevel(), checkApiLevelAgainstNextRelease y getBuildAlias llaman a "adb getprop" en segundo plano. Los recuperamos en una llamada y llamamos a NativeDevice.setProperty. Incluso si no hacemos esto, NativeDevice llamará a setProperty y almacenará en caché el resultado para llamadas futuras. Solo lo hacemos un poco antes. Si el dispositivo está en modo de recuperación o hay otros errores para recuperar los elementos, los ignoramos.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Muestra si se permite cambiar al usuario del sistema sin interfaz gráfica.
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Comprueba si una función es compatible actualmente según un nivel de compatibilidad mínimo. Este método tiene en cuenta las funciones aún no publicadas antes de que se aumente el nivel de API.
Parámetros | |
---|---|
strictMinLevel |
int : Es el nivel mínimo posible estricto que admite la función. |
Muestra | |
---|---|
boolean |
Es verdadero si el nivel es compatible. De lo contrario, el valor es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
checkConnectivity
public boolean checkConnectivity ()
Verifica que el dispositivo tenga conectividad de red.
Muestra | |
---|---|
boolean |
true si el dispositivo tiene una conexión de red que funciona,
false de lo contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
clearErrorDialogs
public boolean clearErrorDialogs ()
Intenta descartar los diálogos de error que se muestran actualmente en la IU del dispositivo.
Muestra | |
---|---|
boolean |
true si no hay diálogos o si se borraron correctamente.
false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
clearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
Borra la última red Wi-Fi conectada. Se debe llamar a este método cuando se inicia una nueva invocación para evitar la conexión a la red Wi-Fi que se usó en la prueba anterior después de reiniciar el dispositivo.
clearLogcat
public void clearLogcat ()
Borra los datos de Logcat acumulados.
Esto es útil en los casos en que deseas asegurarte de que ITestDevice#getLogcat()
solo devuelva los datos de registro generados después de un punto determinado (por ejemplo, después de escribir en la memoria flash una nueva compilación del dispositivo, etcétera).
connectToWifiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Se conecta a una red Wi-Fi.
Activa el Wi-Fi y bloquea hasta que se establece una conexión exitosa con una de las redes Wi-Fi que se indican en el mapa wifiSsidToPsk. Una vez que se establezca una conexión, la instancia intentará restablecerla después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi()
o ITestDevice#clearLastConnectedWifiNetwork()
.
Parámetros | |
---|---|
wifiSsidToPsk |
: Es un mapa de SSID de Wi-Fi a contraseñas. |
scanSsid |
boolean : Indica si se deben buscar SSID ocultos de esta red. |
Muestra | |
---|---|
boolean |
true si se conecta correctamente a la red Wi-Fi. false
de lo contrario |
Arroja | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Se conecta a una red Wi-Fi.
Activa el Wi-Fi y lo bloquea hasta que se establece una conexión correcta con la red Wi-Fi especificada.
Una vez que se establezca una conexión, la instancia intentará restablecerla después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi()
o ITestDevice#clearLastConnectedWifiNetwork()
.
Parámetros | |
---|---|
wifiSsid |
String : El SSID de Wi-Fi al que te conectarás |
wifiPsk |
String : La frase de contraseña del PSK o un valor nulo si no está encriptada |
Muestra | |
---|---|
boolean |
true si se conectó correctamente a la red Wi-Fi. false
otherwise |
Arroja | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk)
Se conecta a una red Wi-Fi.
Activa la red Wi-Fi y la bloquea hasta que se establezca una conexión correcta con una de las redes Wi-Fi que se indican en el mapa wifiSsidToPsk. Una vez que se establezca una conexión, la instancia intentará restablecerla después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi()
o ITestDevice#clearLastConnectedWifiNetwork()
.
Parámetros | |
---|---|
wifiSsidToPsk |
: Es un mapa de SSID de Wi-Fi a contraseñas. |
Muestra | |
---|---|
boolean |
true si se conecta correctamente a la red Wi-Fi. false
de lo contrario |
Arroja | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Se conecta a una red Wi-Fi.
Activa el Wi-Fi y bloquea hasta que se establezca una conexión exitosa a la red Wi-Fi especificada.
Una vez que se establezca la conexión, la instancia intentará restablecerla después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi()
o ITestDevice#clearLastConnectedWifiNetwork()
.
Parámetros | |
---|---|
wifiSsid |
String : El SSID de Wi-Fi al que te conectarás |
wifiPsk |
String : La frase de contraseña del PSK o un valor nulo si no está encriptada |
scanSsid |
boolean : Indica si se debe buscar un SSID oculto de esta red. |
Muestra | |
---|---|
boolean |
true si se conectó correctamente a la red Wi-Fi. false
otherwise |
Arroja | |
---|---|
DeviceNotAvailableException |
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Es una variante de connectToWifiNetwork(String, String)
que solo se conecta si el dispositivo no tiene conectividad de red.
Parámetros | |
---|---|
scanSsid |
boolean : Indica si se debe buscar un SSID oculto de esta red. |
Muestra | |
---|---|
boolean |
true si se conectó correctamente a la red Wi-Fi. false
otherwise |
Arroja | |
---|---|
DeviceNotAvailableException |
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Es una variante de connectToWifiNetwork(String, String)
que solo se conecta si el dispositivo no tiene conectividad de red en ese momento.
Muestra | |
---|---|
boolean |
true si se conectó correctamente a la red Wi-Fi. false
otherwise |
Arroja | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name, boolean guest, boolean ephemeral)
Crea un usuario con un nombre determinado y las marcas proporcionadas
Parámetros | |
---|---|
name |
String : Es el usuario que se creará en el dispositivo. |
guest |
boolean : Habilita la marca de usuario --guest durante la creación. |
ephemeral |
boolean : Habilita la marca del usuario --ephemeral durante la creación. |
Muestra | |
---|---|
int |
ID del usuario creado |
Arroja | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Crea un usuario con un nombre determinado y las marcas proporcionadas
Parámetros | |
---|---|
name |
String : Es el usuario que se creará en el dispositivo. |
guest |
boolean : Habilita la marca de usuario --guest durante la creación. |
ephemeral |
boolean : Habilita la marca del usuario --ephemeral durante la creación. |
forTesting |
boolean : Habilita la marca de prueba --for-testing durante la creación |
Muestra | |
---|---|
int |
ID del usuario creado |
Arroja | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name)
Crea un usuario con un nombre determinado y las marcas predeterminadas 0.
Parámetros | |
---|---|
name |
String : del usuario que se creará en el dispositivo |
Muestra | |
---|---|
int |
el número entero del ID de usuario creado |
Arroja | |
---|---|
DeviceNotAvailableException |
createUserNoThrow
public int createUserNoThrow (String name)
Crea un usuario con un nombre determinado y las marcas predeterminadas 0.
Parámetros | |
---|---|
name |
String : del usuario que se creará en el dispositivo |
Muestra | |
---|---|
int |
el número entero para el ID de usuario creado o -1 para el error. |
Arroja | |
---|---|
DeviceNotAvailableException |
deleteFile
public void deleteFile (String deviceFilePath, int userId)
Es un método auxiliar para borrar un archivo o directorio del dispositivo.
Parámetros | |
---|---|
deviceFilePath |
String : Es la ruta de acceso absoluta del archivo en el dispositivo. |
userId |
int : Es el ID de usuario del que se borrará. |
Arroja | |
---|---|
DeviceNotAvailableException |
deleteFile
public void deleteFile (String deviceFilePath)
Es un método auxiliar para borrar un archivo o directorio del dispositivo.
Parámetros | |
---|---|
deviceFilePath |
String : Es la ruta de acceso absoluta del archivo en el dispositivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
anular el registro deDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Quita el IDeviceActionReceiver
registrado.
Parámetros | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : Es un IDeviceActionReceiver que se quitará. |
Reinicio en segundo plano del dispositivo
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Método auxiliar para verificar si el dispositivo se reinició de forma suave comparando el system_server actual con el ProcessInfo
de system_server anterior. Usa getProcessByName(String)
para obtener ProcessInfo
.
Parámetros | |
---|---|
prevSystemServerProcess |
ProcessInfo : El proceso system_server anterior ProcessInfo . |
Muestra | |
---|---|
boolean |
true si el dispositivo se reinició de forma suave |
Arroja | |
---|---|
DeviceNotAvailableException |
deviceSoftRestartedSince
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Es un método auxiliar para verificar si el dispositivo se reinició de forma suave desde la hora UTC desde la época del dispositivo y su ERROR(/TimeUnit)
. El reinicio suave hace referencia al reinicio de system_server fuera de un reinicio forzado del dispositivo (por ejemplo, un reinicio solicitado). El utcEpochTime del dispositivo actual en Milliseccond se puede obtener mediante el método getDeviceDate()
.
Parámetros | |
---|---|
utcEpochTime |
long : Es la hora del dispositivo en segundos desde la época. |
timeUnit |
TimeUnit : Es la unidad de tiempo TimeUnit para el utcEpochTime determinado. |
Muestra | |
---|---|
boolean |
true si el dispositivo se reinició de forma suave |
Arroja | |
---|---|
DeviceNotAvailableException |
inhabilitarAdbRoot
public boolean disableAdbRoot ()
Desactiva el acceso raíz de adb.
Inhabilitar adb root puede provocar que el dispositivo se desconecte de adb. Este método bloqueará el dispositivo hasta que esté disponible.
Muestra | |
---|---|
boolean |
true si se realiza correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
disableKeyguard
public void disableKeyguard ()
Intenta inhabilitar el bloqueo de teclas.
Primero, espera a que el envío de entrada esté listo. Esto ocurre aproximadamente al mismo tiempo que el dispositivo informa BOOT_COMPLETE, aparentemente de forma asíncrona, porque la implementación actual del framework tiene una condición de carrera ocasional. Luego, se envía el comando para descartar la protección de seguridad (solo funciona en las no seguras).
Arroja | |
---|---|
DeviceNotAvailableException |
disableNetworkMonitor
public boolean disableNetworkMonitor ()
Inhabilita la supervisión de red en el dispositivo.
Muestra | |
---|---|
boolean |
Es true si la supervisión se inhabilitó correctamente. false si falló. |
Arroja | |
---|---|
DeviceNotAvailableException |
disconnectFromWifi
public boolean disconnectFromWifi ()
Se desconecta de una red Wi-Fi.
Quita todas las redes de la lista de redes conocidas e inhabilita el Wi-Fi.
Muestra | |
---|---|
boolean |
true si se desconectó correctamente de la red Wi-Fi. false si no se pudo desconectar. |
Arroja | |
---|---|
DeviceNotAvailableException |
doesFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
Es un método auxiliar para determinar si existe un archivo en el dispositivo para un usuario determinado.
Parámetros | |
---|---|
deviceFilePath |
String : Es la ruta de acceso absoluta del archivo en el dispositivo que se debe verificar. |
userId |
int : Es el ID de usuario con el que se debe verificar la existencia del archivo. |
Muestra | |
---|---|
boolean |
true si el archivo existe, false de lo contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Método auxiliar para determinar si existe un archivo en el dispositivo.
Parámetros | |
---|---|
deviceFilePath |
String : Es la ruta de acceso absoluta del archivo en el dispositivo que se debe verificar. |
Muestra | |
---|---|
boolean |
true si el archivo existe, false de lo contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
dumpHeap
public File dumpHeap (String process, String devicePath)
Intenta volcar el montón desde system_server. El llamador es responsable de limpiar el archivo volcado.
Parámetros | |
---|---|
process |
String : Es el nombre del proceso del dispositivo en el que se volcará el heap. |
devicePath |
String : Es la ruta de acceso en el dispositivo donde se debe colocar el volcado. Debe ser una ubicación donde los permisos lo permitan. |
Muestra | |
---|---|
File |
el ERROR(/File) que contiene el informe. Es nulo si se produjo un error. |
Arroja | |
---|---|
DeviceNotAvailableException |
enableAdbRoot
public boolean enableAdbRoot ()
Activa el permiso de administrador de adb. Si el parámetro de configuración "enable-root" es "false", se registrará un mensaje y se mostrará sin habilitar el permiso de administrador.
Habilitar adb root puede provocar que el dispositivo se desconecte de adb. Este método bloqueará el dispositivo hasta que esté disponible.
Muestra | |
---|---|
boolean |
true si se realiza correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
enableNetworkMonitor
public boolean enableNetworkMonitor ()
Habilita la supervisión de red en el dispositivo.
Muestra | |
---|---|
boolean |
Es true si la supervisión se habilitó correctamente. false si falló. |
Arroja | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado.
En su lugar, se debe usar executeShellCommand(String)
siempre que sea posible, ya que ese método proporciona un mejor rendimiento y detección de fallas.
Parámetros | |
---|---|
timeout |
long : Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Es 0L si no hay tiempo de espera. |
cmdArgs |
String : Es el comando adb y los argumentos para ejecutar. |
Muestra | |
---|---|
String |
el stdout del comando. null si no se pudo ejecutar el comando. |
Arroja | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
Es un método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera especificado.
En su lugar, se debe usar executeShellCommand(String)
siempre que sea posible, ya que ese método proporciona un mejor rendimiento y detección de fallas.
Parámetros | |
---|---|
timeout |
long : Es el tiempo en milisegundos antes de que se considere que el dispositivo no responde. Es 0L si no hay tiempo de espera. |
envMap |
: Es el entorno que se establecerá para el comando. |
cmdArgs |
String : El comando adb y los argumentos para ejecutar |
Muestra | |
---|---|
String |
el stdout del comando. null si no se pudo ejecutar el comando. |
Arroja | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (String... cmdArgs)
Es un método de ayuda que ejecuta un comando adb como un comando del sistema.
En su lugar, se debe usar executeShellCommand(String)
siempre que sea posible, ya que ese método proporciona un mejor rendimiento y detección de fallas.
Parámetros | |
---|---|
cmdArgs |
String : El comando adb y los argumentos para ejecutar |
Muestra | |
---|---|
String |
el stdout del comando. null si no se pudo ejecutar el comando. |
Arroja | |
---|---|
DeviceNotAvailableException |
EjecutarFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
Método auxiliar que ejecuta un comando fastboot como un comando del sistema con un tiempo de espera predeterminado de 2 minutos.
Se espera que se use cuando el dispositivo ya esté en modo fastboot.
Parámetros | |
---|---|
cmdArgs |
String : Es el comando fastboot y los argumentos para ejecutar. |
Muestra | |
---|---|
CommandResult |
El CommandResult que contiene el resultado del comando |
Arroja | |
---|---|
DeviceNotAvailableException |
executeFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Es un método de ayuda que ejecuta un comando fastboot como un comando del sistema.
Se espera que se use cuando el dispositivo ya esté en modo fastboot.
Parámetros | |
---|---|
timeout |
long : Es el tiempo en milisegundos antes de que venza el comando |
cmdArgs |
String : Es el comando fastboot y los argumentos para ejecutar. |
Muestra | |
---|---|
CommandResult |
El CommandResult que contiene el resultado del comando |
Arroja | |
---|---|
DeviceNotAvailableException |
ejecutarLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Es un método de ayuda que ejecuta un comando fastboot de larga duración como un comando del sistema.
Idéntico a executeFastbootCommand(String)
, excepto que usa un tiempo de espera más largo.
Parámetros | |
---|---|
cmdArgs |
String : Es el comando fastboot y los argumentos para ejecutar. |
Muestra | |
---|---|
CommandResult |
El CommandResult que contiene el resultado del comando |
Arroja | |
---|---|
DeviceNotAvailableException |
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
Es un método auxiliar que ejecuta un comando fastboot de larga duración como un comando del sistema con variables de entorno del sistema.
Idéntico a executeFastbootCommand(String)
, excepto que usa un tiempo de espera más largo.
Parámetros | |
---|---|
envVarMap |
: Las variables de entorno del sistema con las que se ejecuta el comando fastboot |
cmdArgs |
String : El comando fastboot y los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
El CommandResult que contiene el resultado del comando |
Arroja | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public String executeShellCommand (String command)
Es un método de ayuda que ejecuta un comando shell de adb y muestra el resultado como un String
.
Parámetros | |
---|---|
command |
String : Es el comando del shell de adb que se ejecutará. |
Muestra | |
---|---|
String |
el resultado del shell |
Arroja | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando adb shell, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
command |
String : Es el comando del shell de adb que se ejecutará. |
receiver |
IShellOutputReceiver : Es el IShellOutputReceiver al que se dirigirá el resultado de la shell. |
maxTimeToOutputShellResponse |
long : Es la cantidad máxima de tiempo durante la cual el comando puede no mostrar ninguna respuesta. La unidad se especifica en timeUnit . |
timeUnit |
TimeUnit : Unidad de maxTimeToOutputShellResponse |
retryAttempts |
int : Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si se realiza retryAttempts
sin éxito. |
Arroja | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando adb shell, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
command |
String : Es el comando del shell de adb que se ejecutará. |
receiver |
IShellOutputReceiver : Es el IShellOutputReceiver al que se dirigirá el resultado de la shell. |
maxTimeoutForCommand |
long : Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en timeUnit . |
maxTimeToOutputShellResponse |
long : Es la cantidad máxima de tiempo durante la cual el comando puede no mostrar ninguna respuesta. La unidad se especifica en timeUnit . |
timeUnit |
TimeUnit : unidad para maxTimeToOutputShellResponse |
retryAttempts |
int : Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponsiveException si se realiza retryAttempts sin éxito. |
Arroja | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver)
Ejecuta el comando adb shell determinado y vuelve a intentarlo varias veces si falla.
Es una forma más simple de executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
con valores predeterminados.
Parámetros | |
---|---|
command |
String : Es el comando del shell de adb que se ejecutará. |
receiver |
IShellOutputReceiver : Es el IShellOutputReceiver al que se dirigirá el resultado de la shell. |
Arroja | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd)
Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como un CommandResult
propagado correctamente con el resultado del estado del comando, stdout y stderr.
Parámetros | |
---|---|
cmd |
String : Es el comando que se debe ejecutar. |
Muestra | |
---|---|
CommandResult |
El resultado en CommandResult . |
Arroja | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Método auxiliar que ejecuta un comando de shell de adb y muestra los resultados como un CommandResult
propagado correctamente con el resultado del estado del comando y stderr. stdout se dirige al flujo especificado.
Parámetros | |
---|---|
cmd |
String : Es el comando que se debe ejecutar. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , donde se redireccionará el resultado estándar, o bien nulo. |
Muestra | |
---|---|
CommandResult |
El resultado en CommandResult . |
Arroja | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Es un método de ayuda que ejecuta un comando shell de adb y muestra los resultados como una CommandResult
propagada correctamente con el resultado del estado del comando, stdout y stderr.
Parámetros | |
---|---|
cmd |
String : Es el comando que se debe ejecutar. |
pipeAsInput |
File : Es un ERROR(/File) que se pasará como entrada al comando o será nulo. |
Muestra | |
---|---|
CommandResult |
El resultado en CommandResult . |
Arroja | |
---|---|
DeviceNotAvailableException |
Comando runShellV2
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando adb shell, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
cmd |
String : Es el comando shell de adb que se ejecutará. |
maxTimeoutForCommand |
long : Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en timeUnit . |
timeUnit |
TimeUnit : Unidad de maxTimeToOutputShellResponse |
retryAttempts |
int : Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponseException si retryAttempts se ejecuta sin éxito. |
Muestra | |
---|---|
CommandResult |
Arroja | |
---|---|
DeviceNotAvailableException |
Comando runShellV2
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Ejecuta un comando adb shell, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
cmd |
String : Es el comando shell de adb que se ejecutará. |
maxTimeoutForCommand |
long : Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en timeUnit . |
timeUnit |
TimeUnit : Unidad de maxTimeToOutputShellResponse |
Muestra | |
---|---|
CommandResult |
Arroja | |
---|---|
DeviceNotAvailableException |
Comando runShellV2
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando adb shell, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
cmd |
String : Es el comando del shell de adb que se ejecutará. |
pipeAsInput |
File : Es un ERROR(/File) que se pasará como entrada al comando o será nulo. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , donde se redireccionará el resultado estándar, o bien nulo. |
maxTimeoutForCommand |
long : Es el tiempo de espera máximo para que se complete el comando; unidad como se especifica en timeUnit . |
timeUnit |
TimeUnit : Unidad de maxTimeToOutputShellResponse |
retryAttempts |
int : Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponseException si retryAttempts se ejecuta sin éxito. |
Muestra | |
---|---|
CommandResult |
Arroja | |
---|---|
DeviceNotAvailableException |
Comando runShellV2
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Ejecuta un comando adb shell, con más parámetros para controlar el comportamiento del comando.
Parámetros | |
---|---|
cmd |
String : Es el comando shell de adb que se ejecutará. |
pipeAsInput |
File : Es un ERROR(/File) que se pasará como entrada al comando o será nulo. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , donde se redireccionará el resultado estándar, o bien nulo. |
pipeToError |
OutputStream : ERROR(/OutputStream) , donde se redireccionará el error estándar, o nulo. |
maxTimeoutForCommand |
long : Es el tiempo de espera máximo para que se complete el comando. La unidad se especifica en timeUnit . |
timeUnit |
TimeUnit : Unidad de maxTimeToOutputShellResponse |
retryAttempts |
int : Es la cantidad máxima de veces que se debe reintentar el comando si falla debido a una excepción. Se arrojará DeviceNotResponseException si retryAttempts se ejecuta sin éxito. |
Muestra | |
---|---|
CommandResult |
Arroja | |
---|---|
DeviceNotAvailableException |
fastbootWipePartition
public CommandResult fastbootWipePartition (String partition)
Es un método de ayuda que borra una partición del dispositivo.
Si getUseFastbootErase()
es true
, se usará el borrado de fastboot para limpiar la partición. Luego, el dispositivo debe crear un sistema de archivos la próxima vez que se inicie.
De lo contrario, se usará el formato fastboot, que creará un nuevo sistema de archivos en el dispositivo.
Se debe usar cuando el dispositivo ya está en Modo fastboot [Fastboot mode].
Parámetros | |
---|---|
partition |
String : Es la partición que se borrará. |
Muestra | |
---|---|
CommandResult |
El CommandResult que contiene el resultado del comando |
Arroja | |
---|---|
DeviceNotAvailableException |
getActiveApexes
publicgetActiveApexes ()
Recupera la información sobre los APEX activados en el dispositivo.
Muestra | |
---|---|
|
ERROR(/Set) de ApexInfo activados actualmente en el dispositivo |
Arroja | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (String namespace)
Muestra los pares clave-valor del espacio de nombres solicitado.
Parámetros | |
---|---|
namespace |
String : Debe ser uno de {"system", "secure", "global"}. |
Muestra | |
---|---|
|
el mapa de pares clave-valor. Es nulo si el espacio de nombres no es compatible. |
Arroja | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
Muestra el estado de asignación actual del dispositivo
Muestra | |
---|---|
DeviceAllocationState |
getAndroidId
public String getAndroidId (int userId)
Busca y muestra el android-id asociado con un userId (valor nulo si no se encuentra).
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
String |
Arroja | |
---|---|
DeviceNotAvailableException |
getAndroidIds
publicgetAndroidIds ()
Crea un mapa de los ID de Android encontrados que coincidan con los ID de usuario. No hay un seguro de que cada ID de usuario encuentre un ID de Android asociado en esta función, por lo que algunos ID de usuario pueden coincidir con el valor nulo.
Muestra | |
---|---|
|
Mapa de IDs de Android que coinciden con los IDs de usuario |
Arroja | |
---|---|
DeviceNotAvailableException |
getApiLevel
public int getApiLevel ()
Obtén el nivel de API del dispositivo. La configuración predeterminada es UNKNOWN_API_LEVEL
.
Muestra | |
---|---|
int |
Un número entero que indica el nivel de API del dispositivo |
Arroja | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Recupera información sobre un paquete instalado en el dispositivo.
Parámetros | |
---|---|
packageName |
String |
Muestra | |
---|---|
PackageInfo |
el PackageInfo o null si no se pudo recuperar la información |
Arroja | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
Recupera información de los paquetes instalados en el dispositivo.
Muestra | |
---|---|
|
ERROR(/List) de PackageInfo instalados en el dispositivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public String getBasebandVersion ()
Es un método conveniente para obtener la versión de banda base (radio) de este dispositivo. La obtención de la versión de radio es específica del dispositivo, por lo que es posible que no muestre la información correcta de todos los dispositivos. Este método se basa en la propiedad gsm.version.baseband para mostrar la información de versión correcta.
Esto no es preciso para algunos dispositivos CDMA, y es posible que la versión que se muestra aquí no coincida con la versión informada por fastboot ni muestre la versión de la radio CDMA.
TL;DR este método solo informa la versión precisa si la propiedad gsm.version.baseband es la misma que la versión que muestra fastboot getvar version-baseband
.
Muestra | |
---|---|
String |
la versión de banda base String o null si no se puede determinar (el dispositivo no tiene radio o no se puede leer una cadena de versión) |
Arroja | |
---|---|
DeviceNotAvailableException |
getBattery
public Integer getBattery ()
Muestra el nivel de batería actual de un dispositivo o nulo si el nivel de batería no está disponible.
Muestra | |
---|---|
Integer |
getBooleanProperty
public boolean getBooleanProperty (String name, boolean defaultValue)
Muestra el valor booleano de la propiedad determinada.
Parámetros | |
---|---|
name |
String : Es el nombre de la propiedad. |
defaultValue |
boolean : Es el valor predeterminado que se muestra si la propiedad está vacía o no existe. |
Muestra | |
---|---|
boolean |
true si la propiedad tiene el valor "1" , "y" , "yes" , "on" o "true" , false si la propiedad tiene el valor "0" , "n" , "no" , "off" , "false" o defaultValue , de lo contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
getBootHistory
publicgetBootHistory ()
El método auxiliar recopila el mapa del historial de inicio con el tiempo de inicio y el motivo.
Muestra | |
---|---|
|
Mapa del tiempo de inicio (hora UTC en segundos desde la época) y el motivo del inicio |
Arroja | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
El método de ayuda recopila el mapa del historial de inicio con el tiempo de inicio y el motivo desde el momento determinado desde la época del dispositivo y la unidad de tiempo especificada. El utcEpochTime actual del dispositivo en milisegundos se puede obtener con el método getDeviceDate()
.
Parámetros | |
---|---|
utcEpochTime |
long : Es el tiempo del dispositivo desde el ciclo de entrenamiento. |
timeUnit |
TimeUnit : La unidad de tiempo TimeUnit . |
Muestra | |
---|---|
|
Mapa del tiempo de inicio (hora UTC en segundos desde la época) y el motivo del inicio |
Arroja | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public String getBootloaderVersion ()
Método de conveniencia para obtener la versión del bootloader de este dispositivo.
Se intentará recuperar la versión del bootloader del estado actual del dispositivo. (es decir, si el dispositivo está en Modo fastboot [Fastboot mode], intentará recuperar la versión de fastboot).
Muestra | |
---|---|
String |
la versión del bootloader String o null si no se puede encontrar |
Arroja | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
Recupera un informe de errores del dispositivo.
Se garantiza que la implementación de esta función seguirá funcionando en un dispositivo sin una tarjeta SD (o cuando la tarjeta SD aún no está activada).
Muestra | |
---|---|
InputStreamSource |
Un InputStreamSource que producirá el contenido del informe de errores a pedido. En caso de fallar, InputStreamSource producirá un ERROR(/InputStream) vacío. |
getBugreportz
public InputStreamSource getBugreportz ()
Recupera un bugreportz del dispositivo. El informe de errores en formato ZIP contiene el informe de errores principal y otros archivos de registro que son útiles para la depuración.
Solo es compatible con "adb version" > 1.0.36.
Muestra | |
---|---|
InputStreamSource |
un InputStreamSource del archivo ZIP que contiene el bugreportz, muestra un valor nulo en caso de falla. |
getBuildAlias
public String getBuildAlias ()
Recupera el alias de la compilación que el dispositivo está ejecutando actualmente.
El alias de compilación suele ser una cadena más legible que el ID de compilación (por lo general, un número para las compilaciones de Nexus). Por ejemplo, la versión final de Android 4.2 tiene el alias de compilación JDQ39 y el ID de compilación 573038.
Muestra | |
---|---|
String |
el alias de compilación o el ID de compilación si no se pudo recuperar |
Arroja | |
---|---|
DeviceNotAvailableException |
getBuildFlavor.
public String getBuildFlavor ()
Recupera el tipo de compilación del dispositivo.
Muestra | |
---|---|
String |
el tipo de compilación o nulo si no se pudo recuperar |
Arroja | |
---|---|
DeviceNotAvailableException |
getBuildId
public String getBuildId ()
Recupera la compilación que se está ejecutando en el dispositivo.
Muestra | |
---|---|
String |
el ID de compilación o IBuildInfo#UNKNOWN_BUILD_ID si no se pudo recuperar |
Arroja | |
---|---|
DeviceNotAvailableException |
getBuildSigningKeys
public String getBuildSigningKeys ()
Muestra el tipo de clave que se usa para firmar la imagen del dispositivo.
Por lo general, los dispositivos Android se pueden firmar con claves de prueba (como en AOSP) o claves de lanzamiento (controladas por los fabricantes de dispositivos individuales).
Muestra | |
---|---|
String |
La clave de firma si se encuentra; de lo contrario, es nulo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Muestra un DeviceDescriptor
almacenado en caché si el dispositivo está asignado; de lo contrario, muestra el DeviceDescriptor
actual.
Muestra | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Muestra un DeviceDescriptor
almacenado en caché si el dispositivo está asignado; de lo contrario, muestra el DeviceDescriptor
actual.
Parámetros | |
---|---|
shortDescriptor |
boolean : Indica si se debe limitar el descriptor a la información mínima. |
Muestra | |
---|---|
DeviceDescriptor |
getChildren
public String[] getChildren (String path)
Es una alternativa al uso de IFileEntry
que, a veces, no funciona debido a los permisos.
Parámetros | |
---|---|
path |
String : Es la ruta de acceso en el dispositivo donde se debe realizar la búsqueda. |
Muestra | |
---|---|
String[] |
Array de cadena que contiene todo el archivo de una ruta de acceso en el dispositivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
La conexión actual asociada con el dispositivo.
Muestra | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
Muestra ContentProviderHandler
o un valor nulo si no está disponible.
Se puede volver a usar el proveedor de contenido si se creó antes con el mismo userId
.
Parámetros | |
---|---|
userId |
int : Es el ID de usuario con el que se inicializa el proveedor de contenido. |
Muestra | |
---|---|
ContentProviderHandler |
Arroja | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Devuelve el estado plegable actual del dispositivo o un valor nulo si se produjeron algunos problemas.
Muestra | |
---|---|
DeviceFoldableState |
Arroja | |
---|---|
DeviceNotAvailableException |
getCurrentUser
public int getCurrentUser ()
Muestra el ID del usuario en ejecución actual. En caso de error, muestra -10000.
Muestra | |
---|---|
int |
Arroja | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
Obtén la clase del dispositivo.
Muestra | |
---|---|
String |
la clase de dispositivo String . |
getDeviceDate
public long getDeviceDate ()
Muestra la fecha del dispositivo en milisegundos desde la época.
Muestra | |
---|---|
long |
la fecha del dispositivo en formato de época |
Arroja | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor.
public DeviceDescriptor getDeviceDescriptor ()
Devuelve un DeviceDescriptor
de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo real.
Muestra | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Devuelve un DeviceDescriptor
de la información del dispositivo para obtener información sobre él sin pasar el objeto del dispositivo real.
Parámetros | |
---|---|
shortDescriptor |
boolean : Indica si se debe limitar el descriptor a la información mínima. |
Muestra | |
---|---|
DeviceDescriptor |
getDeviceState
public TestDeviceState getDeviceState ()
Obtén el estado del dispositivo.
Muestra | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Es una herramienta de ayuda para obtener la diferencia de hora entre el dispositivo y un ERROR(/Date)
determinado. Usa el tiempo de época a nivel interno.
Parámetros | |
---|---|
date |
Date |
Muestra | |
---|---|
long |
la diferencia en milisegundos |
Arroja | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
Obtén la transmisión de stdout y stderr del emulador
Muestra | |
---|---|
InputStreamSource |
resultado del emulador |
getEmulatorProcess
public Process getEmulatorProcess ()
Muestra el Process
correspondiente a este emulador.
Muestra | |
---|---|
Process |
el Process o null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
El registro que contiene todos los registros de executeShellCommand(String)
.
Muestra | |
---|---|
File |
getExternalStoreFreeSpace
public long getExternalStoreFreeSpace ()
Es un método de ayuda para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo.
Muestra | |
---|---|
long |
la cantidad de espacio libre en KB |
Arroja | |
---|---|
DeviceNotAvailableException |
getFastbootPath
public String getFastbootPath ()
Muestra la ruta de acceso del objeto binario de fastboot que se usa.
Aún requiere que isFastbootEnabled()
sea verdadero para que se habiliten las funciones de Fastboot.
Muestra | |
---|---|
String |
getFastbootProductType
public String getFastbootProductType ()
Es un método conveniente para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.
Este método solo debe usarse si el dispositivo debe estar en fastboot. En este caso, es una variante un poco más segura que el método getProductType()
genérico, ya que ITestDevice sabrá cómo recuperar el dispositivo en Fastboot si está en un estado incorrecto o no responde.
Muestra | |
---|---|
String |
el nombre del tipo de producto String o null si no se puede determinar |
Arroja | |
---|---|
DeviceNotAvailableException |
getFastbootProductVariant
public String getFastbootProductVariant ()
Es un método conveniente para obtener el tipo de producto de este dispositivo cuando está en modo fastboot.
Este método solo debe usarse si el dispositivo debe estar en fastboot. En este caso, es una variante un poco más segura que el método genérico getProductType()
, ya que ITestDevice sabrá que debe recuperar el dispositivo en fastboot si se encuentra en un estado incorrecto o no responde.
Muestra | |
---|---|
String |
el nombre del tipo de producto String o null si no se puede determinar |
Arroja | |
---|---|
DeviceNotAvailableException |
getFastbootSerialNumber
public String getFastbootSerialNumber ()
Devuelve el número de serie del modo fastboot.
Muestra | |
---|---|
String |
getFastbootVariable
public String getFastbootVariable (String variableName)
Recupera el valor de la variable de fastboot específico del dispositivo.
Parámetros | |
---|---|
variableName |
String : Es el nombre de la variable. |
Muestra | |
---|---|
String |
el valor de la propiedad o null si no existe |
Arroja | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
Muestra la cadena de versión del objeto binario de fastboot que se usa. O bien nulo si algo sale mal.
Muestra | |
---|---|
String |
getFileEntry
public IFileEntry getFileEntry (String path)
Recupera una referencia a un archivo remoto en el dispositivo.
Parámetros | |
---|---|
path |
String : Es la ruta de acceso del archivo que se recuperará. Puede ser una ruta de acceso absoluta o relativa a “/”. (es decir, se admite la sintaxis “/system” y “system”). |
Muestra | |
---|---|
IFileEntry |
el IFileEntry o null si no se puede encontrar el archivo en path determinado |
Arroja | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Es un asistente no oficial para obtener un FileEntry
de una ruta que no es raíz. FIXME: Refactoriza el sistema de FileEntry para que esté disponible desde cualquier ruta de acceso. (incluso sin permisos de administrador).
Parámetros | |
---|---|
entry |
FileListingService.FileEntry : Un FileEntry que no es necesariamente raíz, como lo requiere Ddmlib. |
Muestra | |
---|---|
IFileEntry |
Un FileEntryWrapper que representa el FileEntry. |
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getFoldableStates
publicgetFoldableStates ()
Muestra la lista de estados plegables en el dispositivo. Se puede obtener con "cmd device_state print-states".
Muestra | |
---|---|
|
Arroja | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
Devuelve una referencia al IDevice
de ddmlib asociado.
DDMS puede asignar un nuevo IDevice
cada vez que el dispositivo se desconecta y se vuelve a conectar de adb. Por lo tanto, los llamadores no deben mantener una referencia a IDevice
, ya que esa referencia puede volverse inactiva.
Muestra | |
---|---|
IDevice |
IDevice |
getInstalledPackageNames
publicgetInstalledPackageNames ()
Recupera los nombres de los paquetes de la aplicación presentes en el dispositivo.
Muestra | |
---|---|
|
ERROR(/Set) de los nombres de paquetes String instalados actualmente en el dispositivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getIntProperty
public long getIntProperty (String name, long defaultValue)
Muestra el valor entero de la propiedad determinada desde el dispositivo.
Parámetros | |
---|---|
name |
String : Es el nombre de la propiedad. |
defaultValue |
long : Es el valor predeterminado que se muestra si la propiedad está vacía o no existe. |
Muestra | |
---|---|
long |
el valor de la propiedad o defaultValue si la propiedad está vacía, no existe o no tiene un valor de número entero |
Arroja | |
---|---|
DeviceNotAvailableException |
getIpAddress
public String getIpAddress ()
Obtiene la dirección IP del dispositivo.
Muestra | |
---|---|
String |
la dirección IP del dispositivo o null si el dispositivo no tiene dirección IP |
Arroja | |
---|---|
DeviceNotAvailableException |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Muestra un objeto para obtener el estado actual del protector de pantalla o nulo si no es compatible.
Muestra | |
---|---|
KeyguardControllerState |
un KeyguardControllerState que contiene una instantánea del estado del bloqueo de teclas y muestra un valor nulo si no se admite la consulta del bloqueo de teclas. |
Arroja | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public long getLastExpectedRebootTimeMillis ()
Muestra la última vez que las APIs de Tradefed activaron un reinicio en milisegundos desde la época, como lo muestra System.currentTimeMillis()
.
Muestra | |
---|---|
long |
getLaunchApiLevel
public int getLaunchApiLevel ()
Obtener el primer nivel de API iniciado en el dispositivo La configuración predeterminada es UNKNOWN_API_LEVEL
.
Muestra | |
---|---|
int |
Un número entero que indica el primer nivel de API lanzado del dispositivo |
Arroja | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
Captura una transmisión de instantáneas de los datos de Logcat.
Funciona en dos modos:
TestDeviceOptions.getMaxLogcatDataSize()
bytes del contenido actual de la captura de logcat en segundo plano.
Muestra | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Captura un flujo de instantáneas de los últimos maxBytes
de datos de Logcat capturados.
Es útil para los casos en los que deseas capturar instantáneas frecuentes de los datos de logcat capturados sin incurrir en la penalidad de espacio en el disco potencialmente grande de obtener la instantánea getLogcat()
completa.
Parámetros | |
---|---|
maxBytes |
int : Es la cantidad máxima de datos que se mostrarán. Debe ser una cantidad que se ajuste cómodamente en la memoria. |
Muestra | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
Obtén un volcado del logcat actual del dispositivo. A diferencia de getLogcat()
, este método siempre mostrará un volcado estático del logcat.
Tiene la desventaja de que no se mostrará nada si no se puede acceder al dispositivo.
Muestra | |
---|---|
InputStreamSource |
un InputStreamSource de los datos de Logcat. Se muestra una transmisión vacía si no se capturan los datos de logcat. |
getLogcatSince
public InputStreamSource getLogcatSince (long date)
Captura una transmisión de instantáneas de los datos capturados de logcat a partir de la fecha proporcionada. Se debe usar la hora del
dispositivo getDeviceDate()
.
Parámetros | |
---|---|
date |
long : En milisegundos desde el formato de época de cuándo iniciar la instantánea hasta el presente.
(se puede obtener con "date +%s") |
Muestra | |
---|---|
InputStreamSource |
getMacAddress
public String getMacAddress ()
Devuelve la dirección MAC del dispositivo, nula si no se puede consultar desde el dispositivo.
Muestra | |
---|---|
String |
getMainUserId
public Integer getMainUserId ()
Muestra el ID de usuario principal.
Muestra | |
---|---|
Integer |
el userId del usuario principal si hay uno y nulo si no hay un usuario principal. |
Arroja | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
Obtén información sobre los módulos principales instalados en el dispositivo.
Muestra | |
---|---|
|
Hay ERROR(/Set) de String módulos de línea principales instalados en el dispositivo actualmente. |
Arroja | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
Obtén la cantidad máxima de usuarios que se ejecutan de manera simultánea. La configuración predeterminada es 0.
Muestra | |
---|---|
int |
Un número entero que indica la cantidad de usuarios que se ejecutan de forma simultánea. |
Arroja | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
Obtén la cantidad máxima de usuarios admitidos. La configuración predeterminada es 0.
Muestra | |
---|---|
int |
Un número entero que indica la cantidad de usuarios admitidos |
Arroja | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
Muestra | |
---|---|
Process |
Muestra el proceso de la VM de Microdroid. Si TestDevice no es un Microdroid, muestra un valor nulo. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Muestra el IDeviceStateMonitor
asociado con el dispositivo.
Muestra | |
---|---|
IDeviceStateMonitor |
getMountPoint
public String getMountPoint (String mountName)
Muestra un punto de activación.
Consulta el dispositivo directamente si la información almacenada en caché en IDevice
no está disponible.
TODO: mover este comportamiento a IDevice#getMountPoint(String)
Parámetros | |
---|---|
mountName |
String : Es el nombre del punto de activación. |
Muestra | |
---|---|
String |
el punto de activación o null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Muestra un MountPointInfo
que corresponde a la ruta de acceso del punto de activación especificado, o null
si esa ruta no tiene nada activado o no aparece en /proc/mounts como punto de activación.
Parámetros | |
---|---|
mountpoint |
String |
Muestra | |
---|---|
ITestDevice.MountPointInfo |
Un ERROR(/List) de MountPointInfo que contiene la información de "/proc/mounts" |
Arroja | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
Muestra una versión analizada de la información en /proc/mounts en el dispositivo.
Muestra | |
---|---|
|
Un ERROR(/List) de MountPointInfo que contenga la información en "/proc/mounts" |
Arroja | |
---|---|
DeviceNotAvailableException |
getOptions
public TestDeviceOptions getOptions ()
Recupera las opciones de prueba del dispositivo.
Muestra | |
---|---|
TestDeviceOptions |
TestDeviceOptions relacionado con el dispositivo de prueba. |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
Es un método auxiliar para determinar la cantidad de espacio libre en la partición del dispositivo.
Parámetros | |
---|---|
partition |
String |
Muestra | |
---|---|
long |
la cantidad de espacio libre en KB |
Arroja | |
---|---|
DeviceNotAvailableException |
getPrimaryUserId
public Integer getPrimaryUserId ()
Muestra el ID de usuario principal.
Muestra | |
---|---|
Integer |
el userId del usuario principal si hay uno y nulo si no hay un usuario principal. |
Arroja | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
El método de ayuda ejecuta los comandos "pidof" y "stat" y muestra el objeto ProcessInfo
con el PID y la hora de inicio del proceso determinado.
Parámetros | |
---|---|
processName |
String : Es la cadena de nombre del proceso. |
Muestra | |
---|---|
ProcessInfo |
ProcessInfo del proceso processName determinado |
Arroja | |
---|---|
DeviceNotAvailableException |
getProcessPid
public String getProcessPid (String process)
Muestra el pid del servicio o nulo si se produjo un error.
Parámetros | |
---|---|
process |
String : Es la cadena del nombre del proceso. |
Muestra | |
---|---|
String |
Arroja | |
---|---|
DeviceNotAvailableException |
getProductType
public String getProductType ()
Método de conveniencia para obtener el tipo de producto de este dispositivo.
Este método funcionará si el dispositivo está en modo adb o fastboot.
Muestra | |
---|---|
String |
el nombre del tipo de producto String . No será nulo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getProductVariant
public String getProductVariant ()
Es un método de conveniencia para obtener la variante de producto de este dispositivo.
Este método funcionará si el dispositivo está en modo adb o fastboot.
Muestra | |
---|---|
String |
el nombre de la variante del producto String o null si no se puede determinar |
Arroja | |
---|---|
DeviceNotAvailableException |
getProperty
public String getProperty (String name)
Recupera el valor de la propiedad determinada del dispositivo.
Parámetros | |
---|---|
name |
String : Es el nombre de la propiedad. |
Muestra | |
---|---|
String |
el valor de la propiedad o null si no existe |
Arroja | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
Obtén el modo de recuperación actual que se usa para el dispositivo.
Muestra | |
---|---|
ITestDevice.RecoveryMode |
el modo de recuperación actual que se usa para el dispositivo |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Toma una captura de pantalla del dispositivo con el ID de visualización determinado. El formato es PNG.
TODO: Extiende las implementaciones anteriores para admitir "format" y "rescale".
Parámetros | |
---|---|
displayId |
long : Es el ID de visualización de la pantalla desde la que se obtiene la captura de pantalla. |
Muestra | |
---|---|
InputStreamSource |
un InputStreamSource de la captura de pantalla en formato o null si la captura de pantalla no se realizó correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format)
Toma una captura de pantalla del dispositivo. Se recomienda usar getScreenshot(format) con codificación JPEG para obtener un tamaño más pequeño.
Parámetros | |
---|---|
format |
String : Se admiten PNG y JPEG. |
Muestra | |
---|---|
InputStreamSource |
un InputStreamSource de la captura de pantalla en formato o null si la captura de pantalla no se realizó correctamente |
Arroja | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Toma una captura de pantalla del dispositivo. Se recomienda usar getScreenshot(String)
en su lugar con codificación JPEG para obtener un tamaño más pequeño.
Parámetros | |
---|---|
format |
String : Se admiten PNG y JPEG. |
rescale |
boolean : Indica si se debe cambiar el tamaño de la captura de pantalla para reducir el tamaño de la imagen resultante. |
Muestra | |
---|---|
InputStreamSource |
una InputStreamSource de la captura de pantalla en formato, o null si la captura de pantalla no se realizó correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot ()
Toma una captura de pantalla del dispositivo.
Muestra | |
---|---|
InputStreamSource |
Un InputStreamSource de la captura de pantalla en formato PNG o null si la captura de pantalla no se realizó correctamente |
Arroja | |
---|---|
DeviceNotAvailableException |
getSerialNumber
public String getSerialNumber ()
Es un método conveniente para obtener el número de serie de este dispositivo.
Muestra | |
---|---|
String |
el número de serie String |
getSetting
public String getSetting (int userId, String namespace, String key)
Muestra el valor del parámetro de configuración solicitado. el espacio de nombres debe ser uno de los siguientes: {"system", "secure", "global"}
Parámetros | |
---|---|
userId |
int |
namespace |
String |
key |
String |
Muestra | |
---|---|
String |
el valor asociado con el espacio de nombres:clave de un usuario. Es nulo si no se encuentra. |
Arroja | |
---|---|
DeviceNotAvailableException |
getSetting
public String getSetting (String namespace, String key)
Consulta getSetting(int, String, String)
y realiza la acción en el usuario del sistema.
Parámetros | |
---|---|
namespace |
String |
key |
String |
Muestra | |
---|---|
String |
Arroja | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
Muestra el operador de la tarjeta SIM o un valor nulo si no está disponible o si el dispositivo no está disponible.
Muestra | |
---|---|
String |
getSimState
public String getSimState ()
Devuelve el estado de la tarjeta SIM o muestra un valor nulo si no está disponible o el dispositivo no está disponible.
Muestra | |
---|---|
String |
getTombstones
publicgetTombstones ()
Recupera y muestra la lista de lápidas de los dispositivos. Requiere permisos de administrador.
es el mejor esfuerzo, de modo que, si una tombstone no se puede extraer por algún motivo, no estará en la lista. Solo un DeviceNotAvailableException
finalizará el método antes de tiempo.
Muestra | |
---|---|
|
Es una lista de archivos de tumba, vacía si no hay ninguno. |
Arroja | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
Muestra el tamaño total de la memoria física en bytes o -1 en caso de error interno.
Muestra | |
---|---|
long |
getTrackingSerial
public String getTrackingSerial ()
Para la administración de dispositivos, obtén el número de serie que se usa para hacer un seguimiento del dispositivo.
Muestra | |
---|---|
String |
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
Recupera los nombres de los paquetes de la aplicación que se pueden desinstalar. Actualmente, se define como paquetes que no son del sistema y paquetes del sistema actualizados.
Muestra | |
---|---|
|
ERROR(/Set) de nombres de paquetes String que se pueden desinstalar instalados actualmente en el
dispositivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getUseFastbootBorrar
public boolean getUseFastbootErase ()
Obtén información para usar el comando fastboot erase o fastboot format para limpiar una partición del dispositivo.
Muestra | |
---|---|
boolean |
true si se usará el comando fastboot erase o false si se usará el comando fastboot format. |
getUserFlags
public int getUserFlags (int userId)
Busca y muestra las marcas de un usuario determinado. Las marcas se definen en la clase "android.content.pm.UserInfo" del Proyecto de código abierto de Android.
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
int |
las marcas asociadas con el userId proporcionado si se encuentra, -10000 en cualquier otro caso |
Arroja | |
---|---|
DeviceNotAvailableException |
getUserInfos
publicgetUserInfos ()
Obtiene el mapa de useId a UserInfo
en el dispositivo. Lanzará DeviceRuntimeException
si el resultado del dispositivo no es el esperado.
Muestra | |
---|---|
|
la lista de objetos UserInfo. |
Arroja | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Devuelve el número de serie asociado al userId si se encuentra, -10000 en cualquier otro caso.
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
int |
Arroja | |
---|---|
DeviceNotAvailableException |
handleAllocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Procesa el DeviceEvent determinado. Es posible que transfiera el dispositivo a un estado nuevo. Informará a IDeviceMonitor
sobre cualquier transición de estado.
Procesa el DeviceEvent, que puede o no migrar este dispositivo a un nuevo estado de asignación.
Parámetros | |
---|---|
event |
DeviceEvent |
Muestra | |
---|---|
IManagedTestDevice.DeviceEventResponse |
hasFeature
public boolean hasFeature (String feature)
Verifica si una función está disponible en un dispositivo.
Parámetros | |
---|---|
feature |
String : Corresponde al formato que debe ser directamente "feature: |
Muestra | |
---|---|
boolean |
Es verdadero si se encuentra la función; de lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Instala un paquete de Android en el dispositivo.
Parámetros | |
---|---|
packageFile |
File : Es el archivo APK que se instalará. |
reinstall |
boolean : Es la true si se debe reinstalar el sistema. |
extraArgs |
String : Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para conocer las opciones disponibles. |
Muestra | |
---|---|
String |
Un String con un código de error o null si se realiza correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Instala un paquete de Android en el dispositivo.
Nota: Solo los casos de uso que requieran un control explícito de la concesión de permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.
Parámetros | |
---|---|
packageFile |
File : Es el archivo APK que se instalará. |
reinstall |
boolean : true si se debe realizar una reinstalación |
grantPermissions |
boolean : Si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación. |
extraArgs |
String : Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles. |
Muestra | |
---|---|
String |
Un String con un código de error o null si se realiza correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
instalarPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Instala un paquete de Android en el dispositivo de un usuario determinado.
Parámetros | |
---|---|
packageFile |
File : Es el archivo APK que se instalará. |
reinstall |
boolean : true si se debe realizar una reinstalación |
userId |
int : Es el ID de usuario entero para el que se instalará. |
extraArgs |
String : Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles. |
Muestra | |
---|---|
String |
Un String con un código de error o null si se realiza correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
instalarPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instala un paquete de Android en el dispositivo de un usuario determinado.
Nota: Solo los casos de uso que requieran un control explícito de la concesión de permisos de tiempo de ejecución en el momento de la instalación deben llamar a esta función.
Parámetros | |
---|---|
packageFile |
File : Es el archivo APK que se instalará. |
reinstall |
boolean : true si se debe realizar una reinstalación |
grantPermissions |
boolean : Indica si se deben otorgar todos los permisos de tiempo de ejecución en el momento de la instalación. |
userId |
int : Es el ID de usuario entero para el que se instalará. |
extraArgs |
String : Son argumentos adicionales opcionales para pasar. Consulta "adb shell pm -h" para ver las opciones disponibles. |
Muestra | |
---|---|
String |
Un String con un código de error o null si se realiza correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
Muestra | |
---|---|
boolean |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Verifica si la plataforma del dispositivo admite la enumeración de apps
Muestra | |
---|---|
boolean |
Es verdadero si se admite la enumeración de apps; de lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public boolean isBypassLowTargetSdkBlockSupported ()
Verifica si la plataforma del dispositivo admite omitir el bloqueo de SDK de destino bajo en las instalaciones de apps
Muestra | |
---|---|
boolean |
Es verdadero si se admite la omisión del bloque de SDK de destino bajo; de lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public boolean isDebugfsMounted ()
Verifica si debugfs está activado.
Muestra | |
---|---|
boolean |
true si se activa debugfs |
Arroja | |
---|---|
DeviceNotAvailableException |
isDeviceEncrypted
public boolean isDeviceEncrypted ()
Muestra si el dispositivo está encriptado.
Muestra | |
---|---|
boolean |
true si el dispositivo está encriptado. |
Arroja | |
---|---|
DeviceNotAvailableException |
isDirectory
public boolean isDirectory (String path)
Muestra True si la ruta de acceso en el dispositivo es un directorio y False en caso contrario.
Parámetros | |
---|---|
path |
String |
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
isEnableAdbRoot
public boolean isEnableAdbRoot ()
Muestra | |
---|---|
boolean |
true si se debe habilitar el permiso de administrador de adb en el dispositivo |
isEncryptionSupported
public boolean isEncryptionSupported ()
Muestra si la encriptación es compatible con el dispositivo.
Muestra | |
---|---|
boolean |
true si el dispositivo admite la encriptación. |
Arroja | |
---|---|
DeviceNotAvailableException |
isExecutable
public boolean isExecutable (String fullPath)
Muestra verdadero si la ruta de acceso del archivo en el dispositivo es un archivo ejecutable; de lo contrario, muestra falso.
Parámetros | |
---|---|
fullPath |
String |
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
isFastbootEnabled
public boolean isFastbootEnabled ()
Muestra si fastboot está disponible para el dispositivo.
Muestra | |
---|---|
boolean |
isHeadless
public boolean isHeadless ()
Muestra verdadero si el dispositivo no tiene pantalla (sin pantalla); de lo contrario, muestra falso.
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Muestra si el dispositivo usa el modo de usuario del sistema sin interfaz gráfica.
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Muestra si el usuario principal es un administrador permanente y no se puede borrar ni cambiar a un estado que no sea de administrador.
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
Compatibilidad con múltiples usuarios
public boolean isMultiUserSupported ()
Determina si se admite el modo multiusuario.
Muestra | |
---|---|
boolean |
Es verdadero si se admite el uso multiusuario; de lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
isPackageInstalled
public boolean isPackageInstalled (String packageName, String userId)
Consulta el dispositivo para un nombre de paquete y un ID de usuario determinados para verificar si está instalado o no para ese usuario.
Parámetros | |
---|---|
packageName |
String : Es el paquete que estamos verificando si está instalado. |
userId |
String : Es el ID de usuario para el que estamos verificando que se haya instalado el paquete. Si es nulo, se usará el usuario principal cero. |
Muestra | |
---|---|
boolean |
Es verdadero si se informa que el paquete está instalado. De lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
PaqueteInstalado
public boolean isPackageInstalled (String packageName)
Consulta el dispositivo para un nombre de paquete determinado y comprueba si está instalado o no.
Parámetros | |
---|---|
packageName |
String |
Muestra | |
---|---|
boolean |
Es verdadero si se informa que el paquete está instalado. De lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public boolean isRuntimePermissionSupported ()
Verifica si la plataforma del dispositivo admite el otorgamiento de permisos de tiempo de ejecución
Muestra | |
---|---|
boolean |
Es verdadero si se admite el permiso de tiempo de ejecución. De lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
Muestra verdadero si el dispositivo está en TestDeviceState#FASTBOOT
o TestDeviceState.FASTBOOTD
.
Muestra | |
---|---|
boolean |
isUserRunning
public boolean isUserRunning (int userId)
Verifica si un usuario determinado está en ejecución.
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
boolean |
Es verdadero si el usuario está corriendo y falso en todos los demás casos. |
Arroja | |
---|---|
DeviceNotAvailableException |
isUserSecondary
public boolean isUserSecondary (int userId)
Muestra si el usuario especificado es un usuario secundario según sus marcas.
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
boolean |
true si el usuario es secundario; de lo contrario, false |
Arroja | |
---|---|
DeviceNotAvailableException |
isUserVisible
public boolean isUserVisible (int userId)
Verifica si el usuario determinado es visible.
Un usuario "visible" es un usuario que interactúa con el usuario "humano" y, por lo tanto, puede iniciar actividades de inicio (por lo general, en la pantalla predeterminada).
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Comprueba si el usuario determinado es visible en la pantalla determinada.
Un usuario "visible" es un usuario que interactúa con el usuario "humano" y, por lo tanto, puede iniciar actividades de inicio en esa pantalla.
Parámetros | |
---|---|
userId |
int |
displayId |
int |
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Devuelve si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano en ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
Si es así, puedes llamar a startVisibleBackgroundUser(int, int, boolean)
y pasar una pantalla que muestra listDisplayIdsForStartingVisibleBackgroundUsers()
(que debe incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
Muestra si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano.
Si es así, puedes llamar a startVisibleBackgroundUser(int, int, boolean)
y pasar una pantalla que muestra listDisplayIdsForStartingVisibleBackgroundUsers()
.
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
¿Tiene Wi-Fi habilitado?
public boolean isWifiEnabled ()
Prueba si la red Wi-Fi está habilitada.
Verifica si la red Wi-Fi está habilitada en el dispositivo. Es útil para confirmar el estado de Wi-Fi antes de las pruebas que no deben ejecutarse con Wi-Fi, p.ej., pruebas de datos móviles.
Muestra | |
---|---|
boolean |
true si el Wi-Fi está habilitado. false si está inhabilitado |
Arroja | |
---|---|
DeviceNotAvailableException |
listDisplayIds
publiclistDisplayIds ()
Recopila la lista de ID de pantallas disponibles en el dispositivo según lo informa "dumpsys SurfaceFlinger".
Muestra | |
---|---|
|
Es la lista de pantallas. El valor predeterminado siempre muestra la pantalla predeterminada 0. |
Arroja | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Obtiene la lista de pantallas que se pueden usar para start a user visible in the background
.
Muestra | |
---|---|
|
Arroja | |
---|---|
DeviceNotAvailableException |
usuarios de la lista
publiclistUsers ()
Obtiene la lista de usuarios del dispositivo. Arrojará DeviceRuntimeException
si el resultado del dispositivo no es el esperado.
Muestra | |
---|---|
|
la lista de IDs de usuario. |
Arroja | |
---|---|
DeviceNotAvailableException |
LogAnrs.
public boolean logAnrs (ITestLogger logger)
Recopila y registra errores ANR del dispositivo.
Parámetros | |
---|---|
logger |
ITestLogger : Es un ITestLogger para registrar los errores de ANR. |
Muestra | |
---|---|
boolean |
Es verdadero si el registro se realizó correctamente; de lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
informe de errores de registro
public boolean logBugreport (String dataName, ITestLogger listener)
Es un método de ayuda para tomar un informe de errores y registrarlo en los generadores.
Parámetros | |
---|---|
dataName |
String : Es el nombre con el que se informará el informe de errores. |
listener |
ITestLogger : Un ITestLogger para registrar el informe de errores. |
Muestra | |
---|---|
boolean |
Es verdadero si el registro se realizó correctamente; de lo contrario, es falso. |
Dispositivo de acceso
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Registra un mensaje en el logcat del dispositivo. Esta es una llamada segura que no arrojará, incluso, si falla el registro.
Parámetros | |
---|---|
tag |
String : Es la etiqueta con la que registramos nuestro mensaje en el logcat. |
level |
Log.LogLevel : Es el nivel de depuración del mensaje en el logcat. |
format |
String : Es el formato del mensaje. |
args |
Object : Los argumentos que se reemplazarán a través de String.format(). |
reinicio no bloqueado
public void nonBlockingReboot ()
Emite un comando para reiniciar el dispositivo y muestra el resultado cuando se completa el comando y cuando el dispositivo ya no es visible para adb.
Arroja | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
Anula esta opción si el dispositivo necesita que se realicen algunas acciones específicas después de adb root y antes de que el dispositivo vuelva a estar en línea. La implementación predeterminada no incluye ninguna acción de adición. No se garantiza que adb root esté habilitado en esta etapa.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
Anula si el dispositivo necesita que se realicen algunas acciones específicas después de quitar adb y antes de que el dispositivo vuelva a estar en línea. La implementación predeterminada no incluye ninguna acción adicional. No se garantiza que adb root esté inhabilitado en esta etapa.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postBootSetup
public void postBootSetup ()
Sigue las instrucciones para configurar el dispositivo y realizar pruebas después de cada inicio.
Se debe llamar después de que el dispositivo se haya iniciado o esté disponible por completo.
En circunstancias normales, no es necesario llamar a este método de manera explícita, ya que las implementaciones deberían realizar estos pasos automáticamente cuando se realiza un reinicio.
Es posible que deba llamarse cuando se reinicia el dispositivo debido a otros eventos (p. ej., cuando se completó un comando de actualización de fastboot).
Arroja | |
---|---|
DeviceNotAvailableException |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Pasos adicionales para la limpieza requerida específica del dispositivo que se ejecutarán después de que se complete la invocación.
Parámetros | |
---|---|
exception |
Throwable : Si existe, la excepción final que generó el error de invocación. |
Configuración previa a la invocación
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Son pasos adicionales para la configuración requerida específica del dispositivo que se ejecutará en el dispositivo antes del flujo de invocación.
Parámetros | |
---|---|
info |
IBuildInfo : El IBuildInfo del dispositivo. |
attributes |
MultiMap : Son los atributos almacenados en el contexto de invocación. |
Arroja | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
pullDir
public boolean pullDir (String deviceFilePath, File localDir, int userId)
Extrae de forma recursiva el contenido del directorio del dispositivo.
Parámetros | |
---|---|
deviceFilePath |
String : Es la ruta de acceso absoluta del archivo de la fuente remota. |
localDir |
File : El directorio local al que se extraerán archivos |
userId |
int : El ID del usuario del que se extraerá la información |
Muestra | |
---|---|
boolean |
true si el archivo se extrajo correctamente. false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
pullDir
public boolean pullDir (String deviceFilePath, File localDir)
Extrae de forma recursiva el contenido del directorio del dispositivo.
Parámetros | |
---|---|
deviceFilePath |
String : Es la ruta de acceso absoluta del archivo de la fuente remota. |
localDir |
File : Es el directorio local al que se extraen los archivos. |
Muestra | |
---|---|
boolean |
true si el archivo se extrajo correctamente. false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile)
Recupera un archivo del dispositivo.
Parámetros | |
---|---|
remoteFilePath |
String : Es la ruta de acceso absoluta al archivo en el dispositivo. |
localFile |
File : Es el archivo local en el que se almacenará el contenido. Si no está vacío, se reemplazará el contenido. |
Muestra | |
---|---|
boolean |
true si el archivo se recuperó correctamente. false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath, int userId)
Recupera un archivo del dispositivo, lo almacena en un ERROR(/File)
temporal local y muestra ese File
.
Parámetros | |
---|---|
remoteFilePath |
String : Es la ruta de acceso absoluta al archivo en el dispositivo. |
userId |
int : El ID del usuario del que se extraerá la información |
Muestra | |
---|---|
File |
Un ERROR(/File) que contiene el contenido del archivo del dispositivo o null si la
copia falló por algún motivo (incluidos problemas con el sistema de archivos del host) |
Arroja | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath)
Recupera un archivo del dispositivo, lo almacena en un ERROR(/File)
temporal local y muestra ese File
.
Parámetros | |
---|---|
remoteFilePath |
String : Es la ruta de acceso absoluta al archivo en el dispositivo. |
Muestra | |
---|---|
File |
Un ERROR(/File) que contiene el contenido del archivo del dispositivo o null si la
copia falló por algún motivo (incluidos problemas con el sistema de archivos del host) |
Arroja | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Recupera un archivo del dispositivo.
Parámetros | |
---|---|
remoteFilePath |
String : Es la ruta de acceso absoluta al archivo en el dispositivo. |
localFile |
File : Es el archivo local en el que se almacenará el contenido. Si no está vacío, se reemplazará
el contenido. |
userId |
int : El ID del usuario del que se extraerá la información |
Muestra | |
---|---|
boolean |
true si el archivo se recuperó correctamente. false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
pullFileContents
public String pullFileContents (String remoteFilePath)
Recupera un archivo fuera del dispositivo y muestra el contenido.
Parámetros | |
---|---|
remoteFilePath |
String : Es la ruta de acceso absoluta al archivo en el dispositivo. |
Muestra | |
---|---|
String |
Un String que contiene el contenido del archivo del dispositivo o null si la
copia falló por algún motivo (incluidos problemas con el sistema de archivos del host) |
Arroja | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
Es un método conveniente para recuperar un archivo del almacenamiento externo del dispositivo, almacenarlo en un ERROR(/File)
temporal local y mostrar una referencia a ese File
.
Parámetros | |
---|---|
remoteFilePath |
String : Es la ruta de acceso al archivo en el dispositivo, en relación con el punto de activación del almacenamiento externo del dispositivo. |
Muestra | |
---|---|
File |
Un ERROR(/File) que contiene el contenido del archivo del dispositivo o null si la
copia falló por algún motivo (incluidos problemas con el sistema de archivos del host) |
Arroja | |
---|---|
DeviceNotAvailableException |
PushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Envía de manera recurrente el contenido del directorio al dispositivo y, al mismo tiempo, excluye algunos directorios filtrados.
Parámetros | |
---|---|
localFileDir |
File : Es el directorio local que se enviará. |
deviceFilePath |
String : La ruta de acceso absoluta del archivo del destino remoto |
excludedDirectories |
: Es un conjunto de nombres de directorios excluidos que no se deben enviar. |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
Envía de forma recursiva el contenido del directorio al dispositivo.
Parámetros | |
---|---|
localFileDir |
File : Es el directorio local que se enviará. |
deviceFilePath |
String : La ruta de acceso absoluta del archivo del destino remoto |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
Envía de forma recursiva el contenido del directorio al dispositivo.
Parámetros | |
---|---|
localFileDir |
File : Es el directorio local que se enviará. |
deviceFilePath |
String : Es la ruta de acceso absoluta al archivo del destino remoto. |
userId |
int : Es el ID de usuario al que se enviará el mensaje. |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Es una variante de pushFile(File, String)
que, de manera opcional, puede considerar evaluar la necesidad del proveedor de contenido.
Parámetros | |
---|---|
localFile |
File : Es el archivo local que se enviará. |
remoteFilePath |
String : Es la ruta de acceso absoluta del archivo de destino remoto. |
evaluateContentProviderNeeded |
boolean : Indica si se debe verificar si necesitamos el proveedor de contenido. |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
Archivo push
public boolean pushFile (File localFile, String remoteFilePath)
Envía un archivo al dispositivo. De forma predeterminada, usa un proveedor de contenido.
Parámetros | |
---|---|
localFile |
File : Es el archivo local que se enviará. |
remoteFilePath |
String : Es la ruta de acceso absoluta del archivo de destino remoto. |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
Archivo push
public boolean pushFile (File localFile, String remoteFilePath, int userId)
Envía un archivo al dispositivo. De forma predeterminada, usa un proveedor de contenido.
Parámetros | |
---|---|
localFile |
File : Es el archivo local que se enviará. |
remoteFilePath |
String : Es la ruta de acceso absoluta del archivo de destino remoto. |
userId |
int : Es el userId al que se enviará. |
Muestra | |
---|---|
boolean |
true si el archivo se envió correctamente. false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
pushString
public boolean pushString (String contents, String remoteFilePath)
Envío de archivo creado a partir de una cadena al dispositivo
Parámetros | |
---|---|
contents |
String : Es el contenido del archivo que se enviará. |
remoteFilePath |
String : Es la ruta de acceso absoluta del archivo de destino remoto. |
Muestra | |
---|---|
boolean |
true si la cadena se envió correctamente. De lo contrario, false . |
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciar
public void reboot (String reason)
Reinicia el dispositivo en modo adb con el reason
determinado para que persista durante el reinicio.
Se bloquea hasta que el dispositivo esté disponible.
El motivo del último reinicio se puede obtener consultando la propiedad sys.boot.reason
.
Parámetros | |
---|---|
reason |
String : Es el motivo del reinicio o null si no se especifica ningún motivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciar
public void reboot ()
Reinicia el dispositivo en modo ADB.
Se bloquea hasta que el dispositivo esté disponible.
Arroja | |
---|---|
DeviceNotAvailableException |
rebootIntoBootloader
public void rebootIntoBootloader ()
Reinicia el dispositivo en el modo bootloader.
Bloquea el dispositivo hasta que esté en modo de bootloader.
Arroja | |
---|---|
DeviceNotAvailableException |
rebootIntoFastbootd
public void rebootIntoFastbootd ()
Reinicia el dispositivo en modo fastbootd.
Se bloquea hasta que el dispositivo esté en modo de inicio rápido.
Arroja | |
---|---|
DeviceNotAvailableException |
rebootIntoRecovery
public void rebootIntoRecovery ()
Reinicia el dispositivo en el modo de recuperación de adb.
Bloquea el dispositivo hasta que entre en modo de recuperación.
Arroja | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload ()
Reinicia el dispositivo en el modo sideload de adb (ten en cuenta que este es un modo especial en la recuperación).
Bloquea hasta que el dispositivo entre en modo de carga lateral.
Arroja | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Reinicia el dispositivo en el modo sideload de adb (ten en cuenta que este es un modo especial en la recuperación).
Bloquea hasta que el dispositivo entre en modo de carga lateral.
Parámetros | |
---|---|
autoReboot |
boolean : Indica si se debe reiniciar automáticamente el dispositivo después de una transferencia. |
Arroja | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline ()
Una alternativa a reboot()
que solo se bloquea hasta que el dispositivo esté en línea, es decir, visible para adb
Arroja | |
---|---|
DeviceNotAvailableException |
reiniciarHastaEn línea
public void rebootUntilOnline (String reason)
Es un método alternativo a reboot()
que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.
Parámetros | |
---|---|
reason |
String : Es el motivo del reinicio o null si no se especifica ningún motivo. |
Arroja | |
---|---|
DeviceNotAvailableException |
espacio de usuario de reinicio
public void rebootUserspace ()
Reinicia solo una parte del espacio del usuario del dispositivo.
Bloquea el dispositivo hasta que esté disponible.
ADVERTENCIA. El reinicio del espacio de usuario está en desarrollo activo. Úsalo bajo tu propia responsabilidad.
Arroja | |
---|---|
DeviceNotAvailableException |
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
Es un método alternativo a rebootUserspace()
()} que solo bloquea hasta que el dispositivo está en línea, es decir, visible para adb.
Arroja | |
---|---|
DeviceNotAvailableException |
recoverDevice
public boolean recoverDevice ()
Intenta recuperar la comunicación con el dispositivo.
Muestra | |
---|---|
boolean |
Es verdadero si se intentó la recuperación y se realizó correctamente. Devuelve False si se omitió la recuperación. |
Arroja | |
---|---|
DeviceNotAvailableException |
si el dispositivo ya no está disponible |
registerDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registra un IDeviceActionReceiver
para este dispositivo.
Se notificará a todos los IDeviceActionReceiver
registrados antes de que comience una acción del dispositivo y después de que finalice.
Parámetros | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : Es un IDeviceActionReceiver que se registrará. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Haz que la partición del sistema en el dispositivo sea de solo lectura. Es posible que se reinicie el dispositivo.
Arroja | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Haz que se pueda escribir en la partición del sistema del dispositivo. Es posible que se reinicie el dispositivo.
Arroja | |
---|---|
DeviceNotAvailableException |
remountVendor (solo lectura)
public void remountVendorReadOnly ()
Haz que la partición del proveedor en el dispositivo sea de solo lectura. Es posible que se reinicie el dispositivo.
Arroja | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
Haz que se pueda escribir en la partición del proveedor del dispositivo. Es posible que se reinicie el dispositivo.
Arroja | |
---|---|
DeviceNotAvailableException |
removeAdmin
public boolean removeAdmin (String componentName, int userId)
Quita el administrador de dispositivo determinado de un usuario determinado y muestra true
si se realiza correctamente; de lo contrario, muestra false
.
Parámetros | |
---|---|
componentName |
String : Es el administrador de dispositivos que se quitará. |
userId |
int : del usuario en el que reside el administrador del dispositivo. |
Muestra | |
---|---|
boolean |
Es verdadero si se realiza correctamente; de lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
Quita todos los propietarios de perfiles de dispositivos existentes con el mejor esfuerzo.
Arroja | |
---|---|
DeviceNotAvailableException |
removeUser
public boolean removeUser (int userId)
Quita a un usuario determinado del dispositivo.
Parámetros | |
---|---|
userId |
int : Es el usuario que se quitará. |
Muestra | |
---|---|
boolean |
Es verdadero si se quitó correctamente el usuario; de lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
resetContentProviderSetup
public void resetContentProviderSetup ()
Restablece la marca de configuración del proveedor de contenido para volver a activarla.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Es un método conveniente para realizar ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
con uno o más objetos de escucha pasados como parámetros.
Parámetros | |
---|---|
runner |
IRemoteAndroidTestRunner : Es el IRemoteAndroidTestRunner que ejecuta las pruebas. |
listeners |
ITestLifeCycleReceiver : Los objetos de escucha de resultados de prueba |
Muestra | |
---|---|
boolean |
true si se completó el comando de prueba. false si no se completó, pero la recuperación se realizó correctamente |
Arroja | |
---|---|
DeviceNotAvailableException |
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Ejecuta pruebas de instrumentación y proporciona recuperación de dispositivos.
Si se pierde la conexión con el dispositivo antes de que se complete la ejecución de prueba y la recuperación se realiza correctamente, se informará a todos los objetos de escucha sobre testRunFailed y se mostrará "false". No se volverá a ejecutar el comando de prueba. Los llamadores deben volver a intentarlo si es necesario.
Si se pierde la conexión con el dispositivo antes de que se complete la ejecución de prueba y la recuperación falla, se informará a todos los objetos de escucha que testRunFailed y se arrojará DeviceNotAvailableException.
Parámetros | |
---|---|
runner |
IRemoteAndroidTestRunner : Es el IRemoteAndroidTestRunner que ejecuta las pruebas. |
listeners |
: Son los objetos de escucha del resultado de la prueba. |
Muestra | |
---|---|
boolean |
true si se completó el comando de prueba. false si no se completó debido a una excepción de comunicación del dispositivo, pero la recuperación se realizó correctamente |
Arroja | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Es igual que ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
, pero ejecuta la prueba para el usuario determinado.
Parámetros | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsComoUsuario
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Es igual que ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
, pero ejecuta la prueba para un usuario determinado.
Parámetros | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Inyecta el IConfiguration
en uso.
Parámetros | |
---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Parámetros | |
---|---|
avdInfo |
GceAvdInfo |
Configurar Fecha
public void setDate (Date date)
Establece la fecha en el dispositivo.
Nota: Para configurar la fecha en el dispositivo, se requiere acceso de raíz.
Parámetros | |
---|---|
date |
Date : Especifica una fecha en particular. Se usará la fecha del host si null . |
Arroja | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
Establece un componente de administrador de dispositivos como propietario del dispositivo en un usuario determinado.
Parámetros | |
---|---|
componentName |
String : del administrador del dispositivo para ser el propietario del dispositivo. |
userId |
int : del usuario en el que vive el propietario del dispositivo. |
Muestra | |
---|---|
boolean |
Es verdadero si se realiza correctamente; de lo contrario, es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Actualiza el estado del dispositivo.
Parámetros | |
---|---|
deviceState |
TestDeviceState : el TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
Para el emulador, establece SizeLimitedOutputStream
para registrar el resultado
Parámetros | |
---|---|
output |
SizeLimitedOutputStream : Para registrar el resultado |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Establece el Process
, cuando este dispositivo es un emulador.
Parámetros | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Establece la opción de fastboot para el dispositivo. Se debe configurar cuando se asigna el dispositivo por primera vez.
Parámetros | |
---|---|
fastbootEnabled |
boolean : Indica si fastboot está disponible para el dispositivo o no. |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Establece la ruta de acceso al objeto binario de fastboot que se debe usar.
Aún requiere que isFastbootEnabled()
sea verdadero para que se habiliten las funciones de Fastboot.
Parámetros | |
---|---|
fastbootPath |
String |
SetIDevice
public void setIDevice (IDevice newDevice)
Actualiza el IDevice asociado con este ITestDevice.
El nuevo IDevice debe hacer referencia al mismo dispositivo físico que la referencia actual. Se llamará a este método si DDMS asignó un IDevice nuevo.
Parámetros | |
---|---|
newDevice |
IDevice : el IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Establece el tiempo en ms que se debe esperar antes de iniciar la captura de logcat para un dispositivo en línea.
Parámetros | |
---|---|
delay |
int : Es el retraso en ms. |
setOptions
public void setOptions (TestDeviceOptions options)
Establece el TestDeviceOptions
para el dispositivo
Parámetros | |
---|---|
options |
TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
Establece el valor de la propiedad determinada en el dispositivo. Requiere que adb root sea verdadero.
Parámetros | |
---|---|
propKey |
String : Es la clave que se establecerá. |
propValue |
String : Es el valor de la propiedad que se establecerá. |
Muestra | |
---|---|
boolean |
Muestra True si el comando setprop se realizó correctamente; de lo contrario, muestra False. |
Arroja | |
---|---|
DeviceNotAvailableException |
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Establece el IDeviceRecovery
que se usará para este dispositivo. Se debe configurar cuando se asigna el dispositivo por primera vez.
Parámetros | |
---|---|
recovery |
IDeviceRecovery : el IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Establece el modo de recuperación actual que se usará para el dispositivo.
Se usa para controlar qué método de recuperación se debe usar cuando se encuentra un problema de comunicación del dispositivo. Se recomienda usar este método con moderación cuando sea necesario (por ejemplo, cuando el framework esté inactivo, etcétera).
Parámetros | |
---|---|
mode |
ITestDevice.RecoveryMode : Indica si el modo "recuperar hasta solo en línea" debe estar activado o no. |
setSetting
public void setSetting (String namespace, String key, String value)
Consulta setSetting(int, String, String, String)
y se realizó en el usuario del sistema.
Parámetros | |
---|---|
namespace |
String |
key |
String |
value |
String |
Arroja | |
---|---|
DeviceNotAvailableException |
setSetting
public void setSetting (int userId, String namespace, String key, String value)
Agrega un valor de configuración al espacio de nombres de un usuario determinado. Algunos parámetros de configuración solo estarán disponibles después de un reinicio. namespace debe ser una de las siguientes opciones: {"system", "secure", "global"}
Parámetros | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
Arroja | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Inyecta la instancia de ITestLogger
Parámetros | |
---|---|
testLogger |
ITestLogger |
setTrackingSerial
public void setTrackingSerial (String trackingSerial)
Para la administración de dispositivos, realiza un seguimiento del número de serie que usamos para referirnos al dispositivo.
Parámetros | |
---|---|
trackingSerial |
String |
setUsarInicioRápidoBorrar
public void setUseFastbootErase (boolean useFastbootErase)
Establece si quieres usar el comando fastboot erase o fastboot format para limpiar una partición del dispositivo.
Parámetros | |
---|---|
useFastbootErase |
boolean : true si se debe usar el borrado de fastboot o false si se debe usar el formato de fastboot. |
startLogcat
public void startLogcat ()
Comienza a capturar resultados de logcat del dispositivo en segundo plano.
No tendrá efecto si ya se está capturando el resultado de Logcat. Los datos se pueden recuperar más adelante a través de getLogcat.
Cuando el dispositivo ya no esté en uso, se debe llamar a stopLogcat()
.
Por lo general, no es necesario llamar a startLogcat()
y stopLogcat()
cuando están en un contexto de invocación de TF, ya que el framework de TF iniciará y detendrá logcat.
Usuario de inicio
public boolean startUser (int userId)
Inicia un usuario determinado en segundo plano si está detenido. Si el usuario ya se está ejecutando en segundo plano, este método es un NOOP.
Parámetros | |
---|---|
userId |
int : del usuario para iniciar en segundo plano |
Muestra | |
---|---|
boolean |
true si el usuario se inició correctamente en segundo plano. |
Arroja | |
---|---|
DeviceNotAvailableException |
startUser
public boolean startUser (int userId, boolean waitFlag)
Inicia un usuario determinado en segundo plano si está detenido. Si el usuario ya se está ejecutando en segundo plano, este método es un NOOP. Es posible proporcionar una marca adicional para esperar a que la operación tenga efecto.
Parámetros | |
---|---|
userId |
int : Del usuario que se iniciará en segundo plano |
waitFlag |
boolean : Hace que el comando espere hasta que el usuario se inicie y se desbloquee. |
Muestra | |
---|---|
boolean |
true si el usuario se inició correctamente en segundo plano. |
Arroja | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Inicia un usuario determinado en segundo plano, visible en la pantalla determinada (es decir, le permite al usuario iniciar actividades en esa pantalla).
NOTA: Este comando no verifica si el usuario existe, si la pantalla está disponible, device supports such feature
, etcétera.
Parámetros | |
---|---|
userId |
int : del usuario para iniciar en segundo plano |
displayId |
int : Es la pantalla en la que se iniciará el usuario visible. |
waitFlag |
boolean : Hace que el comando espere hasta que el usuario se inicie y se desbloquee. |
Muestra | |
---|---|
boolean |
true si el usuario se inició correctamente y es visible en segundo plano. |
Arroja | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Cierra y borra el resultado del emulador.
stopLogcat
public void stopLogcat ()
Detén la captura de resultados de logcat del dispositivo y descarta los datos de logcat guardados actualmente.
No tendrá efecto si no se captura el resultado de logcat.
stopUser
public boolean stopUser (int userId)
Detiene a un usuario determinado. Si el usuario ya se detuvo, este método es un NOOP. No se puede detener al usuario actual ni al del sistema.
Parámetros | |
---|---|
userId |
int : del usuario que se detendrá. |
Muestra | |
---|---|
boolean |
Es verdadero si se detuvo al usuario correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Detener a un usuario determinado Es posible proporcionar marcas adicionales para esperar a que la operación tenga efecto y forzar la finalización del usuario. No se puede detener al usuario actual ni al del sistema.
Parámetros | |
---|---|
userId |
int : del usuario que se detendrá. |
waitFlag |
boolean : Hace que el comando espere hasta que se detenga el usuario. |
forceFlag |
boolean : Detendrá el usuario de forma forzosa. |
Muestra | |
---|---|
boolean |
Es verdadero si se detuvo al usuario correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
cambiarAAdbTcp
public String switchToAdbTcp ()
Cambia el dispositivo al modo adb-over-tcp.
Muestra | |
---|---|
String |
el número de serie del TCP o null si no se pudo cambiar el dispositivo |
Arroja | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Cambia el dispositivo al modo adb mediante USB.
Muestra | |
---|---|
boolean |
true si el cambio se realizó correctamente, false de lo contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
Cambiar de usuario
public boolean switchUser (int userId)
Cambia a otro userId con un tiempo de espera predeterminado. switchUser(int, long)
.
Parámetros | |
---|---|
userId |
int |
Muestra | |
---|---|
boolean |
Es verdadero si el userId nuevo coincide con el proveedor de userId. De lo contrario, el valor es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
switchUser
public boolean switchUser (int userId, long timeout)
Cambia a otro userId con el tiempo de espera proporcionado como fecha límite. Intenta inhabilitar el bloqueo de teclado después de que se realiza correctamente el cambio de usuario.
Parámetros | |
---|---|
userId |
int |
timeout |
long : Esperar antes de mostrar un valor falso para que falle el cambio de usuario. |
Muestra | |
---|---|
boolean |
Es verdadero si el userId nuevo coincide con el proveedor de userId. De lo contrario, el valor es falso. |
Arroja | |
---|---|
DeviceNotAvailableException |
syncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
Sincroniza de forma incremental el contenido de un directorio de archivos local con el dispositivo.
Decide qué archivos enviar comparando las marcas de tiempo de los archivos locales con sus equivalentes remotos. Solo se enviarán al dispositivo los archivos "más nuevos" o inexistentes. Por lo tanto, la sobrecarga debería ser relativamente pequeña si el archivo establecido en el dispositivo ya está actualizado.
Se ignorarán los archivos ocultos (con nombres que comienzan con ".").
Ejemplo de uso: syncFiles("/tmp/files", "/sdcard") creará un directorio /sdcard/files si aún no existe y enviará de manera recurrente el contenido de /tmp/files a /sdcard/files.
Parámetros | |
---|---|
localFileDir |
File : Es el directorio de archivos local que contiene los archivos que se enviarán de forma recursiva. |
deviceFilePath |
String : Es la raíz de la ruta de acceso absoluta del archivo de destino remoto. Todos los directorios de esa ruta de acceso de archivo deben ser legibles. Es decir, si envías a /data/local/tmp cuando adb no tiene permisos de raíz, se producirá un error. |
Muestra | |
---|---|
boolean |
true si los archivos se sincronizaron correctamente. false en caso contrario. |
Arroja | |
---|---|
DeviceNotAvailableException |
informe de errores de toma
public Bugreport takeBugreport ()
Toma un informe de errores y devuélvelo dentro de un objeto Bugreport
para controlarlo. Muestra un valor nulo en caso de que haya un problema. El archivo al que se hace referencia en el objeto del informe de errores se debe limpiar a través de Bugreport.close()
.
Muestra | |
---|---|
Bugreport |
uninstallPackage
public String uninstallPackage (String packageName)
Desinstala un paquete de Android del dispositivo.
Parámetros | |
---|---|
packageName |
String : Es el paquete de Android que se desinstalará. |
Muestra | |
---|---|
String |
una String con un código de error, o null si se ejecuta de forma correcta. |
Arroja | |
---|---|
DeviceNotAvailableException |
desinstalarPaqueteParaUsuario
public String uninstallPackageForUser (String packageName, int userId)
Desinstala un paquete de Android del dispositivo de un usuario determinado.
Parámetros | |
---|---|
packageName |
String : Es el paquete de Android que se desinstalará. |
userId |
int : Es el ID de usuario entero para el que se desinstalará. |
Muestra | |
---|---|
String |
Un String con un código de error o null si se realiza correctamente. |
Arroja | |
---|---|
DeviceNotAvailableException |
unlockDevice
public boolean unlockDevice ()
Desbloquea el dispositivo si está en estado encriptado.
Este método puede reiniciar el framework, pero no llamará apostBootSetup()
. Por lo tanto, es posible que el dispositivo no esté completamente listo para probarse cuando se devuelve este método.
Muestra | |
---|---|
boolean |
Es true si se ejecuta correctamente o si el dispositivo no está encriptado. |
Arroja | |
---|---|
DeviceNotAvailableException |
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Se bloquea hasta que se establece la marca de inicio completado del dispositivo.
Parámetros | |
---|---|
timeOut |
long : Es el tiempo en milisegundos que se espera para que se establezca la marca. |
Muestra | |
---|---|
boolean |
true si la marca de inicio completado del dispositivo se establece dentro del tiempo de espera |
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
Espera a que el dispositivo sea responsivo y esté disponible para realizar pruebas. Usa el tiempo de espera predeterminado.
Muestra | |
---|---|
boolean |
Es verdadero si el dispositivo está disponible y falso si la recuperación está inhabilitada y no está disponible. |
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
Espera a que el dispositivo sea responsivo y esté disponible para realizar pruebas.
Parámetros | |
---|---|
waitTime |
long : Es el tiempo en ms que se debe esperar. |
Muestra | |
---|---|
boolean |
Es verdadero si el dispositivo está disponible y falso si la recuperación está inhabilitada y no está disponible. |
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Espera a que el dispositivo responda y esté disponible sin considerar la ruta de recuperación.
Parámetros | |
---|---|
waitTime |
long |
Muestra | |
---|---|
boolean |
Verdadero si el dispositivo está disponible. Falso si no lo está. |
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Bloquea el dispositivo hasta que sea visible a través de fastboot. Usar el tiempo de espera predeterminado
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Bloquea el dispositivo para que esté en el estado "adb recovery" (ten en cuenta que esto es distinto de IDeviceRecovery
).
Parámetros | |
---|---|
waitTime |
long : Es el tiempo en ms que se debe esperar. |
Muestra | |
---|---|
boolean |
true si el dispositivo se inicia en modo de recuperación antes de que venza el tiempo.
false de lo contrario |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
Bloquea el dispositivo para que esté en el estado "sideload de adb".
Parámetros | |
---|---|
waitTime |
long : Es el tiempo en ms que se debe esperar. |
Muestra | |
---|---|
boolean |
true si el dispositivo se inicia en la transferencia lateral antes de que venza el tiempo. false
por lo demás |
waitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Bloquea el dispositivo para que no esté disponible, es decir, que no esté en ADB.
Parámetros | |
---|---|
waitTime |
long : Es el tiempo en ms que se debe esperar. |
Muestra | |
---|---|
boolean |
true si el dispositivo no está disponible antes de que venza el tiempo.
false de lo contrario |
waitForDeviceEn línea
public void waitForDeviceOnline ()
Se bloquea hasta que el dispositivo sea visible mediante adb. Usa el tiempo de espera predeterminado
Ten en cuenta que es posible que el dispositivo no responda a los comandos cuando se complete. En su lugar, usa waitForDeviceAvailable()
.
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceEn línea
public void waitForDeviceOnline (long waitTime)
Se bloquea hasta que el dispositivo sea visible mediante adb.
Ten en cuenta que es posible que el dispositivo no responda a los comandos cuando se complete. En su lugar, usa waitForDeviceAvailable()
.
Parámetros | |
---|---|
waitTime |
long : Es el tiempo en ms que se debe esperar. |
Arroja | |
---|---|
DeviceNotAvailableException |
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Espera a que el dispositivo responda a un comando shell adb básico.
Parámetros | |
---|---|
waitTime |
long : Es el tiempo en ms que se debe esperar. |
Muestra | |
---|---|
boolean |
true si el dispositivo responde antes de que transcurra waitTime. |
Métodos protegidos
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Parámetros | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Compila el comando del SO para la sesión y los argumentos del comando adb shell dados.
Parámetros | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
Muestra | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Parámetros | |
---|---|
feature |
String |
strictMinLevel |
int |
createRestartDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Crea un RebootDeviceAction
para usarlo cuando realices una acción de reinicio.
Parámetros | |
---|---|
rebootMode |
NativeDevice.RebootMode : Es un modo de este reinicio. |
reason |
String : Para este reinicio. |
Muestra | |
---|---|
NativeDevice.RebootDeviceAction |
el RebootDeviceAction creado. |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Realiza un reinicio de adb.
Parámetros | |
---|---|
rebootMode |
NativeDevice.RebootMode : Es un modo de este reinicio. |
reason |
String : Para este reinicio. |
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
método auxiliar para generar una excepción si no se admite el permiso de tiempo de ejecución
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Muestra | |
---|---|
int |
getRunUtil
protected IRunUtil getRunUtil ()
Obtén la instancia de RunUtil
que se usará.
Muestra | |
---|---|
IRunUtil |
inicializarConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parámetros | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
Arroja | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
internalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Recupera una propiedad del dispositivo, de la caché de ddmlib de forma predeterminada, y recurre a "adb shell getprop" o "fastboot getvar" según si el dispositivo está en Fastboot o no.
Parámetros | |
---|---|
propName |
String : Es el nombre de la propiedad del dispositivo que muestra "adb shell getprop". |
fastbootVar |
String : Es el nombre de la variable de fastboot equivalente que se consultará. Si es null , no se intentará la consulta de fastboot. |
description |
String : Es una descripción simple de la variable. La primera letra debe estar en mayúscula. |
Muestra | |
---|---|
String |
Es una cadena, posiblemente null o vacía, que contiene el valor de la propiedad determinada. |
Arroja | |
---|---|
DeviceNotAvailableException |
isInRebootCallback
protected boolean isInRebootCallback ()
Muestra si las devoluciones de llamada de reinicio se están ejecutando actualmente o no. Si es verdadero, se deben inhabilitar todas las APIs públicas para el reinicio.
Muestra | |
---|---|
boolean |
isNewer
protected boolean isNewer (File localFile, IFileEntry entry)
Muestra true
si el archivo local es más reciente que el archivo remoto. IFileEntry
es precisa hasta el minuto, en caso de que los tiempos sean iguales, el archivo se considerará más reciente.
Parámetros | |
---|---|
localFile |
File |
entry |
IFileEntry |
Muestra | |
---|---|
boolean |
notifyRebootEnded
protected void notifyRebootEnded ()
Notifica a todos los IDeviceActionReceiver
sobre el evento de finalización del reinicio.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notifyRebootStarted
protected void notifyRebootStarted ()
Notifica a todos los IDeviceActionReceiver
sobre el evento de inicio del reinicio.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
realice una acción en el dispositivo
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Realiza una acción en este dispositivo. Intenta recuperar el dispositivo y, de manera opcional, vuelve a intentar el comando si falla la acción.
Parámetros | |
---|---|
actionDescription |
String : Es una descripción breve de la acción que se realizará. Solo se usa con fines de registro. |
action |
NativeDevice.DeviceAction : Es la acción que se realizará. |
retryAttempts |
int : El reintento intenta realizar la acción si falla, pero la recuperación se realiza correctamente. |
Muestra | |
---|---|
boolean |
true si la acción se realizó correctamente |
Arroja | |
---|---|
DeviceNotAvailableException |
si el intento de recuperación falla o los intentos máximos se realizan sin éxito |
relanzamiento de post abierto
protected void postAdbReboot ()
Son posibles acciones adicionales que se pueden realizar después de un reinicio.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
prePostBootSetup
protected void prePostBootSetup ()
Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) anule este método para una configuración específica después del inicio.
Arroja | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInterno
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Parámetros | |
---|---|
remoteFilePath |
String |
localFile |
File |
Muestra | |
---|---|
boolean |
Arroja | |
---|---|
DeviceNotAvailableException |
setClock
protected void setClock (Clock clock)
Establece la instancia de reloj que se usará.
Parámetros | |
---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Marca el TestDevice como microdroid y establece su CID.
Parámetros | |
---|---|
process |
Process : Es el proceso de la VM de Microdroid. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Parámetros | |
---|---|
deviceOptions |
|
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Ejecuta un comando fastboot simple con variables de entorno y, luego, informa el estado del comando.
Parámetros | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
Muestra | |
---|---|
CommandResult |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Ejecuta un comando fastboot simple y, luego, informa el estado del comando.
Parámetros | |
---|---|
timeout |
long |
fullCmd |
String |
Muestra | |
---|---|
CommandResult |
waitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Espera a que el dispositivo deje de estar disponible (deje de informar a adb).
Parámetros | |
---|---|
operationDesc |
String : Es el nombre de la operación que está esperando un estado no disponible. |
time |
long : Es el tiempo que se debe esperar hasta que ocurra un evento no disponible. |
Muestra | |
---|---|
boolean |
Es verdadero si el dispositivo no está disponible. |