A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

java.lang.Object
↳	com.android.tradefed.device.NativeDevice

Subclasses diretas conhecidas

TestDevice

TestDevice Implementação de um ITestDevice para um dispositivo Android de pilha completa

Subclasses indiretas conhecidas

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	A classe para dispositivos virtuais locais executados no host TradeFed.
ManagedRemoteDevice	Um dispositivo em execução em uma máquina virtual que gerenciamos remotamente por uma instância do Tradefed dentro da VM.
NestedRemoteDevice	Representação do dispositivo em execução em uma VM remota do Cuttlefish.
RemoteAndroidDevice	Implementação de um `ITestDevice` para um dispositivo Android full stack conectado via adb connect.
RemoteAndroidVirtualDevice	Estende o comportamento de `RemoteAndroidDevice` para um dispositivo Android de pilha completa em execução no Google Compute Engine (Gce).

Implementação padrão de um ITestDevice. Dispositivos Android não full-stack.

Resumo

Classes aninhadas
`class`	`NativeDevice.AdbAction` Um `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` para executar um comando "adb ...." do SO.
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` para reiniciar um dispositivo.

Constantes
`String`	`DEBUGFS_PATH`
`int`	`INVALID_USER_ID` Valor retornado para qualquer ID de usuário inválido/não encontrado: UserHandle definiu o valor -10000
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` o número padrão de tentativas de repetição de comando a serem realizadas
`String`	`SD_CARD`
`String`	`STORAGE_EMULATED`

Campos
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

Construtores públicos
`NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` Cria um `TestDevice`.

Métodos públicos
`void`	`batchPrefetchStartupBuildProps()` Micro otimização (cerca de 400 milissegundos) pré-buscando todas as propriedades necessárias em vez de chamar "adb getprop" para cada uma.
`boolean`	`canSwitchToHeadlessSystemUser()` Retorna se é permitido mudar para o usuário SYSTEM headless.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Verifica se um recurso é compatível com um nível de suporte mínimo.
`boolean`	`checkConnectivity()` Verifique se o dispositivo tem conectividade de rede.
`boolean`	`clearErrorDialogs()` Tente dispensar todas as caixas de diálogo de erro exibidas na interface do dispositivo.
`void`	`clearLastConnectedWifiNetwork()` Limpa a última rede Wi-Fi conectada.
`void`	`clearLogcat()` Exclui todos os dados acumulados do logcat.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Conecta-se a uma rede Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Conecta-se a uma rede Wi-Fi.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Conecta-se a uma rede Wi-Fi.f
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` Conecta-se a uma rede Wi-Fi.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` Uma variante de `connectToWifiNetwork(String, String)` que só se conecta se o dispositivo não tiver conectividade de rede no momento.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` Uma variante de `connectToWifiNetwork(String, String)` que só se conecta se o dispositivo não tiver conectividade de rede no momento.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` Crie um usuário com um nome e as flags fornecidas.
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Crie um usuário com um nome e as flags fornecidas.
`int`	`createUser(String name)` Crie um usuário com um nome específico e flags padrão 0.
`int`	`createUserNoThrow(String name)` Crie um usuário com um nome específico e flags padrão 0.
`DeviceInspectionResult`	`debugDeviceNotAvailable()` Inspecionar um dispositivo e retornar informações detalhadas quando ele ficar indisponível.
`void`	`deleteFile(String deviceFilePath, int userId)` Método auxiliar para excluir um arquivo ou diretório no dispositivo.
`void`	`deleteFile(String deviceFilePath)` Método auxiliar para excluir um arquivo ou diretório no dispositivo.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Remove o `IDeviceActionReceiver` registrado.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Método auxiliar para verificar se o dispositivo foi reiniciado por software comparando o system_server atual com o system_server anterior `ProcessInfo`.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Método auxiliar para verificar se o dispositivo foi reiniciado por software desde o horário UTC desde a época do dispositivo e seu `ERROR(/TimeUnit)`.
`boolean`	`disableAdbRoot()` Desativa o adb root.
`void`	`disableKeyguard()` Tenta desativar o keyguard.
`boolean`	`disableNetworkMonitor()` Desativa o monitoramento de rede no dispositivo.
`boolean`	`disconnectFromWifi()` Desconecta de uma rede Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` Método auxiliar para determinar se o arquivo no dispositivo existe para um determinado usuário.
`boolean`	`doesFileExist(String deviceFilePath)` Método auxiliar para determinar se o arquivo existe no dispositivo.
`File`	`dumpHeap(String process, String devicePath)` Tente despejar o heap do system_server.
`boolean`	`enableAdbRoot()` Ativa o adb root.
`boolean`	`enableNetworkMonitor()` Ativa o monitoramento de rede no dispositivo.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.
`String`	`executeAdbCommand(String... cmdArgs)` Método auxiliar que executa um comando adb como um comando do sistema.
`CommandResult`	`executeAdbV2Command(String... cmdArgs)` Método auxiliar que executa um comando adb como um comando do sistema.
`CommandResult`	`executeAdbV2Command(long timeout, String... cmdArgs)` Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.
`CommandResult`	`executeAdbV2Command(long timeout, envMap, String... cmdArgs)` Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` Método auxiliar que executa um comando fastboot como um comando do sistema com um tempo limite padrão de 2 minutos.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` Método auxiliar que executa um comando fastboot como um comando do sistema.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema com variáveis de ambiente do sistema.
`String`	`executeShellCommand(String command)` Método auxiliar que executa um comando do shell adb e retorna a saída como um `String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Executa o comando adb shell especificado, tentando várias vezes se o comando falhar.
`CommandResult`	`executeShellV2Command(String cmd)` Método auxiliar que executa um comando do shell adb e retorna os resultados como um `CommandResult` preenchido corretamente com a saída de status do comando, stdout e stderr.
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` Método auxiliar que executa um comando do shell adb e retorna os resultados como um `CommandResult` corretamente preenchido com a saída de status do comando e stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` Método auxiliar que executa um comando do shell adb e retorna os resultados como um `CommandResult` corretamente preenchido com a saída do status do comando, stdout e stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.
`CommandResult`	`fastbootWipePartition(String partition)` Método auxiliar que apaga uma partição do dispositivo.
	`getActiveApexes()` Busca as informações sobre os APEXs ativados no dispositivo.
`String`	`getAdbPath()` Retorna o caminho do binário adb que está sendo usado.
	`getAllSettings(String namespace)` Retorna pares de chave-valor do namespace solicitado.
`DeviceAllocationState`	`getAllocationState()` Retorna o estado de alocação atual do dispositivo.
`String`	`getAndroidId(int userId)` Encontra e retorna o android-id associado a um userId. Retorna nulo se não for encontrado.
	`getAndroidIds()` Crie um mapa de IDs do Android que correspondem aos IDs de usuário.
`int`	`getApiLevel()` Recebe o nível da API do dispositivo.
`PackageInfo`	`getAppPackageInfo(String packageName)` Busca informações sobre um pacote instalado no dispositivo.
	`getAppPackageInfos()` Busca informações de pacotes instalados no dispositivo.
`String`	`getBasebandVersion()` Método de conveniência para receber a versão da banda de base (rádio) deste dispositivo.
`Integer`	`getBattery()` Retorna o nível atual da bateria de um dispositivo ou Null se o nível da bateria não estiver disponível.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` Retorna o valor booleano da propriedade especificada.
	`getBootHistory()` O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização desde o tempo especificado desde a época do dispositivo e a unidade de tempo especificada.
`String`	`getBootloaderVersion()` Método conveniente para receber a versão do carregador de inicialização deste dispositivo.
`InputStreamSource`	`getBugreport()` Recupera um relatório do bug do dispositivo.
`InputStreamSource`	`getBugreportz()` Recupera um bugreportz do dispositivo.
`String`	`getBuildAlias()` Recupera o alias da build que o dispositivo está executando no momento.
`String`	`getBuildFlavor()` Recupere a variante de build do dispositivo.
`String`	`getBuildId()` Recupere o build que o dispositivo está executando no momento.
`String`	`getBuildSigningKeys()` Retorna o tipo de chave usado para assinar a imagem do dispositivo. Normalmente, os dispositivos Android podem ser assinados com chaves de teste (como no AOSP) ou chaves de lançamento (controladas por fabricantes de dispositivos individuais).
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Retorna um `DeviceDescriptor` em cache se o dispositivo estiver alocado. Caso contrário, retorna o `DeviceDescriptor` atual.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Retorna um `DeviceDescriptor` em cache se o dispositivo estiver alocado. Caso contrário, retorna o `DeviceDescriptor` atual.
`String[]`	`getChildren(String path)` Alternativa ao uso de `IFileEntry`, que às vezes não funciona devido a permissões.
`AbstractConnection`	`getConnection()` A conexão atual associada ao dispositivo.
`ContentProviderHandler`	`getContentProvider(int userId)` Retorna o `ContentProviderHandler` ou nulo se não estiver disponível.
`DeviceFoldableState`	`getCurrentFoldableState()` Retorna o estado dobrável atual do dispositivo ou nulo se ocorrerem problemas.
`int`	`getCurrentUser()` Retorna o ID do usuário em execução no momento.
`String`	`getDeviceClass()` Receba a classe do dispositivo.
`long`	`getDeviceDate()` Retorna a data do dispositivo em milissegundos desde o período.
`DeviceDescriptor`	`getDeviceDescriptor()` Retorna um `DeviceDescriptor` das informações do dispositivo para receber informações sobre ele sem transmitir o objeto do dispositivo real.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Retorna um `DeviceDescriptor` das informações do dispositivo para receber informações sobre ele sem transmitir o objeto do dispositivo real.
`TestDeviceState`	`getDeviceState()` Acessa o estado do dispositivo.
`long`	`getDeviceTimeOffset(Date date)` Auxiliar para receber a diferença de horário entre o dispositivo e um determinado `ERROR(/Date)`.
`InputStreamSource`	`getEmulatorOutput()` Receber o fluxo de stdout e stderr do emulador
`Process`	`getEmulatorProcess()` Retorna o `Process` correspondente a este emulador.
`final File`	`getExecuteShellCommandLog()` O registro que contém todos os registros `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` Método auxiliar para determinar a quantidade de espaço livre no armazenamento externo do dispositivo.
`String`	`getFastbootPath()` Retorna o caminho do binário fastboot em uso.
`String`	`getFastbootProductType()` Método conveniente para receber o tipo de produto deste dispositivo quando ele está no modo fastboot.
`String`	`getFastbootProductVariant()` Método conveniente para receber o tipo de produto deste dispositivo quando ele está no modo fastboot.
`String`	`getFastbootSerialNumber()` Retorna o número de série do modo fastboot.
`String`	`getFastbootVariable(String variableName)` Recupera o valor da variável fastboot especificada do dispositivo.
`String`	`getFastbootVersion()` Retorna a string de versão do binário fastboot em uso.
`IFileEntry`	`getFileEntry(String path)` Recupera uma referência a um arquivo remoto no dispositivo.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` Helper não oficial para receber um `FileEntry` de um caminho não raiz.
	`getFoldableStates()` Retorna a lista de estados dobráveis no dispositivo.
`IDevice`	`getIDevice()` Retorna uma referência à `IDevice` ddmlib associada.
	`getInstalledPackageNames()` Busca os nomes de pacotes de aplicativos presentes no dispositivo.
`long`	`getIntProperty(String name, long defaultValue)` Retorna o valor inteiro da propriedade especificada do dispositivo.
`String`	`getIpAddress()` Recebe o endereço IP do dispositivo.
`KeyguardControllerState`	`getKeyguardState()` Retorne um objeto para receber o estado atual do keyguard ou null se não for compatível.
`long`	`getLastExpectedRebootTimeMillis()` Retorna a última vez que as APIs do Tradefed acionaram uma reinicialização em milissegundos desde EPOCH, conforme retornado por `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` Recebe o primeiro nível de API iniciado do dispositivo.
`InputStreamSource`	`getLogcat()` Captura um fluxo de snapshot dos dados do logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` Captura um fluxo de snapshot dos últimos `maxBytes` dados de logcat capturados.
`InputStreamSource`	`getLogcatDump()` Receba um despejo do logcat atual do dispositivo.
`InputStreamSource`	`getLogcatSince(long date)` Extrai um fluxo de snapshot dos dados do logcat capturados a partir da data fornecida.
`String`	`getMacAddress()` Retorna o endereço MAC do dispositivo ou nulo se não for possível consultar o dispositivo.
`Integer`	`getMainUserId()` Retorna o ID do usuário principal.
	`getMainlineModuleInfo()` Receba informações sobre os módulos principais instalados no dispositivo.
`int`	`getMaxNumberOfRunningUsersSupported()` Recebe o número máximo de usuários que podem ser executados simultaneamente.
`int`	`getMaxNumberOfUsersSupported()` Recebe o número máximo de usuários aceitos.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Retorna o `IDeviceStateMonitor` associado ao dispositivo.
`String`	`getMountPoint(String mountName)` Retorna um ponto de montagem.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` Retorna um `MountPointInfo` correspondente ao caminho do ponto de montagem especificado ou `null` se esse caminho não tiver nada montado ou não aparecer em /proc/mounts como um ponto de montagem.
	`getMountPointInfo()` Retorna uma versão analisada das informações em /proc/mounts no dispositivo.
`TestDeviceOptions`	`getOptions()` Busque as opções de teste para o dispositivo.
`long`	`getPartitionFreeSpace(String partition)` Método auxiliar para determinar a quantidade de espaço livre na partição do dispositivo.
`Integer`	`getPrimaryUserId()` Retorna o ID do usuário principal.
`ProcessInfo`	`getProcessByName(String processName)` O método auxiliar executa os comandos "pidof" e "stat" e retorna o objeto `ProcessInfo` com o PID e o horário de início do processo especificado.
`String`	`getProcessPid(String process)` Retorna o PID do serviço ou nulo se algo der errado.
`String`	`getProductType()` Método de conveniência para receber o tipo de produto deste dispositivo.
`String`	`getProductVariant()` Método de conveniência para receber a variante do produto deste dispositivo.
`String`	`getProperty(String name)` Recupera o valor da propriedade especificada do dispositivo.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Recebe o modo de recuperação atual usado no dispositivo.
`InputStreamSource`	`getScreenshot(long displayId)` Faz uma captura de tela do dispositivo com o ID de exibição especificado.
`InputStreamSource`	`getScreenshot(String format)` Captura uma captura de tela do dispositivo.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` Captura uma captura de tela do dispositivo.
`InputStreamSource`	`getScreenshot()` Captura uma captura de tela do dispositivo.
`String`	`getSerialNumber()` Método prático para receber o número de série deste dispositivo.
`String`	`getSetting(int userId, String namespace, String key)` Retorna o valor da configuração solicitada.
`String`	`getSetting(String namespace, String key)` Consulte `getSetting(int, String, String)` e executado no usuário do sistema.
`String`	`getSimOperator()` Retorna a operadora do chip ou nulo se não estiver disponível ou se o dispositivo não estiver disponível.
`String`	`getSimState()` Retorna o estado do chip ou nulo se não estiver disponível ou se o dispositivo não estiver disponível.
	`getTombstones()` Busca e retorna a lista de lápides dos dispositivos.
`long`	`getTotalMemory()` Retorna o tamanho total da memória física em bytes ou -1 em caso de erro interno.
`String`	`getTrackingSerial()` Para fins de gerenciamento de dispositivos, receba o número de série usado para rastrear o dispositivo.
	`getUninstallablePackageNames()` Extraia os nomes de pacotes de aplicativos que podem ser desinstalados.
`boolean`	`getUseFastbootErase()` Recebe se é necessário usar "fastboot erase" ou "fastboot format" para limpar uma partição no dispositivo.
`int`	`getUserFlags(int userId)` Encontra e retorna as flags de um determinado usuário.
	`getUserInfos()` Recebe o mapa de useId para `UserInfo` no dispositivo.
`int`	`getUserSerialNumber(int userId)` Retorna o número de série associado ao userId se encontrado, -10000 em qualquer outro caso.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Processa o DeviceEvent especificado. Processa o DeviceEvent, que pode ou não fazer a transição desse dispositivo para um novo estado de alocação.
`boolean`	`hasFeature(String feature)` Verifica se um recurso está disponível em um dispositivo.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)` Inicialize a conexão com o dispositivo.
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` Instala um pacote Android no dispositivo.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` Instala um pacote Android no dispositivo.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` Instala um pacote Android no dispositivo para um determinado usuário.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Instala um pacote Android no dispositivo para um determinado usuário.
`boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` Instala APKs com modo incremental.
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` Verificar se a plataforma no dispositivo é compatível com a enumeração de apps
`boolean`	`isBypassLowTargetSdkBlockSupported()` Verifique se a plataforma no dispositivo permite ignorar o bloqueio de SDK de destino baixo nas instalações de apps
`boolean`	`isDebugfsMounted()` Verifique se o debugfs está montado.
`boolean`	`isDeviceEncrypted()` Retorna se o dispositivo está criptografado.
`boolean`	`isDirectory(String path)` Retorna "True" se o caminho no dispositivo for um diretório. Caso contrário, retorna "False".
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Retorna se a criptografia é compatível com o dispositivo.
`boolean`	`isExecutable(String fullPath)` Retorna "True" se o caminho do arquivo no dispositivo for um arquivo executável. Caso contrário, retorna "False".
`boolean`	`isFastbootEnabled()` Retorna se o fastboot está disponível para o dispositivo.
`boolean`	`isHeadless()` Retorna "true" se o dispositivo for sem tela. Caso contrário, retorna "false".
`boolean`	`isHeadlessSystemUserMode()` Retorna se o dispositivo usa o modo de usuário do sistema headless.
`boolean`	`isMainUserPermanentAdmin()` Retorna se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para o status de não administrador.
`boolean`	`isMultiUserSupported()` Determina se vários usuários são aceitos.
`boolean`	`isPackageInstalled(String packageName, String userId)` Consulte o dispositivo para um determinado nome de pacote e ID de usuário para verificar se ele está instalado ou não para esse usuário.
`boolean`	`isPackageInstalled(String packageName)` Consulte o dispositivo para um determinado nome de pacote e verifique se ele está instalado ou não.
`boolean`	`isRuntimePermissionSupported()` Verificar se a plataforma no dispositivo é compatível com a concessão de permissões de execução
`boolean`	`isStateBootloaderOrFastbootd()` Retorna "true" se o dispositivo estiver em `TestDeviceState.FASTBOOT` ou `TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` Verifica se um determinado usuário está em execução.
`boolean`	`isUserSecondary(int userId)` Retorna se o usuário especificado é secundário de acordo com as flags dele.
`boolean`	`isUserVisible(int userId)` Verifica se o usuário especificado está visível.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` Verifica se o usuário especificado está visível na tela especificada.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano no `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`boolean`	`isVisibleBackgroundUsersSupported()` Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano.
`boolean`	`isWifiEnabled()` Teste se o Wi-Fi está ativado.
	`listDisplayIds()` Colete a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys SurfaceFlinger".
	`listDisplayIdsForStartingVisibleBackgroundUsers()` Recebe a lista de telas que podem ser usadas para `start a user visible in the background`.
	`listUsers()` Recebe a lista de usuários no dispositivo.
`boolean`	`logAnrs(ITestLogger logger)` Coleta e registra erros de ANR do dispositivo.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` Método auxiliar para criar um relatório de bug e registrá-lo para os repórteres.
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Registre uma mensagem no logcat do dispositivo.
`void`	`mountDebugfs()` Monte o debugfs.
`void`	`nonBlockingReboot()` Emite um comando para reiniciar o dispositivo e retorna quando o comando é concluído e quando o dispositivo não está mais visível para o adb.
`void`	`postAdbRootAction()` Substitua se o dispositivo precisar de ações específicas após o adb root e antes de ficar on-line novamente.
`void`	`postAdbUnrootAction()` Substitua se o dispositivo precisar de ações específicas após a remoção do acesso root do adb e antes de o dispositivo voltar a ficar on-line.
`void`	`postBootSetup()` Siga as instruções para configurar o dispositivo para testes após cada inicialização.
`void`	`postInvocationTearDown(Throwable exception)` Etapas extras para limpeza obrigatória específica do dispositivo que será executada após a conclusão da invocação.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Etapas extras para a configuração obrigatória específica do dispositivo que será executada nele antes do fluxo de invocação.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` Extrai recursivamente o conteúdo do diretório do dispositivo.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Extrai recursivamente o conteúdo do diretório do dispositivo.
`boolean`	`pullFile(String remoteFilePath, File localFile)` Recupera um arquivo do dispositivo.
`File`	`pullFile(String remoteFilePath, int userId)` Recupera um arquivo do dispositivo, armazena em um `ERROR(/File)` temporário local e retorna esse `File`.
`File`	`pullFile(String remoteFilePath)` Recupera um arquivo do dispositivo, armazena em um `ERROR(/File)` temporário local e retorna esse `File`.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` Recupera um arquivo do dispositivo.
`String`	`pullFileContents(String remoteFilePath)` Recupera um arquivo do dispositivo e retorna o conteúdo.
`File`	`pullFileFromExternal(String remoteFilePath)` Um método conveniente para recuperar um arquivo do armazenamento externo do dispositivo, armazená-lo em um `ERROR(/File)` temporário local e retornar uma referência a esse `File`.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Envie recursivamente o conteúdo do diretório para o dispositivo, excluindo alguns diretórios que são filtrados.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` Envie o conteúdo do diretório de maneira recursiva para o dispositivo.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` Envie o conteúdo do diretório de maneira recursiva para o dispositivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` Variante de `pushFile(File, String)` que pode considerar opcionalmente a avaliação da necessidade para o provedor de conteúdo.
`boolean`	`pushFile(File localFile, String remoteFilePath)` Envie um arquivo por push para o dispositivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Envie um arquivo por push para o dispositivo.
`boolean`	`pushString(String contents, String remoteFilePath)` Enviar arquivo criado de uma string para o dispositivo
`void`	`reboot(String reason)` Reinicializa o dispositivo no modo adb com o `reason` especificado para ser mantido durante a reinicialização.
`void`	`reboot()` Reinicializa o dispositivo no modo adb.
`void`	`rebootIntoBootloader()` Reinicializa o dispositivo no modo bootloader.
`void`	`rebootIntoFastbootd()` Reinicializa o dispositivo no modo fastbootd.
`void`	`rebootIntoRecovery()` Reinicializa o dispositivo no modo de recuperação do adb.
`void`	`rebootIntoSideload()` Reinicializa o dispositivo no modo adb sideload (observe que esse é um modo especial em recuperação) Bloqueia até que o dispositivo entre no modo de sideload
`void`	`rebootIntoSideload(boolean autoReboot)` Reinicializa o dispositivo no modo adb sideload (observe que esse é um modo especial em recuperação) Bloqueia até que o dispositivo entre no modo de sideload
`void`	`rebootUntilOnline()` Uma alternativa a `reboot()` que bloqueia apenas até que o dispositivo esteja on-line, ou seja, visível para o adb.
`void`	`rebootUntilOnline(String reason)` Uma alternativa a `reboot()` que bloqueia apenas até que o dispositivo esteja on-line, ou seja, visível para o adb.
`void`	`rebootUserspace()` Reinicializa apenas a parte do espaço do usuário do dispositivo.
`void`	`rebootUserspaceUntilOnline()` Uma alternativa a `rebootUserspace()` ()} que só bloqueia até que o dispositivo esteja on-line, ou seja, visível para o adb.
`boolean`	`recoverDevice()` Tenta recuperar a comunicação do dispositivo.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Registra um `IDeviceActionReceiver` para este dispositivo.
`void`	`remountSystemReadOnly()` Deixe a partição do sistema no dispositivo como somente leitura.
`void`	`remountSystemWritable()` Torne a partição do sistema no dispositivo gravável.
`void`	`remountVendorReadOnly()` Defina a partição do fornecedor no dispositivo como somente leitura.
`void`	`remountVendorWritable()` Torne a partição do fornecedor no dispositivo gravável.
`boolean`	`removeAdmin(String componentName, int userId)` Remova o administrador de dispositivo do usuário especificado e retorne `true` se a operação for bem-sucedida ou `false` caso contrário.
`void`	`removeOwners()` Remova todos os proprietários de perfis de dispositivos atuais com o melhor esforço.
`boolean`	`removeUser(int userId)` Remova um usuário específico do dispositivo.
`void`	`resetContentProviderSetup()` Redefina a flag para a configuração do provedor de conteúdo e acione-a novamente.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Método conveniente para realizar `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` com um ou mais listeners transmitidos como parâmetros.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` Executa testes de instrumentação e oferece recuperação de dispositivos.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` Igual a `ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))`, mas executa o teste para o usuário especificado.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` Igual a `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, mas executa o teste para um determinado usuário.
`void`	`setAdbPath(String adbPath)` Define o caminho para o binário adb que deve ser usado.
`void`	`setConfiguration(IConfiguration configuration)` Injeta o `IConfiguration` em uso.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` Define a data no dispositivo. Observação: definir a data no dispositivo requer acesso root
`boolean`	`setDeviceOwner(String componentName, int userId)` Defina um componente de administrador do dispositivo como proprietário do dispositivo para um determinado usuário.
`void`	`setDeviceState(TestDeviceState deviceState)` Atualize o estado do dispositivo.
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` Para o emulador, defina `SizeLimitedOutputStream` como saída de registro
`void`	`setEmulatorProcess(Process p)` Define o `Process` quando o dispositivo é um emulador.
`void`	`setFastbootEnabled(boolean fastbootEnabled)` Defina a opção fastboot para o dispositivo.
`void`	`setFastbootPath(String fastbootPath)` Define o caminho para o binário fastboot que precisa ser usado.
`void`	`setIDevice(IDevice newDevice)` Atualiza o IDevice associado a este ITestDevice.
`void`	`setLogStartDelay(int delay)` Define o tempo em ms para aguardar antes de iniciar a captura do logcat em um dispositivo on-line.
`void`	`setOptions(TestDeviceOptions options)` Definir o `TestDeviceOptions` para o dispositivo
`boolean`	`setProperty(String propKey, String propValue)` Define o valor da propriedade especificada no dispositivo.
`void`	`setRecovery(IDeviceRecovery recovery)` Defina o `IDeviceRecovery` a ser usado neste dispositivo.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Define o modo de recuperação atual a ser usado no dispositivo.
`void`	`setSetting(String namespace, String key, String value)` Consulte `setSetting(int, String, String, String)` e executado no usuário do sistema.
`void`	`setSetting(int userId, String namespace, String key, String value)` Adiciona um valor de configuração ao namespace de um determinado usuário.
`void`	`setTestLogger(ITestLogger testLogger)` Injeta a instância `ITestLogger`.
`void`	`setTrackingSerial(String trackingSerial)` Para fins de gerenciamento de dispositivos, rastreamos o número de série que usamos para fazer referência ao dispositivo.
`void`	`setUseFastbootErase(boolean useFastbootErase)` Defina se você quer usar "fastboot erase" ou "fastboot format" para limpar uma partição no dispositivo.
`void`	`startLogcat()` Comece a capturar a saída do logcat do dispositivo em segundo plano.
`boolean`	`startTradeInModeTesting(int timeoutMs)` Ativa o modo de teste de troca.
`boolean`	`startUser(int userId)` Inicia um determinado usuário em segundo plano se ele estiver parado.
`boolean`	`startUser(int userId, boolean waitFlag)` Inicia um determinado usuário em segundo plano se ele estiver parado.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` Inicia um determinado usuário em segundo plano, visível na tela especificada (ou seja, permitindo que o usuário inicie atividades nessa tela).
`void`	`stopEmulatorOutput()` Feche e exclua a saída do emulador.
`void`	`stopLogcat()` Interrompe a captura da saída do logcat do dispositivo e descarta os dados do logcat salvos no momento.
`void`	`stopTradeInModeTesting()` Interrompa o teste do modo de troca.
`boolean`	`stopUser(int userId)` Interrompe um determinado usuário.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Interrompe um determinado usuário.
`String`	`switchToAdbTcp()` Mude o dispositivo para o modo adb-over-tcp.
`boolean`	`switchToAdbUsb()` Coloque o dispositivo no modo adb por USB.
`boolean`	`switchUser(int userId)` Mude para outro userId com um tempo limite padrão.
`boolean`	`switchUser(int userId, long timeout)` Mude para outro userId com o tempo limite fornecido como prazo.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Sincroniza incrementalmente o conteúdo de um diretório de arquivos local com o dispositivo.
`Bugreport`	`takeBugreport()` Recebe um bugreport e o retorna em um objeto `Bugreport` para processamento.
`String`	`uninstallPackage(String packageName)` Desinstala um pacote Android do dispositivo.
`String`	`uninstallPackageForUser(String packageName, int userId)` Desinstala um pacote Android do dispositivo para um determinado usuário.
`boolean`	`unlockDevice()` Desbloqueia o dispositivo se ele estiver criptografado.
`void`	`unmountDebugfs()` Desmonte o debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Bloqueia até que a flag de conclusão da inicialização do dispositivo seja definida.
`boolean`	`waitForDeviceAvailable()` Aguarde até que o dispositivo esteja responsivo e disponível para testes.
`boolean`	`waitForDeviceAvailable(long waitTime)` Aguarde até que o dispositivo esteja responsivo e disponível para testes.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Espera que o dispositivo responda e esteja disponível sem considerar o caminho de recuperação.
`void`	`waitForDeviceBootloader()` Bloqueia até que o dispositivo fique visível via fastboot.
`void`	`waitForDeviceFastbootD()`
`boolean`	`waitForDeviceInRecovery(long waitTime)` Bloqueia para que o dispositivo esteja no estado "adb recovery". Isso é diferente de `IDeviceRecovery`.
`boolean`	`waitForDeviceInSideload(long waitTime)` Bloqueia para que o dispositivo fique no estado "adb sideload".
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Bloqueia para que o dispositivo não esteja disponível, ou seja, ausente do adb.
`void`	`waitForDeviceOnline()` Bloqueia até que o dispositivo fique visível via adb.
`void`	`waitForDeviceOnline(long waitTime)` Bloqueia até que o dispositivo fique visível via adb.
`boolean`	`waitForDeviceShell(long waitTime)` Aguarde até que o dispositivo responda a um comando básico do shell adb.

Métodos protegidos
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` Cria o comando do SO para a sessão e os argumentos do comando adb shell especificados.
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` Crie um `RebootDeviceAction` para ser usado ao realizar uma ação de reinicialização.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Faça uma reinicialização do adb.
`void`	`ensureRuntimePermissionSupported()` Método auxiliar para gerar exceção se a permissão de tempo de execução não for compatível.
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` Receba a instância `RunUtil` para usar.
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Busca uma propriedade do dispositivo, do cache ddmlib por padrão, e volta para "adb shell getprop" ou "fastboot getvar", dependendo se o dispositivo está no Fastboot ou não.
`boolean`	`isInRebootCallback()` Retorna se os callbacks de reinicialização estão sendo executados ou não.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Retorna `true` se o arquivo local for mais recente que o arquivo remoto.
`void`	`notifyRebootEnded()` Notifica todos os `IDeviceActionReceiver` sobre o evento de término da reinicialização.
`void`	`notifyRebootStarted()` Notifica todos os `IDeviceActionReceiver` sobre o evento de início da reinicialização.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Realiza uma ação neste dispositivo.
`void`	`postAdbReboot(NativeDevice.RebootMode rebootMode)` Possíveis ações extras que podem ser realizadas após uma reinicialização.
`void`	`prePostBootSetup()` Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) substitua esse método para configuração específica após a inicialização.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Defina a instância de Clock a ser usada.
`void`	`setMicrodroidProcess(Process process)` Marca o TestDevice como microdroid e define o CID dele.
`void`	`setTestDeviceOptions( deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)` Executa um comando fastboot simples com variáveis de ambiente e informa o status do comando.
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` Executa um comando fastboot simples e informa o status dele.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` Aguarde até que o dispositivo fique indisponível (pare de gerar relatórios para o adb).

Constantes

DEBUGFS_PATH

public static final String DEBUGFS_PATH

Valor da constante: "/sys/kernel/debug"

INVALID_USER_ID

public static final int INVALID_USER_ID

Valor retornado para qualquer ID de usuário inválido/não encontrado: UserHandle definiu o valor -10000

Valor da constante: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Valor da constante: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

o número padrão de tentativas de repetição de comando a serem realizadas

Valor da constante: 2 (0x00000002)

SD_CARD

protected static final String SD_CARD

Valor da constante: "/sdcard/"

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

Valor da constante: "/storage/emulated/"

Campos

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Construtores públicos

NativeDevice

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Cria um TestDevice.

Parâmetros
`device`	`IDevice`: o `IDevice` associado
`stateMonitor`	`IDeviceStateMonitor`: o mecanismo `IDeviceStateMonitor` a ser usado
`allocationMonitor`	`IDeviceMonitor`: o `IDeviceMonitor` para informar sobre mudanças no estado de alocação. Pode ser nulo

Métodos públicos

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Micro otimização (cerca de 400 milissegundos) pré-buscando todas as propriedades necessárias em vez de chamar "adb getprop" para cada uma. Ou seja, é tão rápido buscar todas as propriedades quanto buscar uma. Funções como device.getApiLevel(), checkApiLevelAgainstNextRelease e getBuildAlias chamam `adb getprop` nos bastidores. Buscamos em uma chamada e chamamos NativeDevice.setProperty. Mesmo que não façamos isso, o NativeDevice vai chamar setProperty e armazenar em cache o resultado para futuras chamadas. Só estamos fazendo isso um pouco antes. Se o dispositivo estiver em recuperação ou houver outros erros ao buscar as propriedades, vamos ignorá-los.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Retorna se é permitido mudar para o usuário SYSTEM headless.

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Verifica se um recurso é compatível com um nível de suporte mínimo. Esse método considera recursos não lançados antes do aumento do nível da API.

Parâmetros
`strictMinLevel`	`int`: o nível mínimo possível que oferece suporte ao recurso.

Retorna
`boolean`	Verdadeiro se o nível for compatível. Caso contrário, retorna "falso".

Gera
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

Verifique se o dispositivo tem conectividade de rede.

Retorna
`boolean`	`true` se o dispositivo tiver uma conexão de rede ativa, `false` caso contrário.

Gera
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

Tente dispensar todas as caixas de diálogo de erro exibidas na interface do dispositivo.

Retorna
`boolean`	`true` se não houver caixas de diálogo ou se elas forem limpas. `false` se não forem.

Gera
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Limpa a última rede Wi-Fi conectada. Isso deve ser chamado ao iniciar uma nova invocação para evitar a conexão com a rede Wi-Fi usada no teste anterior após a reinicialização do dispositivo.

clearLogcat

public void clearLogcat ()

Exclui todos os dados acumulados do logcat.

Isso é útil para casos em que você quer garantir que ITestDevice.getLogcat() retorne apenas dados de registro produzidos após um determinado ponto (como depois de atualizar uma nova versão do dispositivo etc.).

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Conecta-se a uma rede Wi-Fi.

Ativa o Wi-Fi e bloqueia até que uma conexão seja feita com uma das redes Wi-Fi fornecidas no mapa wifiSsidToPsk. Depois que uma conexão é estabelecida, a instância tenta restaurar a conexão após cada reinicialização até que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
`wifiSsidToPsk`	: um mapa de SSIDs de Wi-Fi para senhas.
`scanSsid`	`boolean`: se é necessário verificar SSIDs ocultos para esta rede.

Retorna
`boolean`	`true` se a conexão com a rede Wi-Fi for bem-sucedida. `false` caso contrário

Gera
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Conecta-se a uma rede Wi-Fi.

Ativa o Wi-Fi e bloqueia até que uma conexão seja feita com a rede Wi-Fi especificada. Depois que uma conexão é estabelecida, a instância tenta restaurá-la após cada reinicialização até que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
`wifiSsid`	`String`: o SSID do Wi-Fi a que você quer se conectar
`wifiPsk`	`String`: senha PSK ou nula se não estiver criptografada

Retorna
`boolean`	`true` se a conexão com a rede Wi-Fi for bem-sucedida. `false` caso contrário

Gera
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Conecta-se a uma rede Wi-Fi.

Parâmetros
`wifiSsidToPsk`	: um mapa de SSIDs de Wi-Fi para senhas.

Retorna
`boolean`	`true` se a conexão com a rede Wi-Fi for bem-sucedida. `false` caso contrário

Gera
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Conecta-se a uma rede Wi-Fi.

Parâmetros
`wifiSsid`	`String`: o SSID do Wi-Fi a que você quer se conectar
`wifiPsk`	`String`: senha PSK ou nula se não estiver criptografada
`scanSsid`	`boolean`: se é necessário verificar o SSID oculto dessa rede.

Retorna
`boolean`	`true` se a conexão com a rede Wi-Fi for bem-sucedida. `false` caso contrário

Gera
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Uma variante de connectToWifiNetwork(String, String) que só se conecta se o dispositivo não tiver conectividade de rede no momento.

Parâmetros
`scanSsid`	`boolean`: se é necessário verificar o SSID oculto desta rede

Retorna
`boolean`	`true` se a conexão com a rede Wi-Fi for bem-sucedida. `false` caso contrário

Gera
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Uma variante de connectToWifiNetwork(String, String) que só se conecta se o dispositivo não tiver conectividade de rede no momento.

Retorna
`boolean`	`true` se a conexão com a rede Wi-Fi for bem-sucedida. `false` caso contrário

Gera
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Crie um usuário com um nome e as flags fornecidas.

Parâmetros
`name`	`String`: do usuário a ser criado no dispositivo
`guest`	`boolean`: ative a flag do usuário --guest durante a criação
`ephemeral`	`boolean`: ative a flag do usuário --ephemeral durante a criação

Retorna
`int`	ID do usuário criado.

Gera
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Crie um usuário com um nome e as flags fornecidas.

Parâmetros
`name`	`String`: do usuário a ser criado no dispositivo
`guest`	`boolean`: ative a flag do usuário --guest durante a criação
`ephemeral`	`boolean`: ative a flag do usuário --ephemeral durante a criação
`forTesting`	`boolean`: ative a flag de teste --for-testing durante a criação

Retorna
`int`	ID do usuário criado.

Gera
`DeviceNotAvailableException`

createUser

public int createUser (String name)

Crie um usuário com um nome específico e flags padrão 0.

Parâmetros
`name`	`String`: do usuário a ser criado no dispositivo

Retorna
`int`	o número inteiro do ID do usuário criado

Gera
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

Crie um usuário com um nome específico e flags padrão 0.

Parâmetros
`name`	`String`: do usuário a ser criado no dispositivo

Retorna
`int`	o número inteiro do ID do usuário criado ou -1 em caso de erro.

Gera
`DeviceNotAvailableException`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

Inspecionar um dispositivo e retornar informações detalhadas quando ele ficar indisponível.

Retorna
`DeviceInspectionResult`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

Método auxiliar para excluir um arquivo ou diretório no dispositivo.

Parâmetros
`deviceFilePath`	`String`: o caminho absoluto do arquivo no dispositivo.
`userId`	`int`: o ID do usuário a ser excluído de

Gera
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath)

Método auxiliar para excluir um arquivo ou diretório no dispositivo.

Parâmetros
`deviceFilePath`	`String`: o caminho absoluto do arquivo no dispositivo.

Gera
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Remove o IDeviceActionReceiver registrado.

Parâmetros
`deviceActionReceiver`	`IDeviceActionReceiver`: uma `IDeviceActionReceiver` que será removida.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Método auxiliar para verificar se o dispositivo foi reiniciado por software comparando o system_server atual com o system_server anterior ProcessInfo. Use getProcessByName(String) para receber ProcessInfo.

Parâmetros
`prevSystemServerProcess`	`ProcessInfo`: o processo system_server anterior `ProcessInfo`.

Retorna
`boolean`	`true` se o dispositivo for reiniciado de forma suave

Gera
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Método auxiliar para verificar se o dispositivo foi reiniciado por software desde o horário UTC desde a época do dispositivo e seu ERROR(/TimeUnit). A reinicialização suave se refere ao system_server reiniciado fora de uma reinicialização forçada do dispositivo (por exemplo, uma reinicialização solicitada). O utcEpochTime do dispositivo atual em milissegundos pode ser obtido pelo método getDeviceDate().

Parâmetros
`utcEpochTime`	`long`: o horário do dispositivo em segundos desde o período.
`timeUnit`	`TimeUnit`: a unidade de tempo `TimeUnit` para o utcEpochTime especificado.

Retorna
`boolean`	`true` se o dispositivo for reiniciado de forma suave

Gera
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

Desativa o adb root.

Desativar o adb root pode fazer com que o dispositivo se desconecte do adb. Esse método será bloqueado até que o dispositivo esteja disponível.

Retorna
`boolean`	`true` se for bem-sucedido.

Gera
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

Tenta desativar o keyguard.

Primeiro, aguarde a preparação do envio de entrada. Isso acontece aproximadamente ao mesmo tempo em que o dispositivo informa BOOT_COMPLETE, aparentemente de forma assíncrona, porque a implementação atual do framework tem uma condição de corrida ocasional. Em seguida, o comando é enviado para dispensar o keyguard (funciona apenas em dispositivos não seguros)

Gera
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Desativa o monitoramento de rede no dispositivo.

Retorna
`boolean`	`true` se o monitoramento for desativado. `false` se houver falha.

Gera
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

Desconecta de uma rede Wi-Fi.

Remove todas as redes da lista de redes conhecidas e desativa o Wi-Fi.

Retorna
`boolean`	`true` se a desconexão da rede Wi-Fi for bem-sucedida. `false` se a desconexão falhar.

Gera
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Método auxiliar para determinar se o arquivo no dispositivo existe para um determinado usuário.

Parâmetros
`deviceFilePath`	`String`: o caminho absoluto do arquivo no dispositivo a ser verificado
`userId`	`int`: o ID do usuário em relação ao qual a existência do arquivo será verificada

Retorna
`boolean`	`true` se o arquivo existir, `false` caso contrário.

Gera
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Método auxiliar para determinar se o arquivo existe no dispositivo.

Parâmetros
`deviceFilePath`	`String`: o caminho absoluto do arquivo no dispositivo a ser verificado

Retorna
`boolean`	`true` se o arquivo existir, `false` caso contrário.

Gera
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Tente despejar o heap do system_server. É responsabilidade do chamador limpar o arquivo despejado.

Parâmetros
`process`	`String`: o nome do processo do dispositivo em que o dumpheap será executado.
`devicePath`	`String`: o caminho no dispositivo onde colocar o despejo. Esse precisa ser um local em que as permissões permitem isso.

Retorna
`File`	o `ERROR(/File)` que contém o relatório. Nulo se algo falhar.

Gera
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

Ativa o adb root. Se a configuração "enable-root" for "false", uma mensagem será registrada e retornada sem ativar o acesso root.

Ativar o adb root pode fazer com que o dispositivo se desconecte do adb. Esse método será bloqueado até que o dispositivo esteja disponível.

Retorna
`boolean`	`true` se for bem-sucedido.

Gera
`DeviceNotAvailableException`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Ativa o monitoramento de rede no dispositivo.

Retorna
`boolean`	`true` se o monitoramento for ativado. `false` se houver falha.

Gera
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

Parâmetros
`timeout`	`long`: o tempo em milissegundos antes de o dispositivo ser considerado sem resposta, 0L para sem tempo limite.
`cmdArgs`	`String`: o comando adb e os argumentos a serem executados

Retorna
`String`	o stdout do comando. `null` se o comando não for executado.

Gera
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

Parâmetros
`timeout`	`long`: o tempo em milissegundos antes de o dispositivo ser considerado sem resposta, 0L para sem tempo limite.
`envMap`	: ambiente a ser definido para o comando
`cmdArgs`	`String`: o comando adb e os argumentos a serem executados

Retorna
`String`	o stdout do comando. `null` se o comando não for executado.

Gera
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

Método auxiliar que executa um comando adb como um comando do sistema.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

Parâmetros
`cmdArgs`	`String`: o comando adb e os argumentos a serem executados

Retorna
`String`	o stdout do comando. `null` se o comando não for executado.

Gera
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

Método auxiliar que executa um comando adb como um comando do sistema.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

Parâmetros
`cmdArgs`	`String`: o comando adb e os argumentos a serem executados

Retorna
`CommandResult`	o CommandResult que contém a saída do comando.

Gera
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                String... cmdArgs)

Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

Parâmetros
`timeout`	`long`: o tempo em milissegundos antes de o dispositivo ser considerado sem resposta, 0L para sem tempo limite.
`cmdArgs`	`String`: o comando adb e os argumentos a serem executados

Retorna
`CommandResult`	o CommandResult que contém a saída do comando.

Gera
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... cmdArgs)

Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

Parâmetros
`timeout`	`long`: o tempo em milissegundos antes de o dispositivo ser considerado sem resposta, 0L para sem tempo limite.
`envMap`	: ambiente a ser definido para o comando
`cmdArgs`	`String`: o comando adb e os argumentos a serem executados

Retorna
`CommandResult`	o CommandResult que contém a saída do comando.

Gera
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

Método auxiliar que executa um comando fastboot como um comando do sistema com um tempo limite padrão de 2 minutos.

Deve ser usado quando o dispositivo já está no modo fastboot.

Parâmetros
`cmdArgs`	`String`: o comando fastboot e os argumentos a serem executados

Retorna
`CommandResult`	o CommandResult que contém a saída do comando

Gera
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

Método auxiliar que executa um comando fastboot como um comando do sistema.

Deve ser usado quando o dispositivo já está no modo fastboot.

Parâmetros
`timeout`	`long`: o tempo em milissegundos antes de o comando expirar.
`cmdArgs`	`String`: o comando fastboot e os argumentos a serem executados

Retorna
`CommandResult`	o CommandResult que contém a saída do comando

Gera
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema.

Idêntico a executeFastbootCommand(String), exceto por usar um tempo limite maior.

Parâmetros
`cmdArgs`	`String`: o comando fastboot e os argumentos a serem executados

Retorna
`CommandResult`	o CommandResult que contém a saída do comando

Gera
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema com variáveis de ambiente do sistema.

Idêntico a executeFastbootCommand(String), exceto por usar um tempo limite maior.

Parâmetros
`envVarMap`	: as variáveis de ambiente do sistema com que o comando fastboot é executado.
`cmdArgs`	`String`: o comando fastboot e os argumentos a serem executados

Retorna
`CommandResult`	o CommandResult que contém a saída do comando

Gera
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

Método auxiliar que executa um comando do shell adb e retorna a saída como um String.

Parâmetros
`command`	`String`: o comando adb shell a ser executado

Retorna
`String`	a saída do shell

Gera
`DeviceNotAvailableException`

executeShellCommand

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

Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.

Parâmetros
`command`	`String`: o comando adb shell a ser executado
`receiver`	`IShellOutputReceiver`: o `IShellOutputReceiver` para direcionar a saída do shell.
`maxTimeToOutputShellResponse`	`long`: o período máximo em que o comando pode ficar sem gerar uma resposta. A unidade é especificada em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade para `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de novas tentativas de execução do comando se ele falhar devido a uma exceção. A exceção "DeviceNotResponsiveException" será gerada se `retryAttempts` forem executadas sem sucesso.

Gera
`DeviceNotAvailableException`

executeShellCommand

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

Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.

Parâmetros
`command`	`String`: o comando adb shell a ser executado
`receiver`	`IShellOutputReceiver`: o `IShellOutputReceiver` para direcionar a saída do shell.
`maxTimeoutForCommand`	`long`: o tempo limite máximo para a conclusão do comando; unidade conforme especificado em `timeUnit`.
`maxTimeToOutputShellResponse`	`long`: o período máximo em que o comando pode ficar sem gerar uma resposta. A unidade é especificada em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade para `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de novas tentativas de execução do comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será gerado se `retryAttempts` forem executados sem sucesso.

Gera
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Executa o comando adb shell especificado, tentando várias vezes se o comando falhar.

Uma forma mais simples de executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) com valores padrão.

Parâmetros
`command`	`String`: o comando adb shell a ser executado
`receiver`	`IShellOutputReceiver`: o `IShellOutputReceiver` para direcionar a saída do shell.

Gera
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

Método auxiliar que executa um comando do shell adb e retorna os resultados como um CommandResult preenchido corretamente com a saída de status do comando, stdout e stderr.

Parâmetros
`cmd`	`String`: o comando a ser executado.

Retorna
`CommandResult`	O resultado em `CommandResult`.

Gera
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Método auxiliar que executa um comando do shell adb e retorna os resultados como um CommandResult corretamente preenchido com a saída do status do comando e stderr. stdout é direcionado para o fluxo especificado.

Parâmetros
`cmd`	`String`: o comando a ser executado.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` em que a saída padrão será redirecionada ou nula.

Retorna
`CommandResult`	O resultado em `CommandResult`.

Gera
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Método auxiliar que executa um comando do shell adb e retorna os resultados como um CommandResult corretamente preenchido com a saída do status do comando, stdout e stderr.

Parâmetros
`cmd`	`String`: o comando a ser executado.
`pipeAsInput`	`File`: um `ERROR(/File)` que será transmitido como entrada para o comando ou nulo.

Retorna
`CommandResult`	O resultado em `CommandResult`.

Gera
`DeviceNotAvailableException`

executeShellV2Command

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

Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.

Parâmetros
`cmd`	`String`: o comando adb shell a ser executado
`maxTimeoutForCommand`	`long`: o tempo limite máximo para a conclusão do comando; unidade conforme especificado em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade para `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de novas tentativas de execução do comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será gerado se `retryAttempts` forem executados sem sucesso.

Retorna
`CommandResult`

Gera
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.

Parâmetros
`cmd`	`String`: o comando adb shell a ser executado
`maxTimeoutForCommand`	`long`: o tempo limite máximo para a conclusão do comando; unidade conforme especificado em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade para `maxTimeToOutputShellResponse`

Retorna
`CommandResult`

Gera
`DeviceNotAvailableException`

executeShellV2Command

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

Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.

Parâmetros
`cmd`	`String`: o comando adb shell a ser executado
`pipeAsInput`	`File`: um `ERROR(/File)` que será transmitido como entrada para o comando ou nulo.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` em que a saída padrão será redirecionada ou nula.
`maxTimeoutForCommand`	`long`: o tempo limite máximo para a conclusão do comando; unidade conforme especificado em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade para `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de novas tentativas de execução do comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será gerado se `retryAttempts` forem executados sem sucesso.

Retorna
`CommandResult`

Gera
`DeviceNotAvailableException`

executeShellV2Command

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

Executa um comando adb shell com mais parâmetros para controlar o comportamento do comando.

Parâmetros
`cmd`	`String`: o comando adb shell a ser executado
`pipeAsInput`	`File`: um `ERROR(/File)` que será transmitido como entrada para o comando ou nulo.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` em que a saída padrão será redirecionada ou nula.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)` em que o erro padrão será redirecionado ou nulo.
`maxTimeoutForCommand`	`long`: o tempo limite máximo para a conclusão do comando; unidade conforme especificado em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade para `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de novas tentativas de execução do comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será gerado se `retryAttempts` forem executados sem sucesso.

Retorna
`CommandResult`

Gera
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

Método auxiliar que apaga uma partição do dispositivo.

Se getUseFastbootErase() for true, o comando fastboot erase será usado para limpar a partição. O dispositivo vai criar um sistema de arquivos na próxima vez que for inicializado. Caso contrário, o formato fastboot será usado, o que vai criar um novo sistema de arquivos no dispositivo.

Deve ser usado quando o dispositivo já está no modo fastboot.

Parâmetros
`partition`	`String`: a partição a ser apagada

Retorna
`CommandResult`	o CommandResult que contém a saída do comando

Gera
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

Busca as informações sobre os APEXs ativados no dispositivo.

Retorna
	`ERROR(/Set)` de `ApexInfo` ativados no dispositivo

Gera
`DeviceNotAvailableException`

getAdbPath

public String getAdbPath ()

Retorna o caminho do binário adb que está sendo usado.

Retorna
`String`

getAllSettings

public  getAllSettings (String namespace)

Retorna pares de chave-valor do namespace solicitado.

Parâmetros
`namespace`	`String`: precisa ser um dos valores {"system", "secure", "global"}

Retorna
	o mapa de pares de chave-valor. Nulo se o namespace não for compatível.

Gera
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Retorna o estado de alocação atual do dispositivo.

Retorna
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

Encontra e retorna o android-id associado a um userId. Retorna nulo se não for encontrado.

Parâmetros
`userId`	`int`

Retorna
`String`

Gera
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Crie um mapa de IDs do Android que correspondem aos IDs de usuário. Não há garantia de que cada ID de usuário vai encontrar um ID do Android associado a essa função. Portanto, alguns IDs de usuário podem corresponder a "null".

Retorna
	Mapa de IDs do Android encontrados que correspondem a IDs de usuário.

Gera
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

Recebe o nível da API do dispositivo. O valor padrão é UNKNOWN_API_LEVEL.

Retorna
`int`	um número inteiro que indica o nível de API do dispositivo

Gera
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Busca informações sobre um pacote instalado no dispositivo.

Parâmetros
`packageName`	`String`

Retorna
`PackageInfo`	o `PackageInfo` ou `null` se não for possível recuperar as informações

Gera
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

Busca informações de pacotes instalados no dispositivo.

Retorna
	`ERROR(/List)` de `PackageInfo`s instalados no dispositivo.

Gera
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

Método de conveniência para receber a versão da banda de base (rádio) deste dispositivo. A versão do rádio é específica do dispositivo, então pode não retornar as informações corretas para todos os dispositivos. Esse método depende da propriedade gsm.version.baseband para retornar as informações corretas da versão. Isso não é preciso para alguns dispositivos CDMA, e a versão retornada aqui pode não corresponder à versão informada pelo fastboot e pode não retornar a versão do rádio CDMA. Resumindo, esse método só informa a versão correta se a propriedade gsm.version.baseband for a mesma que a versão retornada por fastboot getvar version-baseband.

Retorna
`String`	a versão da banda de base `String` ou `null` se não for possível determinar (o dispositivo não tem rádio ou a string de versão não pode ser lida)

Gera
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

Retorna o nível atual da bateria de um dispositivo ou Null se o nível da bateria não estiver disponível.

Retorna
`Integer`

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Retorna o valor booleano da propriedade especificada.

Parâmetros
`name`	`String`: o nome da propriedade
`defaultValue`	`boolean`: valor padrão a ser retornado se a propriedade estiver vazia ou não existir.

Retorna
`boolean`	`true` se a propriedade tiver o valor `"1"`, `"y"`, `"yes"`, `"on"` ou `"true"`, `false` se a propriedade tiver o valor `"0"`, `"n"`, `"no"`, `"off"`, `"false"` ou `defaultValue` caso contrário.

Gera
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização.

Retorna
	Mapa do tempo de inicialização (horário UTC em segundos desde a época) e motivo da inicialização.

Gera
`DeviceNotAvailableException`

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização desde o tempo especificado desde a época do dispositivo e a unidade de tempo especificada. O utcEpochTime do dispositivo atual em milissegundos pode ser obtido pelo método getDeviceDate().

Parâmetros
`utcEpochTime`	`long`: o tempo do dispositivo desde a Era Unix.
`timeUnit`	`TimeUnit`: a unidade de tempo `TimeUnit`.

Retorna
	Mapa do tempo de inicialização (horário UTC em segundos desde a época) e motivo da inicialização.

Gera
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

Método conveniente para receber a versão do carregador de inicialização deste dispositivo.

Tenta recuperar a versão do carregador de inicialização do estado atual do dispositivo. (ou seja, se o dispositivo estiver no modo fastboot, ele tentará recuperar a versão do fastboot)

Retorna
`String`	a versão do carregador de inicialização `String` ou `null` se não for possível encontrá-la

Gera
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

Recupera um relatório do bug do dispositivo.

A implementação disso tem garantia de continuar funcionando em um dispositivo sem um cartão SD (ou em que o cartão SD ainda não está montado).

Retorna
`InputStreamSource`	Um `InputStreamSource` que vai produzir o conteúdo do bugreport on demand. Em caso de falha, o `InputStreamSource` vai produzir um `ERROR(/InputStream)` vazio.

getBugreportz

public InputStreamSource getBugreportz ()

Recupera um bugreportz do dispositivo. O relatório de bug no formato ZIP contém o relatório principal e outros arquivos de registro úteis para depuração.

Compatível apenas com "adb version" > 1.0.36

Retorna
`InputStreamSource`	um `InputStreamSource` do arquivo ZIP que contém o bugreportz. Retorne nulo em caso de falha.

getBuildAlias

public String getBuildAlias ()

Recupera o alias da build que o dispositivo está executando no momento.

O alias de build geralmente é uma string mais legível do que o ID de build (normalmente um número para builds do Nexus). Por exemplo, a versão final do Android 4.2 tem o alias de build JDQ39 e o ID de build 573038

Retorna
`String`	o alias da build ou o ID da build se não for possível recuperá-lo

Gera
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Recupere a variante de build do dispositivo.

Retorna
`String`	o sabor do build ou nulo se não for possível recuperá-lo

Gera
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

Recupere o build que o dispositivo está executando no momento.

Retorna
`String`	o ID do build ou `IBuildInfo.UNKNOWN_BUILD_ID` se não for possível recuperá-lo

Gera
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

Retorna o tipo de chave usado para assinar a imagem do dispositivo.

Normalmente, os dispositivos Android podem ser assinados com chaves de teste (como no AOSP) ou chaves de lançamento (controladas por fabricantes de dispositivos individuais).

Retorna
`String`	A chave de assinatura, se encontrada. Caso contrário, será nulo.

Gera
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Retorna um DeviceDescriptor em cache se o dispositivo estiver alocado. Caso contrário, retorna o DeviceDescriptor atual.

Retorna
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Retorna um DeviceDescriptor em cache se o dispositivo estiver alocado. Caso contrário, retorna o DeviceDescriptor atual.

Parâmetros
`shortDescriptor`	`boolean`: se o descritor deve ser limitado ao mínimo de informações

Retorna
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

Alternativa ao uso de IFileEntry, que às vezes não funciona devido a permissões.

Parâmetros
`path`	`String`: é o caminho no dispositivo em que a pesquisa será feita.

Retorna
`String[]`	Matriz de string que contém todos os arquivos em um caminho no dispositivo.

Gera
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

A conexão atual associada ao dispositivo.

Retorna
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Retorna o ContentProviderHandler ou nulo se não estiver disponível.

O provedor de conteúdo pode ser reutilizado se tiver sido construído antes com o mesmo userId.

Parâmetros
`userId`	`int`: o ID do usuário para inicializar o provedor de conteúdo.

Retorna
`ContentProviderHandler`

Gera
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Retorna o estado dobrável atual do dispositivo ou nulo se ocorrerem problemas.

Retorna
`DeviceFoldableState`

Gera
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Retorna o ID do usuário em execução no momento. Em caso de erro, retorne -10000.

Retorna
`int`

Gera
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

Receba a classe do dispositivo.

Retorna
`String`	a classe de dispositivo `String`.

getDeviceDate

public long getDeviceDate ()

Retorna a data do dispositivo em milissegundos desde o período.

Retorna
`long`	a data do dispositivo no formato de época.

Gera
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Retorna um DeviceDescriptor das informações do dispositivo para receber informações sobre ele sem transmitir o objeto do dispositivo real.

Retorna
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Retorna um DeviceDescriptor das informações do dispositivo para receber informações sobre ele sem transmitir o objeto do dispositivo real.

Parâmetros
`shortDescriptor`	`boolean`: se o descritor deve ser limitado ao mínimo de informações

Retorna
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

Acessa o estado do dispositivo.

Retorna
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Auxiliar para receber a diferença de horário entre o dispositivo e um determinado ERROR(/Date). Use o tempo de época internamente.

Parâmetros
`date`	`Date`

Retorna
`long`	a diferença em milissegundos

Gera
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Receber o fluxo de stdout e stderr do emulador

Retorna
`InputStreamSource`	saída do emulador

getEmulatorProcess

public Process getEmulatorProcess ()

Retorna o Process correspondente a este emulador.

Retorna
`Process`	o `Process` ou o `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

O registro que contém todos os registros executeShellCommand(String).

Retorna
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Método auxiliar para determinar a quantidade de espaço livre no armazenamento externo do dispositivo.

Retorna
`long`	a quantidade de espaço livre em KB

Gera
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

Retorna o caminho do binário fastboot em uso. Ainda exige que isFastbootEnabled() seja verdadeiro para ter as funções do fastboot ativadas.

Retorna
`String`

getFastbootProductType

public String getFastbootProductType ()

Método conveniente para receber o tipo de produto deste dispositivo quando ele está no modo fastboot.

Esse método só deve ser usado se o dispositivo estiver no modo fastboot. É uma variante um pouco mais segura do que o método genérico getProductType() nesse caso, porque o ITestDevice vai saber como recuperar o dispositivo no fastboot se ele estiver em um estado incorreto ou não estiver respondendo.

Retorna
`String`	o nome do tipo de produto `String` ou `null` se não for possível determinar

Gera
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

Método conveniente para receber o tipo de produto deste dispositivo quando ele está no modo fastboot.

Retorna
`String`	o nome do tipo de produto `String` ou `null` se não for possível determinar

Gera
`DeviceNotAvailableException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Retorna o número de série do modo fastboot.

Retorna
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

Recupera o valor da variável fastboot especificada do dispositivo.

Parâmetros
`variableName`	`String`: o nome da variável

Retorna
`String`	o valor da propriedade ou `null` se ela não existir

Gera
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

Retorna a string de versão do binário fastboot em uso. Ou nulo se algo der errado.

Retorna
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

Recupera uma referência a um arquivo remoto no dispositivo.

Parâmetros
`path`	`String`: o caminho do arquivo a ser recuperado. Pode ser um caminho absoluto ou relativo a "/". Por exemplo, as sintaxes "/system" e "system" são compatíveis.

Retorna
`IFileEntry`	o `IFileEntry` ou `null` se o arquivo no `path` especificado não for encontrado

Gera
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Helper não oficial para receber um FileEntry de um caminho não raiz. FIXME: refatore o sistema FileEntry para que ele esteja disponível em qualquer caminho. (mesmo que não seja root).

Parâmetros
`entry`	`FileListingService.FileEntry`: um `FileEntry` não necessariamente raiz, como exige a Ddmlib.

Retorna
`IFileEntry`	um FileEntryWrapper que representa o FileEntry.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

Retorna a lista de estados dobráveis no dispositivo. Pode ser obtido com "cmd device_state print-states".

Retorna

Gera
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

Retorna uma referência à IDevice ddmlib associada.

Um novo IDevice pode ser alocado pelo DDMS sempre que o dispositivo é desconectado e reconectado do adb. Portanto, os chamadores não devem manter uma referência ao IDevice, porque ela pode ficar desatualizada.

Retorna
`IDevice`	o `IDevice`

getInstalledPackageNames

public  getInstalledPackageNames ()

Busca os nomes de pacotes de aplicativos presentes no dispositivo.

Retorna
	`ERROR(/Set)` de `String` nomes de pacotes instalados no dispositivo.

Gera
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Retorna o valor inteiro da propriedade especificada do dispositivo.

Parâmetros
`name`	`String`: o nome da propriedade
`defaultValue`	`long`: valor padrão a ser retornado se a propriedade estiver vazia ou não existir.

Retorna
`long`	o valor da propriedade ou `defaultValue` se a propriedade estiver vazia, não existir ou não tiver um valor inteiro.

Gera
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Recebe o endereço IP do dispositivo.

Retorna
`String`	o endereço IP do dispositivo ou `null` se o dispositivo não tiver um endereço IP

Gera
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Retorne um objeto para receber o estado atual do keyguard ou null se não for compatível.

Retorna
`KeyguardControllerState`	um `KeyguardControllerState` que contém um snapshot do estado do keyguard e retorna Null se a consulta do Keyguard não for compatível.

Gera
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

Retorna a última vez que as APIs do Tradefed acionaram uma reinicialização em milissegundos desde EPOCH, conforme retornado por System.currentTimeMillis().

Retorna
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

Recebe o primeiro nível de API iniciado do dispositivo. O valor padrão é UNKNOWN_API_LEVEL.

Retorna
`int`	um número inteiro que indica o primeiro nível de API iniciado do dispositivo

Gera
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

Captura um fluxo de snapshot dos dados do logcat.

Funciona em dois modos:

Se o logcat estiver sendo capturado em segundo plano, vai retornar até TestDeviceOptions.getMaxLogcatDataSize() bytes do conteúdo atual da captura de logcat em segundo plano.

Caso contrário, vai retornar um despejo estático dos dados do logcat se o dispositivo estiver respondendo no momento.

Retorna
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

Captura um fluxo de snapshot dos últimos maxBytes dados de logcat capturados.

Útil para casos em que você quer capturar snapshots frequentes dos dados do logcat capturados sem incorrer na penalidade potencialmente grande de espaço em disco de receber o snapshot getLogcat() inteiro.

Parâmetros
`maxBytes`	`int`: a quantidade máxima de dados a serem retornados. Precisa ser um valor que caiba confortavelmente na memória.

Retorna
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

Receba um despejo do logcat atual do dispositivo. Ao contrário de getLogcat(), esse método sempre retorna um despejo estático do logcat.

Tem a desvantagem de que nada será retornado se o dispositivo não estiver acessível.

Retorna
`InputStreamSource`	um `InputStreamSource` dos dados do logcat. Um fluxo vazio será retornado se não for possível capturar dados de logcat.

getLogcatSince

public InputStreamSource getLogcatSince (long date)

Extrai um fluxo de snapshot dos dados do logcat capturados a partir da data fornecida. O horário no dispositivo deve ser usado getDeviceDate().

Parâmetros
`date`	`long`: em milissegundos desde o formato de época de quando iniciar o snapshot até o presente. (pode ser obtido usando "date +%s")

Retorna
`InputStreamSource`

getMacAddress

public String getMacAddress ()

Retorna o endereço MAC do dispositivo ou nulo se não for possível consultar o dispositivo.

Retorna
`String`

getMainUserId

public Integer getMainUserId ()

Retorna o ID do usuário principal.

Retorna
`Integer`	o userId do usuário principal, se houver um, e nulo se não houver um usuário principal.

Gera
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Receba informações sobre os módulos principais instalados no dispositivo.

Retorna
	`ERROR(/Set)` dos `String` módulos principais instalados no dispositivo.

Gera
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Recebe o número máximo de usuários que podem ser executados simultaneamente. O valor padrão é 0.

Retorna
`int`	um número inteiro que indica o número de usuários em execução simultânea

Gera
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Recebe o número máximo de usuários aceitos. O valor padrão é 0.

Retorna
`int`	um número inteiro que indica o número de usuários aceitos

Gera
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

Retorna
`Process`	Retorna o processo da VM do Microdroid. Se TestDevice não for um Microdroid, vai retornar nulo.

getMonitor

public IDeviceStateMonitor getMonitor ()

Retorna o IDeviceStateMonitor associado ao dispositivo.

Retorna
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

Retorna um ponto de montagem.

Consulta o dispositivo diretamente se as informações armazenadas em cache em IDevice não estiverem disponíveis.

TODO: mover esse comportamento para IDevice.getMountPoint(String)

Parâmetros
`mountName`	`String`: o nome do ponto de montagem

Retorna
`String`	o ponto de montagem ou `null`

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Retorna um MountPointInfo correspondente ao caminho do ponto de montagem especificado ou null se esse caminho não tiver nada montado ou não aparecer em /proc/mounts como um ponto de montagem.

Parâmetros
`mountpoint`	`String`

Retorna
`ITestDevice.MountPointInfo`	Um `ERROR(/List)` de `MountPointInfo` que contém as informações em "/proc/mounts"

Gera
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

Retorna uma versão analisada das informações em /proc/mounts no dispositivo.

Retorna
	Um `ERROR(/List)` de `MountPointInfo` que contém as informações em "/proc/mounts"

Gera
`DeviceNotAvailableException`

getOptions

public TestDeviceOptions getOptions ()

Busque as opções de teste para o dispositivo.

Retorna
`TestDeviceOptions`	`TestDeviceOptions` relacionado ao dispositivo em teste.

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

Método auxiliar para determinar a quantidade de espaço livre na partição do dispositivo.

Parâmetros
`partition`	`String`

Retorna
`long`	a quantidade de espaço livre em KB

Gera
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

Retorna o ID do usuário principal.

Retorna
`Integer`	o userId do usuário principal, se houver, e nulo se não houver um usuário principal.

Gera
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

O método auxiliar executa os comandos "pidof" e "stat" e retorna o objeto ProcessInfo com o PID e o horário de início do processo especificado.

Parâmetros
`processName`	`String`: a string do nome do processo.

Retorna
`ProcessInfo`	ProcessInfo do determinado processName

Gera
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

Retorna o PID do serviço ou nulo se algo der errado.

Parâmetros
`process`	`String`: a string do nome do processo.

Retorna
`String`

Gera
`DeviceNotAvailableException`

getProductType

public String getProductType ()

Método de conveniência para receber o tipo de produto deste dispositivo.

Esse método funciona se o dispositivo estiver no modo adb ou fastboot.

Retorna
`String`	o nome do tipo de produto `String`. Não será nulo

Gera
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

Método de conveniência para receber a variante do produto deste dispositivo.

Esse método funciona se o dispositivo estiver no modo adb ou fastboot.

Retorna
`String`	o nome da variante do produto `String` ou `null` se não for possível determinar

Gera
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

Recupera o valor da propriedade especificada do dispositivo.

Parâmetros
`name`	`String`: o nome da propriedade

Retorna
`String`	o valor da propriedade ou `null` se ela não existir

Gera
`DeviceNotAvailableException`

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

Recebe o modo de recuperação atual usado no dispositivo.

Retorna
`ITestDevice.RecoveryMode`	o modo de recuperação atual usado no dispositivo.

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Faz uma captura de tela do dispositivo com o ID de exibição especificado. O formato é PNG.

TODO: estender as implementações acima para oferecer suporte a "format" e "rescale"

Parâmetros
`displayId`	`long`: o ID de exibição da tela para capturar a captura de tela.

Retorna
`InputStreamSource`	um `InputStreamSource` da captura de tela no formato ou `null` se a captura de tela não foi concluída.

Gera
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

Captura uma captura de tela do dispositivo. Recomendado usar getScreenshot(format) com codificação JPEG para um tamanho menor

Parâmetros
`format`	`String`: PNG e JPEG compatíveis

Retorna
`InputStreamSource`	um `InputStreamSource` da captura de tela no formato ou `null` se a captura de tela não foi concluída.

Gera
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Captura uma captura de tela do dispositivo. Recomendamos usar getScreenshot(String) com codificação JPEG para um tamanho menor.

Parâmetros
`format`	`String`: PNG e JPEG compatíveis
`rescale`	`boolean`: se a captura de tela precisa ser redimensionada para reduzir o tamanho da imagem resultante.

Retorna
`InputStreamSource`	um `InputStreamSource` da captura de tela no formato ou `null` se a captura de tela não foi concluída.

Gera
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

Captura uma captura de tela do dispositivo.

Retorna
`InputStreamSource`	um `InputStreamSource` da captura de tela no formato png ou `null` se a captura de tela não foi concluída.

Gera
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

Método prático para receber o número de série deste dispositivo.

Retorna
`String`	o número de série `String`

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

Retorna o valor da configuração solicitada. O namespace precisa ser um destes: {"system", "secure", "global"}

Parâmetros
`userId`	`int`
`namespace`	`String`
`key`	`String`

Retorna
`String`	o valor associado ao namespace:chave de um usuário. Nulo se não for encontrado.

Gera
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

Consulte getSetting(int, String, String) e executado no usuário do sistema.

Parâmetros
`namespace`	`String`
`key`	`String`

Retorna
`String`

Gera
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

Retorna a operadora do chip ou nulo se não estiver disponível ou se o dispositivo não estiver disponível.

Retorna
`String`

getSimState

public String getSimState ()

Retorna o estado do chip ou nulo se não estiver disponível ou se o dispositivo não estiver disponível.

Retorna
`String`

getTombstones

public  getTombstones ()

Busca e retorna a lista de lápides dos dispositivos. Requer acesso root.

O método é de melhor esforço. Portanto, se um marcador não for extraído por qualquer motivo, ele vai ficar faltando na lista. Apenas um DeviceNotAvailableException vai encerrar o método antes do tempo.

Retorna
	Uma lista de arquivos de lápide, vazia se não houver lápide.

Gera
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

Retorna o tamanho total da memória física em bytes ou -1 em caso de erro interno.

Retorna
`long`

getTrackingSerial

public String getTrackingSerial ()

Para fins de gerenciamento de dispositivos, receba o número de série usado para rastrear o dispositivo.

Retorna
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Extraia os nomes de pacotes de aplicativos que podem ser desinstalados. Atualmente, isso é definido como pacotes que não são do sistema e pacotes atualizados do sistema.

Retorna
	`ERROR(/Set)` de nomes de pacotes `String` não desinstaláveis instalados no dispositivo.

Gera
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

Recebe se é necessário usar "fastboot erase" ou "fastboot format" para limpar uma partição no dispositivo.

Retorna
`boolean`	`true` se o fastboot erase for usado ou `false` se o fastboot format for usado.

getUserFlags

public int getUserFlags (int userId)

Encontra e retorna as flags de um determinado usuário. As flags são definidas na classe "android.content.pm.UserInfo" no Android Open Source Project.

Parâmetros
`userId`	`int`

Retorna
`int`	as flags associadas ao userId fornecido, se encontradas, -10000 em qualquer outro caso.

Gera
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Recebe o mapa de useId para UserInfo no dispositivo. Vai gerar DeviceRuntimeException se a saída do dispositivo não for a esperada.

Retorna
	a lista de objetos UserInfo.

Gera
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

Retorna o número de série associado ao userId se encontrado, -10000 em qualquer outro caso.

Parâmetros
`userId`	`int`

Retorna
`int`

Gera
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Processa o DeviceEvent especificado. Pode fazer a transição do dispositivo para um novo estado. Informa o IDeviceMonitor sobre todas as transições de estado.

Processa o DeviceEvent, que pode ou não fazer a transição desse dispositivo para um novo estado de alocação.

Parâmetros
`event`	`DeviceEvent`

Retorna
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

Verifica se um recurso está disponível em um dispositivo.

Parâmetros
`feature`	`String`: qual formato deve ser "feature:" ou "" diretamente.

Retorna
`boolean`	True se o recurso for encontrado. Caso contrário, será false.

Gera
`DeviceNotAvailableException`

initializeConnection

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

Inicialize a conexão com o dispositivo. Isso é chamado por preInvocationSetup, mas, em casos raros, pode ser necessário chamar separadamente ao criar a conexão durante a configuração do dispositivo.

Parâmetros
`info`	`IBuildInfo`
`attributes`	`MultiMap`

Gera
`DeviceNotAvailableException`
`TargetSetupError`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Instala um pacote Android no dispositivo.

Parâmetros
`packageFile`	`File`: o arquivo APK a ser instalado
`reinstall`	`boolean`: `true` se uma reinstalação precisar ser feita.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.

Retorna
`String`	um `String` com um código de erro ou `null` se a operação for concluída corretamente.

Gera
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Instala um pacote Android no dispositivo.

Observação: só os casos de uso que exigem controle explícito da concessão de permissão de execução no momento da instalação devem chamar essa função.

Parâmetros
`packageFile`	`File`: o arquivo APK a ser instalado
`reinstall`	`boolean`: `true` se uma reinstalação precisar ser feita.
`grantPermissions`	`boolean`: se todas as permissões de ambiente de execução devem ser concedidas no momento da instalação.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.

Retorna
`String`	um `String` com um código de erro ou `null` se a operação for concluída corretamente.

Gera
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Instala um pacote Android no dispositivo para um determinado usuário.

Parâmetros
`packageFile`	`File`: o arquivo APK a ser instalado
`reinstall`	`boolean`: `true` se uma reinstalação precisar ser feita.
`userId`	`int`: o ID de usuário inteiro para instalar.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.

Retorna
`String`	um `String` com um código de erro ou `null` se a operação for concluída corretamente.

Gera
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Instala um pacote Android no dispositivo para um determinado usuário.

Observação: só os casos de uso que exigem controle explícito da concessão de permissão de execução no momento da instalação devem chamar essa função.

Parâmetros
`packageFile`	`File`: o arquivo APK a ser instalado
`reinstall`	`boolean`: `true` se uma reinstalação precisar ser feita.
`grantPermissions`	`boolean`: se todas as permissões de ambiente de execução devem ser concedidas no momento da instalação.
`userId`	`int`: o ID de usuário inteiro para instalar.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.

Retorna
`String`	um `String` com um código de erro ou `null` se a operação for concluída corretamente.

Gera
`DeviceNotAvailableException`

installPackageWithIncrementalMode

public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

Instala APKs com modo incremental.

Parâmetros
`apkFiles`	`File`: os arquivos APK a serem instalados.
`extraArgs`	`String`
`userId`	`String`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

Retorna
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Verificar se a plataforma no dispositivo é compatível com a enumeração de apps

Retorna
`boolean`	True se a enumeração de apps for compatível. Caso contrário, false.

Gera
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

Verifique se a plataforma no dispositivo permite ignorar o bloqueio de SDK de destino baixo nas instalações de apps

Retorna
`boolean`	Verdadeiro se o bloqueio de SDK de destino baixo for compatível. Caso contrário, falso.

Gera
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Verifique se o debugfs está montado.

Retorna
`boolean`	`true` se debugfs estiver ativado

Gera
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

Retorna se o dispositivo está criptografado.

Retorna
`boolean`	`true` se o dispositivo estiver criptografado.

Gera
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

Retorna "True" se o caminho no dispositivo for um diretório. Caso contrário, retorna "False".

Parâmetros
`path`	`String`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

Retorna
`boolean`	`true` se o adb root deve ser ativado no dispositivo

isEncryptionSupported

public boolean isEncryptionSupported ()

Retorna se a criptografia é compatível com o dispositivo.

Retorna
`boolean`	`true` se o dispositivo for compatível com criptografia.

Gera
`DeviceNotAvailableException`

isExecutable

public boolean isExecutable (String fullPath)

Retorna "True" se o caminho do arquivo no dispositivo for um arquivo executável. Caso contrário, retorna "False".

Parâmetros
`fullPath`	`String`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

Retorna se o fastboot está disponível para o dispositivo.

Retorna
`boolean`

isHeadless

public boolean isHeadless ()

Retorna "true" se o dispositivo for sem tela. Caso contrário, retorna "false".

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Retorna se o dispositivo usa o modo de usuário do sistema headless.

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Retorna se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para o status de não administrador.

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Determina se vários usuários são aceitos.

Retorna
`boolean`	true se o recurso multiusuário for compatível, false caso contrário

Gera
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Consulte o dispositivo para um determinado nome de pacote e ID de usuário para verificar se ele está instalado ou não para esse usuário.

Parâmetros
`packageName`	`String`: o pacote que estamos verificando se está instalado.
`userId`	`String`: o ID do usuário para quem estamos verificando se o pacote está instalado. Se for nulo, o usuário principal zero será usado.

Retorna
`boolean`	Verdadeiro se o pacote for informado como instalado. Caso contrário, retorna "falso".

Gera
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Consulte o dispositivo para um determinado nome de pacote e verifique se ele está instalado ou não.

Parâmetros
`packageName`	`String`

Retorna
`boolean`	Verdadeiro se o pacote for informado como instalado. Caso contrário, retorna "falso".

Gera
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

Verificar se a plataforma no dispositivo é compatível com a concessão de permissões de execução

Retorna
`boolean`	Verdadeiro se as permissões de tempo de execução forem compatíveis. Caso contrário, será falso.

Gera
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

Retorna "true" se o dispositivo estiver em TestDeviceState.FASTBOOT ou TestDeviceState.FASTBOOTD.

Retorna
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

Verifica se um determinado usuário está em execução.

Parâmetros
`userId`	`int`

Retorna
`boolean`	True se o usuário estiver executando, false em todos os outros casos.

Gera
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

Retorna se o usuário especificado é secundário de acordo com as flags dele.

Parâmetros
`userId`	`int`

Retorna
`boolean`	"true" se o usuário for secundário. Caso contrário, "false".

Gera
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

Verifica se o usuário especificado está visível.

Um usuário "visível" é aquele que está interagindo com o usuário "humano" e, portanto, pode iniciar atividades de inicialização (normalmente na tela padrão).

Parâmetros
`userId`	`int`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Verifica se o usuário especificado está visível na tela especificada.

Um usuário "visível" é aquele que está interagindo com o usuário "humano" e, portanto, pode iniciar atividades de inicialização na tela.

Parâmetros
`userId`	`int`
`displayId`	`int`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano no ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

Se for o caso, chame startVisibleBackgroundUser(int, int, boolean), transmitindo uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers() (que deve incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano.

Se isso acontecer, chame startVisibleBackgroundUser(int, int, boolean), transmitindo uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers().

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Teste se o Wi-Fi está ativado.

Verifica se o Wi-Fi está ativado no dispositivo. Útil para declarar o status do Wi-Fi antes de testes que não devem ser executados com Wi-Fi, por exemplo, testes de dados móveis.

Retorna
`boolean`	`true` se o Wi-Fi estiver ativado. `false` se desativado

Gera
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

Colete a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys SurfaceFlinger".

Retorna
	A lista de telas. O padrão sempre retorna a tela padrão 0.

Gera
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Recebe a lista de telas que podem ser usadas para start a user visible in the background.

Retorna

Gera
`DeviceNotAvailableException`

listUsers

public  listUsers ()

Recebe a lista de usuários no dispositivo. Vai gerar DeviceRuntimeException se a saída do dispositivo não for a esperada.

Retorna
	a lista de IDs de usuário.

Gera
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

Coleta e registra erros de ANR do dispositivo.

Parâmetros
`logger`	`ITestLogger`: um `ITestLogger` para registrar os ANRs.

Retorna
`boolean`	True se o registro for bem-sucedido. Caso contrário, false.

Gera
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Método auxiliar para criar um relatório de bug e registrá-lo para os repórteres.

Parâmetros
`dataName`	`String`: nome em que o relatório de bug será informado.
`listener`	`ITestLogger`: um `ITestLogger` para registrar o bugreport.

Retorna
`boolean`	True se o registro for bem-sucedido. Caso contrário, false.

logOnDevice

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

Registre uma mensagem no logcat do dispositivo. Essa é uma chamada segura que não vai gerar uma exceção mesmo que o registro falhe.

Parâmetros
`tag`	`String`: a tag em que registramos nossa mensagem no logcat.
`level`	`Log.LogLevel`: o nível de depuração da mensagem no logcat.
`format`	`String`: o formato da mensagem.
`args`	`Object`: os argumentos a serem substituídos usando String.format().

mountDebugfs

public void mountDebugfs ()

Monte o debugfs.

Gera
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

Emite um comando para reiniciar o dispositivo e retorna quando o comando é concluído e quando o dispositivo não está mais visível para o adb.

Gera
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Substitua se o dispositivo precisar de ações específicas após o adb root e antes de ficar on-line novamente. A implementação padrão não inclui ações adicionais. Não há garantia de que o adb root esteja ativado nesta etapa.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postAdbUnrootAction

public void postAdbUnrootAction ()

Substitua se o dispositivo precisar de ações específicas após a remoção do acesso root do adb e antes de o dispositivo voltar a ficar on-line. A implementação padrão não inclui outras ações. Não há garantia de que o adb root será desativado nesta etapa.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public void postBootSetup ()

Siga as instruções para configurar o dispositivo para testes após cada inicialização.

Deve ser chamado depois que o dispositivo estiver totalmente inicializado/disponível

Em circunstâncias normais, não é necessário chamar esse método explicitamente, já que as implementações realizam essas etapas automaticamente ao fazer uma reinicialização.

Ele pode precisar ser chamado quando o dispositivo for reiniciado devido a outros eventos, por exemplo, quando um comando de atualização do fastboot for concluído.

Gera
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Etapas extras para limpeza obrigatória específica do dispositivo que será executada após a conclusão da invocação.

Parâmetros
`exception`	`Throwable`: se houver, a exceção final gerada pela falha na invocação.

preInvocationSetup

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

Etapas extras para a configuração obrigatória específica do dispositivo que será executada nele antes do fluxo de invocação.

Parâmetros
`info`	`IBuildInfo`: o `IBuildInfo` do dispositivo.
`attributes`	`MultiMap`: os atributos armazenados no contexto de invocação

Gera
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

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

Extrai recursivamente o conteúdo do diretório do dispositivo.

Parâmetros
`deviceFilePath`	`String`: o caminho absoluto do arquivo da fonte remota
`localDir`	`File`: o diretório local para extrair os arquivos
`userId`	`int`: o ID do usuário a ser extraído

Retorna
`boolean`	`true` se o arquivo foi extraído. `false` se não forem.

Gera
`DeviceNotAvailableException`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Extrai recursivamente o conteúdo do diretório do dispositivo.

Parâmetros
`deviceFilePath`	`String`: o caminho absoluto do arquivo da fonte remota
`localDir`	`File`: o diretório local para extrair os arquivos

Retorna
`boolean`	`true` se o arquivo foi extraído. `false` se não forem.

Gera
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

Recupera um arquivo do dispositivo.

Parâmetros
`remoteFilePath`	`String`: o caminho absoluto para o arquivo no dispositivo.
`localFile`	`File`: o arquivo local para armazenar o conteúdo. Se não estiver vazio, o conteúdo será substituído.

Retorna
`boolean`	`true` se o arquivo foi recuperado. `false` se não forem.

Gera
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

Recupera um arquivo do dispositivo, armazena em um ERROR(/File) temporário local e retorna esse File.

Parâmetros
`remoteFilePath`	`String`: o caminho absoluto para o arquivo no dispositivo.
`userId`	`int`: o ID do usuário a ser extraído.

Retorna
`File`	Um `ERROR(/File)` que contém o conteúdo do arquivo do dispositivo ou `null` se a cópia falhou por qualquer motivo, incluindo problemas com o sistema de arquivos do host.

Gera
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

Recupera um arquivo do dispositivo, armazena em um ERROR(/File) temporário local e retorna esse File.

Parâmetros
`remoteFilePath`	`String`: o caminho absoluto para o arquivo no dispositivo.

Retorna
`File`	Um `ERROR(/File)` que contém o conteúdo do arquivo do dispositivo ou `null` se a cópia falhou por qualquer motivo, incluindo problemas com o sistema de arquivos do host.

Gera
`DeviceNotAvailableException`

pullFile

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

Recupera um arquivo do dispositivo.

Parâmetros
`remoteFilePath`	`String`: o caminho absoluto para o arquivo no dispositivo.
`localFile`	`File`: o arquivo local para armazenar o conteúdo. Se não estiver vazio, o conteúdo será substituído.
`userId`	`int`: o ID do usuário a ser extraído.

Retorna
`boolean`	`true` se o arquivo foi recuperado. `false` se não forem.

Gera
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

Recupera um arquivo do dispositivo e retorna o conteúdo.

Parâmetros
`remoteFilePath`	`String`: o caminho absoluto para o arquivo no dispositivo.

Retorna
`String`	Um `String` que contém o conteúdo do arquivo do dispositivo ou `null` se a cópia falhou por qualquer motivo, incluindo problemas com o sistema de arquivos do host.

Gera
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

Um método conveniente para recuperar um arquivo do armazenamento externo do dispositivo, armazená-lo em um ERROR(/File) temporário local e retornar uma referência a esse File.

Parâmetros
`remoteFilePath`	`String`: o caminho para o arquivo no dispositivo, relativo ao ponto de montagem do armazenamento externo do dispositivo.

Retorna
`File`	Um `ERROR(/File)` que contém o conteúdo do arquivo do dispositivo ou `null` se a cópia falhou por qualquer motivo, incluindo problemas com o sistema de arquivos do host.

Gera
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

Envie recursivamente o conteúdo do diretório para o dispositivo, excluindo alguns diretórios que são filtrados.

Parâmetros
`localFileDir`	`File`: o diretório local a ser enviado por push
`deviceFilePath`	`String`: o caminho absoluto do arquivo do destino remoto
`excludedDirectories`	: conjunto de nomes de diretórios excluídos que não devem ser enviados por push.

Retorna
`boolean`	`true` se o envio do arquivo foi concluído. `false` se não forem.

Gera
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Envie o conteúdo do diretório de maneira recursiva para o dispositivo.

Parâmetros
`localFileDir`	`File`: o diretório local a ser enviado por push
`deviceFilePath`	`String`: o caminho absoluto do arquivo do destino remoto

Retorna
`boolean`	`true` se o envio do arquivo foi concluído. `false` se não forem.

Gera
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                int userId)

Envie o conteúdo do diretório de maneira recursiva para o dispositivo.

Parâmetros
`localFileDir`	`File`: o diretório local a ser enviado por push
`deviceFilePath`	`String`: o caminho absoluto do arquivo do destino remoto
`userId`	`int`: o ID do usuário para enviar a notificação push.

Retorna
`boolean`	`true` se o envio do arquivo foi concluído. `false` se não forem.

Gera
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                boolean evaluateContentProviderNeeded)

Variante de pushFile(File, String) que pode considerar opcionalmente a avaliação da necessidade para o provedor de conteúdo.

Parâmetros
`localFile`	`File`: o arquivo local a ser enviado
`remoteFilePath`	`String`: o caminho absoluto do arquivo de destino remoto
`evaluateContentProviderNeeded`	`boolean`: se é necessário verificar se precisamos do provedor de conteúdo.

Retorna
`boolean`	`true` se o envio do arquivo foi concluído. `false` se não forem.

Gera
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

Envie um arquivo por push para o dispositivo. Por padrão, usando um provedor de conteúdo.

Parâmetros
`localFile`	`File`: o arquivo local a ser enviado
`remoteFilePath`	`String`: o caminho absoluto do arquivo de destino remoto

Retorna
`boolean`	`true` se o envio do arquivo foi concluído. `false` se não forem.

Gera
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                int userId)

Envie um arquivo por push para o dispositivo. Por padrão, usando um provedor de conteúdo.

Parâmetros
`localFile`	`File`: o arquivo local a ser enviado
`remoteFilePath`	`String`: o caminho absoluto do arquivo de destino remoto
`userId`	`int`: o userId para enviar por push.

Retorna
`boolean`	`true` se o envio do arquivo foi concluído. `false` se não forem.

Gera
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

Enviar arquivo criado de uma string para o dispositivo

Parâmetros
`contents`	`String`: o conteúdo do arquivo a ser enviado
`remoteFilePath`	`String`: o caminho absoluto do arquivo de destino remoto

Retorna
`boolean`	`true` se a string foi enviada com sucesso. `false` se não forem.

Gera
`DeviceNotAvailableException`

reiniciar

public void reboot (String reason)

Reinicializa o dispositivo no modo adb com o reason especificado para ser mantido durante a reinicialização.

Bloqueia até que o dispositivo fique disponível.

O motivo da última reinicialização pode ser obtido consultando a propriedade sys.boot.reason.

Parâmetros
`reason`	`String`: um motivo para essa reinicialização ou `null` se nenhum motivo for especificado.

Gera
`DeviceNotAvailableException`

reiniciar

public void reboot ()

Reinicializa o dispositivo no modo adb.

Bloqueia até que o dispositivo fique disponível.

Gera
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

Reinicializa o dispositivo no modo bootloader.

Bloqueia até que o dispositivo esteja no modo de carregador de inicialização.

Gera
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

Reinicializa o dispositivo no modo fastbootd.

Bloqueia até que o dispositivo esteja no modo fastbootd.

Gera
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

Reinicializa o dispositivo no modo de recuperação do adb.

Bloqueia até que o dispositivo entre na recuperação

Gera
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

Reinicializa o dispositivo no modo adb sideload (observe que esse é um modo especial em recuperação)

Bloqueia até que o dispositivo entre no modo de sideload

Gera
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

Reinicializa o dispositivo no modo adb sideload (observe que esse é um modo especial em recuperação)

Bloqueia até que o dispositivo entre no modo de sideload

Parâmetros
`autoReboot`	`boolean`: se o dispositivo será reinicializado automaticamente após o sideload.

Gera
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

Uma alternativa a reboot() que bloqueia apenas até que o dispositivo esteja on-line, ou seja, visível para o adb.

Gera
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline (String reason)

Uma alternativa a reboot() que bloqueia apenas até que o dispositivo esteja on-line, ou seja, visível para o adb.

Parâmetros
`reason`	`String`: um motivo para essa reinicialização ou `null` se nenhum motivo for especificado.

Gera
`DeviceNotAvailableException`

rebootUserspace

public void rebootUserspace ()

Reinicializa apenas a parte do espaço do usuário do dispositivo.

Bloqueia até que o dispositivo fique disponível.

AVISO. A reinicialização do espaço do usuário está em desenvolvimento ativo. Use por sua conta e risco.

Gera
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

Uma alternativa a rebootUserspace() ()} que só bloqueia até que o dispositivo esteja on-line, ou seja, visível para o adb.

Gera
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

Tenta recuperar a comunicação do dispositivo.

Retorna
`boolean`	True se a recuperação foi tentada e bem-sucedida. Retorna False se a recuperação foi ignorada.

Gera
`DeviceNotAvailableException`	se o dispositivo não estiver mais disponível

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra um IDeviceActionReceiver para este dispositivo.

Todos os IDeviceActionReceivers registrados vão receber uma notificação antes e depois de uma ação no dispositivo.

Parâmetros
`deviceActionReceiver`	`IDeviceActionReceiver`: um `IDeviceActionReceiver` que será registrado.

remountSystemReadOnly

public void remountSystemReadOnly ()

Deixe a partição do sistema no dispositivo como somente leitura. Pode reiniciar o dispositivo.

Gera
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

Torne a partição do sistema no dispositivo gravável. Pode reiniciar o dispositivo.

Gera
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

Defina a partição do fornecedor no dispositivo como somente leitura. Pode reiniciar o dispositivo.

Gera
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

Torne a partição do fornecedor no dispositivo gravável. Pode reiniciar o dispositivo.

Gera
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Remova o administrador de dispositivo do usuário especificado e retorne true se a operação for bem-sucedida ou false caso contrário.

Parâmetros
`componentName`	`String`: do administrador do dispositivo a ser removido.
`userId`	`int`: do usuário em que o administrador do dispositivo está.

Retorna
`boolean`	True se for bem-sucedido. Caso contrário, false.

Gera
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Remova todos os proprietários de perfis de dispositivos atuais com o melhor esforço.

Gera
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

Remova um usuário específico do dispositivo.

Parâmetros
`userId`	`int`: do usuário a ser removido

Retorna
`boolean`	"true" se a remoção do usuário for bem-sucedida. Caso contrário, "false".

Gera
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

Redefina a flag para a configuração do provedor de conteúdo e acione-a novamente.

runInstrumentationTests

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

Método conveniente para realizar ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) com um ou mais listeners transmitidos como parâmetros.

Parâmetros
`runner`	`IRemoteAndroidTestRunner`: o `IRemoteAndroidTestRunner` que executa os testes
`listeners`	`ITestLifeCycleReceiver`: os listeners de resultados de teste

Retorna
`boolean`	`true` se o comando de teste for concluído. `false` se não for concluída, mas a recuperação for bem-sucedida

Gera
`DeviceNotAvailableException`

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Executa testes de instrumentação e oferece recuperação de dispositivos.

Se a conexão com o dispositivo for perdida antes da conclusão da execução do teste e a recuperação for bem-sucedida, todos os listeners serão informados sobre testRunFailed e "false" será retornado. O comando de teste não será executado novamente. Se necessário, os autores da chamada podem tentar de novo.

Se a conexão com o dispositivo for perdida antes da conclusão da execução do teste e a recuperação falhar, todos os listeners serão informados sobre testRunFailed, e DeviceNotAvailableException será gerado.

Parâmetros
`runner`	`IRemoteAndroidTestRunner`: o `IRemoteAndroidTestRunner` que executa os testes
`listeners`	: os listeners de resultados do teste

Retorna
`boolean`	`true` se o comando de teste for concluído. `false` se a conclusão falhou devido a uma exceção de comunicação do dispositivo, mas a recuperação foi bem-sucedida

Gera
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

Igual a ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), mas executa o teste para o usuário especificado.

Parâmetros
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

Igual a ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), mas executa o teste para um determinado usuário.

Parâmetros
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`ITestLifeCycleReceiver`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

setAdbPath

public void setAdbPath (String adbPath)

Define o caminho para o binário adb que deve ser usado.

Parâmetros
`adbPath`	`String`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injeta o IConfiguration em uso.

Parâmetros
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

Parâmetros
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

Define a data no dispositivo.

Observação: definir a data no dispositivo requer acesso root

Parâmetros
`date`	`Date`: especifique uma data específica. Se `null`, será usada a data do host.

Gera
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Defina um componente de administrador do dispositivo como proprietário do dispositivo para um determinado usuário.

Parâmetros
`componentName`	`String`: de administrador do dispositivo para proprietário do dispositivo.
`userId`	`int`: do usuário em que o proprietário do dispositivo mora.

Retorna
`boolean`	True se for bem-sucedido. Caso contrário, false.

Gera
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Atualize o estado do dispositivo.

Parâmetros
`deviceState`	`TestDeviceState`: o `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

Para o emulador, defina SizeLimitedOutputStream como saída de registro.

Parâmetros
`output`	`SizeLimitedOutputStream`: para registrar a saída

setEmulatorProcess

public void setEmulatorProcess (Process p)

Define o Process quando o dispositivo é um emulador.

Parâmetros
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

Defina a opção fastboot para o dispositivo. Deve ser definido quando o dispositivo é alocado pela primeira vez.

Parâmetros
`fastbootEnabled`	`boolean`: se o fastboot está disponível para o dispositivo ou não

setFastbootPath

public void setFastbootPath (String fastbootPath)

Define o caminho para o binário fastboot que precisa ser usado. Ainda exige que isFastbootEnabled() seja verdadeiro para ter as funções do fastboot ativadas.

Parâmetros
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Atualiza o IDevice associado a este ITestDevice.

O novo IDevice precisa se referir ao mesmo dispositivo físico que a referência atual. Esse método será chamado se o DDMS tiver alocado um novo IDevice.

Parâmetros
`newDevice`	`IDevice`: o `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

Define o tempo em ms para aguardar antes de iniciar a captura do logcat em um dispositivo on-line.

Parâmetros
`delay`	`int`: o atraso em ms

setOptions

public void setOptions (TestDeviceOptions options)

Definir o TestDeviceOptions para o dispositivo

Parâmetros
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

Define o valor da propriedade especificada no dispositivo. Exige que adb root seja verdadeiro.

Parâmetros
`propKey`	`String`: a chave que será definida.
`propValue`	`String`: o valor da propriedade a ser definido.

Retorna
`boolean`	Retorna `True` se o comando setprop for bem-sucedido. Caso contrário, retorna False.

Gera
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

Defina o IDeviceRecovery a ser usado neste dispositivo. Deve ser definido quando o dispositivo é alocado pela primeira vez.

Parâmetros
`recovery`	`IDeviceRecovery`: o `IDeviceRecovery`

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

Define o modo de recuperação atual a ser usado no dispositivo.

Usado para controlar qual método de recuperação usar quando um problema de comunicação do dispositivo é encontrado. Recomendamos usar esse método apenas quando necessário (por exemplo, quando o framework está inativo etc.

Parâmetros
`mode`	`ITestDevice.RecoveryMode`: se o modo "Recuperar até ficar on-line" deve estar ativado ou não.

setSetting

public void setSetting (String namespace, 
                String key, 
                String value)

Consulte setSetting(int, String, String, String) e executado no usuário do sistema.

Parâmetros
`namespace`	`String`
`key`	`String`
`value`	`String`

Gera
`DeviceNotAvailableException`

setSetting

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Adiciona um valor de configuração ao namespace de um determinado usuário. Algumas configurações só vão estar disponíveis após uma reinicialização. O namespace precisa ser um destes: {"system", "secure", "global"}

Parâmetros
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

Gera
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Injeta a instância ITestLogger.

Parâmetros
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

Para fins de gerenciamento de dispositivos, rastreamos o número de série que usamos para fazer referência ao dispositivo.

Parâmetros
`trackingSerial`	`String`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

Defina se você quer usar "fastboot erase" ou "fastboot format" para limpar uma partição no dispositivo.

Parâmetros
`useFastbootErase`	`boolean`: `true` se o fastboot erase precisar ser usado ou `false` se o fastboot format precisar ser usado.

startLogcat

public void startLogcat ()

Comece a capturar a saída do logcat do dispositivo em segundo plano.

Não terá efeito se a saída do logcat já estiver sendo capturada. Os dados podem ser recuperados posteriormente usando getLogcat.

Quando o dispositivo não estiver mais em uso, chame stopLogcat().

Normalmente, startLogcat() e stopLogcat() não precisam ser chamados em um contexto de invocação do TF, porque o framework TF inicia e interrompe o logcat.

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

Ativa o modo de teste de troca. O dispositivo será limpo e reinicializado.

Parâmetros
`timeoutMs`	`int`

Retorna
`boolean`	True se for bem-sucedido. Caso contrário, false.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId)

Inicia um determinado usuário em segundo plano se ele estiver parado. Se o usuário já estiver em execução em segundo plano, esse método será uma NOOP.

Parâmetros
`userId`	`int`: do usuário para iniciar em segundo plano

Retorna
`boolean`	verdadeiro se o usuário foi iniciado em segundo plano.

Gera
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Inicia um determinado usuário em segundo plano se ele estiver parado. Se o usuário já estiver em execução em segundo plano, esse método será uma NOOP. É possível fornecer uma flag extra para aguardar o efeito da operação.

Parâmetros
`userId`	`int`: do usuário para iniciar em segundo plano
`waitFlag`	`boolean`: faz com que o comando aguarde até que o usuário seja iniciado e desbloqueado.

Retorna
`boolean`	verdadeiro se o usuário foi iniciado em segundo plano.

Gera
`DeviceNotAvailableException`

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Inicia um determinado usuário em segundo plano, visível na tela especificada (ou seja, permitindo que o usuário inicie atividades nessa tela).

OBSERVAÇÃO : esse comando não verifica se o usuário existe, se a exibição está disponível, se é device supports such feature etc.

Parâmetros
`userId`	`int`: do usuário para iniciar em segundo plano
`displayId`	`int`: tela para iniciar o usuário visível em
`waitFlag`	`boolean`: faz com que o comando aguarde até que o usuário seja iniciado e desbloqueado.

Retorna
`boolean`	`true` se o usuário tiver sido iniciado com sucesso em segundo plano.

Gera
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

Feche e exclua a saída do emulador.

stopLogcat

public void stopLogcat ()

Interrompe a captura da saída do logcat do dispositivo e descarta os dados do logcat salvos no momento.

Não terá efeito se a saída do logcat não estiver sendo capturada.

stopTradeInModeTesting

public void stopTradeInModeTesting ()

Interromper o teste do modo de troca.

Gera
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

Interrompe um determinado usuário. Se o usuário já estiver parado, esse método será uma NOOP. Não é possível interromper o usuário atual e do sistema.

Parâmetros
`userId`	`int`: do usuário a ser interrompido.

Retorna
`boolean`	true se o usuário foi interrompido.

Gera
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Interrompe um determinado usuário. É possível fornecer flags extras para aguardar o efeito da operação e encerrar o usuário à força. Não é possível interromper o usuário atual e do sistema.

Parâmetros
`userId`	`int`: do usuário a ser interrompido.
`waitFlag`	`boolean`: faz com que o comando aguarde até que o usuário seja interrompido.
`forceFlag`	`boolean`: vai forçar a interrupção do usuário.

Retorna
`boolean`	true se o usuário foi interrompido.

Gera
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

Mude o dispositivo para o modo adb-over-tcp.

Retorna
`String`	o número de série do TCP ou `null` se o dispositivo não puder ser trocado

Gera
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Coloque o dispositivo no modo adb por USB.

Retorna
`boolean`	`true` se a troca for bem-sucedida. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

Mude para outro userId com um tempo limite padrão. switchUser(int, long).

Parâmetros
`userId`	`int`

Retorna
`boolean`	Verdadeiro se o novo userId corresponder ao provedor de userId. Caso contrário, retorna "falso".

Gera
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

Mude para outro userId com o tempo limite fornecido como prazo. Tentar desativar o bloqueio de tela depois que a mudança de usuário for concluída.

Parâmetros
`userId`	`int`
`timeout`	`long`: aguardar antes de retornar "false" para a troca de usuário com falha.

Retorna
`boolean`	Verdadeiro se o novo userId corresponder ao provedor de userId. Caso contrário, retorna "falso".

Gera
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

Sincroniza incrementalmente o conteúdo de um diretório de arquivos local com o dispositivo.

Decide quais arquivos enviar por push comparando os carimbos de data/hora dos arquivos locais com os equivalentes remotos. Apenas arquivos "mais recentes" ou inexistentes serão enviados por push para o dispositivo. Assim, a sobrecarga será relativamente pequena se o conjunto de arquivos no dispositivo já estiver atualizado.

Os arquivos ocultos (com nomes que começam com ".") serão ignorados.

Exemplo de uso: syncFiles("/tmp/files", "/sdcard") vai criar um diretório /sdcard/files se ele ainda não existir e vai enviar recursivamente o conteúdo de /tmp/files para /sdcard/files.

Parâmetros
`localFileDir`	`File`: o diretório de arquivos local que contém os arquivos a serem enviados recursivamente.
`deviceFilePath`	`String`: a raiz do caminho absoluto do arquivo de destino remoto. Todos os diretórios nesse caminho de arquivo precisam ser legíveis. Ou seja, o envio para /data/local/tmp quando o adb não é raiz vai falhar.

Retorna
`boolean`	`true` se os arquivos foram sincronizados. `false` se não forem.

Gera
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

Recebe um bugreport e o retorna em um objeto Bugreport para processamento. Retorne nulo em caso de problema. O arquivo referenciado no objeto Bugreport precisa ser limpo com Bugreport.close().

Retorna
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

Desinstala um pacote Android do dispositivo.

Parâmetros
`packageName`	`String`: o pacote Android a ser desinstalado.

Retorna
`String`	um `String` com um código de erro ou `null` se a operação for concluída corretamente.

Gera
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Desinstala um pacote Android do dispositivo para um determinado usuário.

Parâmetros
`packageName`	`String`: o pacote Android a ser desinstalado.
`userId`	`int`: o ID de usuário inteiro a ser desinstalado.

Retorna
`String`	um `String` com um código de erro ou `null` se a operação for concluída corretamente.

Gera
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

Desbloqueia o dispositivo se ele estiver criptografado.

Esse método pode reiniciar o framework, mas não vai chamar postBootSetup(). Portanto, o dispositivo pode não estar totalmente pronto para ser testado quando esse método retornar.

Retorna
`boolean`	`true` se a operação for concluída ou se o dispositivo não estiver criptografado.

Gera
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

Desmonte o debugfs.

Gera
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

Bloqueia até que a flag de conclusão da inicialização do dispositivo seja definida.

Parâmetros
`timeOut`	`long`: tempo em milissegundos para aguardar a definição da flag.

Retorna
`boolean`	true se a flag de conclusão da inicialização do dispositivo for definida dentro do tempo limite

Gera
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

Aguarde até que o dispositivo esteja responsivo e disponível para testes. Usa o tempo limite padrão.

Retorna
`boolean`	True se o dispositivo estiver disponível, False se a recuperação estiver desativada e indisponível.

Gera
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

Aguarde até que o dispositivo esteja responsivo e disponível para testes.

Parâmetros
`waitTime`	`long`: o tempo em ms para aguardar

Retorna
`boolean`	True se o dispositivo estiver disponível, False se a recuperação estiver desativada e indisponível.

Gera
`DeviceNotAvailableException`

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Espera que o dispositivo responda e esteja disponível sem considerar o caminho de recuperação.

Parâmetros
`waitTime`	`long`

Retorna
`boolean`	Verdadeiro se o dispositivo estiver disponível, falso se não estiver.

Gera
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

Bloqueia até que o dispositivo fique visível via fastboot. Usar o tempo limite padrão.

Gera
`DeviceNotAvailableException`

waitForDeviceFastbootD

public void waitForDeviceFastbootD ()

Gera
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

Bloqueia para que o dispositivo esteja no estado "adb recovery". Isso é diferente de IDeviceRecovery.

Parâmetros
`waitTime`	`long`: o tempo em ms para aguardar

Retorna
`boolean`	`true` se o dispositivo for inicializado na recuperação antes do tempo expirar. `false` caso contrário

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

Bloqueia para que o dispositivo fique no estado "adb sideload".

Parâmetros
`waitTime`	`long`: o tempo em ms para aguardar

Retorna
`boolean`	`true` se o dispositivo for inicializado por sideload antes do tempo expirar. `false` caso contrário

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

Bloqueia para que o dispositivo não esteja disponível, ou seja, ausente do adb.

Parâmetros
`waitTime`	`long`: o tempo em ms para aguardar

Retorna
`boolean`	`true` se o dispositivo ficar indisponível antes do prazo. `false` caso contrário

waitForDeviceOnline

public void waitForDeviceOnline ()

Bloqueia até que o dispositivo fique visível via adb. Usa o tempo limite padrão

O dispositivo pode não responder aos comandos após a conclusão. Use waitForDeviceAvailable() em vez disso.

Gera
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

Bloqueia até que o dispositivo fique visível via adb.

O dispositivo pode não responder aos comandos após a conclusão. Use waitForDeviceAvailable() em vez disso.

Parâmetros
`waitTime`	`long`: o tempo em ms para aguardar

Gera
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

Aguarde até que o dispositivo responda a um comando básico do shell adb.

Parâmetros
`waitTime`	`long`: o tempo em ms para aguardar

Retorna
`boolean`	`true` se o dispositivo responder antes do fim de `waitTime`.

Métodos protegidos

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

Parâmetros
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

protected String[] buildAdbShellCommand (String command, 
                boolean forceExitStatusDetection)

Cria o comando do SO para a sessão e os argumentos do comando adb shell especificados.

Parâmetros
`command`	`String`
`forceExitStatusDetection`	`boolean`

Retorna
`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)

Crie um RebootDeviceAction para ser usado ao realizar uma ação de reinicialização.

Parâmetros
`rebootMode`	`NativeDevice.RebootMode`: um modo dessa reinicialização.
`reason`	`String`: para esta reinicialização.

Retorna
`NativeDevice.RebootDeviceAction`	o `RebootDeviceAction` criado.

createRunUtil

protected IRunUtil createRunUtil ()

Retorna
`IRunUtil`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Faça uma reinicialização do adb.

Parâmetros
`rebootMode`	`NativeDevice.RebootMode`: um modo dessa reinicialização.
`reason`	`String`: para esta reinicialização.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

Método auxiliar para gerar exceção se a permissão de tempo de execução não for compatível.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getApiLevelSafe

protected int getApiLevelSafe ()

Retorna
`int`

getLogger

protected ITestLogger getLogger ()

Retorna
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

Receba a instância RunUtil para usar.

Retorna
`IRunUtil`

internalGetProperty

protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

Busca uma propriedade do dispositivo, do cache ddmlib por padrão, e volta para "adb shell getprop" ou "fastboot getvar", dependendo se o dispositivo está no Fastboot ou não.

Parâmetros
`propName`	`String`: o nome da propriedade do dispositivo conforme retornado por "adb shell getprop"
`fastbootVar`	`String`: o nome da variável fastboot equivalente a ser consultada. Se `null`, a consulta fastboot não será tentada.
`description`	`String`: uma descrição simples da variável. A primeira letra precisa ser maiúscula.

Retorna
`String`	Uma string, possivelmente `null` ou vazia, contendo o valor da propriedade especificada.

Gera
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

Retorna se os callbacks de reinicialização estão sendo executados ou não. Todas as APIs públicas para reinicialização serão desativadas se for verdadeiro.

Retorna
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Retorna true se o arquivo local for mais recente que o arquivo remoto. IFileEntry sendo preciso até o minuto. Em caso de horários iguais, o arquivo será considerado mais novo.

Parâmetros
`localFile`	`File`
`entry`	`IFileEntry`

Retorna
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

Notifica todos os IDeviceActionReceiver sobre o evento de término da reinicialização.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

notifyRebootStarted

protected void notifyRebootStarted ()

Notifica todos os IDeviceActionReceiver sobre o evento de início da reinicialização.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

performDeviceAction

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

Realiza uma ação neste dispositivo. Tenta recuperar o dispositivo e, opcionalmente, repete o comando se a ação falhar.

Parâmetros
`actionDescription`	`String`: uma breve descrição da ação a ser realizada. Usado apenas para fins de geração de registros.
`action`	`NativeDevice.DeviceAction`: a ação a ser realizada
`retryAttempts`	`int`: as tentativas de repetição para a ação se ela falhar, mas a recuperação for bem-sucedida.

Retorna
`boolean`	`true` se a ação foi realizada com sucesso

Gera
`DeviceNotAvailableException`	se a tentativa de recuperação falhar ou o número máximo de tentativas for atingido sem sucesso

postAdbReboot

protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

Possíveis ações extras que podem ser realizadas após uma reinicialização.

Parâmetros
`rebootMode`	`NativeDevice.RebootMode`

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

prePostBootSetup

protected void prePostBootSetup ()

Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) substitua esse método para configuração específica após a inicialização.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

Parâmetros
`remoteFilePath`	`String`
`localFile`	`File`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

Defina a instância de Clock a ser usada.

Parâmetros
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Marca o TestDevice como microdroid e define o CID dele.

Parâmetros
`process`	`Process`: processo da VM Microdroid.

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

Parâmetros
`deviceOptions`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                 envVarMap, 
                String[] fullCmd)

Executa um comando fastboot simples com variáveis de ambiente e informa o status do comando.

Parâmetros
`timeout`	`long`
`envVarMap`
`fullCmd`	`String`

Retorna
`CommandResult`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

Executa um comando fastboot simples e informa o status dele.

Parâmetros
`timeout`	`long`
`fullCmd`	`String`

Retorna
`CommandResult`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

Aguarde até que o dispositivo fique indisponível (pare de gerar relatórios para o adb).

Parâmetros
`operationDesc`	`String`: o nome da operação que está aguardando ficar disponível.
`time`	`long`: o tempo de espera para que o status "Indisponível" ocorra.

Retorna
`boolean`	Verdadeiro se o dispositivo ficou indisponível.

NativeDevice

Resumo

Classes aninhadas

Constantes

Campos

Construtores públicos

Métodos públicos

Métodos protegidos

Constantes

DEBUGFS_PATH

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

SD_CARD

STORAGE_EMULATED

Campos

mOptions

mStateMonitor

Construtores públicos

NativeDevice

Métodos públicos

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

debugDeviceNotAvailable

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeAdbV2Command

executeAdbV2Command

executeAdbV2Command

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAdbPath

getAllSettings

getAllocationState

getAndroidId