Dispositivo nativo
public class NativeDevice
extends Object
implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver
java.lang.Objeto | |
↳ | com.android.tradefed.device.NativeDevice |
Implementación predeterminada de un ITestDevice
Dispositivos Android que no son de pila completa.
Resumen
clases anidadas | |
---|---|
class | NativeDevice.AdbAction Un |
class | NativeDevice.AdbShellAction |
class | NativeDevice.RebootDeviceAction |
Constantes | |
---|---|
int | INVALID_USER_ID Valor devuelto para cualquier identificación de usuario no válida o no encontrada: UserHandle definió el valor -10000 |
long | MAX_HOST_DEVICE_TIME_OFFSET |
int | MAX_RETRY_ATTEMPTS el número predeterminado de intentos de reintento de comando para 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) al obtener previamente todos los accesorios que necesitamos en lugar de llamar 'adb getprop' para cada uno. |
boolean | canSwitchToHeadlessSystemUser () Devuelve si está permitido cambiar al usuario del SISTEMA sin cabeza. |
boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) Compruebe si una característica es actualmente compatible con un nivel mínimo de compatibilidad. |
boolean | checkConnectivity () Verifique que el dispositivo tenga conectividad de red. |
boolean | clearErrorDialogs () Intente descartar cualquier cuadro de diálogo de error que se muestre actualmente en la interfaz de usuario del dispositivo. |
void | clearLastConnectedWifiNetwork () Borra la última red wifi conectada. |
void | clearLogcat () Elimina cualquier dato de logcat acumulado. |
boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) Se conecta a una red wifi. |
boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) Se conecta a una red wifi. |
boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) Se conecta a una red wifi.f |
boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) Se conecta a una red wifi. |
boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) Una variante de |
boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) Una variante de |
int | createUser (String name, boolean guest, boolean ephemeral) Cree un usuario con un nombre de pila y las banderas proporcionadas |
int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) Cree un usuario con un nombre de pila y las banderas proporcionadas |
int | createUser (String name) Cree un usuario con un nombre de pila y banderas predeterminadas 0. |
int | createUserNoThrow (String name) Cree un usuario con un nombre de pila y banderas predeterminadas 0. |
void | deleteFile (String deviceFilePath) Método auxiliar para eliminar un archivo o directorio en el dispositivo. |
void | deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Elimina el |
boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) Método auxiliar para verificar si el dispositivo se reinició suavemente comparando el system_server actual con el system_server |
boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Método auxiliar para verificar si el dispositivo se reinició suavemente desde la hora UTC desde la época del dispositivo y su |
boolean | disableAdbRoot () Desactiva la raíz de adb. |
void | disableKeyguard () Intenta desactivar el bloqueo de teclas. |
boolean | disableNetworkMonitor () Desactiva el monitoreo de red en el dispositivo. |
boolean | disconnectFromWifi () Se desconecta de una red wifi. |
boolean | doesFileExist (String deviceFilePath, int userId) 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) Intente volcar el montón del system_server. |
boolean | enableAdbRoot () Activa la raíz de adb. |
boolean | enableNetworkMonitor () Habilita el monitoreo de red en el dispositivo. |
String | executeAdbCommand (long timeout, String... cmdArgs) Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera específico. |
String | executeAdbCommand (long timeout, envMap, String... cmdArgs) executeAdbCommand (long timeout, envMap, String... cmdArgs) Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera específico. |
String | executeAdbCommand (String... cmdArgs) Método auxiliar que ejecuta un comando adb como comando del sistema. |
CommandResult | executeFastbootCommand (String... cmdArgs) Método auxiliar que ejecuta un comando fastboot como comando del sistema con un tiempo de espera predeterminado de 2 minutos. |
CommandResult | executeFastbootCommand (long timeout, String... cmdArgs) Método auxiliar que ejecuta un comando fastboot como comando del sistema. |
CommandResult | executeLongFastbootCommand (String... cmdArgs) Método auxiliar que ejecuta un comando fastboot de larga duración como comando del sistema. |
CommandResult | executeLongFastbootCommand ( envVarMap, String... cmdArgs) executeLongFastbootCommand ( envVarMap, String... cmdArgs) 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) Método auxiliar que ejecuta un comando de adb Shell y devuelve la salida como una |
void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando. |
void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando. |
void | executeShellCommand (String command, IShellOutputReceiver receiver) Ejecuta el comando adb shell dado y lo vuelve a intentar varias veces si el comando falla. |
CommandResult | executeShellV2Command (String cmd) Método auxiliar que ejecuta un comando de adb shell y devuelve los resultados como un |
CommandResult | executeShellV2Command (String cmd, OutputStream pipeToOutput) Método auxiliar que ejecuta un comando de adb shell y devuelve los resultados como un |
CommandResult | executeShellV2Command (String cmd, File pipeAsInput) Método auxiliar que ejecuta un comando de adb shell y devuelve los resultados como un |
CommandResult | executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Ejecuta un comando de adb shell, con más parámetros para controlar el comportamiento del comando. |
CommandResult | executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit) Ejecuta un comando de 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 de 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 de adb shell, con más parámetros para controlar el comportamiento del comando. |
CommandResult | fastbootWipePartition (String partition) Método auxiliar que borra una partición del dispositivo. |
getActiveApexes () Obtenga la información sobre APEX activados en el dispositivo. | |
getAllSettings (String namespace) Devuelve pares clave-valor del espacio de nombres solicitado. | |
DeviceAllocationState | getAllocationState () Devolver el estado de asignación actual del dispositivo |
String | getAndroidId (int userId) Busque y devuelva el ID de Android asociado a un ID de usuario, nulo si no se encuentra. |
getAndroidIds () Cree un mapa de identificadores de Android que coincidan con los identificadores de usuario. | |
int | getApiLevel () Obtenga el nivel API del dispositivo. |
PackageInfo | getAppPackageInfo (String packageName) Obtenga información sobre un paquete instalado en el dispositivo. |
getAppPackageInfos () Obtenga información de los paquetes instalados en el dispositivo. | |
String | getBasebandVersion () Método conveniente para obtener la versión de banda base (radio) de este dispositivo. |
Integer | getBattery () Devuelve el nivel actual de batería de un dispositivo o Nulo si el nivel de batería no está disponible. |
boolean | getBooleanProperty (String name, boolean defaultValue) Devuelve el valor booleano de la propiedad dada. |
getBootHistory () El método auxiliar recopila el mapa del historial de arranque con la hora de arranque y el motivo de arranque. | |
getBootHistorySince (long utcEpochTime, TimeUnit timeUnit) El método auxiliar recopila el mapa del historial de inicio con el tiempo de inicio y el motivo de inicio desde el momento dado desde la época del dispositivo y la unidad de tiempo especificada. | |
String | getBootloaderVersion () Método conveniente para obtener la versión del gestor de arranque de este dispositivo. |
InputStreamSource | getBugreport () Recupera un informe de error del dispositivo. |
InputStreamSource | getBugreportz () Recupera un informe de error del dispositivo. |
String | getBuildAlias () Recupere el alias de la compilación que el dispositivo está ejecutando actualmente. |
String | getBuildFlavor () Recupere el tipo de compilación para el dispositivo. |
String | getBuildId () Recupere la compilación que el dispositivo está ejecutando actualmente. |
String | getBuildSigningKeys () Devuelve el tipo de clave utilizada para firmar la imagen del dispositivo. Normalmente, los dispositivos Android pueden estar firmados con claves de prueba (como en AOSP) o claves de liberación (controladas por los fabricantes de dispositivos individuales). |
DeviceDescriptor | getCachedDeviceDescriptor () Devuelve un |
DeviceDescriptor | getCachedDeviceDescriptor (boolean shortDescriptor) Devuelve un |
String[] | getChildren (String path) Alternativa al uso |
AbstractConnection | getConnection () La conexión actual asociada con el dispositivo. |
DeviceFoldableState | getCurrentFoldableState () Devuelve el estado plegable actual del dispositivo o nulo si ocurrieron algunos problemas. |
int | getCurrentUser () Devuelve la identificación del usuario actual en ejecución. |
String | getDeviceClass () Obtenga la clase de dispositivo. |
long | getDeviceDate () Devuelve la fecha del dispositivo en milisegundos desde la época. |
DeviceDescriptor | getDeviceDescriptor () Devuelve un |
DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) Devuelve un |
TestDeviceState | getDeviceState () Obtenga el estado del dispositivo. |
long | getDeviceTimeOffset (Date date) Ayudante para obtener la diferencia horaria entre el dispositivo y un |
InputStreamSource | getEmulatorOutput () Obtener el flujo de stdout y stderr del emulador |
Process | getEmulatorProcess () Devuelve el |
final File | getExecuteShellCommandLog () El registro que contiene todos los registros |
long | getExternalStoreFreeSpace () Método auxiliar para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo. |
String | getFastbootPath () Devuelve la ruta del binario fastboot que se está utilizando. |
String | getFastbootProductType () Método conveniente para obtener el tipo de producto de este dispositivo cuando está en modo fastboot. |
String | getFastbootProductVariant () Método conveniente para obtener el tipo de producto de este dispositivo cuando está en modo fastboot. |
String | getFastbootSerialNumber () Devuelve el número de serie del modo fastboot. |
String | getFastbootVariable (String variableName) Recupere el valor de la variable fastboot proporcionado del dispositivo. |
String | getFastbootVersion () Devuelve la cadena de versión del binario fastboot que se está utilizando. |
IFileEntry | getFileEntry (String path) Recupera una referencia a un archivo remoto en el dispositivo. |
IFileEntry | getFileEntry (FileListingService.FileEntry entry) Ayudante no oficial para obtener un |
getFoldableStates () Devuelve la lista de estados plegables en el dispositivo. | |
IDevice | getIDevice () Devuelve una referencia al |
getInstalledPackageNames () Obtenga los nombres de los paquetes de aplicaciones presentes en el dispositivo. | |
long | getIntProperty (String name, long defaultValue) Devuelve el valor entero de la propiedad dada del dispositivo. |
String | getIpAddress () Obtiene la dirección IP del dispositivo. |
KeyguardControllerState | getKeyguardState () Devuelve un objeto para obtener el estado actual del protector de claves o nulo si no es compatible. |
long | getLastExpectedRebootTimeMillis () Devuelve la última vez que las API Tradefed activaron un reinicio en milisegundos desde EPOCH según lo devuelto por |
int | getLaunchApiLevel () Obtenga el primer nivel API lanzado del dispositivo. |
InputStreamSource | getLogcat () Toma un flujo de instantáneas de los datos de logcat. |
InputStreamSource | getLogcat (int maxBytes) Toma una secuencia de instantáneas de los últimos |
InputStreamSource | getLogcatDump () Obtenga un volcado del logcat actual para el dispositivo. |
InputStreamSource | getLogcatSince (long date) Toma un flujo de instantáneas de los datos de logcat capturados a partir de la fecha proporcionada. |
String | getMacAddress () Devuelve la dirección MAC del dispositivo, nula si no se puede realizar la consulta desde el dispositivo. |
Integer | getMainUserId () Devuelve la identificación del usuario principal. |
getMainlineModuleInfo () Obtenga la información sobre los módulos principales instalados en el dispositivo. | |
int | getMaxNumberOfRunningUsersSupported () Obtenga la cantidad máxima de usuarios compatibles que se ejecutan simultáneamente. |
int | getMaxNumberOfUsersSupported () Obtenga el número máximo de usuarios admitidos. |
Process | getMicrodroidProcess () |
IDeviceStateMonitor | getMonitor () Devuelve el |
String | getMountPoint (String mountName) Devuelve un punto de montaje. |
ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) Devuelve un |
getMountPointInfo () Devuelve una versión analizada de la información en /proc/mounts en el dispositivo | |
TestDeviceOptions | getOptions () Obtenga las opciones de prueba para el dispositivo. |
long | getPartitionFreeSpace (String partition) Método auxiliar para determinar la cantidad de espacio libre en la partición del dispositivo. |
Integer | getPrimaryUserId () Devuelve la identificación del usuario principal. |
ProcessInfo | getProcessByName (String processName) El método auxiliar ejecuta los comandos "pidof" y "stat" y devuelve el objeto |
String | getProcessPid (String process) Devuelve el pid del servicio o nulo si algo salió mal. |
String | getProductType () Método conveniente para obtener el tipo de producto de este dispositivo. |
String | getProductVariant () Método conveniente para obtener la variante de producto de este dispositivo. |
String | getProperty (String name) Recupere el valor de propiedad dado del dispositivo. |
ITestDevice.RecoveryMode | getRecoveryMode () Obtenga el modo de recuperación actual utilizado para el dispositivo. |
InputStreamSource | getScreenshot (String format) Toma una captura de pantalla del dispositivo. |
InputStreamSource | getScreenshot (long displayId) Toma una captura de pantalla del dispositivo con la identificación de pantalla dada. |
InputStreamSource | getScreenshot (String format, boolean rescale) Toma una captura de pantalla del dispositivo. |
InputStreamSource | getScreenshot () Toma una captura de pantalla del dispositivo. |
String | getSerialNumber () Método conveniente para obtener el número de serie de este dispositivo. |
String | getSetting (int userId, String namespace, String key) Devuelve el valor de la configuración solicitada. |
String | getSetting (String namespace, String key) Consulte |
String | getSimOperator () Devuelve la tarjeta SIM del operador o nula si no está disponible o si el dispositivo no está disponible. |
String | getSimState () Devuelve el estado de la tarjeta SIM o nulo si no está disponible o el dispositivo no está disponible. |
getTombstones () Obtenga y devuelva la lista de lápidas de los dispositivos. | |
long | getTotalMemory () Devuelve el tamaño total de la memoria física en bytes o -1 en caso de error interno |
getUninstallablePackageNames () Obtenga los nombres de los paquetes de aplicaciones que se pueden desinstalar. | |
boolean | getUseFastbootErase () Obtenga información sobre si desea utilizar el borrado fastboot o el formato fastboot para borrar una partición del dispositivo. |
int | getUserFlags (int userId) Encuentra y devuelve las banderas de un usuario determinado. |
getUserInfos () Obtiene el mapa de useId a | |
int | getUserSerialNumber (int userId) Devuelve el número de serie asociado al ID de usuario si lo encuentra, -10000 en cualquier otro caso. |
IManagedTestDevice.DeviceEventResponse | handleAllocationEvent (DeviceEvent event) Procese el DeviceEvent dado. Procese el DeviceEvent, que puede o no hacer la transición de este dispositivo a un nuevo estado de asignación. |
boolean | hasFeature (String feature) Compruebe si una función está disponible en un dispositivo. |
String | installPackage (File packageFile, boolean reinstall, String... extraArgs) Instale un paquete de Android en el dispositivo. |
String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Instale un paquete de Android en el dispositivo. |
String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Instale un paquete de Android en el dispositivo de un usuario determinado. |
String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instale un paquete de Android en el dispositivo de un usuario determinado. |
void | invalidatePropertyCache () |
boolean | isAdbRoot () |
boolean | isAdbTcp () |
boolean | isAppEnumerationSupported () Compruebe si la plataforma del dispositivo admite la enumeración de aplicaciones |
boolean | isBypassLowTargetSdkBlockSupported () Verifique si la plataforma en el dispositivo permite omitir el bloqueo de SDK de destino bajo en las instalaciones de aplicaciones |
boolean | isDebugfsMounted () Compruebe si debugfs está montado. |
boolean | isDeviceEncrypted () Devuelve si el dispositivo está cifrado. |
boolean | isDirectory (String path) Devuelve True si la ruta del dispositivo es un directorio; false en caso contrario. |
boolean | isEnableAdbRoot () |
boolean | isEncryptionSupported () Devuelve si el cifrado es compatible con el dispositivo. |
boolean | isExecutable (String fullPath) Devuelve True si la ruta del archivo en el dispositivo es un archivo ejecutable; false en caso contrario. |
boolean | isFastbootEnabled () Devuelve si fastboot está disponible para el dispositivo. |
boolean | isHeadless () Devuelve verdadero si el dispositivo no tiene cabeza (sin pantalla), falso en caso contrario. |
boolean | isHeadlessSystemUserMode () Devuelve si el dispositivo utiliza el modo de usuario del sistema sin cabeza. |
boolean | isMainUserPermanentAdmin () Devuelve si el usuario principal es un administrador permanente y no se puede eliminar ni degradar al estado de no administrador. |
boolean | isMultiUserSupported () Determina si se admite multiusuario. |
boolean | isPackageInstalled (String packageName, String userId) Consulte el dispositivo para obtener un nombre de paquete determinado y una identificación de usuario determinada para verificar si está actualmente instalado o no para ese usuario. |
boolean | isPackageInstalled (String packageName) Consulta en el dispositivo un nombre de paquete determinado para comprobar si está actualmente instalado o no. |
boolean | isRuntimePermissionSupported () Compruebe si la plataforma del dispositivo admite la concesión de permisos en tiempo de ejecución |
boolean | isStateBootloaderOrFastbootd () Devuelve verdadero si el dispositivo está en |
boolean | isUserRunning (int userId) Compruebe si un usuario determinado se está ejecutando. |
boolean | isUserSecondary (int userId) Devuelve si el usuario especificado es un usuario secundario según sus indicadores. |
boolean | isUserVisible (int userId) Comprueba si el usuario dado es visible. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Comprueba si el usuario dado es visible en la pantalla dada. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Devuelve si el dispositivo permite que los usuarios se inicien visibles en segundo plano en |
boolean | isVisibleBackgroundUsersSupported () Devuelve si el dispositivo permite que los usuarios se inicien de forma visible en segundo plano. |
boolean | isWifiEnabled () Pruebe si el wifi está habilitado. |
listDisplayIds () Recopile la lista de ID de pantallas disponibles en el dispositivo según lo informado por "dumpsys SurfaceFlinger". | |
listDisplayIdsForStartingVisibleBackgroundUsers () Obtiene la lista de pantallas que se pueden usar para | |
listUsers () Obtiene la lista de usuarios en el dispositivo. | |
boolean | logAnrs ( ITestLogger logger) Recopila y registra ANR del dispositivo. |
boolean | logBugreport (String dataName, ITestLogger listener) Método auxiliar para tomar un informe de error y registrarlo para los reporteros. |
void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Registre un mensaje en el logcat del dispositivo. |
void | mountDebugfs () Montar debugfs. |
void | nonBlockingReboot () Emite un comando para reiniciar el dispositivo y regresa cuando el comando se completa y cuando el dispositivo ya no es visible para adb. |
void | postAdbRootAction () Anule 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 () Anule si el dispositivo necesita que se realicen algunas acciones específicas después de desrootear adb y antes de que el dispositivo vuelva a estar en línea. |
void | postBootSetup () Siga las instrucciones para configurar el dispositivo y probarlo después de cada arranque. |
void | postInvocationTearDown (Throwable exception) Se requieren pasos adicionales para la limpieza específica del dispositivo que se ejecutarán una vez finalizada 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án en el dispositivo antes del flujo de invocación. |
boolean | pullDir (String deviceFilePath, File localDir) Extraiga recursivamente 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 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 fuera del dispositivo y devuelve el contenido. |
File | pullFileFromExternal (String remoteFilePath) Un método conveniente para recuperar un archivo del almacenamiento externo del dispositivo, lo almacena en un |
boolean | pushDir (File localFileDir, String deviceFilePath, excludedDirectories) pushDir (File localFileDir, String deviceFilePath, excludedDirectories) Envíe de forma recursiva el contenido del directorio al dispositivo y excluya algunos directorios que están filtrados. |
boolean | pushDir (File localFileDir, String deviceFilePath) Empuje recursivamente el contenido del directorio al dispositivo. |
boolean | pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded) Variante de |
boolean | pushFile (File localFile, String remoteFilePath) Envíe un archivo al dispositivo. |
boolean | pushString (String contents, String remoteFilePath) Enviar archivo creado a partir de una cadena al dispositivo |
void | reboot (String reason) Reinicia el dispositivo en modo adb con el |
void | reboot () Reinicia el dispositivo en modo adb. |
void | rebootIntoBootloader () Reinicia el dispositivo en modo gestor de arranque. |
void | rebootIntoFastbootd () Reinicia el dispositivo en modo fastbootd. |
void | rebootIntoRecovery () Reinicia el dispositivo en modo de recuperación adb. |
void | rebootIntoSideload () Reinicia el dispositivo en modo de carga lateral de adb (tenga en cuenta que este es un modo especial en recuperación) Se bloquea hasta que el dispositivo ingresa al modo de carga lateral |
void | rebootIntoSideload (boolean autoReboot) Reinicia el dispositivo en modo de carga lateral de adb (tenga en cuenta que este es un modo especial en recuperación) Se bloquea hasta que el dispositivo ingresa al modo de carga lateral |
void | rebootUntilOnline () Una alternativa a |
void | rebootUntilOnline (String reason) Una alternativa a |
void | rebootUserspace () Reinicia solo la parte del espacio de usuario del dispositivo. |
void | rebootUserspaceUntilOnline () Una alternativa a |
boolean | recoverDevice () Intenta recuperar la comunicación del dispositivo. |
void | registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Registra un |
void | remountSystemReadOnly () Haga que la partición del sistema en el dispositivo sea de solo lectura. |
void | remountSystemWritable () Haga que la partición del sistema en el dispositivo sea escribible. |
void | remountVendorReadOnly () Haga que la partición del proveedor en el dispositivo sea de solo lectura. |
void | remountVendorWritable () Haga que la partición del proveedor en el dispositivo sea escribible. |
boolean | removeAdmin (String componentName, int userId) Elimine el administrador del dispositivo determinado en un usuario determinado y devuelva |
void | removeOwners () Elimine a todos los propietarios de perfiles de dispositivos existentes con el mejor esfuerzo. |
boolean | removeUser (int userId) Eliminar un usuario determinado del dispositivo. |
void | resetContentProviderSetup () Restablezca el indicador para la configuración del proveedor de contenido para activarlo nuevamente. |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Método conveniente para realizar |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Ejecuta pruebas de instrumentación y proporciona recuperación de dispositivos. |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) Igual que |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) Igual que |
void | setConfiguration ( IConfiguration configuration) Inyecta la |
final void | setConnectionAvdInfo ( GceAvdInfo avdInfo) |
void | setDate (Date date) Establece la fecha en el dispositivo Nota: configurar la fecha en el dispositivo requiere root |
boolean | setDeviceOwner (String componentName, int userId) Configure un componente de administración del dispositivo como propietario del dispositivo en un usuario determinado. |
void | setDeviceState ( TestDeviceState deviceState) Actualiza el estado del dispositivo. |
void | setEmulatorOutputStream ( SizeLimitedOutputStream output) Para el emulador, configure |
void | setEmulatorProcess (Process p) Establece el |
void | setFastbootEnabled (boolean fastbootEnabled) Configure la opción fastboot para el dispositivo. |
void | setFastbootPath (String fastbootPath) Establece la ruta al binario fastboot que se debe utilizar. |
void | setIDevice (IDevice newDevice) Actualice 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) Configure |
boolean | setProperty (String propKey, String propValue) Establece el valor de propiedad dado en el dispositivo. |
void | setRecovery ( IDeviceRecovery recovery) Configure el |
void | setRecoveryMode ( ITestDevice.RecoveryMode mode) Configure el modo de recuperación actual que se utilizará en el dispositivo. |
void | setSetting (String namespace, String key, String value) Consulte |
void | setSetting (int userId, String namespace, String key, String value) Agregue un valor de configuración al espacio de nombres de un usuario determinado. |
void | setTestLogger ( ITestLogger testLogger) Inyecta la instancia |
void | setUseFastbootErase (boolean useFastbootErase) Establezca si desea utilizar el borrado fastboot o el formato fastboot para borrar una partición en el dispositivo. |
void | startLogcat () Comience a capturar la salida de Logcat desde el dispositivo en segundo plano. |
boolean | startUser (int userId) Inicia un usuario determinado en segundo plano si actualmente está detenido. |
boolean | startUser (int userId, boolean waitFlag) Inicia un usuario determinado en segundo plano si actualmente está detenido. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Inicia un usuario determinado en segundo plano, visible en la pantalla determinada (es decir, permitiendo al usuario iniciar actividades en esa pantalla). |
void | stopEmulatorOutput () Cierre y elimine la salida del emulador. |
void | stopLogcat () Deje de capturar la salida de Logcat desde el dispositivo y descarte 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 () Cambie el dispositivo al modo adb-over-tcp. |
boolean | switchToAdbUsb () Cambie el dispositivo al modo adb sobre usb. |
boolean | switchUser (int userId) Cambie a otro ID de usuario con un tiempo de espera predeterminado. |
boolean | switchUser (int userId, long timeout) Cambie a otro ID de usuario con el tiempo de espera proporcionado como fecha límite. |
boolean | syncFiles (File localFileDir, String deviceFilePath) Sincroniza incrementalmente el contenido de un directorio de archivos local con el dispositivo. |
Bugreport | takeBugreport () Tome un informe de error y lo devuelva dentro de un objeto |
String | uninstallPackage (String packageName) Desinstale un paquete de Android del dispositivo. |
String | uninstallPackageForUser (String packageName, int userId) Desinstale un paquete de Android del dispositivo para un usuario determinado. |
boolean | unlockDevice () Desbloquea el dispositivo si el dispositivo está en un estado cifrado. |
void | unmountDebugfs () Desmontar debugfs. |
boolean | waitForBootComplete (long timeOut) Se bloquea hasta que se establece el indicador de inicio completo del dispositivo. |
boolean | waitForDeviceAvailable () Espera a que el dispositivo responda y esté disponible para realizar pruebas. |
boolean | waitForDeviceAvailable (long waitTime) Espera a que el dispositivo responda y esté disponible para realizar pruebas. |
boolean | waitForDeviceAvailableInRecoverPath (long waitTime) Espera a que el dispositivo responda y esté disponible sin considerar la ruta de recuperación. |
void | waitForDeviceBootloader () Se bloquea hasta que el dispositivo sea visible a través de fastboot. |
boolean | waitForDeviceInRecovery (long waitTime) Bloquea para que el dispositivo esté en el estado 'adb recovery' (tenga en cuenta que esto es distinto de |
boolean | waitForDeviceInSideload (long waitTime) Bloques para que el dispositivo esté en el estado 'adb sideload' |
boolean | waitForDeviceNotAvailable (long waitTime) Bloques para que el dispositivo no esté disponible, es decir, que falte en adb |
void | waitForDeviceOnline () Se bloquea hasta que el dispositivo sea visible a través de adb. |
void | waitForDeviceOnline (long waitTime) Se 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 de adb shell. |
Métodos protegidos | |
---|---|
void | addExtraConnectionBuilderArgs ( DefaultConnection.ConnectionBuilder builder) |
String[] | buildAdbShellCommand (String command, boolean forceExitStatusDetection) Crea el comando del sistema operativo para la sesión de comando de adb shell y los argumentos dados. |
void | checkApiLevelAgainst (String feature, int strictMinLevel) |
NativeDevice.RebootDeviceAction | createRebootDeviceAction ( NativeDevice.RebootMode rebootMode, String reason) Cree una |
IRunUtil | createRunUtil () |
void | doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason) Realice un reinicio de adb. |
void | ensureRuntimePermissionSupported () método auxiliar para lanzar una excepción si el permiso de tiempo de ejecución no es compatible |
int | getApiLevelSafe () |
ITestLogger | getLogger () |
IRunUtil | getRunUtil () Obtenga la instancia |
void | initializeConnection ( IBuildInfo info, MultiMap <String, String> attributes) |
String | internalGetProperty (String propName, String fastbootVar, String description) Obtenga una propiedad del dispositivo, desde la caché ddmlib de forma predeterminada, y recurra a `adb shell getprop` o `fastboot getvar` dependiendo de si el dispositivo está en Fastboot o no. |
boolean | isInRebootCallback () Devuelve si las devoluciones de llamada de reinicio se están ejecutando actualmente o no. |
boolean | isNewer (File localFile, IFileEntry entry) Devuelve |
void | notifyRebootEnded () Notifica a todos |
void | notifyRebootStarted () Notifica a todos |
boolean | performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts) Realiza una acción en este dispositivo. |
void | postAdbReboot () Posibles acciones adicionales que se pueden realizar después de reiniciar. |
void | prePostBootSetup () Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) anule este método para una configuración posterior al arranque específica. |
boolean | pullFileInternal (String remoteFilePath, File localFile) |
void | setClock (Clock clock) Configure la instancia de reloj que se utilizará. |
void | setMicrodroidProcess (Process process) Marca el TestDevice como microdroid y establece su CID. |
void | setTestDeviceOptions ( deviceOptions) setTestDeviceOptions ( deviceOptions) |
CommandResult | simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) Ejecuta un comando fastboot simple con variables de entorno e informa el estado del comando. |
CommandResult | simpleFastbootCommand (long timeout, String[] fullCmd) Ejecuta un comando fastboot simple e informa el estado del comando. |
boolean | waitForDeviceNotAvailable (String operationDesc, long time) Espere a que el dispositivo deje de estar disponible (deje de informar a adb). |
Constantes
ID DE USUARIO INVALIDO
public static final int INVALID_USER_ID
Valor devuelto para cualquier identificación de usuario no válida o no encontrada: 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
el número predeterminado de intentos de reintento de comando para realizar
Valor constante: 2 (0x00000002)
Campos
DEBUGFS_PATH
public static final String DEBUGFS_PATH
TARJETA SD
protected static final String SD_CARD
ALMACENAMIENTO_EMULADO
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 : el mecanismo IDeviceStateMonitor a utilizar |
allocationMonitor | IDeviceMonitor : el IDeviceMonitor para informar de los cambios en el estado de asignación. Puede ser nulo |
Métodos públicos
lotePrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Microoptimización (alrededor de 400 milisegundos) al obtener previamente todos los accesorios que necesitamos en lugar de llamar 'adb getprop' para cada uno. es decir, es tan rápido recuperar todas las propiedades como recuperar una. Cosas como device.getApiLevel(), checkApiLevelAgainstNextRelease y getBuildAlias llaman a `adb getprop` bajo el capó. 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 futuras llamadas. Lo estamos haciendo un poco antes. Si el dispositivo está en recuperación o hay otros errores al buscar los accesorios, simplemente los ignoramos.
puede cambiar a usuario del sistema sin cabeza
public boolean canSwitchToHeadlessSystemUser ()
Devuelve si está permitido cambiar al usuario del SISTEMA sin cabeza.
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Compruebe si una característica es actualmente compatible con un nivel mínimo de compatibilidad. Este método tiene en cuenta funciones inéditas aún, antes de que se eleve el nivel de API.
Parámetros | |
---|---|
strictMinLevel | int : el nivel mínimo estricto posible que admite la función. |
Devoluciones | |
---|---|
boolean | Verdadero si el nivel es compatible. Falso en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
checkConectividad
public boolean checkConnectivity ()
Verifique que el dispositivo tenga conectividad de red.
Devoluciones | |
---|---|
boolean | true si el dispositivo tiene una conexión de red que funciona; false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
clearErrorDiálogos
public boolean clearErrorDialogs ()
Intente descartar cualquier cuadro de diálogo de error que se muestre actualmente en la interfaz de usuario del dispositivo.
Devoluciones | |
---|---|
boolean | true si no había ningún cuadro de diálogo presente o si los cuadros de diálogo se borraron correctamente. false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
borrarÚltimoConectadoRedWifi
public void clearLastConnectedWifiNetwork ()
Borra la última red wifi conectada. Esto debe llamarse al iniciar una nueva invocación para evitar conectarse a la red wifi utilizada en la prueba anterior después de reiniciar el dispositivo.
borrarLogcat
public void clearLogcat ()
Elimina cualquier dato de logcat acumulado.
Esto es útil para los casos en los que desea asegurarse de queITestDevice#getLogcat()
solo devuelva datos de registro producidos después de un cierto punto (como después de actualizar la compilación de un nuevo dispositivo, etc.). conectarse a la red wifi
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Se conecta a una red wifi.
Enciende wifi y bloquea hasta que se establece una conexión exitosa con una de las redes wifi que figuran en el mapa wifiSsidToPsk. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi()
o ITestDevice#clearLastConnectedWifiNetwork()
.
Parámetros | |
---|---|
wifiSsidToPsk | |
scanSsid | boolean : si se deben buscar SSID ocultos para esta red. |
Devoluciones | |
---|---|
boolean | true si se conecta correctamente a la red wifi. false en caso contrario |
Lanza | |
---|---|
DeviceNotAvailableException |
conectarse a la red wifi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Se conecta a una red wifi.
Enciende wifi y bloquea hasta que se realiza una conexión exitosa a la red wifi especificada. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se llame aITestDevice#disconnectFromWifi()
o ITestDevice#clearLastConnectedWifiNetwork()
.Parámetros | |
---|---|
wifiSsid | String : el ssid wifi al que conectarse |
wifiPsk | String : frase de contraseña PSK o nula si no está cifrada |
Devoluciones | |
---|---|
boolean | true si se conecta correctamente a la red wifi. false en caso contrario |
Lanza | |
---|---|
DeviceNotAvailableException |
conectarse a la red wifi
public boolean connectToWifiNetwork (wifiSsidToPsk)
Se conecta a una red wifi.
Enciende wifi y bloquea hasta que se establece una conexión exitosa con una de las redes wifi que figuran en el mapa wifiSsidToPsk. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se llame a ITestDevice#disconnectFromWifi()
o ITestDevice#clearLastConnectedWifiNetwork()
Parámetros | |
---|---|
wifiSsidToPsk |
Devoluciones | |
---|---|
boolean | true si se conecta correctamente a la red wifi. false en caso contrario |
Lanza | |
---|---|
DeviceNotAvailableException |
conectarse a la red wifi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Se conecta a una red wifi.
Enciende wifi y bloquea hasta que se realiza una conexión exitosa a la red wifi especificada. Una vez que se establece una conexión, la instancia intentará restaurar la conexión después de cada reinicio hasta que se llame aITestDevice#disconnectFromWifi()
o ITestDevice#clearLastConnectedWifiNetwork()
.Parámetros | |
---|---|
wifiSsid | String : el ssid wifi al que conectarse |
wifiPsk | String : frase de contraseña PSK o nula si no está cifrada |
scanSsid | boolean : si se debe buscar SSID oculto para esta red. |
Devoluciones | |
---|---|
boolean | true si se conecta correctamente a la red wifi. false en caso contrario |
Lanza | |
---|---|
DeviceNotAvailableException |
conectarse a la red Wifi si es necesario
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Una variante de connectToWifiNetwork(String, String)
que solo se conecta si el dispositivo actualmente no tiene conectividad de red.
Parámetros | |
---|---|
scanSsid | boolean : si se debe buscar SSID oculto para esta red |
Devoluciones | |
---|---|
boolean | true si se conecta correctamente a la red wifi. false en caso contrario |
Lanza | |
---|---|
DeviceNotAvailableException |
conectarse a la red Wifi si es necesario
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Una variante de connectToWifiNetwork(String, String)
que solo se conecta si el dispositivo actualmente no tiene conectividad de red.
Devoluciones | |
---|---|
boolean | true si se conecta correctamente a la red wifi. false en caso contrario |
Lanza | |
---|---|
DeviceNotAvailableException |
crear usuario
public int createUser (String name, boolean guest, boolean ephemeral)
Cree un usuario con un nombre de pila y las banderas proporcionadas
Parámetros | |
---|---|
name | String : del usuario a crear en el dispositivo |
guest | boolean : habilita la bandera de usuario --guest durante la creación |
ephemeral | boolean : habilita la bandera de usuario --efímera durante la creación |
Devoluciones | |
---|---|
int | ID del usuario creado. |
Lanza | |
---|---|
DeviceNotAvailableException |
crear usuario
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Cree un usuario con un nombre de pila y las banderas proporcionadas
Parámetros | |
---|---|
name | String : del usuario a crear en el dispositivo |
guest | boolean : habilita la bandera de usuario --guest durante la creación |
ephemeral | boolean : habilita la bandera de usuario --efímera durante la creación |
forTesting | boolean : habilita el indicador de prueba --for-testing durante la creación |
Devoluciones | |
---|---|
int | ID del usuario creado. |
Lanza | |
---|---|
DeviceNotAvailableException |
crear usuario
public int createUser (String name)
Cree un usuario con un nombre de pila y banderas predeterminadas 0.
Parámetros | |
---|---|
name | String : del usuario a crear en el dispositivo |
Devoluciones | |
---|---|
int | el número entero para la identificación de usuario creada |
Lanza | |
---|---|
DeviceNotAvailableException |
crearUsuarioNoThrow
public int createUserNoThrow (String name)
Cree un usuario con un nombre de pila y banderas predeterminadas 0.
Parámetros | |
---|---|
name | String : del usuario a crear en el dispositivo |
Devoluciones | |
---|---|
int | el número entero para la identificación de usuario creada o -1 para el error. |
Lanza | |
---|---|
DeviceNotAvailableException |
borrar archivo
public void deleteFile (String deviceFilePath)
Método auxiliar para eliminar un archivo o directorio en el dispositivo.
Parámetros | |
---|---|
deviceFilePath | String : la ruta absoluta del archivo en el dispositivo. |
Lanza | |
---|---|
DeviceNotAvailableException |
cancelar el registroDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Elimina el IDeviceActionReceiver
registrado.
Parámetros | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : un IDeviceActionReceiver que se eliminará. |
dispositivoSoftRestarted
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Método auxiliar para verificar si el dispositivo se reinició suavemente comparando el system_server actual con el system_server ProcessInfo
anterior. Utilice getProcessByName(String)
para obtener ProcessInfo
.
Parámetros | |
---|---|
prevSystemServerProcess | ProcessInfo : el proceso anterior system_server ProcessInfo . |
Devoluciones | |
---|---|
boolean | true si el dispositivo se reinicia suavemente |
Lanza | |
---|---|
DeviceNotAvailableException |
dispositivoSoftRestartedDesde
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Método auxiliar para verificar si el dispositivo se reinició suavemente desde la hora UTC desde la época del dispositivo y su ERROR(/TimeUnit)
. El reinicio suave se refiere al servidor_sistema reiniciado fuera de un reinicio completo del dispositivo (por ejemplo: reinicio solicitado). El dispositivo actual utcEpochTime en Milliseccond se puede obtener mediante el método getDeviceDate()
.
Parámetros | |
---|---|
utcEpochTime | long : el tiempo del dispositivo en segundos desde la época. |
timeUnit | TimeUnit : la unidad de tiempo TimeUnit para el utcEpochTime dado. |
Devoluciones | |
---|---|
boolean | true si el dispositivo se reinicia suavemente |
Lanza | |
---|---|
DeviceNotAvailableException |
desactivarAdbRoot
public boolean disableAdbRoot ()
Desactiva la raíz de adb.
Deshabilitar adb root puede hacer que el dispositivo se desconecte de adb. Este método se bloqueará hasta que el dispositivo esté disponible.Devoluciones | |
---|---|
boolean | true si tiene éxito. |
Lanza | |
---|---|
DeviceNotAvailableException |
desactivar Keyguard
public void disableKeyguard ()
Intenta desactivar el bloqueo de teclas.
Primero espere a que el envío de entrada esté listo; esto sucede aproximadamente al mismo tiempo que el dispositivo informa BOOT_COMPLETE, aparentemente de forma asincrónica, porque la implementación actual del marco tiene condiciones de carrera ocasionales. Luego se envía el comando para descartar el bloqueo de teclas (sólo funciona en los no seguros)
Lanza | |
---|---|
DeviceNotAvailableException |
desactivarNetworkMonitor
public boolean disableNetworkMonitor ()
Desactiva el monitoreo de red en el dispositivo.
Devoluciones | |
---|---|
boolean | true si la supervisión se deshabilita correctamente. false si falla. |
Lanza | |
---|---|
DeviceNotAvailableException |
desconectarse de Wifi
public boolean disconnectFromWifi ()
Se desconecta de una red wifi.
Elimina todas las redes de la lista de redes conocidas y desactiva el wifi.Devoluciones | |
---|---|
boolean | true si se desconecta correctamente de la red wifi. false si falla la desconexión. |
Lanza | |
---|---|
DeviceNotAvailableException |
¿Existe el archivo?
public boolean doesFileExist (String deviceFilePath, int userId)
Método auxiliar para determinar si existe un archivo en el dispositivo para un usuario determinado.
Parámetros | |
---|---|
deviceFilePath | String : la ruta absoluta del archivo en el dispositivo para verificar |
userId | int : la identificación de usuario con la que verificar la existencia del archivo. |
Devoluciones | |
---|---|
boolean | true si el archivo existe; false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
¿Existe el archivo?
public boolean doesFileExist (String deviceFilePath)
Método auxiliar para determinar si existe un archivo en el dispositivo.
Parámetros | |
---|---|
deviceFilePath | String : la ruta absoluta del archivo en el dispositivo para verificar |
Devoluciones | |
---|---|
boolean | true si el archivo existe; false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
montón de volcado
public File dumpHeap (String process, String devicePath)
Intente volcar el montón del system_server. Es responsabilidad de la persona que llama limpiar el archivo volcado.
Parámetros | |
---|---|
process | String : el nombre del proceso del dispositivo en el que se realizará el volcado. |
devicePath | String : la ruta en el dispositivo donde colocar el volcado. Debe ser una ubicación donde los permisos lo permitan. |
Devoluciones | |
---|---|
File | el ERROR(/File) que contiene el informe. Nulo si algo falló. |
Lanza | |
---|---|
DeviceNotAvailableException |
habilitarAdbRoot
public boolean enableAdbRoot ()
Activa la raíz de adb. Si la configuración "enable-root" es "false", registrará un mensaje y regresará sin habilitar root.
Habilitar adb root puede hacer que el dispositivo se desconecte de adb. Este método se bloqueará hasta que el dispositivo esté disponible.Devoluciones | |
---|---|
boolean | true si tiene éxito. |
Lanza | |
---|---|
DeviceNotAvailableException |
habilitarNetworkMonitor
public boolean enableNetworkMonitor ()
Habilita el monitoreo de red en el dispositivo.
Devoluciones | |
---|---|
boolean | true si la supervisión se habilita correctamente. false si falla. |
Lanza | |
---|---|
DeviceNotAvailableException |
ejecutarAdbCommand
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 específico.
En lugar de ello, se debe utilizar executeShellCommand(String)
siempre que sea posible, ya que ese método proporciona una mejor detección de fallas y rendimiento.
Parámetros | |
---|---|
timeout | long : el tiempo en milisegundos antes de que se considere que el dispositivo no responde, 0L sin tiempo de espera |
cmdArgs | String : el comando adb y los argumentos para ejecutar |
Devoluciones | |
---|---|
String | la salida estándar del comando. null si el comando no se pudo ejecutar. |
Lanza | |
---|---|
DeviceNotAvailableException |
ejecutarAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
Método auxiliar que ejecuta un comando adb como un comando del sistema con un tiempo de espera específico.
En lugar de ello, se debe utilizar executeShellCommand(String)
siempre que sea posible, ya que ese método proporciona una mejor detección de fallas y rendimiento.
Parámetros | |
---|---|
timeout | long : el tiempo en milisegundos antes de que se considere que el dispositivo no responde, 0L sin tiempo de espera |
envMap | |
cmdArgs | String : el comando adb y los argumentos para ejecutar |
Devoluciones | |
---|---|
String | la salida estándar del comando. null si el comando no se pudo ejecutar. |
Lanza | |
---|---|
DeviceNotAvailableException |
ejecutarAdbCommand
public String executeAdbCommand (String... cmdArgs)
Método auxiliar que ejecuta un comando adb como comando del sistema.
En lugar de ello, se debe utilizarexecuteShellCommand(String)
siempre que sea posible, ya que ese método proporciona una mejor detección de fallas y rendimiento.Parámetros | |
---|---|
cmdArgs | String : el comando adb y los argumentos para ejecutar |
Devoluciones | |
---|---|
String | la salida estándar del comando. null si el comando no se pudo ejecutar. |
Lanza | |
---|---|
DeviceNotAvailableException |
ejecutar FastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
Método auxiliar que ejecuta un comando fastboot como comando del sistema con un tiempo de espera predeterminado de 2 minutos.
Se espera que se utilice cuando el dispositivo ya esté en modo fastboot.
Parámetros | |
---|---|
cmdArgs | String : el comando fastboot y los argumentos para ejecutar |
Devoluciones | |
---|---|
CommandResult | el CommandResult que contiene la salida del comando |
Lanza | |
---|---|
DeviceNotAvailableException |
ejecutar FastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Método auxiliar que ejecuta un comando fastboot como comando del sistema.
Se espera que se utilice cuando el dispositivo ya esté en modo fastboot.Parámetros | |
---|---|
timeout | long : el tiempo en milisegundos antes de que expire el comando |
cmdArgs | String : el comando fastboot y los argumentos para ejecutar |
Devoluciones | |
---|---|
CommandResult | el CommandResult que contiene la salida del comando |
Lanza | |
---|---|
DeviceNotAvailableException |
ejecutar LongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Método auxiliar que ejecuta un comando fastboot de larga duración como comando del sistema.
Idéntico aexecuteFastbootCommand(String)
excepto que utiliza un tiempo de espera más largo.Parámetros | |
---|---|
cmdArgs | String : el comando fastboot y los argumentos para ejecutar |
Devoluciones | |
---|---|
CommandResult | el CommandResult que contiene la salida del comando |
Lanza | |
---|---|
DeviceNotAvailableException |
ejecutar LongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
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 | |
cmdArgs | String : el comando y argumentos fastboot para ejecutar |
Devoluciones | |
---|---|
CommandResult | El comandante que contiene la salida del comando |
Lanza | |
---|---|
DeviceNotAvailableException |
EXECHESHELLCOMMAND
public String executeShellCommand (String command)
Método auxiliar que ejecuta un comando ADB Shell y devuelve la salida como una String
.
Parámetros | |
---|---|
command | String : el comando de shell adb para ejecutar |
Devoluciones | |
---|---|
String | la salida de shell |
Lanza | |
---|---|
DeviceNotAvailableException |
EXECHESHELLCOMMAND
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 : el comando de shell adb para ejecutar |
receiver | IShellOutputReceiver : el IShellOutputReceiver para dirigir la salida de shell a. |
maxTimeToOutputShellResponse | long : la cantidad máxima de tiempo durante el cual se permite que el comando no genere ninguna respuesta; Unidad como se especifica en timeUnit |
timeUnit | TimeUnit : Unidad para maxTimeToOutputShellResponse |
retryAttempts | int : El número máximo de veces para volver al comando si falla debido a una excepción. DevicenotresponsiveException se arrojará si retryAttempts se realizan sin éxito. |
Lanza | |
---|---|
DeviceNotAvailableException |
EXECHESHELLCOMMAND
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 : el comando de shell adb para ejecutar |
receiver | IShellOutputReceiver : el IShellOutputReceiver para dirigir la salida de shell a. |
maxTimeoutForCommand | long : el tiempo de espera máximo para que el comando complete; Unidad como se especifica en timeUnit |
maxTimeToOutputShellResponse | long : la cantidad máxima de tiempo durante el cual se permite que el comando no genere ninguna respuesta; Unidad como se especifica en timeUnit |
timeUnit | TimeUnit : Unidad para maxTimeToOutputShellResponse |
retryAttempts | int : El número máximo de veces para volver al comando si falla debido a una excepción. DevicenotresponsiveException se arrojará si retryAttempts se realizan sin éxito. |
Lanza | |
---|---|
DeviceNotAvailableException |
EXECHESHELLCOMMAND
public void executeShellCommand (String command, IShellOutputReceiver receiver)
Ejecuta el comando dado adb shell, vuelve a intentar varias veces si el comando falla.
Una forma más simple deexecuteShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
con valores predeterminados.Parámetros | |
---|---|
command | String : el comando de shell adb para ejecutar |
receiver | IShellOutputReceiver : el IShellOutputReceiver para dirigir la salida de shell a. |
Lanza | |
---|---|
DeviceNotAvailableException |
EXECTHELLV2COMMAND
public CommandResult executeShellV2Command (String cmd)
Método auxiliar que ejecuta un comando ADB Shell y devuelve los resultados como un CommandResult
se pobló correctamente con la salida de estado del comando, STDOUT y STDERR.
Parámetros | |
---|---|
cmd | String : el comando que debe ejecutarse. |
Devoluciones | |
---|---|
CommandResult | El resultado en CommandResult . |
Lanza | |
---|---|
DeviceNotAvailableException |
EXECTHELLV2COMMAND
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Método auxiliar que ejecuta un comando ADB Shell y devuelve los resultados como un CommandResult
se pobló correctamente con la salida de estado del comando y Stderr. Stdout está dirigido a la corriente especificada.
Parámetros | |
---|---|
cmd | String : el comando que debe ejecutarse. |
pipeToOutput | OutputStream : ERROR(/OutputStream) donde se redirigirá la salida STD o nula. |
Devoluciones | |
---|---|
CommandResult | El resultado en CommandResult . |
Lanza | |
---|---|
DeviceNotAvailableException |
EXECTHELLV2COMMAND
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Método auxiliar que ejecuta un comando ADB Shell y devuelve los resultados como un CommandResult
se pobló correctamente con la salida de estado del comando, STDOUT y STDERR.
Parámetros | |
---|---|
cmd | String : el comando que debe ejecutarse. |
pipeAsInput | File : un ERROR(/File) que se canalizará como entrada al comando o nulo. |
Devoluciones | |
---|---|
CommandResult | El resultado en CommandResult . |
Lanza | |
---|---|
DeviceNotAvailableException |
EXECTHELLV2COMMAND
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 : el comando de shell adb para ejecutar |
maxTimeoutForCommand | long : el tiempo de espera máximo para que el comando complete; Unidad como se especifica en timeUnit |
timeUnit | TimeUnit : Unidad para maxTimeToOutputShellResponse |
retryAttempts | int : El número máximo de veces para volver al comando si falla debido a una excepción. DevicenotresponsiveException se arrojará si retryAttempts se realizan sin éxito. |
Devoluciones | |
---|---|
CommandResult |
Lanza | |
---|---|
DeviceNotAvailableException |
EXECTHELLV2COMMAND
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 : el comando de shell adb para ejecutar |
maxTimeoutForCommand | long : el tiempo de espera máximo para que el comando complete; Unidad como se especifica en timeUnit |
timeUnit | TimeUnit : Unidad para maxTimeToOutputShellResponse |
Devoluciones | |
---|---|
CommandResult |
Lanza | |
---|---|
DeviceNotAvailableException |
EXECTHELLV2COMMAND
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 : el comando de shell adb para ejecutar |
pipeAsInput | File : un ERROR(/File) que se canalizará como entrada al comando o nulo. |
pipeToOutput | OutputStream : ERROR(/OutputStream) donde se redirigirá la salida STD o nula. |
maxTimeoutForCommand | long : el tiempo de espera máximo para que el comando complete; Unidad como se especifica en timeUnit |
timeUnit | TimeUnit : Unidad para maxTimeToOutputShellResponse |
retryAttempts | int : El número máximo de veces para volver al comando si falla debido a una excepción. DevicenotresponsiveException se arrojará si retryAttempts se realizan sin éxito. |
Devoluciones | |
---|---|
CommandResult |
Lanza | |
---|---|
DeviceNotAvailableException |
EXECTHELLV2COMMAND
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 : el comando de shell adb para ejecutar |
pipeAsInput | File : un ERROR(/File) que se canalizará como entrada al comando o nulo. |
pipeToOutput | OutputStream : ERROR(/OutputStream) donde se redirigirá la salida STD o nula. |
pipeToError | OutputStream : ERROR(/OutputStream) donde se redirigirá el error STD o nulo. |
maxTimeoutForCommand | long : el tiempo de espera máximo para que el comando complete; Unidad como se especifica en timeUnit |
timeUnit | TimeUnit : Unidad para maxTimeToOutputShellResponse |
retryAttempts | int : El número máximo de veces para volver al comando si falla debido a una excepción. DevicenotresponsiveException se arrojará si retryAttempts se realizan sin éxito. |
Devoluciones | |
---|---|
CommandResult |
Lanza | |
---|---|
DeviceNotAvailableException |
FastBootWipePartition
public CommandResult fastbootWipePartition (String partition)
Método auxiliar que limpia una partición para el dispositivo.
SigetUseFastbootErase()
es true
, entonces FastBoot Eraase se usará para borrar la partición. El dispositivo debe crear un sistema de archivos la próxima vez que se inicie el dispositivo. De lo contrario, se utiliza el formato FastBoot que creará un nuevo sistema de archivos en el dispositivo. Se espera que se use cuando el dispositivo ya está en modo FastBoot.Parámetros | |
---|---|
partition | String : la partición para borrar |
Devoluciones | |
---|---|
CommandResult | El comandante que contiene la salida del comando |
Lanza | |
---|---|
DeviceNotAvailableException |
getActiveApexes
publicgetActiveApexes ()
Obtenga la información sobre los ápices activados en el dispositivo.
Devoluciones | |
---|---|
ERROR(/Set) de ApexInfo actualmente activado en el dispositivo |
Lanza | |
---|---|
DeviceNotAvailableException |
getallsettings
publicgetAllSettings (String namespace)
Devuelve los pares de valor clave del espacio de nombres solicitado.
Parámetros | |
---|---|
namespace | String : debe ser uno de {"sistema", "seguro", "global"} |
Devoluciones | |
---|---|
El mapa de pares de valor clave. Nulo si el espacio de nombres no es compatible. |
Lanza | |
---|---|
DeviceNotAvailableException |
GetAllocationState
public DeviceAllocationState getAllocationState ()
Devolver el estado de asignación actual del dispositivo
Devoluciones | |
---|---|
DeviceAllocationState |
getandroidid
public String getAndroidId (int userId)
Encuentre y devuelva el ID de Android asociado a un ID de usuario, nulo si no se encuentra.
Parámetros | |
---|---|
userId | int |
Devoluciones | |
---|---|
String |
Lanza | |
---|---|
DeviceNotAvailableException |
getAdroidids
publicgetAndroidIds ()
Cree un mapa de ID de Android encontrados ID de usuario coincidentes. No hay seguro que cada ID de usuario encontre una ID de Android asociada en esta función, por lo que algunas ID de usuario pueden coincidir con NULL.
Devoluciones | |
---|---|
Mapa de ID de Android encontrados ID de usuario coincidentes. |
Lanza | |
---|---|
DeviceNotAvailableException |
getapilevel
public int getApiLevel ()
Obtenga el nivel de API del dispositivo. El valor predeterminado a UNKNOWN_API_LEVEL
.
Devoluciones | |
---|---|
int | un entero que indica el nivel API del dispositivo |
Lanza | |
---|---|
DeviceNotAvailableException |
getApppackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Obtenga información sobre un paquete instalado en el dispositivo.
Parámetros | |
---|---|
packageName | String |
Devoluciones | |
---|---|
PackageInfo | el PackageInfo o null si no se pudiera recuperar la información |
Lanza | |
---|---|
DeviceNotAvailableException |
getApppackageInfos
publicgetAppPackageInfos ()
Obtenga información de los paquetes instalados en el dispositivo.
Devoluciones | |
---|---|
ERROR(/List) de PackageInfo instalados en el dispositivo. |
Lanza | |
---|---|
DeviceNotAvailableException |
getBaseBandversion
public String getBasebandVersion ()
Método de conveniencia para obtener la versión de banda base (radio) de este dispositivo. Obtener la versión de radio es específica del dispositivo, por lo que es posible que no devuelva la información correcta para todos los dispositivos. Este método se basa en la propiedad de la base de gsm.version.base para devolver la información de la versión correcta. Esto no es exacto para algunos dispositivos CDMA y la versión devuelta aquí podría no coincidir con la versión informada desde FastBoot y podría no devolver la versión para la radio CDMA. TL; DR Este método solo informa una versión precisa si la propiedad GSM.version.BaseBand es la misma que la versión devuelta por fastboot getvar version-baseband
.
Devoluciones | |
---|---|
String | La versión de banda base String o null si no se puede determinar (el dispositivo no tiene radio o cadena de versión no se puede leer) |
Lanza | |
---|---|
DeviceNotAvailableException |
GetBattery
public Integer getBattery ()
Devuelve el nivel actual de la batería de un dispositivo o nulo si el nivel de la batería no está disponible.
Devoluciones | |
---|---|
Integer |
GetBooleanProperty
public boolean getBooleanProperty (String name, boolean defaultValue)
Devuelve el valor booleano de la propiedad dada.
Parámetros | |
---|---|
name | String : el nombre de la propiedad |
defaultValue | boolean : valor predeterminado para devolver si la propiedad está vacía o no existe. |
Devoluciones | |
---|---|
boolean | true si la propiedad tiene valor "1" , "y" , "yes" , "on" o "true" , false si la propiedad tiene valor de "0" , "n" , "no" , "off" , " "false" , o defaultValue de lo contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
GetBoothistory
publicgetBootHistory ()
El método Helper recopila el mapa del historial de arranque con tiempo de arranque y razón de arranque.
Devoluciones | |
---|---|
Mapa del tiempo de arranque (tiempo de UTC en segundo lugar desde la época) y la razón del arranque |
Lanza | |
---|---|
DeviceNotAvailableException |
GetBoothistorysince
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
El método Helper recopila el mapa del historial de arranque con tiempo de arranque y razón de arranque desde el tiempo dado desde la época desde el dispositivo y la unidad de tiempo especificada. El dispositivo actual UtCepochtime en milisegundo se puede obtener mediante el método getDeviceDate()
.
Parámetros | |
---|---|
utcEpochTime | long : el tiempo del dispositivo desde la época. |
timeUnit | TimeUnit : la unidad de tiempo TimeUnit . |
Devoluciones | |
---|---|
Mapa del tiempo de arranque (tiempo de UTC en segundo lugar desde la época) y la razón del arranque |
Lanza | |
---|---|
DeviceNotAvailableException |
getBootloaderversion
public String getBootloaderVersion ()
Método de conveniencia para obtener la versión del cargador de arranque de este dispositivo.
Intentará recuperar la versión del cargador de arranque del estado actual del dispositivo. (es decir, si el dispositivo está en modo FastBoot, intentará recuperar la versión de FastBoot)Devoluciones | |
---|---|
String | la versión String bootloader o null si no se puede encontrar |
Lanza | |
---|---|
DeviceNotAvailableException |
getBuGreport
public InputStreamSource getBugreport ()
Recupera un bugreport del dispositivo.
Se garantiza que la implementación de esto continúa funcionando en un dispositivo sin una tarjeta SD (o donde la tarjeta SD aún no está montada).
Devoluciones | |
---|---|
InputStreamSource | Un InputStreamSource que producirá el contenido de Bugreport a pedido. En el caso de la falla, InputStreamSource producirá un ERROR(/InputStream) . |
getBuGreportz
public InputStreamSource getBugreportz ()
Recupera un bufreportz del dispositivo. El formato ZIP BuGreport contiene el principal bugreport y otros archivos de registro que son útiles para la depuración.
Solo admitido para 'Versión ADB'> 1.0.36
Devoluciones | |
---|---|
InputStreamSource | Un InputStreamSource del archivo ZIP que contiene el Bugreportz, return NULL en caso de falla. |
GetBuildalias
public String getBuildAlias ()
Recupere 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 la ID de compilación (generalmente un número para las compilaciones de Nexus). Por ejemplo, la versión final de Android 4.2 tiene alias Build JDQ39 e ID de compilación 573038
Devoluciones | |
---|---|
String | el alias de construcción o volver a la identificación de construcción si no se pudiera recuperar |
Lanza | |
---|---|
DeviceNotAvailableException |
GetBuildFlear
public String getBuildFlavor ()
Recupere el sabor de compilación para el dispositivo.
Devoluciones | |
---|---|
String | el sabor de construcción o nulo si no se pudiera recuperar |
Lanza | |
---|---|
DeviceNotAvailableException |
GetBuildid
public String getBuildId ()
Recupere la compilación que el dispositivo se está ejecutando actualmente.
Devoluciones | |
---|---|
String | la identificación de compilación o IBuildInfo#UNKNOWN_BUILD_ID si no se pudiera recuperar |
Lanza | |
---|---|
DeviceNotAvailableException |
GetBuildSigningKeys
public String getBuildSigningKeys ()
Devuelve el tipo de tecla utilizado para firmar la imagen del dispositivo
Por lo general, los dispositivos de Android se pueden firmar con teclas de prueba (como en AOSP) o llaves de liberación (controlados por fabricantes de dispositivos individuales)
Devoluciones | |
---|---|
String | La clave de firma si se encuentra, nula de lo contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
getCachedDeviceScriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Devuelve un DeviceDescriptor
en caché si se asigna el dispositivo, de lo contrario devuelve el DeviceDescriptor
actual.
Devoluciones | |
---|---|
DeviceDescriptor |
getCachedDeviceScriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Devuelve un DeviceDescriptor
en caché si se asigna el dispositivo, de lo contrario devuelve el DeviceDescriptor
actual.
Parámetros | |
---|---|
shortDescriptor | boolean : si limitar o no el descriptor a la información mínima |
Devoluciones | |
---|---|
DeviceDescriptor |
obtener niños
public String[] getChildren (String path)
Alternativa al uso IFileEntry
que a veces no funcionará debido a los permisos.
Parámetros | |
---|---|
path | String : ¿está la ruta en el dispositivo donde hacer la búsqueda? |
Devoluciones | |
---|---|
String[] | Matriz de cadena que contiene todo el archivo en una ruta en el dispositivo. |
Lanza | |
---|---|
DeviceNotAvailableException |
obtener conexión
public AbstractConnection getConnection ()
La conexión actual asociada con el dispositivo.
Devoluciones | |
---|---|
AbstractConnection |
GetCurrentFoldeableSestate
public DeviceFoldableState getCurrentFoldableState ()
Devuelve el estado plegable actual del dispositivo o nulo si ocurrieron algunos problemas.
Devoluciones | |
---|---|
DeviceFoldableState |
Lanza | |
---|---|
DeviceNotAvailableException |
getCurrentuser
public int getCurrentUser ()
Devuelva la ID del usuario en ejecución actual. En caso de error, return -10000.
Devoluciones | |
---|---|
int |
Lanza | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
Obtenga la clase del dispositivo.
Devoluciones | |
---|---|
String | La clase de dispositivo String . |
GetDevictado
public long getDeviceDate ()
Devuelva la fecha del dispositivo en milisegundo desde la época.
Devoluciones | |
---|---|
long | La fecha del dispositivo en formato de época. |
Lanza | |
---|---|
DeviceNotAvailableException |
GetDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
Devuelva un DeviceDescriptor
de la información del dispositivo para obtener información al respecto sin pasar el objeto de dispositivo real.
Devoluciones | |
---|---|
DeviceDescriptor |
GetDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Devuelva un DeviceDescriptor
de la información del dispositivo para obtener información al respecto sin pasar el objeto de dispositivo real.
Parámetros | |
---|---|
shortDescriptor | boolean : si limitar o no el descriptor a la información mínima |
Devoluciones | |
---|---|
DeviceDescriptor |
getDevicestate
public TestDeviceState getDeviceState ()
Obtenga el estado del dispositivo.
Devoluciones | |
---|---|
TestDeviceState |
getDevicetimeOffset
public long getDeviceTimeOffset (Date date)
Ayudante para obtener la diferencia de tiempo entre el dispositivo y un ERROR(/Date)
. Use el tiempo de época internamente.
Parámetros | |
---|---|
date | Date |
Devoluciones | |
---|---|
long | la diferencia en milisegundos |
Lanza | |
---|---|
DeviceNotAvailableException |
getemulatorOutput
public InputStreamSource getEmulatorOutput ()
Obtenga la corriente de emulador stdout y stderr
Devoluciones | |
---|---|
InputStreamSource | salida del emulador |
GetEmulatorProcess
public Process getEmulatorProcess ()
Devuelva el Process
correspondiente a este emulador.
Devoluciones | |
---|---|
Process | el Process o null |
getExecuteshellCommandlog
public final File getExecuteShellCommandLog ()
El registro que contiene todos los registros executeShellCommand(String)
.
Devoluciones | |
---|---|
File |
getExternalStoreFreespace
public long getExternalStoreFreeSpace ()
Método auxiliar para determinar la cantidad de espacio libre en el almacenamiento externo del dispositivo.
Devoluciones | |
---|---|
long | la cantidad de espacio libre en KB |
Lanza | |
---|---|
DeviceNotAvailableException |
Getfastbootpath
public String getFastbootPath ()
Devuelve el camino del fastboot binario que se está utilizando. Todavía requiere que isFastbootEnabled()
sea verdadero, para tener funciones de FastBoot habilitadas.
Devoluciones | |
---|---|
String |
GetFastbootProductType
public String getFastbootProductType ()
Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo FastBoot.
Este método solo debe usarse si el dispositivo debe estar en FastBoot. Es una variante un poco más segura que el método genéricogetProductType()
en este caso, porque ItestDevice sabrá recuperar el dispositivo en FastBoot si el dispositivo está en estado incorrecto o no responde.Devoluciones | |
---|---|
String | el nombre del tipo de producto String o null si no se puede determinar |
Lanza | |
---|---|
DeviceNotAvailableException |
GetFastbootProductVariant
public String getFastbootProductVariant ()
Método de conveniencia para obtener el tipo de producto de este dispositivo cuando está en modo FastBoot.
Este método solo debe usarse si el dispositivo debe estar en FastBoot. Es una variante un poco más segura que el método genéricogetProductType()
en este caso, porque ItestDevice sabrá recuperar el dispositivo en FastBoot si el dispositivo está en estado incorrecto o no responde.Devoluciones | |
---|---|
String | el nombre del tipo de producto String o null si no se puede determinar |
Lanza | |
---|---|
DeviceNotAvailableException |
GetFastbootserialNumber
public String getFastbootSerialNumber ()
Devuelve el número de serie del modo FastBoot.
Devoluciones | |
---|---|
String |
GetFastBootVariable
public String getFastbootVariable (String variableName)
Recupere el valor variable FastBoot dado del dispositivo.
Parámetros | |
---|---|
variableName | String : el nombre de la variable |
Devoluciones | |
---|---|
String | el valor de la propiedad o null si no existe |
Lanza | |
---|---|
DeviceNotAvailableException |
GetFastbootversion
public String getFastbootVersion ()
Devuelve la cadena de versión del fastboot binario que se está utilizando. O nulo si algo sale mal.
Devoluciones | |
---|---|
String |
getFileEntry
public IFileEntry getFileEntry (String path)
Recupere una referencia a un archivo remoto en el dispositivo.
Parámetros | |
---|---|
path | String : la ruta del archivo para recuperar. Puede ser una ruta o ruta absoluta en relación con '/'. (es decir, se admite la sintaxis "/sistema" y "sistema") |
Devoluciones | |
---|---|
IFileEntry | el IFileEntry o null si no se puede encontrar el archivo en path dada |
Lanza | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Ayudante no oficial para obtener un FileEntry
de una ruta no raíz. FixMe: Refactor del sistema FileEntry para que esté disponible desde cualquier ruta. (incluso no raíz).
Parámetros | |
---|---|
entry | FileListingService.FileEntry : un FileEntry no necesariamente root como lo requiere DDMLIB. |
Devoluciones | |
---|---|
IFileEntry | Un FileEntryWrapper que representa el FileEntry. |
Lanza | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
GetFoldeBlestates
publicgetFoldableStates ()
Devuelve la lista de estados plegables en el dispositivo. Se puede obtener con "CMD Device_State Print-State".
Devoluciones | |
---|---|
Lanza | |
---|---|
DeviceNotAvailableException |
GetEdevice
public IDevice getIDevice ()
Devuelve una referencia al IDevice
DDMLIB asociado.
IDevice
cada vez que el dispositivo se desconecta y se vuelve a conectar de ADB. Por lo tanto, las personas que llaman no deben mantener una referencia al IDevice
, porque esa referencia puede volverse obsoleta.Devoluciones | |
---|---|
IDevice | el IDevice |
GetInstalledPackagenames
publicgetInstalledPackageNames ()
Obtenga los nombres de los paquetes de aplicación presentes en el dispositivo.
Devoluciones | |
---|---|
ERROR(/Set) de los nombres de los paquetes String actualmente instalados en el dispositivo. |
Lanza | |
---|---|
DeviceNotAvailableException |
GetintProperty
public long getIntProperty (String name, long defaultValue)
Devuelve el valor entero de la propiedad dada del dispositivo.
Parámetros | |
---|---|
name | String : el nombre de la propiedad |
defaultValue | long : valor predeterminado para devolver si la propiedad está vacía o no existe. |
Devoluciones | |
---|---|
long | El valor de la propiedad o defaultValue si la propiedad está vacía, no existe o no tiene un valor entero. |
Lanza | |
---|---|
DeviceNotAvailableException |
getipaddress
public String getIpAddress ()
Obtiene la dirección IP del dispositivo.
Devoluciones | |
---|---|
String | la dirección IP del dispositivo, o null si el dispositivo no tiene una dirección IP |
Lanza | |
---|---|
DeviceNotAvailableException |
GetKeyGuardState
public KeyguardControllerState getKeyguardState ()
Devuelva un objeto para obtener el estado actual del KeyGuard o NULL si no es compatible.
Devoluciones | |
---|---|
KeyguardControllerState | Un KeyguardControllerState que contiene una instantánea del estado del KeyGuard y devuelve NULL si la consulta KeyGuard no es compatible. |
Lanza | |
---|---|
DeviceNotAvailableException |
getLastEspedreBoottimemillis
public long getLastExpectedRebootTimeMillis ()
Devuelve la última vez que TradeFed API provocó un reinicio en milisegundos desde la época como devuelve System.currentTimeMillis()
.
Devoluciones | |
---|---|
long |
getLaunchApileVel
public int getLaunchApiLevel ()
Obtenga el primer nivel API lanzado del dispositivo. El valor predeterminado a UNKNOWN_API_LEVEL
.
Devoluciones | |
---|---|
int | un entero que indica el primer nivel de dispositivo API lanzado |
Lanza | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
Tome un flujo de instantánea de los datos de logCat.
Funciona en dos modos:
TestDeviceOptions.getMaxLogcatDataSize()
bytes del contenido actual de la captura de logcat de fondoDevoluciones | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Toma una secuencia de instantáneas del último maxBytes
de datos de logcat capturados.
Útil para los casos en que desea capturar instantáneas frecuentes de los datos de logcat capturados sin incurrir en la penalización de espacio de disco potencialmente grande de obtener toda la instantánea getLogcat()
.
Parámetros | |
---|---|
maxBytes | int : La cantidad máxima de datos para devolver. Debe ser una cantidad que pueda encajar cómodamente en la memoria |
Devoluciones | |
---|---|
InputStreamSource |
getLogcatdump
public InputStreamSource getLogcatDump ()
Obtenga un volcado del logCat actual para el dispositivo. A diferencia de getLogcat()
, este método siempre devolverá un volcado estático del logCat.
Tiene la desventaja de que no se devolverá nada si el dispositivo no es accesible.
Devoluciones | |
---|---|
InputStreamSource | Un InputStreamSource de los datos de LogCat. Se devuelve una transmisión vacía si no capturan los datos de LogCat. |
GetLogCatsince
public InputStreamSource getLogcatSince (long date)
Tome un flujo de instantánea de datos de LogCat capturados que comienzan la fecha proporcionada. El tiempo en el dispositivo debe usarse getDeviceDate()
.
Parámetros | |
---|---|
date | long : en milisegundo desde el formato de época de cuándo comenzar la instantánea en el presente. (se puede obtener usando 'date +%s') |
Devoluciones | |
---|---|
InputStreamSource |
obtener dirección Mac
public String getMacAddress ()
Devuelve la dirección MAC del dispositivo, NULL si no puede consultar desde el dispositivo.
Devoluciones | |
---|---|
String |
GetMainuserid
public Integer getMainUserId ()
Devuelve la ID de usuario principal.
Devoluciones | |
---|---|
Integer | el ID de usuario del usuario principal si hay uno, y nulo si no hay usuario principal. |
Lanza | |
---|---|
DeviceNotAvailableException |
GetMainLineModuleInfo
publicgetMainlineModuleInfo ()
Obtenga la información sobre los módulos principales instalados en el dispositivo.
Devoluciones | |
---|---|
ERROR(/Set) de los módulos de línea principal String actualmente instalados en el dispositivo. |
Lanza | |
---|---|
DeviceNotAvailableException |
GetMaxNumberOfrunningUssSupported
public int getMaxNumberOfRunningUsersSupported ()
Obtenga el número máximo de usuarios de ejecución simultáneos compatibles. El valor predeterminado es 0.
Devoluciones | |
---|---|
int | un entero que indica el número de usuarios que se ejecuta simultáneamente |
Lanza | |
---|---|
DeviceNotAvailableException |
GetMaxNumberOfUssSupported
public int getMaxNumberOfUsersSupported ()
Obtenga el número máximo de usuarios compatibles. El valor predeterminado es 0.
Devoluciones | |
---|---|
int | un entero que indica el número de usuarios compatibles |
Lanza | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
Devoluciones | |
---|---|
Process | Devuelve el proceso de la VM de MicroDroid. Si TestDevice no es un MicroDroid, devuelve nulo. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Devuelve el IDeviceStateMonitor
asociado con el dispositivo.
Devoluciones | |
---|---|
IDeviceStateMonitor |
GetMountpoint
public String getMountPoint (String mountName)
Devuelve un punto de montaje.
Consulta el dispositivo directamente si la información en caché enIDevice
no está disponible. TODO: Mueva este comportamiento a IDevice#getMountPoint(String)
Parámetros | |
---|---|
mountName | String : el nombre del punto de montaje |
Devoluciones | |
---|---|
String | el punto de montaje o null |
GetMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Devuelve un MountPointInfo
correspondiente a la ruta de punto de montaje especificada, o null
si esa ruta no tiene nada montado o de otra manera no aparece en /Proc /Mounts como un punto de montaje.
Parámetros | |
---|---|
mountpoint | String |
Devoluciones | |
---|---|
ITestDevice.MountPointInfo | Un ERROR(/List) de MountPointInfo que contiene la información en "/proc/montes" |
Lanza | |
---|---|
DeviceNotAvailableException |
GetMountPointInfo
publicgetMountPointInfo ()
Devuelve una versión analizada de la información en /proc /se monta en el dispositivo
Devoluciones | |
---|---|
Un ERROR(/List) de MountPointInfo que contiene la información en "/proc/montes" |
Lanza | |
---|---|
DeviceNotAvailableException |
obtener Opciones
public TestDeviceOptions getOptions ()
Obtenga las opciones de prueba para el dispositivo.
Devoluciones | |
---|---|
TestDeviceOptions | TestDeviceOptions relacionados con el dispositivo bajo prueba. |
getPartitionFreespace
public long getPartitionFreeSpace (String partition)
Método auxiliar para determinar la cantidad de espacio libre en la partición del dispositivo.
Parámetros | |
---|---|
partition | String |
Devoluciones | |
---|---|
long | la cantidad de espacio libre en KB |
Lanza | |
---|---|
DeviceNotAvailableException |
getPrimaryUserid
public Integer getPrimaryUserId ()
Devuelve la ID de usuario principal.
Devoluciones | |
---|---|
Integer | El ID de usuario del usuario primario si hay uno y nulo si no hay usuario primario. |
Lanza | |
---|---|
DeviceNotAvailableException |
GetProcessByName
public ProcessInfo getProcessByName (String processName)
El método Helper ejecuta el comando "Pidof" y "STAT" y devuelve el objeto ProcessInfo
con PID y la hora de inicio del proceso del proceso dado.
Parámetros | |
---|---|
processName | String : la cadena de nombre de proces. |
Devoluciones | |
---|---|
ProcessInfo | ProcessInfo de ProcessName dado |
Lanza | |
---|---|
DeviceNotAvailableException |
GetProcesspid
public String getProcessPid (String process)
Devuelve el PID del servicio o nulo si algo salió mal.
Parámetros | |
---|---|
process | String : la cadena de nombre de proces. |
Devoluciones | |
---|---|
String |
Lanza | |
---|---|
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.Devoluciones | |
---|---|
String | El nombre del tipo de producto String . No será nulo |
Lanza | |
---|---|
DeviceNotAvailableException |
GetProductVariant
public String getProductVariant ()
Método de conveniencia para obtener la variante del producto de este dispositivo.
Este método funcionará si el dispositivo está en modo ADB o FastBoot.Devoluciones | |
---|---|
String | el nombre de la variante del producto String o null si no se puede determinar |
Lanza | |
---|---|
DeviceNotAvailableException |
obtener propiedad
public String getProperty (String name)
Recupere el valor de la propiedad dado del dispositivo.
Parámetros | |
---|---|
name | String : el nombre de la propiedad |
Devoluciones | |
---|---|
String | el valor de la propiedad o null si no existe |
Lanza | |
---|---|
DeviceNotAvailableException |
getRecoverymode
public ITestDevice.RecoveryMode getRecoveryMode ()
Obtenga el modo de recuperación actual utilizado para el dispositivo.
Devoluciones | |
---|---|
ITestDevice.RecoveryMode | El modo de recuperación actual utilizado para el dispositivo. |
obtener captura de pantalla
public InputStreamSource getScreenshot (String format)
Agarra una captura de pantalla del dispositivo. Recomendado para usar GetScreensHot (formato) en su lugar con la codificación JPEG para un tamaño más pequeño
Parámetros | |
---|---|
format | String : PNG compatible, JPEG |
Devoluciones | |
---|---|
InputStreamSource | Un InputStreamSource de la captura de pantalla en formato, o null si la captura de pantalla no tuvo éxito. |
Lanza | |
---|---|
DeviceNotAvailableException |
obtener captura de pantalla
public InputStreamSource getScreenshot (long displayId)
Tome una captura de pantalla del dispositivo dada la ID de pantalla. El formato es PNG.
TODO: Extienda las implementaciones anteriores para admitir 'formato' y 'rescala'
Parámetros | |
---|---|
displayId | long : la ID de visualización de la pantalla para obtener captura de pantalla. |
Devoluciones | |
---|---|
InputStreamSource | Un InputStreamSource de la captura de pantalla en formato, o null si la captura de pantalla no tuvo éxito. |
Lanza | |
---|---|
DeviceNotAvailableException |
obtener captura de pantalla
public InputStreamSource getScreenshot (String format, boolean rescale)
Agarra una captura de pantalla del dispositivo. Recomendado para usar getScreenshot(String)
en su lugar con la codificación JPEG para un tamaño más pequeño.
Parámetros | |
---|---|
format | String : PNG compatible, JPEG |
rescale | boolean : si la captura de pantalla debe ser reescalada para reducir el tamaño de la imagen resultante |
Devoluciones | |
---|---|
InputStreamSource | Un InputStreamSource de la captura de pantalla en formato, o null si la captura de pantalla no tuvo éxito. |
Lanza | |
---|---|
DeviceNotAvailableException |
obtener captura de pantalla
public InputStreamSource getScreenshot ()
Agarra una captura de pantalla del dispositivo.
Devoluciones | |
---|---|
InputStreamSource | Un InputStreamSource de la captura de pantalla en formato PNG, o null , si la captura de pantalla no tuvo éxito. |
Lanza | |
---|---|
DeviceNotAvailableException |
getserialnumber
public String getSerialNumber ()
Método de conveniencia para obtener el número de serie de este dispositivo.
Devoluciones | |
---|---|
String | el número de serie String |
getero
public String getSetting (int userId, String namespace, String key)
Devuelva el valor de la configuración solicitada. El espacio de nombres debe ser uno de: {"sistema", "seguro", "global"}
Parámetros | |
---|---|
userId | int |
namespace | String |
key | String |
Devoluciones | |
---|---|
String | El valor asociado con el espacio de nombres: clave de un usuario. Nulo si no se encuentra. |
Lanza | |
---|---|
DeviceNotAvailableException |
getero
public String getSetting (String namespace, String key)
Consulte getSetting(int, String, String)
y realizado en el usuario del sistema.
Parámetros | |
---|---|
namespace | String |
key | String |
Devoluciones | |
---|---|
String |
Lanza | |
---|---|
DeviceNotAvailableException |
getSiMoperator
public String getSimOperator ()
Devuelva el operador de la tarjeta SIM o el nulo si no está disponible o si el dispositivo no está disponible.
Devoluciones | |
---|---|
String |
getSimstate
public String getSimState ()
Devuelva el estado de la tarjeta SIM o nulo si no está disponible o el dispositivo no está disponible.
Devoluciones | |
---|---|
String |
piedras de gettombe
publicgetTombstones ()
Obtenga y devuelva la lista de lápidas de los dispositivos. Requiere raíz.
El método es el mejor esfuerzo, por lo que si una lápida no se extrae por cualquier motivo, faltará en la lista. Solo una DeviceNotAvailableException
terminará el método temprano.
Devoluciones | |
---|---|
Una lista de archivos de lápida, vacío si no hay lápida. |
Lanza | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
Devuelve el tamaño total de la memoria física en bytes o -1 en caso de error interno
Devoluciones | |
---|---|
long |
getuninstallablePackagenames
publicgetUninstallablePackageNames ()
Obtenga los nombres de los paquetes de aplicación que se pueden desinstalar. Esto se define actualmente como paquetes que no son del sistema y paquetes de sistema actualizados.
Devoluciones | |
---|---|
ERROR(/Set) de nombres de paquetes String instalables actualmente instalados en el dispositivo. |
Lanza | |
---|---|
DeviceNotAvailableException |
GetUseFastBooterasa
public boolean getUseFastbootErase ()
Obtenga si usar FastBoot Borrar o FastBoot format para borrar una partición en el dispositivo.
Devoluciones | |
---|---|
boolean | true si FastBoot Erase se usará o se false si se utilizará el formato FastBoot. |
getUserflags
public int getUserFlags (int userId)
Encuentre y devuelva las banderas de un usuario determinado. Las banderas se definen en la clase "Android.Content.Pm.UserInfo" en el proyecto de código abierto de Android.
Parámetros | |
---|---|
userId | int |
Devoluciones | |
---|---|
int | Las banderas asociadas con el IDED proporcionadas si se encuentran, -10000 en cualquier otro caso. |
Lanza | |
---|---|
DeviceNotAvailableException |
getUserinfos
publicgetUserInfos ()
Obtiene el mapa de Useid a UserInfo
en el dispositivo. Lanzará DeviceRuntimeException
si la salida del dispositivo no es la esperada.
Devoluciones | |
---|---|
La lista de objetos UserInfo. |
Lanza | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Devuelva el número de serie asociado al ID de usuario si se encuentra, -10000 en cualquier otro caso.
Parámetros | |
---|---|
userId | int |
Devoluciones | |
---|---|
int |
Lanza | |
---|---|
DeviceNotAvailableException |
HandleAlLocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Procese el dispositivo de dispositivo dado. Puede hacer el dispositivo de transición al nuevo estado. Informará al IDeviceMonitor
de cualquier transición estatal.
Procese el dispositivo Event, que puede o no hacer la transición de este dispositivo a un nuevo estado de asignación.
Parámetros | |
---|---|
event | DeviceEvent |
Devoluciones | |
---|---|
IManagedTestDevice.DeviceEventResponse |
HASFAETURA
public boolean hasFeature (String feature)
Verifique si hay una función disponible en un dispositivo.
Parámetros | |
---|---|
feature | String : qué formato debería ser "característica: |
Devoluciones | |
---|---|
boolean | VERDADERO Si se encuentra la función, falso de lo contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
paquete de instalación
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Instale un paquete de Android en el dispositivo.
Parámetros | |
---|---|
packageFile | File : el archivo APK para instalar |
reinstall | boolean : true si se debe realizar una reinstalación |
extraArgs | String : argumentos adicionales opcionales para pasar. Consulte 'ADB Shell PM -H' para ver las opciones disponibles. |
Devoluciones | |
---|---|
String | una String con un código de error, o null IF Success. |
Lanza | |
---|---|
DeviceNotAvailableException |
paquete de instalación
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Instale un paquete de Android en el dispositivo.
Nota: Solo los casos de uso que requieren un control explícito de otorgar el permiso de tiempo de ejecución a la hora de instalación deben llamar a esta función.
Parámetros | |
---|---|
packageFile | File : el archivo APK para instalar |
reinstall | boolean : true si se debe realizar una reinstalación |
grantPermissions | boolean : si todos los permisos de tiempo de ejecución deben otorgarse en la hora de instalación |
extraArgs | String : argumentos adicionales opcionales para pasar. Consulte 'ADB Shell PM -H' para ver las opciones disponibles. |
Devoluciones | |
---|---|
String | una String con un código de error, o null IF Success. |
Lanza | |
---|---|
DeviceNotAvailableException |
installPackageForuser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Instale un paquete de Android en el dispositivo para un usuario determinado.
Parámetros | |
---|---|
packageFile | File : el archivo APK para instalar |
reinstall | boolean : true si se debe realizar una reinstalación |
userId | int : la ID de usuario entero para instalar. |
extraArgs | String : argumentos adicionales opcionales para pasar. Consulte 'ADB Shell PM -H' para ver las opciones disponibles. |
Devoluciones | |
---|---|
String | una String con un código de error, o null IF Success. |
Lanza | |
---|---|
DeviceNotAvailableException |
installPackageForuser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instale un paquete de Android en el dispositivo para un usuario determinado.
Nota: Solo los casos de uso que requieren un control explícito de otorgar el permiso de tiempo de ejecución a la hora de instalación deben llamar a esta función.
Parámetros | |
---|---|
packageFile | File : el archivo APK para instalar |
reinstall | boolean : true si se debe realizar una reinstalación |
grantPermissions | boolean : si todos los permisos de tiempo de ejecución deben otorgarse en la hora de instalación |
userId | int : la ID de usuario entero para instalar. |
extraArgs | String : argumentos adicionales opcionales para pasar. Consulte 'ADB Shell PM -H' para ver las opciones disponibles. |
Devoluciones | |
---|---|
String | una String con un código de error, o null IF Success. |
Lanza | |
---|---|
DeviceNotAvailableException |
invalidatePropertyCache
public void invalidatePropertyCache ()
isadbtcp
public boolean isAdbTcp ()
Devoluciones | |
---|---|
boolean |
iSappenumerationationsupported
public boolean isAppEnumerationSupported ()
Verifique si la plataforma en el dispositivo admite la enumeración de la aplicación
Devoluciones | |
---|---|
boolean | Verdadero si la enumeración de la aplicación es compatible, falso de lo contrario |
Lanza | |
---|---|
DeviceNotAvailableException |
isbypasslowTargetSdkblocksupported
public boolean isBypassLowTargetSdkBlockSupported ()
Compruebe si la plataforma en el dispositivo admite si el bloque SDK de destino bajo en las instalaciones de la aplicación
Devoluciones | |
---|---|
boolean | Verdadero Si se admite el bloque SDK de Target Bypass bajo, falso de lo contrario |
Lanza | |
---|---|
DeviceNotAvailableException |
isdebugfsmounted
public boolean isDebugfsMounted ()
Compruebe si el depugfs está montado.
Devoluciones | |
---|---|
boolean | true si se monta el desbugfs |
Lanza | |
---|---|
DeviceNotAvailableException |
ISDEVICEECRYPTADO
public boolean isDeviceEncrypted ()
Devuelve si el dispositivo está encriptado.
Devoluciones | |
---|---|
boolean | true si el dispositivo está encriptado. |
Lanza | |
---|---|
DeviceNotAvailableException |
ISDirectorio
public boolean isDirectory (String path)
Devuelve verdadero si la ruta en el dispositivo es un directorio, falso de lo contrario.
Parámetros | |
---|---|
path | String |
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
isenableadbroot
public boolean isEnableAdbRoot ()
Devoluciones | |
---|---|
boolean | true si la raíz ADB debe habilitarse en el dispositivo |
Isencryptionsupported
public boolean isEncryptionSupported ()
Devuelve si el cifrado se admite en el dispositivo.
Devoluciones | |
---|---|
boolean | true si el dispositivo admite el cifrado. |
Lanza | |
---|---|
DeviceNotAvailableException |
isexecutable
public boolean isExecutable (String fullPath)
Devuelve True si la ruta del archivo en el dispositivo es un archivo ejecutable, falso de lo contrario.
Parámetros | |
---|---|
fullPath | String |
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
ISFASTBOOTENABLED
public boolean isFastbootEnabled ()
Regrese si FastBoot está disponible para el dispositivo.
Devoluciones | |
---|---|
boolean |
no cabreoso
public boolean isHeadless ()
Devuelve verdadero si el dispositivo no tiene cabeza (sin pantalla), falso de lo contrario.
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
isheadlessSystemUsermode
public boolean isHeadlessSystemUserMode ()
Devuelve si el dispositivo usa el modo de usuario del sistema sin cabeza.
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
ismainuserpermanentadmin
public boolean isMainUserPermanentAdmin ()
Devuelve si el usuario principal es un administrador permanente y no se puede eliminar o degradar al estado no administrativo.
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
esmultiuserSupported
public boolean isMultiUserSupported ()
Determina si es compatible con el usuario múltiple.
Devoluciones | |
---|---|
boolean | Verdadero Si el usuario múltiple es compatible, falso de lo contrario |
Lanza | |
---|---|
DeviceNotAvailableException |
ispackageInstalled
public boolean isPackageInstalled (String packageName, String userId)
Consulte el dispositivo para un nombre de paquete dado y una identificación de usuario dada para verificar si está actualmente instalado o no para ese usuario.
Parámetros | |
---|---|
packageName | String : el paquete que estamos revisando si está instalado. |
userId | String : el ID de usuario para el que estamos comprobando el paquete está instalado. Si es nulo, se utilizará el usuario primario cero. |
Devoluciones | |
---|---|
boolean | Es cierto si el paquete se informa como se instala. Falso en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
ispackageInstalled
public boolean isPackageInstalled (String packageName)
Consulte el dispositivo para un nombre de paquete dado para verificar si está instalado actualmente o no.
Parámetros | |
---|---|
packageName | String |
Devoluciones | |
---|---|
boolean | Es cierto si el paquete se informa como se instala. Falso en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
isruntimePermissionsupported
public boolean isRuntimePermissionSupported ()
Verifique si la plataforma en el dispositivo admite la concesión de permiso de tiempo de ejecución
Devoluciones | |
---|---|
boolean | Verdadero Si el permiso de tiempo de ejecución es compatible, falso de lo contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
iSstateBootLoaderRastbootd
public boolean isStateBootloaderOrFastbootd ()
Devuelve verdadero si el dispositivo está en TestDeviceState#FASTBOOT
o TestDeviceState.FASTBOOTD
.
Devoluciones | |
---|---|
boolean |
isuserrunning
public boolean isUserRunning (int userId)
Compruebe si un usuario determinado se está ejecutando.
Parámetros | |
---|---|
userId | int |
Devoluciones | |
---|---|
boolean | Verdadero Si el usuario se está ejecutando, falso en todos los demás casos. |
Lanza | |
---|---|
DeviceNotAvailableException |
isusersecundario
public boolean isUserSecondary (int userId)
Devuelva si el usuario especificado es un usuario secundario de acuerdo con sus banderas.
Parámetros | |
---|---|
userId | int |
Devoluciones | |
---|---|
boolean | Verdadero si el usuario es secundario, falso de lo contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
isuservisible
public boolean isUserVisible (int userId)
Comprueba si el usuario dado es visible.
Un usuario "visible" es un usuario que interactúa con el usuario "humano" y, por lo tanto, puede lanzar actividades de lanzamiento (generalmente en la pantalla predeterminada).
Parámetros | |
---|---|
userId | int |
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
IsuservisibleDesplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Comprueba si el usuario dado es visible en la pantalla dada.
Un usuario "visible" es un usuario que interactúa con el usuario "humano" y, por lo tanto, puede lanzar actividades de lanzamiento en esa pantalla.
Parámetros | |
---|---|
userId | int |
displayId | int |
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
ISVISible
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Devuelve si el dispositivo permite que los usuarios se inicien visibles en segundo plano en el ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
Si lo hace, puede llamar startVisibleBackgroundUser(int, int, boolean)
, pasando una pantalla devuelta por listDisplayIdsForStartingVisibleBackgroundUsers()
(que debe incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
ISVISible BackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
Devuelve si el dispositivo permite que los usuarios se inicien visibles en segundo plano.
Si es así, puede llamar startVisibleBackgroundUser(int, int, boolean)
, pasando una pantalla devuelta por listDisplayIdsForStartingVisibleBackgroundUsers()
.
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
iswifienable
public boolean isWifiEnabled ()
Pruebe si WiFi está habilitado.
Comprueba si WiFi está habilitado en el dispositivo. Útil para afirmar el estado de WiFi antes de las pruebas que no deberían ejecutarse con WiFi, por ejemplo, pruebas de datos móviles.Devoluciones | |
---|---|
boolean | true si WiFi está habilitado. false si está deshabilitado |
Lanza | |
---|---|
DeviceNotAvailableException |
listdisplayids
publiclistDisplayIds ()
Recoja la lista de ID de pantallas disponibles en el dispositivo según lo informado por "Dumpsys SurfaceFlinger".
Devoluciones | |
---|---|
La lista de pantallas. Predeterminado siempre devuelve la pantalla predeterminada 0. |
Lanza | |
---|---|
DeviceNotAvailableException |
listDisplayidSforStartingVisibleBackgroundusers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Obtiene la lista de pantallas que se pueden usar para start a user visible in the background
.
Devoluciones | |
---|---|
Lanza | |
---|---|
DeviceNotAvailableException |
usuarios de listados
publiclistUsers ()
Obtiene la lista de usuarios en el dispositivo. Lanzará DeviceRuntimeException
si la salida del dispositivo no es la esperada.
Devoluciones | |
---|---|
La lista de ID de usuario. |
Lanza | |
---|---|
DeviceNotAvailableException |
loganrs
public boolean logAnrs (ITestLogger logger)
Recoge y registra ANR del dispositivo.
Parámetros | |
---|---|
logger | ITestLogger : un ITestLogger para registrar el ANRS. |
Devoluciones | |
---|---|
boolean | Verdadero Si el registro fue exitoso, falso de lo contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
logbuGreport
public boolean logBugreport (String dataName, ITestLogger listener)
Método auxiliar para tomar un bugreport y registrarlo a los reporteros.
Parámetros | |
---|---|
dataName | String : nombre bajo el cual se informará el bugreport. |
listener | ITestLogger : un ITestLogger para registrar el bugreport. |
Devoluciones | |
---|---|
boolean | Verdadero Si el registro fue exitoso, falso de lo contrario. |
evidente de logonte
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Registre un mensaje en el logCat del dispositivo. Esta es una llamada segura que no lanzará incluso si el registro falla.
Parámetros | |
---|---|
tag | String : la etiqueta en la que registramos nuestro mensaje en el LogCat. |
level | Log.LogLevel : el nivel de depuración del mensaje en el logCat. |
format | String : el formato de mensaje. |
args | Object : Los args se reemplazarán a través de String.Format (). |
no bloqueado
public void nonBlockingReboot ()
Emite un comando para reiniciar el dispositivo y devuelve el comando completo y cuando el dispositivo ya no es visible para ADB.
Lanza | |
---|---|
DeviceNotAvailableException |
postadbrootaccion
public void postAdbRootAction ()
Anule si el dispositivo necesita que se tomen algunas acciones específicas después de la raíz ADB 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 la raíz ADB esté habilitada en esta etapa.
Lanza | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
posadbunrootacción
public void postAdbUnrootAction ()
Anule si el dispositivo necesita algunas acciones específicas para tomar después de ADB Unroot 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 la raíz ADB esté deshabilitada en esta etapa.
Lanza | |
---|---|
| com.android.tradefed.device.devicenotavailableException |
DeviceNotAvailableException |
bootsetup
public void postBootSetup ()
Realice instrucciones para configurar el dispositivo para probarlo después de cada arranque.
Debe llamarse después de que el dispositivo esté completamente arrancado/disponible En circunstancias normales, este método no necesita llamarse explícitamente, ya que las implementaciones deben realizar estos pasos automáticamente al realizar un reinicio. Donde sea posible que deba llamarse es cuando el dispositivo se reinicia debido a otros eventos (por ejemplo, cuando se ha completado un comando de actualización de fastboot)Lanza | |
---|---|
DeviceNotAvailableException |
Tardown posterior a la invocación
public void postInvocationTearDown (Throwable exception)
Pasos adicionales para la limpieza necesaria específica del dispositivo que se ejecutará después de que se realice la invocación.
Parámetros | |
---|---|
exception | Throwable : si corresponde, la excepción final planteada por la falla de invocación. |
preinvocationatup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Pasos adicionales para la configuración necesaria 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 : los atributos almacenados en el contexto de invocación |
Lanza | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
polldir
public boolean pullDir (String deviceFilePath, File localDir)
Retire recursivamente el contenido del directorio desde el dispositivo.
Parámetros | |
---|---|
deviceFilePath | String : la ruta de archivo absoluto de la fuente remota |
localDir | File : el directorio local para extraer archivos en |
Devoluciones | |
---|---|
boolean | true si el archivo se sacó con éxito. false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
tirón
public boolean pullFile (String remoteFilePath, File localFile)
Recupera un archivo de dispositivo.
Parámetros | |
---|---|
remoteFilePath | String : la ruta absoluta para archivar en el dispositivo. |
localFile | File : el archivo local para almacenar contenido. Si no es vacío, se reemplazarán los contenidos. |
Devoluciones | |
---|---|
boolean | true si el archivo se recuperó con éxito. false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
tirón
public File pullFile (String remoteFilePath, int userId)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
Parámetros | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
userId | int : The user id to pull from |
Devoluciones | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Lanza | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
Parámetros | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
Devoluciones | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Lanza | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Retrieves a file off device.
Parámetros | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
userId | int : The user id to pull from |
Devoluciones | |
---|---|
boolean | true if file was retrieved successfully. false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
pullFileContents
public String pullFileContents (String remoteFilePath)
Retrieves a file off device, and returns the contents.
Parámetros | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
Devoluciones | |
---|---|
String | A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Lanza | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File)
, and return a reference to that File
.
Parámetros | |
---|---|
remoteFilePath | String : the path to file on device, relative to the device's external storage mountpoint |
Devoluciones | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Lanza | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Recursively push directory contents to device while excluding some directories that are filtered.
Parámetros | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
excludedDirectories |
Devoluciones | |
---|---|
boolean | true if file was pushed successfully. false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
Recursively push directory contents to device.
Parámetros | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
Devoluciones | |
---|---|
boolean | true if file was pushed successfully. false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variant of pushFile(File, String)
which can optionally consider evaluating the need for the content provider.
Parámetros | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
evaluateContentProviderNeeded | boolean : whether to check if we need the content provider |
Devoluciones | |
---|---|
boolean | true if file was pushed successfully. false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath)
Push a file to device. By default using a content provider.
Parámetros | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
Devoluciones | |
---|---|
boolean | true if file was pushed successfully. false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
pushString
public boolean pushString (String contents, String remoteFilePath)
Push file created from a string to device
Parámetros | |
---|---|
contents | String : the contents of the file to push |
remoteFilePath | String : the remote destination absolute file path |
Devoluciones | |
---|---|
boolean | true if string was pushed successfully. false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
reiniciar
public void reboot (String reason)
Reboots the device into adb mode with given reason
to be persisted across reboot.
Blocks until device becomes available.
Last reboot reason can be obtained by querying sys.boot.reason
propety.
Parámetros | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
Lanza | |
---|---|
DeviceNotAvailableException |
reiniciar
public void reboot ()
Reboots the device into adb mode.
Blocks until device becomes available.Lanza | |
---|---|
DeviceNotAvailableException |
rebootIntoBootloader
public void rebootIntoBootloader ()
Reboots the device into bootloader mode.
Blocks until device is in bootloader mode.Lanza | |
---|---|
DeviceNotAvailableException |
rebootIntoFastbootd
public void rebootIntoFastbootd ()
Reboots the device into fastbootd mode.
Blocks until device is in fastbootd mode.
Lanza | |
---|---|
DeviceNotAvailableException |
rebootIntoRecovery
public void rebootIntoRecovery ()
Reboots the device into adb recovery mode.
Blocks until device enters recoveryLanza | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload ()
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
Lanza | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
Parámetros | |
---|---|
autoReboot | boolean : whether to automatically reboot the device after sideload |
Lanza | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline ()
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Lanza | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline (String reason)
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Parámetros | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
Lanza | |
---|---|
DeviceNotAvailableException |
rebootUserspace
public void rebootUserspace ()
Reboots only userspace part of device.
Blocks until device becomes available.
ADVERTENCIA. Userspace reboot is currently under active development, use it on your own risk.
Lanza | |
---|---|
DeviceNotAvailableException |
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
An alternate to rebootUserspace()
()} that only blocks until device is online ie visible to adb.
Lanza | |
---|---|
DeviceNotAvailableException |
recoverDevice
public boolean recoverDevice ()
Attempts to recover device communication.
Devoluciones | |
---|---|
boolean | True if recovery attempted and successful, returns False if recovery was skipped |
Lanza | |
---|---|
DeviceNotAvailableException | if device is no longer available |
registerDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registers a IDeviceActionReceiver
for this device.
All registered IDeviceActionReceiver
s will be notified before a device action starts and after the device action ends.
Parámetros | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : A IDeviceActionReceiver which will be registered. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Make the system partition on the device read-only. May reboot the device.
Lanza | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Make the system partition on the device writable. May reboot the device.
Lanza | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
Make the vendor partition on the device read-only. May reboot the device.
Lanza | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
Make the vendor partition on the device writable. May reboot the device.
Lanza | |
---|---|
DeviceNotAvailableException |
removeAdmin
public boolean removeAdmin (String componentName, int userId)
Remove given device admin in given user and return true
if it is successful, false
otherwise.
Parámetros | |
---|---|
componentName | String : of device admin to be removed. |
userId | int : of user that the device admin lives in. |
Devoluciones | |
---|---|
boolean | True if it is successful, false otherwise. |
Lanza | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
Remove all existing device profile owners with the best effort.
Lanza | |
---|---|
DeviceNotAvailableException |
removeUser
public boolean removeUser (int userId)
Remove a given user from the device.
Parámetros | |
---|---|
userId | int : of the user to remove |
Devoluciones | |
---|---|
boolean | true if we were successful in removing the user, false otherwise. |
Lanza | |
---|---|
DeviceNotAvailableException |
resetContentProviderSetup
public void resetContentProviderSetup ()
Reset the flag for content provider setup in order to trigger it again.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
with one or more listeners passed as parameters.
Parámetros | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners | ITestLifeCycleReceiver : the test result listener(s) |
Devoluciones | |
---|---|
boolean | true if test command completed. false if it failed to complete, but recovery succeeded |
Lanza | |
---|---|
DeviceNotAvailableException |
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Runs instrumentation tests, and provides device recovery.
If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.
If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.
Parámetros | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners |
Devoluciones | |
---|---|
boolean | true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded |
Lanza | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
but runs the test for the given user.
Parámetros | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
but runs the test for a given user.
Parámetros | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
establecer configuración
public void setConfiguration (IConfiguration configuration)
Inyecta la IConfiguration
en uso.
Parámetros | |
---|---|
configuration | IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Parámetros | |
---|---|
avdInfo | GceAvdInfo |
Establece la fecha
public void setDate (Date date)
Sets the date on device
Note: setting date on device requires root
Parámetros | |
---|---|
date | Date : specify a particular date; will use host date if null |
Lanza | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
Set a device admin component as device owner in given user.
Parámetros | |
---|---|
componentName | String : of device admin to be device owner. |
userId | int : of the user that the device owner lives in. |
Devoluciones | |
---|---|
boolean | True if it is successful, false otherwise. |
Lanza | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Update the device's state.
Parámetros | |
---|---|
deviceState | TestDeviceState : the TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
For emulator set SizeLimitedOutputStream
to log output
Parámetros | |
---|---|
output | SizeLimitedOutputStream : to log the output |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Sets the Process
, when this device is an emulator.
Parámetros | |
---|---|
p | Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Set the fastboot option for the device. Should be set when device is first allocated.
Parámetros | |
---|---|
fastbootEnabled | boolean : whether fastboot is available for the device or not |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled()
to be true, to have fastboot functions enabled.
Parámetros | |
---|---|
fastbootPath | String |
setIDevice
public void setIDevice (IDevice newDevice)
Update the IDevice associated with this ITestDevice.
The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDeviceParámetros | |
---|---|
newDevice | IDevice : el IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Sets the time in ms to wait before starting logcat capture for a online device.
Parámetros | |
---|---|
delay | int : the delay in ms |
establecer opciones
public void setOptions (TestDeviceOptions options)
Set the TestDeviceOptions
for the device
Parámetros | |
---|---|
options | TestDeviceOptions |
establecer propiedad
public boolean setProperty (String propKey, String propValue)
Sets the given property value on the device. Requires adb root is true.
Parámetros | |
---|---|
propKey | String : The key targeted to be set. |
propValue | String : The property value to be set. |
Devoluciones | |
---|---|
boolean | returns True if the setprop command was successful, False otherwise. |
Lanza | |
---|---|
DeviceNotAvailableException |
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Set the IDeviceRecovery
to use for this device. Should be set when device is first allocated.
Parámetros | |
---|---|
recovery | IDeviceRecovery : the IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Set the current recovery mode to use for the device.
Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etcParámetros | |
---|---|
mode | ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not. |
setSetting
public void setSetting (String namespace, String key, String value)
See setSetting(int, String, String, String)
and performed on system user.
Parámetros | |
---|---|
namespace | String |
key | String |
value | String |
Lanza | |
---|---|
DeviceNotAvailableException |
setSetting
public void setSetting (int userId, String namespace, String key, String value)
Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}
Parámetros | |
---|---|
userId | int |
namespace | String |
key | String |
value | String |
Lanza | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Injects the ITestLogger
instance
Parámetros | |
---|---|
testLogger | ITestLogger |
setUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
Set whether to use fastboot erase or fastboot format to wipe a partition on the device.
Parámetros | |
---|---|
useFastbootErase | boolean : true if fastboot erase should be used or false if fastboot format should be used. |
startLogcat
public void startLogcat ()
Start capturing logcat output from device in the background.
Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat. When the device is no longer in use,stopLogcat()
must be called. startLogcat()
and stopLogcat()
do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat. startUser
public boolean startUser (int userId)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.
Parámetros | |
---|---|
userId | int : of the user to start in the background |
Devoluciones | |
---|---|
boolean | true if the user was successfully started in the background. |
Lanza | |
---|---|
DeviceNotAvailableException |
startUser
public boolean startUser (int userId, boolean waitFlag)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.
Parámetros | |
---|---|
userId | int : of the user to start in the background |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Devoluciones | |
---|---|
boolean | true if the user was successfully started in the background. |
Lanza | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).
NOTE: this command doesn't check if the user exists, display is available, device supports such feature
, etc.
Parámetros | |
---|---|
userId | int : of the user to start in the background |
displayId | int : display to start user visible on |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Devoluciones | |
---|---|
boolean | true if the user was successfully started visible in the background. |
Lanza | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Close and delete the emulator output.
stopLogcat
public void stopLogcat ()
Stop capturing logcat output from device, and discard currently saved logcat data.
Will have no effect if logcat output is not being captured.stopUser
public boolean stopUser (int userId)
Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.
Parámetros | |
---|---|
userId | int : of the user to stop. |
Devoluciones | |
---|---|
boolean | true if the user was successfully stopped. |
Lanza | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.
Parámetros | |
---|---|
userId | int : of the user to stop. |
waitFlag | boolean : will make the command wait until user is stopped. |
forceFlag | boolean : will force stop the user. |
Devoluciones | |
---|---|
boolean | true if the user was successfully stopped. |
Lanza | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public String switchToAdbTcp ()
Switch device to adb-over-tcp mode.
Devoluciones | |
---|---|
String | the tcp serial number or null if device could not be switched |
Lanza | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Switch device to adb over usb mode.
Devoluciones | |
---|---|
boolean | true if switch was successful, false otherwise. |
Lanza | |
---|---|
DeviceNotAvailableException |
cambiar de usuario
public boolean switchUser (int userId)
Switch to another userId with a default timeout. switchUser(int, long)
.
Parámetros | |
---|---|
userId | int |
Devoluciones | |
---|---|
boolean | True if the new userId matches the userId provider. Falso en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
cambiar de usuario
public boolean switchUser (int userId, long timeout)
Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.
Parámetros | |
---|---|
userId | int |
timeout | long : to wait before returning false for switch-user failed. |
Devoluciones | |
---|---|
boolean | True if the new userId matches the userId provider. Falso en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
syncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
Incrementally syncs the contents of a local file directory to device.
Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date. Hidden files (with names starting with ".") will be ignored. Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.Parámetros | |
---|---|
localFileDir | File : the local file directory containing files to recursively push. |
deviceFilePath | String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail |
Devoluciones | |
---|---|
boolean | true if files were synced successfully. false en caso contrario. |
Lanza | |
---|---|
DeviceNotAvailableException |
takeBugreport
public Bugreport takeBugreport ()
Take a bugreport and returns it inside a Bugreport
object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close()
.
Devoluciones | |
---|---|
Bugreport |
uninstallPackage
public String uninstallPackage (String packageName)
Uninstall an Android package from device.
Parámetros | |
---|---|
packageName | String : the Android package to uninstall |
Devoluciones | |
---|---|
String | a String with an error code, or null if success. |
Lanza | |
---|---|
DeviceNotAvailableException |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
Uninstall an Android package from device for a given user.
Parámetros | |
---|---|
packageName | String : the Android package to uninstall |
userId | int : the integer user id to uninstall for. |
Devoluciones | |
---|---|
String | a String with an error code, or null if success. |
Lanza | |
---|---|
DeviceNotAvailableException |
unlockDevice
public boolean unlockDevice ()
Unlocks the device if the device is in an encrypted state.
This method may restart the framework but will not callpostBootSetup()
. Therefore, the device might not be fully ready to be tested when this method returns.Devoluciones | |
---|---|
boolean | true if successful or if the device is unencrypted. |
Lanza | |
---|---|
DeviceNotAvailableException |
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Blocks until the device's boot complete flag is set.
Parámetros | |
---|---|
timeOut | long : time in msecs to wait for the flag to be set |
Devoluciones | |
---|---|
boolean | true if device's boot complete flag is set within the timeout |
Lanza | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
Waits for the device to be responsive and available for testing. Uses default timeout.
Devoluciones | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Lanza | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
Waits for the device to be responsive and available for testing.
Parámetros | |
---|---|
waitTime | long : the time in ms to wait |
Devoluciones | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Lanza | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Waits for the device to be responsive and available without considering recovery path.
Parámetros | |
---|---|
waitTime | long |
Devoluciones | |
---|---|
boolean | True if device is available, False if unavailable. |
Lanza | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Blocks until device is visible via fastboot. Use default timeout.
Lanza | |
---|---|
DeviceNotAvailableException |
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery
).
Parámetros | |
---|---|
waitTime | long : the time in ms to wait |
Devoluciones | |
---|---|
boolean | true if device boots into recovery before time expires. false en caso contrario |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
Blocks for the device to be in the 'adb sideload' state
Parámetros | |
---|---|
waitTime | long : the time in ms to wait |
Devoluciones | |
---|---|
boolean | true if device boots into sideload before time expires. false en caso contrario |
waitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Blocks for the device to be not available ie missing from adb
Parámetros | |
---|---|
waitTime | long : the time in ms to wait |
Devoluciones | |
---|---|
boolean | true if device becomes not available before time expires. false en caso contrario |
waitForDeviceOnline
public void waitForDeviceOnline ()
Blocks until device is visible via adb. Uses default timeout
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Lanza | |
---|---|
DeviceNotAvailableException |
waitForDeviceOnline
public void waitForDeviceOnline (long waitTime)
Blocks until device is visible via adb.
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Parámetros | |
---|---|
waitTime | long : the time in ms to wait |
Lanza | |
---|---|
DeviceNotAvailableException |
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Waits for device to be responsive to a basic adb shell command.
Parámetros | |
---|---|
waitTime | long : the time in ms to wait |
Devoluciones | |
---|---|
boolean | true if device becomes responsive before waitTime elapses. |
Métodos protegidos
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Parámetros | |
---|---|
builder | DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Builds the OS command for the given adb shell command session and args
Parámetros | |
---|---|
command | String |
forceExitStatusDetection | boolean |
Devoluciones | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Parámetros | |
---|---|
feature | String |
strictMinLevel | int |
createRebootDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Create a RebootDeviceAction
to be used when performing a reboot action.
Parámetros | |
---|---|
rebootMode | NativeDevice.RebootMode : a mode of this reboot. |
reason | String : for this reboot. |
Devoluciones | |
---|---|
NativeDevice.RebootDeviceAction | the created RebootDeviceAction . |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Perform a adb reboot.
Parámetros | |
---|---|
rebootMode | NativeDevice.RebootMode : a mode of this reboot. |
reason | String : for this reboot. |
Lanza | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
helper method to throw exception if runtime permission isn't supported
Lanza | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Devoluciones | |
---|---|
int |
initializeConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parámetros | |
---|---|
info | IBuildInfo |
attributes | MultiMap |
Lanza | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
internalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.
Parámetros | |
---|---|
propName | String : The name of the device property as returned by `adb shell getprop` |
fastbootVar | String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted |
description | String : A simple description of the variable. First letter should be capitalized. |
Devoluciones | |
---|---|
String | A string, possibly null or empty, containing the value of the given property |
Lanza | |
---|---|
DeviceNotAvailableException |
isInRebootCallback
protected boolean isInRebootCallback ()
Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.
Devoluciones | |
---|---|
boolean |
isNewer
protected boolean isNewer (File localFile, IFileEntry entry)
Return true
if local file is newer than remote file. IFileEntry
being accurate to the minute, in case of equal times, the file will be considered newer.
Parámetros | |
---|---|
localFile | File |
entry | IFileEntry |
Devoluciones | |
---|---|
boolean |
notifyRebootEnded
protected void notifyRebootEnded ()
Notifies all IDeviceActionReceiver
about reboot end event.
Lanza | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notifyRebootStarted
protected void notifyRebootStarted ()
Notifies all IDeviceActionReceiver
about reboot start event.
Lanza | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
performDeviceAction
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Performs an action on this device. Attempts to recover device and optionally retry command if action fails.
Parámetros | |
---|---|
actionDescription | String : a short description of action to be performed. Used for logging purposes only. |
action | NativeDevice.DeviceAction : the action to be performed |
retryAttempts | int : the retry attempts to make for action if it fails but recovery succeeds |
Devoluciones | |
---|---|
boolean | true if action was performed successfully |
Lanza | |
---|---|
DeviceNotAvailableException | if recovery attempt fails or max attempts done without success |
postAdbReboot
protected void postAdbReboot ()
Possible extra actions that can be taken after a reboot.
Lanza | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
prePostBootSetup
protected void prePostBootSetup ()
Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.
Lanza | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Parámetros | |
---|---|
remoteFilePath | String |
localFile | File |
Devoluciones | |
---|---|
boolean |
Lanza | |
---|---|
DeviceNotAvailableException |
establecer reloj
protected void setClock (Clock clock)
Set the Clock instance to use.
Parámetros | |
---|---|
clock | Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Marks the TestDevice as microdroid and sets its CID.
Parámetros | |
---|---|
process | Process : Process of the Microdroid VM. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Parámetros | |
---|---|
deviceOptions |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Executes a simple fastboot command with environment variables and report the status of the command.
Parámetros | |
---|---|
timeout | long |
envVarMap | |
fullCmd | String |
Devoluciones | |
---|---|
CommandResult |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Executes a simple fastboot command and report the status of the command.
Parámetros | |
---|---|
timeout | long |
fullCmd | String |
Devoluciones | |
---|---|
CommandResult |
waitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Wait to see the device going unavailable (stop reporting to adb).
Parámetros | |
---|---|
operationDesc | String : The name of the operation that is waiting for unavailable. |
time | long : The time to wait for unavailable to occur. |
Devoluciones | |
---|---|
boolean | True if device did become unavailable. |
El contenido y el código de ejemplo de esta página están sujetos a las licencias que se describen en la licencia de contenido. Java y OpenJDK son marcas registradas de Oracle o sus entidades asociadas.
Última actualización: 2023-12-04 (UTC).