O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

Dispositivo nativo

public class NativeDevice
extends Object implements IManagedTestDevice, IConfigurationReceiver, ITestLoggerReceiver

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

Subclasses diretas conhecidas

TestDevice (link em inglês)

TestDevice (link em inglês) Implementação de um ITestDevice para um dispositivo Android de pilha completa

Subclasses indiretas conhecidas

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice

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

Implementação padrão de um dispositivo Android ITestDevice que não é de pilha completa.

Resumo

Classes aninhadas
`class`	`NativeDevice.AdbAction` Uma `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 reinicializar um dispositivo.

Constantes
`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 do comando a serem executadas

Campos
`public static final String`	`DEBUGFS_PATH`
`protected static final String`	`SD_CARD`
`protected static final String`	`STORAGE_EMULATED`
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

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

Métodos públicos
`void`	`batchPrefetchStartupBuildProps()` Microotimização (cerca de 400 milissegundos) por meio da pré-busca de todas as propriedades necessárias, em vez de chamar "adb getprop" para cada uma.
`boolean`	`canSwitchToHeadlessSystemUser()` Retorna se é permitido alternar para o usuário headless SYSTEM.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Verifique se um recurso tem suporte no momento de acordo com um nível com suporte mínimo.
`boolean`	`checkConnectivity()` Verifique se o dispositivo tem conectividade de rede.
`boolean`	`clearErrorDialogs()` Tentativa de dispensar todas as caixas de diálogo de erro exibidas no momento 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 network.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)` Criar um usuário com um determinado nome e as flags fornecidas
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Criar um usuário com um determinado nome e as flags fornecidas
`int`	`createUser(String name)` Cria um usuário com um nome determinado e flags padrão 0.
`int`	`createUserNoThrow(String name)` Cria um usuário com um nome determinado e flags padrão 0.
`void`	`deleteFile(String deviceFilePath, int userId)` Método auxiliar para excluir um arquivo ou diretório do dispositivo.
`void`	`deleteFile(String deviceFilePath)` Método auxiliar para excluir um arquivo ou diretório do dispositivo.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Remove o `IDeviceActionReceiver` registrado.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Método auxiliar para verificar se o dispositivo foi reiniciado de forma reversível, comparando o system_server atual com o `ProcessInfo` system_server anterior.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Método auxiliar para verificar se o dispositivo foi reiniciado de forma reversível desde o horário UTC desde a época do dispositivo e da `ERROR(/TimeUnit)` dele.
`boolean`	`disableAdbRoot()` Desativa a raiz do adb.
`void`	`disableKeyguard()` Tenta desativar o bloqueio de teclado.
`boolean`	`disableNetworkMonitor()` Desativa o monitoramento de rede no dispositivo.
`boolean`	`disconnectFromWifi()` Desconecta da rede Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` Método auxiliar para determinar se um arquivo existente 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)` Tenta despejar a heap do system_server.
`boolean`	`enableAdbRoot()` Ativa a raiz do adb.
`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`	`executeFastbootCommand(String... cmdArgs)` Método auxiliar que executa um comando fastboot como um comando do sistema com um tempo limite padrão de dois 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 do adb e retorna a saída como um `String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Executa um comando do shell do adb, 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 do shell do adb, com mais parâmetros para controlar o comportamento do comando.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Executa o comando do shell do adb fornecido, tentando várias vezes se o comando falhar.
`CommandResult`	`executeShellV2Command(String cmd)` Método auxiliar que executa um comando do shell do 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 do adb e retorna os resultados como uma `CommandResult` preenchida corretamente 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 do 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, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Executa um comando do shell do adb, 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 do shell do adb, 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 do shell do adb, 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()` Busque as informações sobre os APEXs ativados no dispositivo.
	`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)` Encontre e retorne o android-id associado a um userId. Ele será nulo se não for encontrado.
	`getAndroidIds()` Cria um mapa de IDs do Android encontrados que correspondem a IDs de usuário.
`int`	`getApiLevel()` Acessa o nível da API do dispositivo.
`PackageInfo`	`getAppPackageInfo(String packageName)` Busca informações sobre um pacote instalado no dispositivo.
	`getAppPackageInfos()` Busca informações dos pacotes instalados no dispositivo.
`String`	`getBasebandVersion()` Método de conveniência para obter a versão de banda de base (rádio) deste dispositivo.
`Integer`	`getBattery()` Retorna o nível de bateria atual de um dispositivo ou "Nulo" se o nível de bateria estiver indisponí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 período especificado no dispositivo até a unidade de tempo especificada.
`String`	`getBootloaderVersion()` Método de conveniência para obter a versão do carregador de inicialização do dispositivo.
`InputStreamSource`	`getBugreport()` Recupera um relatório de bug do dispositivo.
`InputStreamSource`	`getBugreportz()` Recupera um relatório de bugs do dispositivo.
`String`	`getBuildAlias()` Recupera o alias da compilação que o dispositivo está executando no momento.
`String`	`getBuildFlavor()` Recuperar a variação 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 com chaves de lançamento (controladas por fabricantes de dispositivos individuais).
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Retorna um `DeviceDescriptor` armazenado em cache se o dispositivo estiver alocado. Caso contrário, retorna o `DeviceDescriptor` atual.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Retorna um `DeviceDescriptor` armazenado 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 às 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 atual do dobrável do dispositivo ou retorna nulo caso ocorram problemas.
`int`	`getCurrentUser()` Retorna o ID do usuário em execução no momento.
`String`	`getDeviceClass()` Acessa a classe do dispositivo.
`long`	`getDeviceDate()` Retorna a data do dispositivo em milissegundos desde a época.
`DeviceDescriptor`	`getDeviceDescriptor()` Retorne um `DeviceDescriptor` das informações do dispositivo para receber informações sobre ele sem transmitir o objeto real do dispositivo.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Retorne um `DeviceDescriptor` das informações do dispositivo para receber informações sobre ele sem transmitir o objeto real do dispositivo.
`TestDeviceState`	`getDeviceState()` Recebe o estado do dispositivo.
`long`	`getDeviceTimeOffset(Date date)` Ajuda para mostrar a diferença de horário entre o dispositivo e um determinado `ERROR(/Date)`.
`InputStreamSource`	`getEmulatorOutput()` Acessar o stream do emulador stdout e stderr
`Process`	`getEmulatorProcess()` Retorne o `Process` correspondente a esse 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 sendo usado.
`String`	`getFastbootProductType()` Método de conveniência para obter o tipo de produto deste dispositivo quando ele está no modo fastboot.
`String`	`getFastbootProductVariant()` Método de conveniência para obter 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 fornecido do dispositivo.
`String`	`getFastbootVersion()` Retorna a string da versão do binário fastboot sendo usado.
`IFileEntry`	`getFileEntry(String path)` Recupera uma referência a um arquivo remoto no dispositivo.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` Assistente 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 ao `IDevice` ddmlib associado.
	`getInstalledPackageNames()` Busque os nomes dos pacotes de apps presentes no dispositivo.
`long`	`getIntProperty(String name, long defaultValue)` Retorna o valor inteiro da propriedade especificada do dispositivo.
`String`	`getIpAddress()` Extrai o endereço IP do dispositivo.
`KeyguardControllerState`	`getKeyguardState()` Retorne um objeto para obter o estado atual do bloqueio de teclado ou nulo, se não houver suporte.
`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()` Consiga o primeiro nível de API iniciado do dispositivo.
`InputStreamSource`	`getLogcat()` Captura um stream de snapshot dos dados do logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` Extrai um stream de snapshot dos últimos `maxBytes` de dados do Logcat capturados.
`InputStreamSource`	`getLogcatDump()` Receba um despejo do logcat atual para o dispositivo.
`InputStreamSource`	`getLogcatSince(long date)` Captura um fluxo de snapshot dos dados do logcat capturados a partir da data fornecida.
`String`	`getMacAddress()` Retorna o endereço MAC do dispositivo, retorna nulo se não é possível fazer consultas no dispositivo.
`Integer`	`getMainUserId()` Retorna o ID do usuário principal.
	`getMainlineModuleInfo()` Consiga as informações sobre os módulos de linha principal instalados no dispositivo.
`int`	`getMaxNumberOfRunningUsersSupported()` Receba o número máximo permitido de usuários em execução simultânea.
`int`	`getMaxNumberOfUsersSupported()` Descubra o número máximo de usuários permitidos.
`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 de 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 do 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 PID e horário de início do processo especificado.
`String`	`getProcessPid(String process)` Retorna o pid do serviço ou retorna nulo se algo der errado.
`String`	`getProductType()` Método de conveniência para obter 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 fornecido do dispositivo.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Descubra o modo de recuperação atual usado para o dispositivo.
`InputStreamSource`	`getScreenshot(String format)` Faz uma captura de tela do dispositivo.
`InputStreamSource`	`getScreenshot(long displayId)` Faz uma captura de tela do dispositivo fornecido.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` Faz uma captura de tela do dispositivo.
`InputStreamSource`	`getScreenshot()` Faz uma captura de tela do dispositivo.
`String`	`getSerialNumber()` Método de conveniência para obter 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 realizada em um usuário do sistema.
`String`	`getSimOperator()` Retorna o operador 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 o dispositivo não estiver disponível.
	`getTombstones()` Busque e retorne a lista de tombstones dos dispositivos.
`long`	`getTotalMemory()` Retorna o tamanho total da memória física em bytes ou -1 em caso de erro interno
	`getUninstallablePackageNames()` Busque os nomes dos pacotes de aplicativos que podem ser desinstalados.
`boolean`	`getUseFastbootErase()` Escolha se você quer usar o formato "fastboot" ou "fastboot" para excluir permanentemente uma partição no dispositivo.
`int`	`getUserFlags(int userId)` Encontre e retorne as sinalizações 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. Em qualquer outro caso, retorna -10000.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Processa o DeviceEvent fornecido. Processe o DeviceEvent, que pode ou não fazer a transição desse dispositivo para um novo estado de alocação.
`boolean`	`hasFeature(String feature)` Verifique se um recurso está disponível em um dispositivo.
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` Instale um pacote Android no dispositivo.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` Instale 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.
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` Verificar se a plataforma do dispositivo oferece suporte à enumeração de apps
`boolean`	`isBypassLowTargetSdkBlockSupported()` Verificar se a plataforma no dispositivo oferece suporte à evasão de blocos de SDKs de destino baixos em instalações de apps
`boolean`	`isDebugfsMounted()` Verifique se o debugfs está ativado.
`boolean`	`isDeviceEncrypted()` Retorna se o dispositivo está criptografado.
`boolean`	`isDirectory(String path)` Retorna "True" se o caminho no dispositivo é um diretório. Caso contrário, retorna "false".
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Retorna se a criptografia for compatível com o dispositivo.
`boolean`	`isExecutable(String fullPath)` Retorna "True" se o caminho do arquivo no dispositivo é um arquivo executável. Caso contrário, retorna "false".
`boolean`	`isFastbootEnabled()` Retorne se o fastboot estiver disponível para o dispositivo.
`boolean`	`isHeadless()` Retorna "true" se o dispositivo for headless (sem tela). Caso contrário, retorna "false".
`boolean`	`isHeadlessSystemUserMode()` Retorna indicando 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 há suporte para vários usuários.
`boolean`	`isPackageInstalled(String packageName, String userId)` Consulte o dispositivo em busca de um determinado nome de pacote e ID do usuário para verificar se ele está instalado ou não para esse usuário.
`boolean`	`isPackageInstalled(String packageName)` Consulte o dispositivo em busca de um nome de pacote específico para verificar se ele está instalado ou não.
`boolean`	`isRuntimePermissionSupported()` Verificar se a plataforma do dispositivo é compatível com a concessão de permissões de execução
`boolean`	`isStateBootloaderOrFastbootd()` Retorna "true" se o dispositivo está em `TestDeviceState#FASTBOOT` ou `TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` Verifique se um determinado usuário está em execução.
`boolean`	`isUserSecondary(int userId)` Retorna se o usuário especificado é um usuário secundário, de acordo com as sinalizações dele.
`boolean`	`isUserVisible(int userId)` Verifica se um determinado usuário 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()` Informa 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 ANRs do dispositivo.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` Método auxiliar para registrar um relatório de bug e registrá-lo.
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Registre uma mensagem no logcat do dispositivo.
`void`	`mountDebugfs()` Montar debugfs.
`void`	`nonBlockingReboot()` Emite um comando para reinicializar o dispositivo e é retornado quando o comando é concluído, quando o dispositivo não está mais visível para o adb.
`void`	`postAdbRootAction()` Modifique se o dispositivo precisar que algumas ações específicas sejam realizadas depois do adb root e antes de o dispositivo ficar on-line novamente.
`void`	`postAdbUnrootAction()` Modifique se o dispositivo precisar que algumas ações específicas sejam realizadas depois que o adb for desconectado e antes que o dispositivo fique on-line novamente.
`void`	`postBootSetup()` Siga as instruções para configurar o dispositivo e fazer esses testes após cada inicialização.
`void`	`postInvocationTearDown(Throwable exception)` Etapas extras para a limpeza específica do dispositivo exigem a limpeza que será executada após a conclusão da invocação.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Etapas extras para uma configuração específica do dispositivo exigem que ele seja executado antes do fluxo de invocação.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` Extraia recursivamente o conteúdo do diretório do dispositivo.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Extraia 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, o armazena em um `ERROR(/File)` temporário local e retorna esse `File`.
`File`	`pullFile(String remoteFilePath)` Recupera um arquivo do dispositivo, o 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 prático para recuperar um arquivo do armazenamento externo do dispositivo, o armazena em um `ERROR(/File)` temporário local e retorna 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)` Enviar recursivamente o conteúdo do diretório para o dispositivo.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` Enviar recursivamente o conteúdo do diretório para o dispositivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` Variante de `pushFile(File, String)` que pode, opcionalmente, avaliar a necessidade do provedor de conteúdo.
`boolean`	`pushFile(File localFile, String remoteFilePath)` Envie um arquivo para o dispositivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Envie um arquivo para o dispositivo.
`boolean`	`pushString(String contents, String remoteFilePath)` Enviar por push o arquivo criado a partir de uma string para o dispositivo
`void`	`reboot(String reason)` Reinicializa o dispositivo no modo adb com o `reason` especificado a ser mantido durante a reinicialização.
`void`	`reboot()` Reinicializa o dispositivo no modo adb.
`void`	`rebootIntoBootloader()` Reinicializa o dispositivo no modo de carregador de inicialização.
`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 de sideload do adb. 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 de sideload do adb. Observe que esse é um modo especial em recuperação. Bloqueia até que o dispositivo entre no modo de sideload
`void`	`rebootUntilOnline()` Uma alternativa para `reboot()` que bloqueia apenas até que o dispositivo esteja on-line, ou seja, visível para o adb.
`void`	`rebootUntilOnline(String reason)` Uma alternativa para `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 para `rebootUserspace()` ()} que só é bloqueada 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()` Torne a partição do sistema no dispositivo somente leitura.
`void`	`remountSystemWritable()` Torne a partição do sistema no dispositivo gravável.
`void`	`remountVendorReadOnly()` Torne a partição do fornecedor no dispositivo somente leitura.
`void`	`remountVendorWritable()` Tornar a partição do fornecedor no dispositivo gravável.
`boolean`	`removeAdmin(String componentName, int userId)` Remove o administrador do dispositivo de um determinado usuário e retorna `true` quando o processo é bem-sucedido. Caso contrário, retorna `false`.
`void`	`removeOwners()` Remova todos os proprietários de perfil de dispositivo existentes da melhor maneira possível.
`boolean`	`removeUser(int userId)` Remove determinado usuário do dispositivo.
`void`	`resetContentProviderSetup()` Redefina a flag de configuração do provedor de conteúdo para acioná-la novamente.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Método de conveniência para executar `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 fornece recuperação de dispositivo.
`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`	`setConfiguration(IConfiguration configuration)` Injeta o `IConfiguration` em uso.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` Define a data no dispositivo Observação: para definir a data no dispositivo, é necessário ter acesso root
`boolean`	`setDeviceOwner(String componentName, int userId)` Define um componente de administrador do dispositivo como proprietário do dispositivo em um determinado usuário.
`void`	`setDeviceState(TestDeviceState deviceState)` Atualizar o estado do dispositivo.
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` Para o emulador, defina `SizeLimitedOutputStream` para registrar a saída
`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 será usado.
`void`	`setIDevice(IDevice newDevice)` Atualize o IDevice associado a esse ITestDevice.
`void`	`setLogStartDelay(int delay)` Define o tempo em ms de espera antes de iniciar a captura do logcat para 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 fornecido no dispositivo.
`void`	`setRecovery(IDeviceRecovery recovery)` Defina a `IDeviceRecovery` que será usada 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 realizada em um 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`	`setUseFastbootErase(boolean useFastbootErase)` Defina se você quer usar o formato de limpeza do fastboot ou do fastboot para excluir permanentemente uma partição no dispositivo.
`void`	`startLogcat()` Começa a capturar a saída do logcat do dispositivo em segundo plano.
`boolean`	`startUser(int userId)` Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento.
`boolean`	`startUser(int userId, boolean waitFlag)` Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento.
`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 salvos atualmente.
`boolean`	`stopUser(int userId)` Interrompe um determinado usuário.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Interrompa um determinado usuário.
`String`	`switchToAdbTcp()` Alterna o dispositivo para o modo adb-over-tcp.
`boolean`	`switchToAdbUsb()` Alterna o dispositivo para adb no modo usb.
`boolean`	`switchUser(int userId)` Mude para outro userId com um tempo limite padrão.
`boolean`	`switchUser(int userId, long timeout)` Troque para outro userId com o tempo limite fornecido como prazo.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Sincroniza de forma incremental o conteúdo de um diretório de arquivos local com o dispositivo.
`Bugreport`	`takeBugreport()` Crie um relatório de bug e o retorne dentro de um objeto `Bugreport` para processá-lo.
`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 em um estado criptografado.
`void`	`unmountDebugfs()` Desmonte debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Bloqueia até que a flag de inicialização do dispositivo seja definida.
`boolean`	`waitForDeviceAvailable()` Espera o dispositivo responder e ficar disponível para testes.
`boolean`	`waitForDeviceAvailable(long waitTime)` Espera o dispositivo responder e ficar disponível para testes.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Espera o dispositivo responder e ficar disponível sem considerar o caminho de recuperação.
`void`	`waitForDeviceBootloader()` Bloqueia até que o dispositivo fique visível pelo fastboot.
`boolean`	`waitForDeviceInRecovery(long waitTime)` Bloqueia o dispositivo no estado "recuperação adb" (observe que isso é diferente de `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Bloqueia o dispositivo no estado "adb sideload"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Bloqueios para que o dispositivo não esteja disponível, ou seja, ausentes no 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)` Espera o dispositivo responder a um comando básico do shell do adb.

Métodos protegidos
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` Cria o comando do SO para a sessão de comando do shell do adb e os args específicos
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` Crie um `RebootDeviceAction` para ser usado ao executar uma ação de reinicialização.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Execute uma reinicialização do adb.
`void`	`ensureRuntimePermissionSupported()` método auxiliar para gerar uma exceção se a permissão de tempo de execução não for compatível
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` Consiga a instância `RunUtil` a ser usada.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)`
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Busca uma propriedade do dispositivo no cache ddmlib por padrão e volta a "adb shell getprop" ou "fastboot getvar", dependendo se o dispositivo está ou não no modo fastboot (Fastboot getvar).
`boolean`	`isInRebootCallback()` Retorna se os callbacks de reinicialização estão sendo executados ou não.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Retorne `true` se o arquivo local for mais recente que o arquivo remoto.
`void`	`notifyRebootEnded()` Notifica todos os `IDeviceActionReceiver` sobre o evento de término de reinicialização.
`void`	`notifyRebootStarted()` Notifica todos os `IDeviceActionReceiver` sobre o evento de início de reinicialização.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Executa uma ação neste dispositivo.
`void`	`postAdbReboot()` Outras ações que podem ser realizadas após a reinicialização.
`void`	`prePostBootSetup()` Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) modifique esse método para uma configuração específica pós-inicialização.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Define a instância do Relógio a ser usada.
`void`	`setMicrodroidProcess(Process process)` Marca o TestDevice como microdroide 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 do comando.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` Aguarde até que o dispositivo fique indisponível (pare de gerar relatórios para o adb).

Constantes

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 do comando a serem executadas

Valor da constante: 2 (0x00000002)

Campos

CAMINHO DE DEPURAÇÃO

public static final String DEBUGFS_PATH

Cartão SD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

Opções

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Construtores públicos

Dispositivo nativo

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

Microotimização (cerca de 400 milissegundos) por meio da pré-busca de todas as propriedades necessárias, em vez de chamar "adb getprop" para cada uma delas. Ou seja, a busca de todas as propriedades é tão rápida quanto a busca de uma. Coisas como device.getApiLevel(), checkApiLevelAgainstNextRelease e getBuildAlias chamam "adb getprop" em segundo plano. Nós os buscamos em uma chamada e chamamos NativeDevice.setProperty. Mesmo que não façamos isso, o NativeDevice chamará setProperty e armazenará o resultado em cache para chamadas futuras. Estamos fazendo isso um pouco antes. Se o dispositivo estiver em recuperação ou se houver outros erros ao buscar as propriedades, eles serão ignorados.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Verifique se um recurso tem suporte no momento de acordo com um nível com suporte mínimo. Esse método considera recursos ainda não lançados antes que o nível da API seja aumentado.

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

Retorna
`boolean`	Verdadeiro se o nível for compatível. Falso, do contrário.

Gera
`DeviceNotAvailableException`

verificarConectividade

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` excessivamente.

Gera
`DeviceNotAvailableException`

ClearErrorDialogs

public boolean clearErrorDialogs ()

Tentativa de dispensar todas as caixas de diálogo de erro exibidas no momento na interface do dispositivo.

Retorna
`boolean`	`true` se nenhuma caixa de diálogo estiver presente ou se elas tiverem sido apagadas. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

ClearLastConnectedWiFiNetwork

public void clearLastConnectedWifiNetwork ()

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

limparLogcat

public void clearLogcat ()

Exclui todos os dados acumulados do logcat.

Isso é útil para os casos em que você quer garantir que o ITestDevice#getLogcat() retorne apenas dados de registro produzidos após um determinado ponto (por exemplo, após atualizar um novo build do dispositivo etc.).

conectar à rede Wi-Fi

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 estabelecida com uma das redes Wi-Fi indicadas no mapa de wifiSsidToPsk. Depois que a conexão é estabelecida, a instância tenta restaurá-la após cada reinicialização até que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() sejam chamados.

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

Retorna
`boolean`	`true` se conectado à rede Wi-Fi. Caso contrário, `false`

Gera
`DeviceNotAvailableException`

conectar à rede Wi-Fi

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 estabelecida com a rede Wi-Fi especificada. Depois que a conexão é estabelecida, a instância tenta restaurá-la após cada reinicialização até que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() sejam chamados.

Parâmetros
`wifiSsid`	`String`: o ssid do Wi-Fi a ser conectado.
`wifiPsk`	`String`: senha longa PSK ou nula se não estiver criptografada

Retorna
`boolean`	`true` se conectado à rede Wi-Fi. Caso contrário, `false`

Gera
`DeviceNotAvailableException`

conectar à rede Wi-Fi

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Conecta-se a uma rede Wi-Fi.

Ativa o Wi-Fi e bloqueia até que uma conexão seja estabelecida com uma das redes Wi-Fi indicadas no mapa de wifiSsidToPsk. Após a conexão ser estabelecida, a instância tenta restaurá-la após cada reinicialização até que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() sejam chamados.

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

Retorna
`boolean`	`true` se conectado à rede Wi-Fi. Caso contrário, `false`

Gera
`DeviceNotAvailableException`

conectar à rede Wi-Fi

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 ser conectado.
`wifiPsk`	`String`: senha longa PSK ou nula se não estiver criptografada
`scanSsid`	`boolean`: se é necessário procurar um SSID oculto para esta rede.

Retorna
`boolean`	`true` se conectado à rede Wi-Fi. Caso contrário, `false`

Gera
`DeviceNotAvailableException`

conectar aRedeWiFiSeÉ necessário

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 procurar um SSID oculto para esta rede.

Retorna
`boolean`	`true` se conectado à rede Wi-Fi. Caso contrário, `false`

Gera
`DeviceNotAvailableException`

conectar aRedeWiFiSeÉ necessário

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 conectado à rede Wi-Fi. Caso contrário, `false`

Gera
`DeviceNotAvailableException`

criarUsuário

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

Criar um usuário com um determinado nome e as flags fornecidas

Parâmetros
`name`	`String`: do usuário a ser criado no dispositivo.
`guest`	`boolean`: ativa a flag de usuário --guest durante a criação.
`ephemeral`	`boolean`: ativa a sinalização de usuário "-efêmero" durante a criação.

Retorna
`int`	ID do usuário criado

Gera
`DeviceNotAvailableException`

criarUsuário

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

Criar um usuário com um determinado nome e as flags fornecidas

Parâmetros
`name`	`String`: do usuário a ser criado no dispositivo.
`guest`	`boolean`: ativa a flag de usuário --guest durante a criação.
`ephemeral`	`boolean`: ativa a sinalização de usuário "-efêmero" durante a criação.
`forTesting`	`boolean`: ativa a flag de teste --for-testing durante a criação.

Retorna
`int`	ID do usuário criado

Gera
`DeviceNotAvailableException`

criarUsuário

public int createUser (String name)

Cria um usuário com um nome determinado 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)

Cria um usuário com um nome determinado 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 para o erro.

Gera
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

Gera
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath)

Método auxiliar para excluir um arquivo ou diretório do 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 vai ser removida.

deviceSoftReiniciado

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Método auxiliar para verificar se o dispositivo foi reiniciado de forma reversível, comparando o system_server atual com o ProcessInfo system_server anterior. 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 reversível

Gera
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Método auxiliar para verificar se o dispositivo foi reiniciado de forma reversível desde o horário UTC desde a época do dispositivo e da ERROR(/TimeUnit) dele. "Reinicialização em segundo plano" se refere ao system_server reiniciado fora de uma reinicialização forçada do dispositivo (por exemplo: reinicialização solicitada). O utcEpochTime do dispositivo atual em Milliseccond pode ser obtido pelo método getDeviceDate().

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

Retorna
`boolean`	`true` se o dispositivo for reiniciado de forma reversível

Gera
`DeviceNotAvailableException`

desativarAdbRoot

public boolean disableAdbRoot ()

Desativa a raiz do adb.

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

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

Gera
`DeviceNotAvailableException`

desativar Proteção de teclado

public void disableKeyguard ()

Tenta desativar o bloqueio de teclado.

Primeiro, aguarde o envio de entradas ficar pronto. 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 disputa ocasional. Em seguida, o comando é enviado para dispensar o bloqueio de teclado (funciona apenas em dispositivos não seguros).

Gera
`DeviceNotAvailableException`

desativarNetworkMonitor

public boolean disableNetworkMonitor ()

Desativa o monitoramento de rede no dispositivo.

Retorna
`boolean`	`true` se o monitoramento for desativado. `false` se falhar.

Gera
`DeviceNotAvailableException`

desconectarDoWi-Fi

public boolean disconnectFromWifi ()

Desconecta da rede Wi-Fi.

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

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

Gera
`DeviceNotAvailableException`

fazFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Método auxiliar para determinar se um arquivo existente 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 para verificar a existência do arquivo.

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

Gera
`DeviceNotAvailableException`

fazFileExist

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. Caso contrário, retorna `false`.

Gera
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Tenta despejar a heap do system_server. É responsabilidade do autor da chamada limpar o arquivo despejado.

Parâmetros
`process`	`String`: o nome do processo do dispositivo em que o despejo de heap será feito.
`devicePath`	`String`: o caminho no dispositivo em que o despejo será colocado. Precisa ser um local em que as permissões permitem.

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

Gera
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

Ativa a raiz do adb. Se a configuração "enable-root" for "false", registrará uma mensagem e retornará sem ativar a raiz.

A ativação da raiz do adb pode fazer com que o dispositivo se desconecte do adb. Esse método ficará 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 foi ativado. `false` se falhar.

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.

Use executeShellCommand(String) sempre que possível, porque esse método melhora a detecção de falhas e o desempenho.

Parâmetros
`timeout`	`long`: tempo em milissegundos até o dispositivo deixar de responder, 0L sem tempo limite.
`cmdArgs`	`String`: o comando e os argumentos do adb a serem executados.

Retorna
`String`	a 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.

Use executeShellCommand(String) sempre que possível, porque esse método melhora a detecção de falhas e o desempenho.

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

Retorna
`String`	a 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.

Use executeShellCommand(String) sempre que possível, porque esse método melhora a detecção de falhas e o desempenho.

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

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

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 dois minutos.

Deve ser usado quando o dispositivo já estiver no modo fastboot (Fastboot mode).

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

Retorna
`CommandResult`	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á estiver no modo fastboot (Fastboot mode).

Parâmetros
`timeout`	`long`: o tempo em milissegundos antes da expiração do comando.
`cmdArgs`	`String`: o comando fastboot e os argumentos a serem executados

Retorna
`CommandResult`	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), mas usa um tempo limite maior.

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

Retorna
`CommandResult`	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), mas usa 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`	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 do adb e retorna a saída como um String.

Parâmetros
`command`	`String`: o comando do shell do adb 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 do shell do adb, com mais parâmetros para controlar o comportamento do comando.

Parâmetros
`command`	`String`: o comando do shell do adb a ser executado.
`receiver`	`IShellOutputReceiver`: o `IShellOutputReceiver` para onde direcionar a saída do shell.
`maxTimeToOutputShellResponse`	`long`: o período máximo em que o comando não tem permissão para gerar nenhuma resposta. Unidade conforme especificado em `timeUnit`
`timeUnit`	`TimeUnit`: unidade de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de vezes que o comando é repetido se falhar devido a uma 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 do shell do adb, com mais parâmetros para controlar o comportamento do comando.

Parâmetros
`command`	`String`: o comando do shell do adb a ser executado.
`receiver`	`IShellOutputReceiver`: o `IShellOutputReceiver` para onde direcionar a saída do shell.
`maxTimeoutForCommand`	`long`: o tempo limite máximo para a conclusão do comando. Unidade conforme especificada em `timeUnit`.
`maxTimeToOutputShellResponse`	`long`: o período máximo em que o comando não tem permissão para gerar nenhuma resposta. Unidade conforme especificado em `timeUnit`
`timeUnit`	`TimeUnit`: unidade de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de vezes que o comando é repetido se falhar devido a uma exceção. DeviceNotResponsiveException será gerada se `retryAttempts` for executada sem sucesso.

Gera
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Executa o comando do shell do adb fornecido, 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 do shell do adb a ser executado.
`receiver`	`IShellOutputReceiver`: o `IShellOutputReceiver` para onde direcionar a saída do shell.

Gera
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

Método auxiliar que executa um comando do shell do 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 que 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 do adb e retorna os resultados como um CommandResult preenchido corretamente com a saída de status do comando e stderr. stdout é direcionado para o stream especificado.

Parâmetros
`cmd`	`String`: o comando que será executado.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` em que a saída std 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 do 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 que será executado.
`pipeAsInput`	`File`: uma `ERROR(/File)` que será encadeada como entrada para o comando ou nula.

Retorna
`CommandResult`	O resultado em `CommandResult`.

Gera
`DeviceNotAvailableException`

executeShellV2Command

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

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

Parâmetros
`cmd`	`String`: o comando do shell do adb a ser executado.
`maxTimeoutForCommand`	`long`: o tempo limite máximo para a conclusão do comando. Unidade conforme especificada em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de vezes que o comando é repetido se falhar devido a uma exceção. DeviceNotResponsiveException será gerada se `retryAttempts` for executada sem sucesso.

Retorna
`CommandResult`

Gera
`DeviceNotAvailableException`

executeShellV2Command

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

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

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

Retorna
`CommandResult`

Gera
`DeviceNotAvailableException`

executeShellV2Command

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

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

Parâmetros
`cmd`	`String`: o comando do shell do adb a ser executado.
`pipeAsInput`	`File`: uma `ERROR(/File)` que será encadeada como entrada para o comando ou nula.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` em que a saída std será redirecionada ou nula.
`maxTimeoutForCommand`	`long`: o tempo limite máximo para a conclusão do comando. Unidade conforme especificada em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de vezes que o comando é repetido se falhar devido a uma exceção. DeviceNotResponsiveException será gerada se `retryAttempts` for executada 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 do shell do adb, com mais parâmetros para controlar o comportamento do comando.

Parâmetros
`cmd`	`String`: o comando do shell do adb a ser executado.
`pipeAsInput`	`File`: uma `ERROR(/File)` que será encadeada como entrada para o comando ou nula.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` em que a saída std 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 especificada em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de vezes que o comando é repetido se falhar devido a uma exceção. DeviceNotResponsiveException será gerada se `retryAttempts` for executada 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, a limpeza do fastboot será usada para excluir permanentemente a partição. O dispositivo deverá criar um sistema de arquivos na próxima vez que for inicializado. Caso contrário, o formato fastboot é usado, o que cria um novo sistema de arquivos no dispositivo.

Deve ser usado quando o dispositivo já estiver no modo fastboot (Fastboot mode).

Parâmetros
`partition`	`String`: a partição a ser excluída permanentemente.

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

Gera
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

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

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

Gera
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

Retorna pares de chave-valor do namespace solicitado.

Parâmetros
`namespace`	`String`: precisa ser {"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)

Encontre e retorne o android-id associado a um userId. Ele será nulo se não for encontrado.

Parâmetros
`userId`	`int`

Retorna
`String`

Gera
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Cria um mapa de IDs do Android encontrados que correspondem a IDs de usuário. Não há garantia de que cada ID de usuário encontrará um ID do Android associado a essa função. Portanto, alguns IDs de usuário podem corresponder a valores nulos.

Retorna
	Foi encontrado um mapa de IDs do Android com IDs de usuário correspondentes.

Gera
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

Acessa 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`	`PackageInfo` ou `null` se as informações não puderem ser recuperadas

Gera
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

Busca informações dos 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 obter a versão de banda de base (rádio) deste dispositivo. A versão do rádio é específica do dispositivo e, portanto, 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 de versão. Essa ação não é precisa para alguns dispositivos CDMA, e a versão retornada pode não corresponder à versão informada pelo fastboot e não retornar a versão para o rádio CDMA. Texto longo, leia o resumo: esse método só informará a versão precisa 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 determiná-la (o dispositivo não tem rádio ou a string de versão não pode ser lida)

Gera
`DeviceNotAvailableException`

getBateria

public Integer getBattery ()

Retorna o nível de bateria atual de um dispositivo ou "Nulo" se o nível de bateria estiver indisponí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` de outra forma.

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 segundo desde o período) 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 período especificado no dispositivo até a unidade de tempo especificada. O utcEpochTime em milissegundos do dispositivo atual pode ser obtido pelo método getDeviceDate().

Parâmetros
`utcEpochTime`	`long`: o tempo do dispositivo desde o período.
`timeUnit`	`TimeUnit`: a unidade de tempo `TimeUnit`.

Retorna
	Mapa do tempo de inicialização (horário UTC em segundo desde o período) e motivo da inicialização

Gera
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

Método de conveniência para obter a versão do carregador de inicialização do dispositivo.

Tentará recuperar a versão do carregador de inicialização do estado atual do dispositivo. Ou seja, se o dispositivo estiver no modo fastboot, ele vai tentar recuperar a versão do fastboot

Retorna
`String`	a versão do carregador de inicialização `String` ou `null` se ela não for encontrada;

Gera
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

Recupera um relatório de bug do dispositivo.

A implementação dele garante continuar a funcionar em um dispositivo sem cartão SD (ou em que o cartão SD ainda não esteja ativado).

Retorna
`InputStreamSource`	Um `InputStreamSource` que produzirá o conteúdo do relatório de bug sob demanda. Em caso de falha, o `InputStreamSource` produzirá um `ERROR(/InputStream)` vazio.

getBugreportz

public InputStreamSource getBugreportz ()

Recupera um relatório de bugs do dispositivo. O relatório de bug no formato ZIP contém o principal relatório do bug 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, retorna nulo em caso de falha.

getBuildAlias

public String getBuildAlias ()

Recupera o alias da compilação que o dispositivo está executando no momento.

O alias de build geralmente é uma string mais legível do que o ID do 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 573038.

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

Gera
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Recuperar a variação de build do dispositivo.

Retorna
`String`	a variação de 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 com chaves de lançamento (controladas por fabricantes de dispositivos individuais).

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

Gera
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Retorna um DeviceDescriptor armazenado 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 armazenado em cache se o dispositivo estiver alocado. Caso contrário, retorna o DeviceDescriptor atual.

Parâmetros
`shortDescriptor`	`boolean`: se o descritor 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 às permissões.

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

Retorna
`String[]`	Matriz de strings que contém todo o arquivo 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 atual do dobrável do dispositivo ou retorna nulo caso ocorram 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 ()

Acessa a classe do dispositivo.

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

getDeviceDate

public long getDeviceDate ()

Retorna a data do dispositivo em milissegundos desde a época.

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

Gera
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

Retorna
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Retorna
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

Recebe o estado do dispositivo.

Retorna
`TestDeviceState`

getDeviceTimeShift

public long getDeviceTimeOffset (Date date)

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

Parâmetros
`date`	`Date`

Retorna
`long`	a diferença em milissegundos

Gera
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Acessar o stream do emulador stdout e stderr

Retorna
`InputStreamSource`	saída do emulador

getEmulatorProcess

public Process getEmulatorProcess ()

Retorne o Process correspondente a esse emulador.

Retorna
`Process`	`Process` ou `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 sendo usado. Ainda é necessário que isFastbootEnabled() seja verdadeiro para que as funções de fastboot estejam ativadas.

Retorna
`String`

getFastbootProductType

public String getFastbootProductType ()

Método de conveniência para obter o tipo de produto deste dispositivo quando ele está no modo fastboot.

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

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 de conveniência para obter 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 fornecido do dispositivo.

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

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

Gera
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

Retorna a string da versão do binário fastboot sendo usado. 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 "/". Ou seja, as sintaxes "/system" e "system" são compatíveis.

Retorna
`IFileEntry`	`IFileEntry` ou `null` se o arquivo em `path` não puder ser encontrado

Gera
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Assistente não oficial para receber um FileEntry de um caminho não raiz. FIXME: refatore o sistema FileEntry para que ele fique disponível em qualquer caminho. (mesmo sem raiz).

Parâmetros
`entry`	`FileListingService.FileEntry`: um `FileEntry` não necessariamente raiz, conforme exigido pela Ddmlib.

Retorna
`IFileEntry`	um FileEntryWrapper que representa a FileEntry.

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

getFoldableStates

public  getFoldableStates ()

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

Retorna

Gera
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

Retorna uma referência ao IDevice ddmlib associado.

Um novo IDevice pode ser alocado pelo DDMS sempre que o dispositivo se desconectar e se reconectar do adb. Portanto, os autores das chamadas não devem manter uma referência ao IDevice, porque essa referência pode ficar desatualizada.

Retorna
`IDevice`	`IDevice`

getInstallPackageNames

public  getInstalledPackageNames ()

Busque os nomes dos pacotes de apps presentes no dispositivo.

Retorna
	`ERROR(/Set)` de `String` nomes de pacotes atualmente 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 ()

Extrai 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 obter o estado atual do bloqueio de teclado ou nulo, se não houver suporte.

Retorna
`KeyguardControllerState`	um `KeyguardControllerState` contendo um snapshot do estado do bloqueio de teclado e retorna "Nulo" se a consulta do bloqueio de teclado não tiver suporte.

Gera
`DeviceNotAvailableException`

getLastLastRestartTimeMillis

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

Consiga 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 stream de snapshot dos dados do logcat.

Funciona de dois modos:

Se o Logcat está sendo capturado em segundo plano, ele retorna até TestDeviceOptions.getMaxLogcatDataSize() bytes do conteúdo atual da captura em segundo plano

Caso contrário, retorna um despejo estático dos dados do logcat se o dispositivo estiver respondendo.

Retorna
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

Extrai um stream de snapshot dos últimos maxBytes de dados do Logcat capturados.

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

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

Retorna
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

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

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

Retorna
`InputStreamSource`	uma `InputStreamSource` dos dados do Logcat. Um stream vazio será retornado se não for possível capturar os dados do Logcat.

getLogcatSince

public InputStreamSource getLogcatSince (long date)

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

Parâmetros
`date`	`long`: em milissegundos desde o formato de época do momento em que o snapshot será iniciado até o presente. (pode ser obtido usando 'data +%s')

Retorna
`InputStreamSource`

getMacAddress

public String getMacAddress ()

Retorna o endereço MAC do dispositivo, retorna nulo se não é possível fazer consultas no dispositivo.

Retorna
`String`

getMainUserId

public Integer getMainUserId ()

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`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Consiga as informações sobre os módulos de linha principal instalados no dispositivo.

Retorna
	`ERROR(/Set)` de `String` módulos de linha principal instalados atualmente no dispositivo.

Gera
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersAllowed

public int getMaxNumberOfRunningUsersSupported ()

Receba o número máximo permitido de usuários em execução simultânea. 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`

getMaxNumberOfUsersAllowed

public int getMaxNumberOfUsersSupported ()

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

Retorna
`int`	Um número inteiro que indica o número de usuários compatíveis

Gera
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

Retorna
`Process`	Retorna o processo da VM do Microdroid. Se TestDevice não for um Microdroid, retorna 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.

O que fazer: 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 de 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` contendo 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` contendo as informações em "/proc/mounts"

Gera
`DeviceNotAvailableException`

getOptions

public TestDeviceOptions getOptions ()

Busque as opções de teste do 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 PID e horário de início do processo especificado.

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

Retorna
`ProcessInfo`	ProcessInfo de determinado processName

Gera
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

Retorna o pid do serviço ou retorna 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 obter 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 fornecido do dispositivo.

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

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

Gera
`DeviceNotAvailableException`

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

Descubra o modo de recuperação atual usado para o dispositivo.

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

getCaptura de tela

public InputStreamSource getScreenshot (String format)

Faz uma captura de tela do dispositivo. É recomendável usar getCaptura de tela(format) em vez da codificação JPEG para tamanhos menores

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 for bem-sucedida.

Gera
`DeviceNotAvailableException`

getCaptura de tela

public InputStreamSource getScreenshot (long displayId)

Faz uma captura de tela do dispositivo fornecido. O formato é PNG.

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

Parâmetros
`displayId`	`long`: o ID da tela de onde a captura de tela será feita.

Retorna
`InputStreamSource`	Um `InputStreamSource` da captura de tela no formato ou `null` se a captura de tela não for bem-sucedida.

Gera
`DeviceNotAvailableException`

getCaptura de tela

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Faz uma captura de tela do dispositivo. É recomendável usar getScreenshot(String) com codificação JPEG para tamanhos menores.

Parâmetros
`format`	`String`: PNG e JPEG compatíveis
`rescale`	`boolean`: se a captura de tela precisar 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 for bem-sucedida.

Gera
`DeviceNotAvailableException`

getCaptura de tela

public InputStreamSource getScreenshot ()

Faz uma captura de tela do dispositivo.

Retorna
`InputStreamSource`	Um `InputStreamSource` da captura de tela em formato PNG ou `null` se a captura de tela não tiver sido bem-sucedida.

Gera
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

Método de conveniência para obter 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:key 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 realizada em um usuário do sistema.

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

Retorna
`String`

Gera
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

Retorna o operador 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 o dispositivo não estiver disponível.

Retorna
`String`

getTombstones

public  getTombstones ()

Busque e retorne a lista de tombstones dos dispositivos. Requer acesso root.

é o melhor esforço para que, se uma tombstone não for extraída por qualquer motivo, ela estará faltando na lista. Apenas um DeviceNotAvailableException encerrará o método antecipadamente.

Retorna
	Uma lista de arquivos de tombstone, vazia se não houver nenhuma.

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`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Busque os nomes dos pacotes de aplicativos que podem ser desinstalados. No momento, isso é definido como pacotes que não são do sistema e pacotes de sistema atualizados.

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

Gera
`DeviceNotAvailableException`

getUseFastbootApagar

public boolean getUseFastbootErase ()

Escolha se você quer usar o formato "fastboot" ou "fastboot" para excluir permanentemente uma partição no dispositivo.

Retorna
`boolean`	`true` se a limpeza do fastboot for usada, ou `false` se o formato fastboot for usado.

getUserFlags

public int getUserFlags (int userId)

Encontre e retorne as sinalizações 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 sinalizações associadas ao userId fornecido, se encontrados, -10000 em qualquer outro caso.

Gera
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Recebe o mapa de useId para UserInfo no dispositivo. Uma DeviceRuntimeException vai ser gerada 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. Em qualquer outro caso, retorna -10000.

Parâmetros
`userId`	`int`

Retorna
`int`

Gera
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

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

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

Retorna
`boolean`	Verdadeiro se o atributo for encontrado. Caso contrário, será falso.

Gera
`DeviceNotAvailableException`

installPackage

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

Instale um pacote Android no dispositivo.

Parâmetros
`packageFile`	`File`: o arquivo apk a ser instalado.
`reinstall`	`boolean`: `true` se uma reinstalação precisar ser realizada.
`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` em caso de sucesso.

Gera
`DeviceNotAvailableException`

installPackage

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

Instale um pacote Android no dispositivo.

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

Parâmetros
`packageFile`	`File`: o arquivo apk a ser instalado.
`reinstall`	`boolean`: `true` se uma reinstalação precisar ser realizada.
`grantPermissions`	`boolean`: se todas as permissões de execução forem 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` em caso de sucesso.

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 realizada.
`userId`	`int`: o ID do usuário inteiro para fazer a 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` em caso de sucesso.

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: somente os casos de uso que exigem controle explícito da concessão de permissão de execução no momento da instalação precisam chamar essa função.

Parâmetros
`packageFile`	`File`: o arquivo apk a ser instalado.
`reinstall`	`boolean`: `true` se uma reinstalação precisar ser realizada.
`grantPermissions`	`boolean`: se todas as permissões de execução forem concedidas no momento da instalação
`userId`	`int`: o ID do usuário inteiro para fazer a 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` em caso de sucesso.

Gera
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

AdbRoot

public boolean isAdbRoot ()

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

Retorna
`boolean`

isAppEnumerationsupported

public boolean isAppEnumerationSupported ()

Verificar se a plataforma do dispositivo oferece suporte à enumeração de apps

Retorna
`boolean`	Verdadeiro se a enumeração do app for compatível. Caso contrário, é falso.

Gera
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockAllowed

public boolean isBypassLowTargetSdkBlockSupported ()

Verificar se a plataforma no dispositivo oferece suporte à evasão de blocos de SDKs de destino baixos em instalações de apps

Retorna
`boolean`	Verdadeiro se o bloco do SDK de destino inferior for compatível. Caso contrário, será falso

Gera
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Verifique se o debugfs está ativado.

Retorna
`boolean`	`true` se o 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`

Diretório isDirectory

public boolean isDirectory (String path)

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

Parâmetros
`path`	`String`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

Retorna
`boolean`	`true` se a raiz do adb precisar ser ativada no dispositivo.

isEncryptionsupported

public boolean isEncryptionSupported ()

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

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

Gera
`DeviceNotAvailableException`

IsExecutável

public boolean isExecutable (String fullPath)

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

Parâmetros
`fullPath`	`String`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

Retorne se o fastboot estiver disponível para o dispositivo.

Retorna
`boolean`

isHeadless

public boolean isHeadless ()

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

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Retorna indicando 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 há suporte para vários usuários.

Retorna
`boolean`	verdadeiro se houver suporte para vários usuários; caso contrário, falso

Gera
`DeviceNotAvailableException`

isPackageInstall

public boolean isPackageInstalled (String packageName, 
                String userId)

Consulte o dispositivo em busca de um determinado nome de pacote e ID do 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 em que o pacote está instalado. Se nulo, o usuário principal zero será usado.

Retorna
`boolean`	Verdadeiro se o pacote for relatado como instalado. Falso, do contrário.

Gera
`DeviceNotAvailableException`

isPackageInstall

public boolean isPackageInstalled (String packageName)

Consulte o dispositivo em busca de um nome de pacote específico para verificar se ele está instalado ou não.

Parâmetros
`packageName`	`String`

Retorna
`boolean`	Verdadeiro se o pacote for relatado como instalado. Falso, do contrário.

Gera
`DeviceNotAvailableException`

isRuntimePermissionAllowed

public boolean isRuntimePermissionSupported ()

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

Retorna
`boolean`	Verdadeiro se a permissão de execução for compatível. Caso contrário, retorna falso.

Gera
`DeviceNotAvailableException`

isStatebootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

Retorna "true" se o dispositivo está em TestDeviceState#FASTBOOT ou TestDeviceState.FASTBOOTD.

Retorna
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

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

Parâmetros
`userId`	`int`

Retorna
`boolean`	Verdadeiro se o usuário estiver correndo e falso em todos os outros casos.

Gera
`DeviceNotAvailableException`

Secundário do usuário

public boolean isUserSecondary (int userId)

Retorna se o usuário especificado é um usuário secundário, de acordo com as sinalizações dele.

Parâmetros
`userId`	`int`

Retorna
`boolean`	verdadeiro se o usuário for secundário. Caso contrário, falso.

Gera
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

Verifica se um determinado usuário está visível.

Um usuário "visível" é aquele que interage 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 nessa 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 isso acontecer, você pode chamar startVisibleBackgroundUser(int, int, boolean), transmitindo uma tela retornada por listDisplayIdsForStartingVisibleBackgroundUsers() (que precisa incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isVisibleBackgroundUsersAllowed

public boolean isVisibleBackgroundUsersSupported ()

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

Se isso acontecer, você pode chamar startVisibleBackgroundUser(int, int, boolean), transmitindo uma tela retornada por listDisplayIdsForStartingVisibleBackgroundUsers().

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

Compatível com Wi-Fi

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 dos testes que não podem ser executados com Wi-Fi, como 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 exibições. O padrão sempre retorna a exibição 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. Um DeviceRuntimeException vai ser gerado 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 ANRs do dispositivo.

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

Retorna
`boolean`	True, se a geração de registros foi bem-sucedida. Caso contrário, false.

Gera
`DeviceNotAvailableException`

relatório do bug

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Método auxiliar para registrar um relatório de bug e registrá-lo.

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

Retorna
`boolean`	True, se a geração de registros foi bem-sucedida. 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 será gerada mesmo se a geração de registros falhar.

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 por String.format().

mountDebugfs

public void mountDebugfs ()

Montar debugfs.

Gera
`DeviceNotAvailableException`

nonBlockingReiniciar

public void nonBlockingReboot ()

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

Gera
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Modifique se o dispositivo precisar que algumas ações específicas sejam realizadas depois do adb root e antes de o dispositivo ficar on-line novamente. A implementação padrão não inclui ações de adição. Não há garantia de que a raiz do adb esteja ativada nesta etapa.

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

postAdbUnrootAction

public void postAdbUnrootAction ()

Modifique se o dispositivo precisar que algumas ações específicas sejam realizadas depois que o adb for desconectado e antes que o dispositivo fique on-line novamente. A implementação padrão não inclui outras ações. Não há garantia de que a raiz do adb será desativada nesta etapa.

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

pós-inicialização

public void postBootSetup ()

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

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

Em circunstâncias normais, esse método não precisa ser chamado explicitamente, já que as implementações precisam realizar essas etapas automaticamente ao realizar uma reinicialização.

Talvez ele precise ser chamado quando o dispositivo for reinicializado 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 a limpeza específica do dispositivo exigem a limpeza que será executada após a conclusão da invocação.

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

Configuração preInvocation

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

Etapas extras para uma configuração específica do dispositivo exigem que ele seja executado 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)

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

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

Retorna
`boolean`	`true` se o arquivo foi extraído. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

PullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

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

Parâmetros
`deviceFilePath`	`String`: o caminho absoluto do arquivo da origem remota.
`localDir`	`File`: o diretório local para onde os arquivos serão extraídos

Retorna
`boolean`	`true` se o arquivo foi extraído. Caso contrário, `false`.

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 em que o conteúdo será armazenado. Se não estiver vazio, o conteúdo será substituído.

Retorna
`boolean`	`true` se o arquivo tiver sido recuperado. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

Recupera um arquivo do dispositivo, o 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 de onde extrair

Retorna
`File`	Um `ERROR(/File)` contendo o conteúdo do arquivo do dispositivo ou `null` se a cópia falhar 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, o 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)` contendo o conteúdo do arquivo do dispositivo ou `null` se a cópia falhar 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 em que o conteúdo será armazenado. Se não estiver vazio, o conteúdo será substituído.
`userId`	`int`: o ID do usuário de onde extrair

Retorna
`boolean`	`true` se o arquivo tiver sido recuperado. Caso contrário, `false`.

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` contendo o conteúdo do arquivo do dispositivo ou `null` se a cópia falhar por qualquer motivo (incluindo problemas com o sistema de arquivos do host)

Gera
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

Um método prático para recuperar um arquivo do armazenamento externo do dispositivo, o armazena em um ERROR(/File) temporário local e retorna uma referência a esse File.

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

Retorna
`File`	Um `ERROR(/File)` contendo o conteúdo do arquivo do dispositivo ou `null` se a cópia falhar 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.

Retorna
`boolean`	`true` se o arquivo foi enviado. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Enviar recursivamente o conteúdo do diretório 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 arquivo foi enviado. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

pushDir

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

Enviar recursivamente o conteúdo do diretório 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 a ser enviado.

Retorna
`boolean`	`true` se o arquivo foi enviado. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

pushFile

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

Variante de pushFile(File, String) que pode, opcionalmente, avaliar a necessidade do 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 arquivo foi enviado. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

Envie um arquivo 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 arquivo foi enviado. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

pushFile

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

Envie um arquivo 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 a ser enviado.

Retorna
`boolean`	`true` se o arquivo foi enviado. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

Enviar por push o arquivo criado a partir 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. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

reiniciar

public void reboot (String reason)

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

Bloqueia até que o dispositivo fique disponível.

O último motivo da reinicialização pode ser encontrado 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`

reinicializarIntobootloader

public void rebootIntoBootloader ()

Reinicializa o dispositivo no modo de carregador de inicialização.

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

Gera
`DeviceNotAvailableException`

reinicializarIntoFastbootd

public void rebootIntoFastbootd ()

Reinicializa o dispositivo no modo fastbootd.

Bloqueia até que o dispositivo entre no modo fastbootd.

Gera
`DeviceNotAvailableException`

reinicializarIntoRecovery

public void rebootIntoRecovery ()

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

Bloqueia até que o dispositivo inicie a recuperação

Gera
`DeviceNotAvailableException`

reinicializarIntoSideload

public void rebootIntoSideload ()

Reinicializa o dispositivo no modo de sideload do adb. Observe que esse é um modo especial em recuperação.

Bloqueia até que o dispositivo entre no modo de sideload

Gera
`DeviceNotAvailableException`

reinicializarIntoSideload

public void rebootIntoSideload (boolean autoReboot)

Reinicializa o dispositivo no modo de sideload do adb. 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`

reinicializarUntilOnline

public void rebootUntilOnline ()

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

Gera
`DeviceNotAvailableException`

reinicializarUntilOnline

public void rebootUntilOnline (String reason)

Uma alternativa para 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`

Reinicializar espaço do usuário

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-a por sua conta e risco.

Gera
`DeviceNotAvailableException`

reinicializarUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

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

Gera
`DeviceNotAvailableException`

recupereDispositivo

public boolean recoverDevice ()

Tenta recuperar a comunicação do dispositivo.

Retorna
`boolean`	Verdadeiro em caso de tentativa e êxito de recuperação. Retorna "Falso" se a recuperação foi ignorada

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

registrarDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra um IDeviceActionReceiver para este dispositivo.

Todos os IDeviceActionReceivers registrados vão ser notificados antes que uma ação do dispositivo inicie e depois que ela termine.

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

remountSystemReadOnly

public void remountSystemReadOnly ()

Torne a partição do sistema no dispositivo somente leitura. Pode reinicializar o dispositivo.

Gera
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

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

Gera
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

Torne a partição do fornecedor no dispositivo somente leitura. Pode reinicializar o dispositivo.

Gera
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

Tornar a partição do fornecedor no dispositivo gravável. Pode reinicializar o dispositivo.

Gera
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Remove o administrador do dispositivo de um determinado usuário e retorna true quando o processo é bem-sucedido. Caso contrário, retorna false.

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

Retorna
`boolean`	Verdadeiro se for bem-sucedido, caso contrário, falso.

Gera
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Remova todos os proprietários de perfil de dispositivo existentes da melhor maneira possível.

Gera
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

Remove determinado usuário do dispositivo.

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

Retorna
`boolean`	verdadeiro se conseguirmos remover o usuário, caso contrário é falso.

Gera
`DeviceNotAvailableException`

resetContentProviderConfigurar

public void resetContentProviderSetup ()

Redefina a flag de configuração do provedor de conteúdo para acioná-la novamente.

runInstrumentationTests

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

Método de conveniência para executar 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 resultado do teste

Retorna
`boolean`	`true` se o comando de teste tiver sido concluído. `false` se não foi possível concluir, mas a recuperação foi bem-sucedida

Gera
`DeviceNotAvailableException`

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Executa testes de instrumentação e fornece recuperação de dispositivo.

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. Os autores da chamada podem tentar novamente, se necessário.

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á gerada.

Parâmetros
`runner`	`IRemoteAndroidTestRunner`: o `IRemoteAndroidTestRunner` que executa os testes.
`listeners`	: os listeners do resultado do teste.

Retorna
`boolean`	`true` se o comando de teste tiver sido concluído. `false` se ela não for concluída devido a uma exceção de comunicação do dispositivo, mas a recuperação for 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`

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`

definirData

public void setDate (Date date)

Define a data no dispositivo

Observação: para definir a data no dispositivo, é necessário ter acesso root

Parâmetros
`date`	`Date`: especifica uma data específica. A data do host será usada se `null`.

Gera
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Define um componente de administrador do dispositivo como proprietário do dispositivo em um determinado usuário.

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

Retorna
`boolean`	Verdadeiro se for bem-sucedido, caso contrário, falso.

Gera
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Atualizar o estado do dispositivo.

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

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

Para o emulador, defina SizeLimitedOutputStream para registrar a saída

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. Precisa ser definido quando o dispositivo é alocado pela primeira vez.

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

setFastbootPath

public void setFastbootPath (String fastbootPath)

Define o caminho para o binário fastboot que será usado. Ainda é necessário que isFastbootEnabled() seja verdadeiro para que as funções de fastboot estejam ativadas.

Parâmetros
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Atualize o IDevice associado a esse 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 de espera antes de iniciar a captura do logcat para 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 fornecido no dispositivo. Exige que a raiz do adb seja verdadeira.

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

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

Gera
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

Defina a IDeviceRecovery que será usada neste dispositivo. Precisa 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 o método de recuperação a ser usado quando um problema de comunicação do dispositivo for encontrado. É recomendável usar esse método apenas quando necessário (por exemplo, quando o framework estiver inativo etc.).

Parâmetros
`mode`	`ITestDevice.RecoveryMode`: se o modo "recuperar até apenas on-line" precisa estar ativado ou não.

setSetting

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

Consulte setSetting(int, String, String, String) e realizada em um 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ó estarão 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`

definirUsarFastbootLimpar

public void setUseFastbootErase (boolean useFastbootErase)

Defina se você quer usar o formato de limpeza do fastboot ou do fastboot para excluir permanentemente uma partição no dispositivo.

Parâmetros
`useFastbootErase`	`boolean`: `true` se for necessário usar a limpeza do fastboot ou `false` se o formato fastboot precisar ser usado.

startLogcat

public void startLogcat ()

Começa 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 mais tarde pelo getLogcat.

Quando o dispositivo não estiver mais em uso, será necessário chamar stopLogcat().

startLogcat() e stopLogcat() normalmente não precisam ser chamados quando dentro de um contexto de invocação do TF, já que o framework do TF iniciará e interromperá o Logcat.

usuáriode inicialização

public boolean startUser (int userId)

Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. Se o usuário já estiver executando em segundo plano, esse método será NOOP.

Parâmetros
`userId`	`int`: do usuário que começa em segundo plano

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

Gera
`DeviceNotAvailableException`

usuáriode inicialização

public boolean startUser (int userId, 
                boolean waitFlag)

Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. Se o usuário já estiver executando em segundo plano, esse método será NOOP. É possível fornecer sinalização extra para aguardar que a operação tenha efeito.

Parâmetros
`userId`	`int`: do usuário que começa em segundo plano
`waitFlag`	`boolean`: fará o comando aguardar até que o usuário seja iniciado e desbloqueado.

Retorna
`boolean`	verdadeiro se o usuário tiver sido iniciado com sucesso 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 que começa em segundo plano
`displayId`	`int`: tela para iniciar visíveis ao usuário
`waitFlag`	`boolean`: fará o comando aguardar até que o usuário seja iniciado e desbloqueado.

Retorna
`boolean`	`true` se o usuário tiver sido iniciado visível 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 salvos atualmente.

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

stopUser

public boolean stopUser (int userId)

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

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

Retorna
`boolean`	verdadeiro se o usuário tiver sido interrompido.

Gera
`DeviceNotAvailableException`

stopUser

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

Interrompa um determinado usuário. É possível fornecer sinalizações extras para aguardar até que a operação tenha efeito e forçar o encerramento do usuário. Não é possível interromper o usuário atual e o do sistema.

Parâmetros
`userId`	`int`: do usuário a ser interrompido.
`waitFlag`	`boolean`: fará o comando esperar até que o usuário seja interrompido.
`forceFlag`	`boolean`: força o fechamento do usuário.

Retorna
`boolean`	verdadeiro se o usuário tiver sido interrompido.

Gera
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

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

Retorna
`String`	O número de série TCP ou `null` se não for possível alternar o dispositivo

Gera
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Alterna o dispositivo para adb no modo 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 userId. Falso, do contrário.

Gera
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

Troque para outro userId com o tempo limite fornecido como prazo. Tentativa de desativar o bloqueio de teclado após a alteração do usuário.

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

Retorna
`boolean`	Verdadeiro se o novo userId corresponder ao provedor userId. Falso, do contrário.

Gera
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

decide quais arquivos enviar comparando carimbos de data/hora de arquivos locais com os equivalentes remotos. Apenas arquivos "mais recentes" ou inexistentes serão enviados ao dispositivo. Assim, a sobrecarga será relativamente pequena se o arquivo definido no dispositivo já estiver atualizado.

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

Exemplo de uso: syncFiles("/tmp/files", "/sdcard") cria um diretório /sdcard/files se ele ainda não existe e envia recursivamente o conteúdo /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, enviar para /data/local/tmp quando o adb não for raiz vai falhar

Retorna
`boolean`	`true` se os arquivos foram sincronizados. Caso contrário, `false`.

Gera
`DeviceNotAvailableException`

Relatório TakeBug

public Bugreport takeBugreport ()

Crie um relatório de bug e o retorne dentro de um objeto Bugreport para processá-lo. Retorne um valor nulo em caso de problema. O arquivo referenciado no objeto Bugreport precisa ser limpo com Bugreport.close().

Retorna
`Bugreport`

desinstalarPackage

public String uninstallPackage (String packageName)

Desinstala um pacote Android do dispositivo.

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

Retorna
`String`	um `String` com um código de erro ou `null` em caso de sucesso.

Gera
`DeviceNotAvailableException`

desinstalarPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

Retorna
`String`	um `String` com um código de erro ou `null` em caso de sucesso.

Gera
`DeviceNotAvailableException`

desbloquearDispositivo

public boolean unlockDevice ()

Desbloqueia o dispositivo se ele estiver em um estado 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 for bem-sucedido ou se o dispositivo não estiver criptografado.

Gera
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

Desmonte debugfs.

Gera
`DeviceNotAvailableException`

"waitForBootComplete"

public boolean waitForBootComplete (long timeOut)

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

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

Retorna
`boolean`	verdadeiro se a sinalização de inicialização do dispositivo estiver definida dentro do tempo limite

Gera
`DeviceNotAvailableException`

"waitForDeviceAvailable"

public boolean waitForDeviceAvailable ()

Espera o dispositivo responder e ficar disponível para testes. Usa o tempo limite padrão.

Retorna
`boolean`	Verdadeiro se o dispositivo estiver disponível. Falso se a recuperação estiver desativada e indisponível.

Gera
`DeviceNotAvailableException`

"waitForDeviceAvailable"

public boolean waitForDeviceAvailable (long waitTime)

Espera o dispositivo responder e ficar disponível para testes.

Parâmetros
`waitTime`	`long`: o tempo de espera em ms

Retorna
`boolean`	Verdadeiro se o dispositivo estiver disponível. Falso se a recuperação estiver desativada e indisponível.

Gera
`DeviceNotAvailableException`

"waitForDeviceAvailableInRecoverPath"

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Espera o dispositivo responder e ficar 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 disponível.

Gera
`DeviceNotAvailableException`

"waitForDeviceBootloader"

public void waitForDeviceBootloader ()

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

Gera
`DeviceNotAvailableException`

"waitForDeviceInRecovery"

public boolean waitForDeviceInRecovery (long waitTime)

Bloqueia o dispositivo no estado "recuperação adb" (observe que isso é diferente de IDeviceRecovery).

Parâmetros
`waitTime`	`long`: o tempo de espera em ms

Retorna
`boolean`	`true` se o dispositivo for inicializado para a recuperação antes de o tempo expirar. Caso contrário, `false`

"waitForDeviceInSideload"

public boolean waitForDeviceInSideload (long waitTime)

Bloqueia o dispositivo no estado "adb sideload"

Parâmetros
`waitTime`	`long`: o tempo de espera em ms

Retorna
`boolean`	`true` se o dispositivo for inicializado no sideload antes de o tempo expirar. Caso contrário, `false`

"waitForDeviceNotAvailable"

public boolean waitForDeviceNotAvailable (long waitTime)

Bloqueios para que o dispositivo não esteja disponível, ou seja, ausentes no adb

Parâmetros
`waitTime`	`long`: o tempo de espera em ms

Retorna
`boolean`	`true` se o dispositivo não estiver disponível antes de o tempo expirar. Caso contrário, `false`

"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 ser necessariamente responsivo a comandos após a conclusão. Use waitForDeviceAvailable().

Gera
`DeviceNotAvailableException`

"waitForDeviceOnline"

public void waitForDeviceOnline (long waitTime)

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

O dispositivo pode não ser necessariamente responsivo a comandos após a conclusão. Use waitForDeviceAvailable().

Parâmetros
`waitTime`	`long`: o tempo de espera em ms

Gera
`DeviceNotAvailableException`

"waitForDeviceShell"

public boolean waitForDeviceShell (long waitTime)

Espera o dispositivo responder a um comando básico do shell do adb.

Parâmetros
`waitTime`	`long`: o tempo de espera em ms

Retorna
`boolean`	`true` se o dispositivo começar a responder antes 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 de comando do shell do adb e os args específicos

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

Retorna
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

Parâmetros
`feature`	`String`
`strictMinLevel`	`int`

createReiniciarDeviceAction

protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

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

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

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

createRunUtil

protected IRunUtil createRunUtil ()

Retorna
`IRunUtil`

doAdbReiniciar

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

Execute uma reinicialização do adb.

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

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

certifiqueRuntimePermissionAllowed

protected void ensureRuntimePermissionSupported ()

método auxiliar para gerar uma 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 ()

Consiga a instância RunUtil a ser usada.

Retorna
`IRunUtil`

inicializeConnection

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

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

Gera
`DeviceNotAvailableException`
`TargetSetupError`

internalGetProperty

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

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

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 à consulta. Se for `null`, não haverá tentativa de consulta ao fastboot.
`description`	`String`: uma descrição simples da variável. A primeira letra deve estar em maiúscula.

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

Gera
`DeviceNotAvailableException`

isInReiniciarCallback

protected boolean isInRebootCallback ()

Retorna se os callbacks de reinicialização estão sendo executados ou não. Se definido como verdadeiro, todas as APIs públicas para reinicialização precisam ser desativadas.

Retorna
`boolean`

IsNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Retorne true se o arquivo local for mais recente que o arquivo remoto. a precisão de IFileEntry em relação ao minuto, caso sejam iguais, o arquivo será considerado mais recente.

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

Retorna
`boolean`

notificarReiniciarEnded

protected void notifyRebootEnded ()

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

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

notificarReiniciarIniciado

protected void notifyRebootStarted ()

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

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

performDeviceAction

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

Executa uma ação neste dispositivo. Tenta recuperar o dispositivo e, opcionalmente, repetir 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`: a repetição tenta realizar a ação se falhar, mas a recuperação é bem-sucedida.

Retorna
`boolean`	`true` se a ação tiver sido realizada

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

pós-reinicialização do Adb

protected void postAdbReboot ()

Outras ações que podem ser realizadas após a reinicialização.

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

Configuração PrePostBoot

protected void prePostBootSetup ()

Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) modifique esse método para uma configuração específica pós-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`

definir relógio

protected void setClock (Clock clock)

Define a instância do Relógio a ser usada.

Parâmetros
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Marca o TestDevice como microdroide e define o CID dele.

Parâmetros
`process`	`Process`: processo da VM do 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 do comando.

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 indisponível.
`time`	`long`: o tempo de espera pela indisponibilidade.

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

Dispositivo nativo

Resumo

Classes aninhadas

Constantes

Campos

Construtores públicos

Métodos públicos

Métodos protegidos

Constantes

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

Campos

CAMINHO DE DEPURAÇÃO

Cartão SD

STORAGE_EMULATED

Opções

mStateMonitor

Construtores públicos

Dispositivo nativo

Métodos públicos

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

verificarConectividade

ClearErrorDialogs

ClearLastConnectedWiFiNetwork

limparLogcat

conectar à rede Wi-Fi

conectar à rede Wi-Fi

conectar à rede Wi-Fi

conectar à rede Wi-Fi

conectar aRedeWiFiSeÉ necessário

conectar aRedeWiFiSeÉ necessário

criarUsuário

criarUsuário

criarUsuário

createUserNoThrow

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftReiniciado

deviceSoftRestartedSince

desativarAdbRoot

desativar Proteção de teclado

desativarNetworkMonitor

desconectarDoWi-Fi

fazFileExist

fazFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

getAndroidIds

getApiLevel

getAppPackageInfo

getAppPackageInfos

getBasebandVersion