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.

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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

Subclasses diretas conhecidas

TestDevice

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

Subclasses indiretas conhecidas

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice

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

Implementação padrão de um ITestDevice Dispositivos Android com pilha não completa.

Resumo

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

Constantes
`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 nova execução de comando a serem realizadas

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 delas.
`boolean`	`canSwitchToHeadlessSystemUser()` Retorna se é permitido alternar para o usuário do sistema sem cabeça.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Verifica se um recurso tem suporte no momento, considerando um nível mínimo de compatibilidade.
`boolean`	`checkConnectivity()` Verifique se o dispositivo tem conectividade de rede.
`boolean`	`clearErrorDialogs()` Tente dispensar as caixas de diálogo de erro exibidas na interface do dispositivo.
`void`	`clearLastConnectedWifiNetwork()` Limpa a última rede Wi-Fi conectada.
`void`	`clearLogcat()` Exclui todos os dados de logcat acumulados.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Conecta-se a uma rede Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Conecta-se a uma rede Wi-Fi.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Conecta-se a uma rede Wi-Fi.
`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 nome e as flags fornecidas
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Criar um usuário com um nome e as flags fornecidas
`int`	`createUser(String name)` Crie um usuário com um nome e flags padrão 0.
`int`	`createUserNoThrow(String name)` Crie um usuário com um nome e flags padrão 0.
`void`	`deleteFile(String deviceFilePath, int userId)` Método auxiliar para excluir um arquivo ou diretório no dispositivo.
`void`	`deleteFile(String deviceFilePath)` Método auxiliar para excluir um arquivo ou diretório no dispositivo.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Remove o `IDeviceActionReceiver` registrado.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Método auxiliar para verificar se o dispositivo foi reiniciado 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 desde o horário UTC desde a época do dispositivo e do `ERROR(/TimeUnit)`.
`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 de uma rede Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` Método auxiliar para determinar se o arquivo no dispositivo existe para um determinado usuário.
`boolean`	`doesFileExist(String deviceFilePath)` Método auxiliar para determinar se o arquivo no dispositivo existe.
`File`	`dumpHeap(String process, String devicePath)` Tenta despejar a pilha 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 de inicialização rápida como um comando do sistema com um tempo limite padrão de 2 minutos.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` Método auxiliar que executa um comando fastboot como um comando do sistema.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` Método auxiliar que executa um comando de inicialização rápida de longa duração como um comando do sistema.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` Método auxiliar que executa um comando de inicialização rápida de longa duração como um comando do sistema com variáveis de ambiente do sistema.
`String`	`executeShellCommand(String command)` Método auxiliar que executa um comando do shell adb e retorna a saída como um `String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Executa o comando adb shell 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 de shell do adb e retorna os resultados como um `CommandResult` preenchido corretamente com a saída de status do comando e o stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` Método auxiliar que executa um comando do shell adb e retorna os resultados como um `CommandResult` preenchido corretamente com a saída de status do comando, stdout e stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
`CommandResult`	`fastbootWipePartition(String partition)` Método auxiliar que limpa uma partição do dispositivo.
	`getActiveApexes()` Busca as informações sobre os APEXes 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)` Encontra e retorna o Android-ID associado a um userId, nulo se não 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)` Buscar 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 atual da bateria de um dispositivo ou nulo se o nível da bateria não estiver disponível.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` Retorna o valor booleano da propriedade especificada.
	`getBootHistory()` O método auxiliar coleta o mapa do histórico de inicialização com o horário e o motivo da inicialização.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização desde o tempo fornecido desde a época do dispositivo e a unidade de tempo especificada.
`String`	`getBootloaderVersion()` Método de conveniência para acessar 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()` Extrai o alias do build que está sendo executado no dispositivo.
`String`	`getBuildFlavor()` Recuperar a variação de build do dispositivo.
`String`	`getBuildId()` Extrair o build que está sendo executado no dispositivo.
`String`	`getBuildSigningKeys()` Retorna o tipo de chave usado para assinar a imagem do dispositivo Normalmente, os dispositivos Android podem ser assinados com chaves de teste (como no AOSP) ou chaves de lançamento (controladas por fabricantes de dispositivos individuais).
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Retorna um `DeviceDescriptor` em cache se o dispositivo for alocado. Caso contrário, retorna o `DeviceDescriptor` atual.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Retorna um `DeviceDescriptor` em cache se o dispositivo for alocado. Caso contrário, retorna o `DeviceDescriptor` atual.
`String[]`	`getChildren(String path)` Alternativa ao uso de `IFileEntry`, que às vezes não funciona devido a permissões.
`AbstractConnection`	`getConnection()` A conexão atual associada ao dispositivo.
`ContentProviderHandler`	`getContentProvider(int userId)` Retorna `ContentProviderHandler` ou nulo se não estiver disponível.
`DeviceFoldableState`	`getCurrentFoldableState()` Retorna o estado dobrável atual do dispositivo ou nulo se alguns problemas ocorreram.
`int`	`getCurrentUser()` Retorna o ID do usuário em execução atual.
`String`	`getDeviceClass()` Receba a classe do dispositivo.
`long`	`getDeviceDate()` Retorna a data do dispositivo em milissegundos desde o período.
`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()` Acesse o estado do dispositivo.
`long`	`getDeviceTimeOffset(Date date)` Auxílio para conseguir a diferença de horário entre o dispositivo e um determinado `ERROR(/Date)`.
`InputStreamSource`	`getEmulatorOutput()` Receber o fluxo de stdout e stderr do emulador
`Process`	`getEmulatorProcess()` Retorna o `Process` correspondente a 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 que está sendo usado.
`IFileEntry`	`getFileEntry(String path)` Extraia uma referência a um arquivo remoto no dispositivo.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` Auxiliar não oficial para receber um `FileEntry` de um caminho que não seja raiz.
	`getFoldableStates()` Retorna a lista de estados dobráveis no dispositivo.
`IDevice`	`getIDevice()` Retorna uma referência ao `IDevice` da 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()` Retorna um objeto para conferir o estado atual do bloqueio de teclado ou nulo, se não houver suporte.
`long`	`getLastExpectedRebootTimeMillis()` Retorna a última vez que as APIs Tradefed acionaram uma reinicialização em milissegundos desde EPOCH, conforme retornado por `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` Receba o nível da API lançado pela primeira vez no dispositivo.
`InputStreamSource`	`getLogcat()` Extrai um fluxo de snapshot dos dados do logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` Extrai um fluxo de snapshot dos últimos `maxBytes` de dados de logcat capturados.
`InputStreamSource`	`getLogcatDump()` Receba um despejo do logcat atual do dispositivo.
`InputStreamSource`	`getLogcatSince(long date)` Extrai um fluxo de snapshot de dados do Logcat capturados a partir da data fornecida.
`String`	`getMacAddress()` Retorna o endereço MAC do dispositivo, nulo se não for possível fazer a consulta.
`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 de usuários em execução simultaneamente com suporte.
`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 do ponto de montagem especificado ou `null` se esse caminho não tiver nada montado ou não aparecer em /proc/mounts como um ponto de montagem.
	`getMountPointInfo()` Retorna uma versão analisada das informações em /proc/mounts no dispositivo
`TestDeviceOptions`	`getOptions()` Buscar 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 o PID e o horário de início do processo.
`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 acessar a variante do produto desse dispositivo.
`String`	`getProperty(String name)` Extraia o valor da propriedade fornecido do dispositivo.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Descubra o modo de recuperação atual usado para o dispositivo.
`InputStreamSource`	`getScreenshot(long displayId)` Faz uma captura de tela do ID de exibição fornecido do dispositivo.
`InputStreamSource`	`getScreenshot(String format)` Faz uma captura de tela do dispositivo.
`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 executado no usuário do sistema.
`String`	`getSimOperator()` Retorna a operadora do chip ou nulo se não estiver disponível ou se o dispositivo não estiver disponível.
`String`	`getSimState()` Retorna o estado do chip ou nulo se o dispositivo ou o chip não estiverem disponíveis.
	`getTombstones()` Buscar e retornar a lista de túmulos dos dispositivos.
`long`	`getTotalMemory()` Retorna o tamanho total da memória física em bytes ou -1 em caso de erro interno
`String`	`getTrackingSerial()` Para fins de gerenciamento de dispositivos, acesse o número de série usado para rastrear o dispositivo.
	`getUninstallablePackageNames()` Busca os nomes dos pacotes de aplicativos que podem ser desinstalados.
`boolean`	`getUseFastbootErase()` Saiba se é necessário usar a exclusão ou o formato do fastboot para limpar uma partição no dispositivo.
`int`	`getUserFlags(int userId)` Encontre e retorne as flags de um determinado usuário.
	`getUserInfos()` Recebe o mapa de useId para `UserInfo` no dispositivo.
`int`	`getUserSerialNumber(int userId)` Retorna o número de série associado ao userId, se encontrado, ou -10000 em outros casos.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Processa o DeviceEvent fornecido. Processa o DeviceEvent, que pode ou não fazer a transição do 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 do Android no dispositivo.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` Instale um pacote do Android no dispositivo.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` Instale um pacote Android no dispositivo para um determinado usuário.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Instale 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 para ignorar o bloqueio de SDK de destino baixo em instalações de apps
`boolean`	`isDebugfsMounted()` Verifique se o debugfs está montado.
`boolean`	`isDeviceEncrypted()` Retorna se o dispositivo está criptografado.
`boolean`	`isDirectory(String path)` Retorna "True" se o caminho no dispositivo for um diretório. Caso contrário, retorna "False".
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Retorna se a criptografia é compatível com o dispositivo.
`boolean`	`isExecutable(String fullPath)` Retorna "True" se o caminho do arquivo no dispositivo for um arquivo executável. Caso contrário, retorna "False".
`boolean`	`isFastbootEnabled()` Retorna se o Fastboot estiver disponível para o dispositivo.
`boolean`	`isHeadless()` Retorna true se o dispositivo for sem cabeça (sem tela). Caso contrário, retorna false.
`boolean`	`isHeadlessSystemUserMode()` Retorna se o dispositivo usa o modo de usuário do sistema sem cabeça.
`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)` Consultar o dispositivo para um determinado nome de pacote e ID de usuário para verificar se ele está instalado ou não para esse usuário.
`boolean`	`isPackageInstalled(String packageName)` Consultar o dispositivo para um determinado nome de pacote e verificar se ele está instalado ou não.
`boolean`	`isRuntimePermissionSupported()` Verificar se a plataforma no dispositivo oferece suporte à concessão de permissão no momento da 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 é secundário de acordo com as flags.
`boolean`	`isUserVisible(int userId)` Verifica se o usuário especificado está visível.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` Verifica se o usuário está visível na tela.
`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()` Coletar a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys SurfaceFlinger".
	`listDisplayIdsForStartingVisibleBackgroundUsers()` Consegue 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 para os repórteres.
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Registra uma mensagem no logcat do dispositivo.
`void`	`mountDebugfs()` Ative o debugfs.
`void`	`nonBlockingReboot()` Emite um comando para reiniciar o dispositivo e retorna quando o comando é concluído e quando o dispositivo não está mais visível para o adb.
`void`	`postAdbRootAction()` Substitua se o dispositivo precisar de algumas ações específicas após a raiz do adb e antes que ele volte a ficar on-line.
`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 para testar isso após cada inicialização.
`void`	`postInvocationTearDown(Throwable exception)` Etapas extras para a limpeza necessária específica do dispositivo que será executada após a invocação ser concluída.
`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)` Extrair recursivamente o conteúdo do diretório do dispositivo.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Extrair 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)` Envie 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 considerar a necessidade de avaliação do provedor de conteúdo.
`boolean`	`pushFile(File localFile, String remoteFilePath)` Enviar um arquivo para o dispositivo.
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Enviar um arquivo para o dispositivo.
`boolean`	`pushString(String contents, String remoteFilePath)` Enviar um arquivo criado a partir de uma string para o dispositivo
`void`	`reboot(String reason)` Reinicia o dispositivo no modo adb com o `reason` fornecido para ser mantido durante a reinicialização.
`void`	`reboot()` Reinicia o dispositivo no modo adb.
`void`	`rebootIntoBootloader()` Reinicializa o dispositivo no modo de carregador de inicialização.
`void`	`rebootIntoFastbootd()` Reinicia o dispositivo no modo fastboot.
`void`	`rebootIntoRecovery()` Reinicia o dispositivo no modo de recuperação adb.
`void`	`rebootIntoSideload()` Reinicia o dispositivo no modo de sideload do adb. Esse é um modo especial de recuperação. Bloqueia até que o dispositivo entre no modo de sideload
`void`	`rebootIntoSideload(boolean autoReboot)` Reinicia o dispositivo no modo de sideload do adb. Esse é um modo especial de recuperação. Bloqueia até que o dispositivo entre no modo de sideload
`void`	`rebootUntilOnline()` Uma alternativa para `reboot()` que só bloqueia 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ó bloqueia até que o dispositivo esteja on-line, ou seja, visível para o adb.
`boolean`	`recoverDevice()` Tenta recuperar a comunicação do dispositivo.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Registra um `IDeviceActionReceiver` para este dispositivo.
`void`	`remountSystemReadOnly()` 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()` Torne a partição do fornecedor no dispositivo gravável.
`boolean`	`removeAdmin(String componentName, int userId)` Remove o administrador do dispositivo especificado no usuário especificado e retorna `true` se for bem-sucedido, `false` caso contrário.
`void`	`removeOwners()` Remova todos os proprietários de perfil de dispositivo com o melhor esforço.
`boolean`	`removeUser(int userId)` Remover um 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 oferece recuperação de dispositivos.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` Igual a `ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))`, mas executa o teste para o usuário especificado.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` Igual a `ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, mas executa o teste para um determinado usuário.
`void`	`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 no usuário especificado.
`void`	`setDeviceState(TestDeviceState deviceState)` Atualizar o estado do dispositivo.
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` Para o emulador, defina `SizeLimitedOutputStream` para gerar registros de saída.
`void`	`setEmulatorProcess(Process p)` Define o `Process` quando o dispositivo é um emulador.
`void`	`setFastbootEnabled(boolean fastbootEnabled)` Defina a opção de inicialização rápida para o dispositivo.
`void`	`setFastbootPath(String fastbootPath)` Define o caminho para o binário do Fastboot que precisa ser usado.
`void`	`setIDevice(IDevice newDevice)` Atualize o IDevice associado a este 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` do dispositivo
`boolean`	`setProperty(String propKey, String propValue)` Define o valor da propriedade especificada no dispositivo.
`void`	`setRecovery(IDeviceRecovery recovery)` Defina o `IDeviceRecovery` a ser usado para este dispositivo.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Define o modo de recuperação atual a ser usado no dispositivo.
`void`	`setSetting(String namespace, String key, String value)` Consulte `setSetting(int, String, String, String)` e executado no usuário do sistema.
`void`	`setSetting(int userId, String namespace, String key, String value)` Adicione um valor de configuração ao namespace de um determinado usuário.
`void`	`setTestLogger(ITestLogger testLogger)` Injeta a instância `ITestLogger`
`void`	`setTrackingSerial(String trackingSerial)` Para fins de gerenciamento de dispositivos, rastreie o número de série que usamos para referenciar o dispositivo.
`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()` Comece a capturar a saída do logcat do dispositivo em segundo plano.
`boolean`	`startUser(int userId)` Inicia um determinado usuário em segundo plano se ele estiver parado.
`boolean`	`startUser(int userId, boolean waitFlag)` Inicia um determinado usuário em segundo plano, 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)` Parar um determinado usuário.
`String`	`switchToAdbTcp()` Mudar o dispositivo para o modo adb-over-tcp.
`boolean`	`switchToAdbUsb()` Mude o dispositivo para o modo adb por USB.
`boolean`	`switchUser(int userId)` Mude para outro userId com um tempo limite padrão.
`boolean`	`switchUser(int userId, long timeout)` Mude para outro userId com o tempo limite fornecido como prazo.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Sincroniza de forma incremental o conteúdo de um diretório de arquivos local com o dispositivo.
`Bugreport`	`takeBugreport()` Retorna um bugreport dentro de um objeto `Bugreport` para processá-lo.
`String`	`uninstallPackage(String packageName)` Desinstalar um pacote do Android do dispositivo.
`String`	`uninstallPackageForUser(String packageName, int userId)` Desinstalar um pacote do Android do dispositivo para um determinado usuário.
`boolean`	`unlockDevice()` Desbloqueia o dispositivo se ele estiver em um estado criptografado.
`void`	`unmountDebugfs()` Desmonte o debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Bloqueia até que a flag de inicialização completa 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)` Aguarda 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 para que ele esteja no estado de "recuperação do adb". Isso é diferente de `IDeviceRecovery`.
`boolean`	`waitForDeviceInSideload(long waitTime)` Bloqueia o dispositivo no estado "adb sideload"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Bloqueia o dispositivo para que ele não esteja disponível, ou seja, ausente do adb
`void`	`waitForDeviceOnline()` Bloqueia até que o dispositivo fique visível via adb.
`void`	`waitForDeviceOnline(long waitTime)` Bloqueia até que o dispositivo fique visível pelo 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 e os argumentos do comando do shell adb fornecidos
`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()` Use a instância `RunUtil`.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)`
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Buscar uma propriedade do dispositivo do cache da ddmlib por padrão e retornar a "adb shell getprop" ou "fastboot getvar", dependendo se o dispositivo está no modo Fastboot ou não.
`boolean`	`isInRebootCallback()` Retorna se os callbacks de reinicialização estão sendo executados ou não.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Retorna `true` se o arquivo local for mais recente que o remoto.
`void`	`notifyRebootEnded()` Notifica todos os `IDeviceActionReceiver` sobre o evento de término da reinicialização.
`void`	`notifyRebootStarted()` Notifica todas as `IDeviceActionReceiver` sobre o evento de início da reinicialização.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Realiza uma ação neste dispositivo.
`void`	`postAdbReboot()` Possíveis ações extras que podem ser realizadas após uma reinicialização.
`void`	`prePostBootSetup()` Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) substitua esse método para uma configuração específica após a 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 microdroid e define o CID.
`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 de inicialização rápida simples e informa o status do comando.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` Aguarde até que o dispositivo fique indisponível (pare de enviar 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 nova execução de comando a serem realizadas

Valor da constante: 2 (0x00000002)

Campos

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Construtores públicos

NativeDevice

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

Cria um TestDevice.

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

Métodos públicos

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Microotimização (cerca de 400 milissegundos) com o pré-carregamento de todas as propriedades necessárias em vez de chamar "adb getprop" para cada uma. Ou seja, é tão rápido buscar todas as propriedades quanto buscar uma. 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 vai chamar setProperty e armazenar o resultado em cache para futuras chamadas. Só 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 do sistema sem cabeça.

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Verifica se um recurso tem suporte no momento, considerando um nível mínimo de compatibilidade. Esse método considera recursos ainda não lançados antes que o nível da API seja elevado.

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

Retorna
`boolean`	Verdadeiro se o nível tiver suporte. Falso em outros casos.

Gera
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

Verifique se o dispositivo tem conectividade de rede.

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

Gera
`DeviceNotAvailableException`

ClearErrorDialogs

public boolean clearErrorDialogs ()

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

Retorna
`boolean`	`true` se nenhuma caixa de diálogo estiver presente ou se elas tiverem sido apagadas. `false` se não forem.

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.

clearLogcat

public void clearLogcat ()

Exclui todos os dados de logcat acumulados.

Isso é útil para casos em que você quer garantir que ITestDevice#getLogcat() só retorne dados de registro produzidos após um determinado ponto (por exemplo, depois de atualizar uma nova versão 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 fornecidas no mapa wifiSsidToPsk. Depois que uma conexão for estabelecida, a instância vai tentar restaurar a conexão após cada reinicialização até que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
`wifiSsidToPsk`	: um mapa de SSIDs de Wi-Fi para senhas.
`scanSsid`	`boolean`: se a verificação de SSIDs ocultos para essa rede será feita.

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

Gera
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Conecta-se a uma rede Wi-Fi.

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

Parâmetros
`wifiSsid`	`String`: o SSID do Wi-Fi a que você quer se conectar
`wifiPsk`	`String`: frase de acesso PSK ou nulo se não for criptografada

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

Gera
`DeviceNotAvailableException`

connectToWifiNetwork

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 fornecidas no mapa wifiSsidToPsk. Depois que uma conexão é estabelecida, a instância tenta restaurar a conexão após cada reinicialização até que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() seja chamado.

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

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

Gera
`DeviceNotAvailableException`

connectToWifiNetwork

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

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 que você quer se conectar
`wifiPsk`	`String`: frase de acesso PSK ou nulo se não for criptografada
`scanSsid`	`boolean`: se a verificação de SSID ocultos para essa rede será feita.

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

Gera
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

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

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

Parâmetros
`scanSsid`	`boolean`: se é necessário procurar um SSID oculto para esta rede.

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

Gera
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

Gera
`DeviceNotAvailableException`

createUser

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

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

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

Retorna
`int`	ID do usuário criado

Gera
`DeviceNotAvailableException`

createUser

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

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

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

Retorna
`int`	ID do usuário criado

Gera
`DeviceNotAvailableException`

usuário

public int createUser (String name)

Cria um usuário com um nome determinado e flags padrão 0.

Parâmetros
`name`	`String`: o nome 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`: o nome 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 no dispositivo.

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

Gera
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath)

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

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

Gera
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Remove o IDeviceActionReceiver registrado.

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

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

Retorna
`boolean`	`true` se o dispositivo for reiniciado

Gera
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Método auxiliar para verificar se o dispositivo foi reiniciado desde o horário UTC desde a época do dispositivo e do ERROR(/TimeUnit). A reinicialização suave se refere ao system_server reiniciado fora de uma reinicialização forçada do dispositivo (por exemplo, reinicialização solicitada). O utcEpochTime atual do dispositivo em milissegundos 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 fornecido.

Retorna
`boolean`	`true` se o dispositivo for reiniciado

Gera
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

Desativa a raiz do adb.

A desativação do adb root 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` em caso de sucesso.

Gera
`DeviceNotAvailableException`

desativarKeyguard

public void disableKeyguard ()

Tenta desativar o bloqueio de teclado.

Primeiro, aguarde o envio de entrada ficar pronto. Isso acontece na mesma hora em que o dispositivo informa BOOT_COMPLETE, aparentemente de forma assíncrona, porque a implementação atual do framework tem uma condição de corrida ocasional. O comando é enviado para dispensar a proteção de teclas (funciona apenas em proteções não seguras).

Gera
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Desativa o monitoramento de rede no dispositivo.

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

Gera
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

Desconecta de uma rede Wi-Fi.

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

Retorna
`boolean`	`true` se desconectado da rede Wi-Fi. `false` se houver falha na desconexão.

Gera
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Parâmetros
`deviceFilePath`	`String`: o caminho absoluto do arquivo no dispositivo a ser verificado.
`userId`	`int`: o ID do usuário para verificar a existência do arquivo

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

Gera
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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 pilha 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 dumpheap será usado.
`devicePath`	`String`: o caminho no dispositivo em que o despejo será colocado. Esse precisa ser um local em que as permissões sejam permitidas.

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", uma mensagem será registrada e retornada sem ativar a raiz.

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

Retorna
`boolean`	`true` em caso de sucesso.

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.

O método executeShellCommand(String) deve ser usado sempre que possível, porque ele oferece melhor detecção de falhas e desempenho.

Parâmetros
`timeout`	`long`: o tempo em milissegundos antes que o dispositivo seja considerado não responsivo, 0L para sem tempo limite
`cmdArgs`	`String`: o comando adb e os argumentos a serem executados

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

Gera
`DeviceNotAvailableException`

executeAdbCommand

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

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

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

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

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

Gera
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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`	o 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 de inicialização rápida como um comando do sistema com um tempo limite padrão de 2 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`	o CommandResult que contém a saída do comando

Gera
`DeviceNotAvailableException`

executeFastbootCommand

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

Método auxiliar que executa um comando de inicialização rápida como um comando do sistema.

Espera-se que seja usado quando o dispositivo já estiver no modo fastboot.

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`	o CommandResult que contém a saída do comando

Gera
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

Método auxiliar que executa um comando de inicialização rápida de longa duração como um comando do sistema.

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

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

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

Gera
`DeviceNotAvailableException`

executeLongFastbootCommand

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

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

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

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

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

Gera
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

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

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

Parâmetros
`command`	`String`: o comando do shell adb a ser executado
`receiver`	`IShellOutputReceiver`: o `IShellOutputReceiver` para direcionar a saída do shell.
`maxTimeToOutputShellResponse`	`long`: o tempo máximo durante o qual o comando pode não gerar nenhuma resposta. A unidade é especificada em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de vezes que o comando será tentado novamente se ele falhar devido a uma exceção. A DeviceNotResponsiveException será gerada se a `retryAttempts` for executada sem sucesso.

Gera
`DeviceNotAvailableException`

executeShellCommand

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

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

Parâmetros
`command`	`String`: o comando do shell 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. A unidade é especificada em `timeUnit`.
`maxTimeToOutputShellResponse`	`long`: o tempo máximo durante o qual o comando pode não gerar nenhuma resposta. A unidade é especificada em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de vezes que o comando será tentado novamente se ele falhar devido a uma exceção. A DeviceNotResponsiveException será gerada se a `retryAttempts` for executada sem sucesso.

Gera
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

Gera
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

Método auxiliar que executa um comando de 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 precisa 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 precisa ser executado.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` em que a saída padrão será redirecionada ou nula.

Retorna
`CommandResult`	O resultado em `CommandResult`.

Gera
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Método auxiliar que executa um comando do shell 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`: um `ERROR(/File)` que será canalizado como entrada para o comando ou nulo.

Retorna
`CommandResult`	O resultado em `CommandResult`.

Gera
`DeviceNotAvailableException`

executeShellV2Command

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

Executa um comando 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. A unidade é especificada em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de vezes que o comando será tentado novamente se ele falhar devido a uma exceção. A DeviceNotResponsiveException será gerada se a `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. A unidade é 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`: um `ERROR(/File)` que será canalizado como entrada para o comando ou nulo.
`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. A unidade é especificada em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de vezes que o comando será tentado novamente se ele falhar devido a uma exceção. A DeviceNotResponsiveException será gerada se a `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`: um `ERROR(/File)` que será canalizado como entrada para o comando ou nulo.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` em que a saída padrão será redirecionada ou nula.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)` em que o erro padrão será redirecionado ou nulo.
`maxTimeoutForCommand`	`long`: o tempo limite máximo para a conclusão do comando. A unidade é especificada em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade de `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: o número máximo de vezes que o comando será tentado novamente se ele falhar devido a uma exceção. A DeviceNotResponsiveException será gerada se a `retryAttempts` for executada sem sucesso.

Retorna
`CommandResult`

Gera
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

Se getUseFastbootErase() for true, o apagamento de fastboot será usado para limpar a partição. O dispositivo deverá criar um sistema de arquivos na próxima vez que for inicializado. Caso contrário, o formato de inicialização rápida será usado, o que criará 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 apagada

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

Gera
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

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

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

Gera
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

Retorna pares de chave-valor do namespace solicitado.

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

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

Gera
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Retorna o estado de alocação atual do dispositivo

Retorna
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

Encontra e retorna o Android-ID associado a um userId, nulo se não 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 ()

Receber 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 da API do dispositivo

Gera
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

Parâmetros
`packageName`	`String`

Retorna
`PackageInfo`	o `PackageInfo` ou `null` se as informações não puderem ser recuperadas

Gera
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

Buscar informações de pacotes instalados no dispositivo.

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

Gera
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

Método de conveniência para obter a versão de banda de base (rádio) deste dispositivo. A obtenção da versão do rádio é específica do dispositivo. Por isso, ela 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 de versão corretas. Isso não é preciso para alguns dispositivos CDMA, e a versão retornada aqui pode não corresponder à versão informada pelo fastboot e não retornar a versão para o rádio CDMA. Resumo: esse método só informa a versão precisa se a propriedade gsm.version.baseband for igual à versão retornada por fastboot getvar version-baseband.

Retorna
`String`	a versão da baseband `String` ou `null`, se não puder ser determinada (o dispositivo não tem rádio ou a string de versão não pode ser lida)

Gera
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

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

Retorna
`Integer`

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Retorna o valor booleano da propriedade especificada.

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

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

Gera
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

O método auxiliar coleta o mapa do histórico de inicialização com o horário 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 tempo fornecido desde a época do dispositivo e a unidade de tempo especificada. O utcEpochTime atual do dispositivo em milissegundos 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 acessar a versão do carregador de inicialização do dispositivo.

Tenta recuperar a versão do gerenciador de inicialização do estado atual do dispositivo. Por exemplo, se o dispositivo estiver no modo fastboot, ele tentará recuperar a versão do fastboot.

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

Gera
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

Recupera um relatório de bug do dispositivo.

A implementação disso certamente continuará funcionando em um dispositivo sem cartão SD (ou em que o cartão SD ainda não esteja ativado).

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

getBugreportz

public InputStreamSource getBugreportz ()

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

getBuildAlias

public String getBuildAlias ()

Extrai o alias do build que está sendo executado no dispositivo.

O alias de build geralmente é uma string mais legível do que o ID do build (normalmente um número para builds 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 ele não puder ser recuperado

Gera
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Extrai o tipo 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 recuperar

Gera
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

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

Gera
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Retorna
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

Parâmetros
`shortDescriptor`	`boolean`: se o descritor deve ou não ser limitado às informações mínimas.

Retorna
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

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

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

Retorna
`String[]`	Matriz de string que contém 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 ContentProviderHandler ou nulo se não estiver disponível.

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

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

Retorna
`ContentProviderHandler`

Gera
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Retorna
`DeviceFoldableState`

Gera
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

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

Retorna
`int`

Gera
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

Receba a classe do dispositivo.

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

getDeviceDate

public long getDeviceDate ()

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

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

Gera
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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 deve ou não ser limitado às informações mínimas.

Retorna
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

Acesse o estado do dispositivo.

Retorna
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Auxílio para conseguir a diferença de horário entre o dispositivo e um determinado ERROR(/Date). Use o tempo Epoch 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 a 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 do fastboot em uso. Ainda é necessário definir isFastbootEnabled() como verdadeiro para ativar as funções de inicialização rápida.

Retorna
`String`

getFastbootProductType

public String getFastbootProductType ()

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

Esse método só deve ser usado se o dispositivo estiver no modo fastboot. Essa é uma variante um pouco mais segura do método getProductType() genérico nesse caso, porque ITestDevice vai saber recuperar o dispositivo na inicialização rápida 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)

Extrai 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 de versão do binário do fastboot em uso. Ou nulo se algo der errado.

Retorna
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

Extraia 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, a sintaxe "/system" e "system" são aceitas.

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

Gera
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

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

Retorna
`IFileEntry`	um FileEntryWrapper que representa o FileEntry.

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

getFoldableStates

public  getFoldableStates ()

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

Retorna

Gera
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

Retorna uma referência ao IDevice da ddmlib associado.

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

Retorna
`IDevice`	`IDevice`

getInstalledPackageNames

public  getInstalledPackageNames ()

Busque os nomes dos pacotes de apps presentes no dispositivo.

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

Gera
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Retorna o valor inteiro da propriedade especificada do dispositivo.

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

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

Gera
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Recebe o endereço IP do dispositivo.

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

Gera
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Retorna um objeto para conferir 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`

getLastesperaRestartTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

Retorna
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

Receba o nível da API lançado pela primeira vez no dispositivo. O valor padrão é UNKNOWN_API_LEVEL.

Retorna
`int`	Um número inteiro que indica o primeiro nível de API lançado do dispositivo

Gera
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

Extrai um fluxo de snapshot dos dados do logcat.

Funciona em dois modos:

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

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

Retorna
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

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

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

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

Retorna
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

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

Tem a desvantagem de que nada será retornado se o dispositivo não puder ser acessado.

Retorna
`InputStreamSource`	uma `InputStreamSource` dos dados do logcat. Um stream vazio é retornado se falhar ao capturar dados do Logcat.

getLogcatSince

public InputStreamSource getLogcatSince (long date)

Extrai um fluxo de snapshot de 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 a época, no formato de quando iniciar o snapshot até o presente. (pode ser obtido usando 'data +%s')

Retorna
`InputStreamSource`

getMacAddress

public String getMacAddress ()

Retorna o endereço MAC do dispositivo, nulo se não for possível fazer a consulta.

Retorna
`String`

getMainUserId

public Integer getMainUserId ()

Retorna o ID do usuário principal.

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

Gera
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

Gera
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Receba o número máximo de usuários em execução simultaneamente com suporte. O valor padrão é 0.

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

Gera
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Receba o número máximo de usuários com suporte. O valor padrão é 0.

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

Gera
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

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

getMonitor

public IDeviceStateMonitor getMonitor ()

Retorna o IDeviceStateMonitor associado ao dispositivo.

Retorna
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

Retorna um ponto de montagem.

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

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 do ponto de montagem especificado ou null se esse caminho não tiver nada montado ou não aparecer em /proc/mounts como um ponto de montagem.

Parâmetros
`mountpoint`	`String`

Retorna
`ITestDevice.MountPointInfo`	Um `ERROR(/List)` de `MountPointInfo` 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 ()

Buscar 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 um, e nulo, se não houver.

Gera
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

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

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

Retorna
`ProcessInfo`	ProcessInfo do nome do processo fornecido

Gera
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

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

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

Retorna
`String`

Gera
`DeviceNotAvailableException`

getProductType

public String getProductType ()

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

Esse método vai funcionar 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 vai funcionar 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)

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

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

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

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

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

Parâmetros
`displayId`	`long`: o ID de exibição da tela para fazer capturas de tela.

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

Gera
`DeviceNotAvailableException`

getCaptura de tela

public InputStreamSource getScreenshot (String format)

Faz uma captura de tela do dispositivo. Recomendamos usar getScreenshot(format) com codificação JPEG para tamanhos menores

Parâmetros
`format`	`String`: PNG, JPEG com suporte

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. Recomendamos o uso de getScreenshot(String) com codificação JPEG para tamanhos menores.

Parâmetros
`format`	`String`: PNG, JPEG com suporte
`rescale`	`boolean`: se a captura de tela precisa ser redimensionada para reduzir o tamanho da imagem resultante

Retorna
`InputStreamSource`	uma `InputStreamSource` da captura de tela no formato ou `null` se a captura de tela não foi 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. 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. Valor nulo se não encontrado.

Gera
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

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

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

Retorna
`String`

Gera
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

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

Retorna
`String`

getSimState

public String getSimState ()

Retorna o estado do chip ou nulo se o dispositivo ou o chip não estiverem disponíveis.

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 com antecedência.

Retorna
	Uma lista de arquivos de exclusão, vazia se não houver nenhum.

Gera
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

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

Retorna
`long`

getTrackingSerial

public String getTrackingSerial ()

Para fins de gerenciamento de dispositivos, acesse o número de série usado para rastreá-lo.

Retorna
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

Gera
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

Saiba se é necessário usar a exclusão ou o formato do fastboot para limpar uma partição no dispositivo.

Retorna
`boolean`	`true` se a exclusão de fastboot for usada ou `false` se a formatação de fastboot for usada.

getUserFlags

public int getUserFlags (int userId)

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

Parâmetros
`userId`	`int`

Retorna
`int`	As flags associadas ao userId fornecido, se encontrado, ou -10000 em outros casos.

Gera
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Recebe o mapa de useId para UserInfo no dispositivo. Ocorrerá DeviceRuntimeException se a saída do dispositivo não for como esperado.

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, ou -10000 em outros casos.

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 um novo estado. Informa o IDeviceMonitor sobre todas as transições de estado.

Processa o DeviceEvent, que pode ou não fazer a transição do 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 recurso for encontrado. Caso contrário, será falso.

Gera
`DeviceNotAvailableException`

installPackage

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

Instale um pacote do Android no dispositivo.

Parâmetros
`packageFile`	`File`: o arquivo apk a ser instalado
`reinstall`	`boolean`: `true` se uma reinstalação precisar ser feita
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir 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 do Android no dispositivo.

Observação: somente casos de uso que exigem controle explícito de 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 feita
`grantPermissions`	`boolean`: se todas as permissões de execução precisam ser concedidas no momento da instalação
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir 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)

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

Parâmetros
`packageFile`	`File`: o arquivo apk a ser instalado
`reinstall`	`boolean`: `true` se uma reinstalação precisar ser feita
`userId`	`int`: o ID de usuário inteiro a ser instalado.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir 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)

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

Observação: somente casos de uso que exigem controle explícito de 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 feita
`grantPermissions`	`boolean`: se todas as permissões de execução forem concedidas no momento da instalação
`userId`	`int`: o ID de usuário inteiro a ser instalado.
`extraArgs`	`String`: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir 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 ()

isAdbRoot

public boolean isAdbRoot ()

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

Retorna
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

Retorna
`boolean`	Verdadeiro se a enumeração de apps tiver suporte. Caso contrário, será falso.

Gera
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockAllowed

public boolean isBypassLowTargetSdkBlockSupported ()

Verificar se a plataforma no dispositivo oferece suporte para ignorar o bloqueio de SDK de destino baixo em instalações de apps

Retorna
`boolean`	Verdadeiro se o bloqueio de sdk de destino baixo é aceito. Caso contrário, é falso.

Gera
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Verifique se o debugfs está montado.

Retorna
`boolean`	`true` se o debugfs estiver montado

Gera
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

Retorna se o dispositivo está criptografado.

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

Gera
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

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

Parâmetros
`path`	`String`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

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

isEncryptionSupported

public boolean isEncryptionSupported ()

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

Retorna
`boolean`	`true` se o dispositivo oferece suporte à criptografia.

Gera
`DeviceNotAvailableException`

isExecutable

public boolean isExecutable (String fullPath)

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

Parâmetros
`fullPath`	`String`

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

Retorna se o Fastboot estiver disponível para o dispositivo.

Retorna
`boolean`

isHeadless

public boolean isHeadless ()

Retorna true se o dispositivo for sem cabeça (sem tela). Caso contrário, retorna false.

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Retorna se o dispositivo usa o modo de usuário do sistema sem cabeça.

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`	"true" se houver suporte para vários usuários. Caso contrário, será "false".

Gera
`DeviceNotAvailableException`

isPackageInstalled

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 for nulo, o usuário principal zero será usado.

Retorna
`boolean`	Verdadeiro se o pacote for relatado como instalado. Falso em outros casos.

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 em outros casos.

Gera
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

Verificar se a plataforma no dispositivo oferece suporte à concessão de permissão no momento da 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 verdadeiro se o dispositivo estiver em TestDeviceState#FASTBOOT ou TestDeviceState.FASTBOOTD.

Retorna
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

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

Parâmetros
`userId`	`int`

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

Gera
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

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

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" é um usuário que interage com o usuário "humano" e, portanto, pode iniciar atividades de lançamento (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 está visível na tela.

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 sim, chame startVisibleBackgroundUser(int, int, boolean), transmitindo uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers() (que precisa incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

isVisibleBackgroundUserssupported

public boolean isVisibleBackgroundUsersSupported ()

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

Se isso acontecer, chame 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 de testes que não são executados com Wi-Fi, por exemplo, testes de dados móveis.

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

Gera
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

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

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

Gera
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Consegue 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. Será gerado DeviceRuntimeException se a saída do dispositivo não for como esperado.

Retorna
	a lista de IDs de usuários.

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`	Verdadeiro se a geração de registros foi bem-sucedida. Caso contrário, é falso.

Gera
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Método auxiliar para registrar um relatório de bug para os repórteres.

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

Retorna
`boolean`	Verdadeiro se a geração de registros for bem-sucedida. Caso contrário, é falso.

logOnDevice

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

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

Ative o debugfs.

Gera
`DeviceNotAvailableException`

nonBlockingReiniciar

public void nonBlockingReboot ()

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

Gera
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Substitua se o dispositivo precisar de algumas ações específicas após a raiz do adb e antes que ele volte a ficar on-line. A implementação padrão não inclui nenhuma ação de adição. Não há garantia de que o adb root esteja ativado nesta fase.

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 o adb root será desativado nesta fase.

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

postBootSetup

public void postBootSetup ()

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

Precisa ser chamado depois que o dispositivo for 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 reiniciar.

O local em que ele pode precisar ser chamado é quando o dispositivo é reiniciado devido a outros eventos (por exemplo, quando um comando de atualização de inicialização rápida é concluído).

Gera
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

preInvocationSetup

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

Etapas extras para a configuração necessária específica do dispositivo que será executada no dispositivo 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 de arquivo absoluto da origem remota
`localDir`	`File`: o diretório local para extrair arquivos
`userId`	`int`: o ID do usuário de onde será extraído

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

Gera
`DeviceNotAvailableException`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

Gera
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

Recupera um arquivo do dispositivo.

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

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

Gera
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

Recupera um arquivo do dispositivo, 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 para armazenar o conteúdo. 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 foi recuperado. `false` se não forem.

Gera
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

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

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

Retorna
`String`	Um `String` 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 de conveniência para recuperar um arquivo do armazenamento externo do dispositivo, armazená-lo em um ERROR(/File) temporário local e retornar uma referência a esse File.

Parâmetros
`remoteFilePath`	`String`: o caminho para o arquivo no dispositivo, relativo ao ponto de montagem 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 de arquivo absoluto 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. `false` se não forem.

Gera
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Envie 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 de arquivo absoluto do destino remoto

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

Gera
`DeviceNotAvailableException`

pushDir

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

Envie 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 de arquivo absoluto do destino remoto
`userId`	`int`: o ID do usuário para o push

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

Gera
`DeviceNotAvailableException`

pushFile

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

Variante de pushFile(File, String) que pode considerar a necessidade de avaliação 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 o provedor de conteúdo

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

Gera
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

Enviar 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. `false` se não forem.

Gera
`DeviceNotAvailableException`

pushFile

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

Enviar 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 para enviar.

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

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. `false` se não forem.

Gera
`DeviceNotAvailableException`

reiniciar

public void reboot (String reason)

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

Bloqueia até que o dispositivo fique disponível.

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

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

Gera
`DeviceNotAvailableException`

reiniciar

public void reboot ()

Reinicia o dispositivo no modo adb.

Bloqueia até que o dispositivo fique disponível.

Gera
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

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

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

Gera
`DeviceNotAvailableException`

reinicializarIntoFastbootd

public void rebootIntoFastbootd ()

Reinicializa o dispositivo no modo fastbootd.

Bloqueia até que o dispositivo esteja no modo fastboot.

Gera
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

Reinicia o dispositivo no modo de recuperação adb.

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

Gera
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

Reinicia o dispositivo no modo de sideload do adb. Esse é um modo especial de recuperação.

Bloqueia até que o dispositivo entre no modo de sideload

Gera
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

Reinicia o dispositivo no modo de sideload do adb. Esse é um modo especial de recuperação.

Bloqueia até que o dispositivo entre no modo de sideload

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

Gera
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

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

Gera
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline (String reason)

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

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

Gera
`DeviceNotAvailableException`

rebootUserspace

public void rebootUserspace ()

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

Bloqueia até que o dispositivo fique disponível.

AVISO. O reboot do espaço do usuário está em desenvolvimento ativo. Use por sua conta e risco.

Gera
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

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

Gera
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

Tenta recuperar a comunicação do dispositivo.

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

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra um IDeviceActionReceiver para este dispositivo.

Todos os IDeviceActionReceivers registrados vão receber uma notificação antes do início de uma ação do dispositivo e depois que ela terminar.

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

remountSystemReadOnly

public void remountSystemReadOnly ()

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

Gera
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

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

Gera
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

Tornar a partição do fornecedor no dispositivo somente leitura. Isso pode reinicializar o dispositivo.

Gera
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

Torne a partição do fornecedor no dispositivo gravável. Isso pode reinicializar o dispositivo.

Gera
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Remove o administrador do dispositivo especificado no usuário especificado e retorna true se for bem-sucedido, false caso contrário.

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

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 com o melhor esforço.

Gera
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

Remover um determinado usuário do dispositivo.

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

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

Gera
`DeviceNotAvailableException`

resetContentProviderConfigurar

public void resetContentProviderSetup ()

Redefina a flag de configuração do provedor de conteúdo para acionar 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 foi 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 das chamadas precisam 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 foi concluído. `false`, se não for possível concluir devido a uma exceção de comunicação do dispositivo, mas a recuperação tiver sucesso

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`

setDate

public void setDate (Date date)

Define a data no dispositivo

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

Parâmetros
`date`	`Date`: especifica uma data específica. Usará a data do host se `null`.

Gera
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Define um componente de administrador do dispositivo como proprietário do dispositivo no usuário especificado.

Parâmetros
`componentName`	`String`: de administrador do dispositivo para ser 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)

Atualize 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 for alocado pela primeira vez.

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

setFastbootPath

public void setFastbootPath (String fastbootPath)

Define o caminho para o binário fastboot que será usado. Ainda é necessário definir isFastbootEnabled() como verdadeiro para ativar as funções de inicialização rápida.

Parâmetros
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Atualize o IDevice associado a este ITestDevice.

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

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

setLogStartDelay

public void setLogStartDelay (int delay)

Define o tempo em ms 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 do dispositivo

Parâmetros
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

Define o valor da propriedade especificada no dispositivo. Requer que a raiz do adb seja verdadeira.

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

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

Gera
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

Defina o IDeviceRecovery a ser usado para este 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 qual método de recuperação usar quando um problema de comunicação do dispositivo é 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)

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

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

Gera
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Injeta a instância ITestLogger

Parâmetros
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

Para fins de gerenciamento de dispositivos, rastreie o número de série que usamos para referenciar o dispositivo.

Parâmetros
`trackingSerial`	`String`

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 vai ter efeito se a saída do Logcat já estiver sendo capturada. Os dados podem ser recuperados mais tarde usando o getLogcat.

Quando o dispositivo não estiver mais em uso, stopLogcat() precisará ser chamado.

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

startUser

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 para iniciar em segundo plano

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

Gera
`DeviceNotAvailableException`

usuáriode inicialização

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

Gera
`DeviceNotAvailableException`

startVisibleBackgroundUser

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

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

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

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

Retorna
`boolean`	`true` se o usuário tiver sido iniciado visível em segundo plano.

Gera
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

Feche e exclua a saída do emulador.

stopLogcat

public void stopLogcat ()

Parar de capturar a saída do Logcat do dispositivo e descartar os dados do Logcat salvos.

Não vai 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á estiver parado, esse método será uma operação sem efeito. Não é possível interromper o usuário atual e do sistema.

Parâmetros
`userId`	`int`: do usuário para parar.

Retorna
`boolean`	Verdadeiro se o usuário foi 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 para parar.
`waitFlag`	`boolean`: faz com que o comando aguarde até que o usuário seja interrompido.
`forceFlag`	`boolean`: força a interrupção do usuário.

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

Gera
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

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

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

Gera
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Alterna o dispositivo para adb no modo usb.

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

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 corresponde ao provedor de userId. Falso em outros casos.

Gera
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

Mude 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`: para aguardar antes de retornar falso para o erro de troca de usuário.

Retorna
`boolean`	Verdadeiro se o novo userId corresponde ao provedor de userId. Falso em outros casos.

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. Somente arquivos "mais recentes" ou indisponíveis serão enviados ao dispositivo. Assim, o overhead será relativamente pequeno se o conjunto de arquivos no dispositivo já estiver atualizado.

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

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

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

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

Gera
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

Retorna um bugreport dentro de um objeto Bugreport para processá-lo. Retorne nulo em caso de problemas. O arquivo referenciado no objeto Bugreport precisa ser limpo usando Bugreport.close().

Retorna
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

Desinstalar um pacote do Android do dispositivo.

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

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

Gera
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

Gera
`DeviceNotAvailableException`

unlockDevice

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` em caso de sucesso ou se o dispositivo não estiver criptografado.

Gera
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

Desconecte o 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 milissegundos para aguardar a definição da flag

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

Gera
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

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

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

Gera
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

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

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

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

Gera
`DeviceNotAvailableException`

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

Gera
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

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

Gera
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

Bloqueia o dispositivo para que ele esteja no estado de "recuperação do adb". Isso é diferente de IDeviceRecovery.

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

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

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

Bloqueia o dispositivo para que ele esteja no estado de "sideload do adb"

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

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

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

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

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

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

"waitForDeviceOnline"

public void waitForDeviceOnline ()

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

O dispositivo pode não responder necessariamente a comandos na conclusão. Use waitForDeviceAvailable().

Gera
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

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

O dispositivo pode não responder aos 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 que o dispositivo responda a um comando básico do shell adb.

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

Retorna
`boolean`	`true` se o dispositivo voltar 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 e os argumentos do comando do shell adb fornecidos

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

Retorna
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

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

createRebootDeviceAction

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

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

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

Retorna
`NativeDevice.RebootDeviceAction`	a `RebootDeviceAction` criada.

createRunUtil

protected IRunUtil createRunUtil ()

Retorna
`IRunUtil`

doAdbReboot

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

Faça uma reinicialização do adb.

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

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

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

Método auxiliar para gerar uma exceção se a permissão 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 ()

Use a instância RunUtil.

Retorna
`IRunUtil`

initializeConnection

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)

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

Parâmetros
`propName`	`String`: o nome da propriedade do dispositivo conforme retornado por "adb shell getprop"
`fastbootVar`	`String`: o nome da variável fastboot equivalente à 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`

isInRebootCallback

protected boolean isInRebootCallback ()

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

Retorna
`boolean`

éMais recente

protected boolean isNewer (File localFile, 
                IFileEntry entry)

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

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

Retorna
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

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

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

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)

Realiza 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 registro.
`action`	`NativeDevice.DeviceAction`: a ação a ser realizada
`retryAttempts`	`int`: as tentativas de nova tentativa de ação se ela falhar, mas a recuperação for bem-sucedida

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

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

pós-reinicialização do Adb

protected void postAdbReboot ()

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

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

prePostBootSetup

protected void prePostBootSetup ()

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

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

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

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

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

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

Parâmetros
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Marca o TestDevice como microdroid e define o CID.

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

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

Parâmetros
`deviceOptions`

simpleFastbootCommand

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

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

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

Retorna
`CommandResult`

simpleFastbootCommand

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

Executa um comando de inicialização rápida 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 a disponibilidade.
`time`	`long`: o tempo de espera para que ocorra a indisponibilidade.

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

NativeDevice

Resumo

Classes aninhadas

Constantes

Campos

Construtores públicos

Métodos públicos

Métodos protegidos

Constantes

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

Campos

DEBUGFS_PATH

SD_CARD

STORAGE_EMULATED

mOptions

mStateMonitor

Construtores públicos

NativeDevice

Métodos públicos

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

ClearErrorDialogs

ClearLastConnectedWiFiNetwork

clearLogcat

conectar à rede Wi-Fi

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

usuário

createUserNoThrow

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

desativarKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

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