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.

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

Subclasses indiretas conhecidas

IManagedTestDevice , ITestDevice , LocalAndroidVirtualDevice , ManagedRemoteDevice , NativeDevice , NestedRemoteDevice , RemoteAndroidDevice , RemoteAndroidVirtualDevice , TestDevice

IManagedTestDevice	Um ITestDevice cujo ciclo de vida é gerenciado.
ITestDevice	Fornece uma API confiável e de nível ligeiramente superior para um ddmlib `IDevice` .
LocalAndroidVirtualDevice	A classe para dispositivos virtuais locais em execução no host TradeFed.
ManagedRemoteDevice	Um dispositivo rodando dentro de uma máquina virtual que gerenciamos remotamente por meio de uma instância Tradefed dentro da VM.
Dispositivo nativo	Implementação padrão de um dispositivo Android de pilha não completa `ITestDevice` .
NestedRemoteDevice	Representação do dispositivo rodando dentro de uma VM Cuttlefish remota.
RemoteAndroidDevice	Implementação de um `ITestDevice` para um dispositivo android full stack conectado via adb connect.
RemoteAndroidVirtualDevice	Estende o comportamento `RemoteAndroidDevice` para um dispositivo Android de pilha completa em execução no Google Compute Engine (Gce).
dispositivo de teste	Implementação de um `ITestDevice` para um dispositivo android full stack

Fornece uma API confiável e de nível ligeiramente superior para um ddmlib IDevice .

Tenta novamente comandos de dispositivo por um valor configurável e fornece uma interface de recuperação de dispositivo para dispositivos que não respondem.

Resumo

Constantes
`int`	`UNKNOWN_API_LEVEL` Valor padrão quando o nível da API não pode ser detectado

Métodos públicos
`abstract boolean`	`checkApiLevelAgainstNextRelease (int strictMinLevel)` Verifique se um recurso é ou não suportado no momento, dado um nível minimamente suportado.
`abstract void`	`clearLogcat ()` Exclui todos os dados logcat acumulados.
`abstract void`	`deleteFile (String deviceFilePath)` Método auxiliar para excluir um arquivo ou diretório no dispositivo.
`abstract boolean`	`deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)` Método auxiliar para verificar se o dispositivo reiniciou por software comparando o system_server atual com o system_server anterior `ProcessInfo` .
`abstract boolean`	`deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)` Método auxiliar para verificar se o dispositivo reiniciou por software desde a hora UTC desde a época do dispositivo e seu `ERROR(/TimeUnit)` .
`abstract boolean`	`disableAdbRoot ()` Desativa o adb root.
`abstract boolean`	`doesFileExist (String deviceFilePath)` Método auxiliar para determinar se o arquivo no dispositivo existe.
`abstract boolean`	`enableAdbRoot ()` Ativa adb root.
`abstract String`	`executeAdbCommand (long timeout, String... commandArgs)` Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.
`abstract String`	`executeAdbCommand (String... commandArgs)` Método auxiliar que executa um comando adb como um comando do sistema.
`abstract String`	`executeAdbCommand (long timeout, envMap, String... commandArgs)` `executeAdbCommand (long timeout, envMap, String... commandArgs)` Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.
`abstract CommandResult`	`executeFastbootCommand (long timeout, String... commandArgs)` Método auxiliar que executa um comando fastboot como um comando do sistema.
`abstract CommandResult`	`executeFastbootCommand (String... commandArgs)` Método auxiliar que executa um comando fastboot como um comando do sistema com um tempo limite padrão de 2 minutos.
`abstract CommandResult`	`executeLongFastbootCommand (String... commandArgs)` Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema.
`abstract CommandResult`	`executeLongFastbootCommand ( envVarMap, String... commandArgs)` `executeLongFastbootCommand ( envVarMap, String... commandArgs)` 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.
`abstract String`	`executeShellCommand (String command)` Método auxiliar que executa um comando shell adb e retorna a saída como uma `String` .
`abstract void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
`abstract void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
`abstract void`	`executeShellCommand (String command, IShellOutputReceiver receiver)` Executa o comando adb shell fornecido, tentando várias vezes se o comando falhar.
`abstract CommandResult`	`executeShellV2Command (String command)` Método auxiliar que executa um comando adb shell e retorna os resultados como um `CommandResult` preenchido corretamente com a saída de status do comando, stdout e stderr.
`abstract CommandResult`	`executeShellV2Command (String command, OutputStream pipeToOutput)` Método auxiliar que executa um comando shell adb e retorna os resultados como um `CommandResult` preenchido corretamente com a saída de status do comando e stderr.
`abstract CommandResult`	`executeShellV2Command (String command, File pipeAsInput)` Método auxiliar que executa um comando adb shell e retorna os resultados como um `CommandResult` preenchido corretamente com a saída de status do comando, stdout e stderr.
`abstract CommandResult`	`executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
`abstract CommandResult`	`executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)` Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
`abstract CommandResult`	`executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
`abstract CommandResult`	`executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
`abstract CommandResult`	`fastbootWipePartition (String partition)` Método auxiliar que limpa uma partição do dispositivo.
`abstract int`	`getApiLevel ()` Obtenha o nível de API do dispositivo.
`abstract String`	`getBasebandVersion ()` Método de conveniência para obter a versão de banda base (rádio) deste dispositivo.
`abstract Integer`	`getBattery ()` Retorna o nível atual da bateria de um dispositivo ou Nulo se o nível da bateria estiver indisponível.
`abstract boolean`	`getBooleanProperty (String name, boolean defaultValue)` Retorna o valor booleano da propriedade especificada.
`abstract`	`getBootHistory ()` O método auxiliar coleta o mapa do histórico de inicialização com o tempo de inicialização e o motivo da inicialização.
`abstract`	`getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)` O método auxiliar coleta o mapa do histórico de inicialização com o tempo de inicialização e o motivo da inicialização desde o tempo determinado desde a época do dispositivo e a unidade de tempo especificada.
`abstract String`	`getBootloaderVersion ()` Método de conveniência para obter a versão do carregador de inicialização deste dispositivo.
`abstract String`	`getBuildAlias ()` Recupere o alias da compilação que o dispositivo está executando no momento.
`abstract String`	`getBuildFlavor ()` Recupere o tipo de compilação para o dispositivo.
`abstract String`	`getBuildId ()` Recupere a compilação que o dispositivo está executando no momento.
`abstract 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 liberação (controladas por fabricantes de dispositivos individuais)
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor ()` Retorna um `DeviceDescriptor` armazenado em cache se o dispositivo estiver alocado, caso contrário, retorna o `DeviceDescriptor` atual.
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor (boolean shortDescriptor)` Retorna um `DeviceDescriptor` armazenado em cache se o dispositivo estiver alocado, caso contrário, retorna o `DeviceDescriptor` atual.
`abstract String[]`	`getChildren (String deviceFilePath)` Alternativa para usar `IFileEntry` que às vezes não funciona devido a permissões.
`abstract AbstractConnection`	`getConnection ()` Retorna a conexão associada ao dispositivo.
`abstract String`	`getDeviceClass ()` Obtenha a classe do dispositivo.
`abstract long`	`getDeviceDate ()` Retorna a data do dispositivo em milissegundos desde a época.
`abstract DeviceDescriptor`	`getDeviceDescriptor ()` Retorne um `DeviceDescriptor` das informações do dispositivo para obter informações sobre ele sem passar o objeto do dispositivo real.
`abstract DeviceDescriptor`	`getDeviceDescriptor (boolean shortDescriptor)` Retorne um `DeviceDescriptor` das informações do dispositivo para obter informações sobre ele sem passar o objeto do dispositivo real.
`abstract TestDeviceState`	`getDeviceState ()` Obtenha o estado do dispositivo.
`abstract long`	`getDeviceTimeOffset (Date date)` Helper para obter a diferença de tempo entre o dispositivo e um determinado `ERROR(/Date)` .
`abstract InputStreamSource`	`getEmulatorOutput ()` Obtenha o fluxo do emulador stdout e stderr
`abstract long`	`getExternalStoreFreeSpace ()` Método auxiliar para determinar a quantidade de espaço livre no armazenamento externo do dispositivo.
`abstract String`	`getFastbootProductType ()` Método de conveniência para obter o tipo de produto deste dispositivo quando estiver no modo de inicialização rápida.
`abstract String`	`getFastbootProductVariant ()` Método de conveniência para obter o tipo de produto deste dispositivo quando estiver no modo de inicialização rápida.
`abstract String`	`getFastbootSerialNumber ()` Retorna o número de série do modo fastboot.
`abstract String`	`getFastbootVariable (String variableName)` Recupere o valor da variável fastboot fornecida do dispositivo.
`abstract IFileEntry`	`getFileEntry (String path)` Recupere uma referência a um arquivo remoto no dispositivo.
`abstract IDevice`	`getIDevice ()` Retorna uma referência ao ddmlib `IDevice` associado.
`abstract long`	`getIntProperty (String name, long defaultValue)` Retorna o valor inteiro da propriedade fornecida do dispositivo.
`abstract long`	`getLastExpectedRebootTimeMillis ()` Retorna a última vez que as APIs Tradefed dispararam uma reinicialização em milissegundos desde EPOCH conforme retornado por `System.currentTimeMillis()` .
`abstract int`	`getLaunchApiLevel ()` Obtenha o primeiro nível de API lançado do dispositivo.
`abstract InputStreamSource`	`getLogcat ()` Obtém um fluxo de instantâneo dos dados logcat.
`abstract InputStreamSource`	`getLogcat (int maxBytes)` Obtém um fluxo instantâneo dos últimos `maxBytes` de dados logcat capturados.
`abstract InputStreamSource`	`getLogcatDump ()` Obtenha um despejo do logcat atual para o dispositivo.
`abstract InputStreamSource`	`getLogcatSince (long date)` Obtém um fluxo instantâneo de dados logcat capturados a partir da data fornecida.
`abstract String`	`getMountPoint (String mountName)` Retorna um ponto de montagem.
`abstract 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.
`abstract`	`getMountPointInfo ()` Retorna uma versão analisada das informações em /proc/mounts no dispositivo
`abstract long`	`getPartitionFreeSpace (String partition)` Método auxiliar para determinar a quantidade de espaço livre na partição do dispositivo.
`abstract ProcessInfo`	`getProcessByName (String processName)` O método auxiliar executa o comando "pidof" e "stat" e retorna o objeto `ProcessInfo` com PID e hora de início do processo fornecido.
`abstract String`	`getProcessPid (String process)` Retorna o pid do serviço ou null se algo deu errado.
`abstract String`	`getProductType ()` Método de conveniência para obter o tipo de produto deste dispositivo.
`abstract String`	`getProductVariant ()` Método de conveniência para obter a variante do produto deste dispositivo.
`abstract String`	`getProperty (String name)` Recupere o valor da propriedade fornecido do dispositivo.
`abstract ITestDevice.RecoveryMode`	`getRecoveryMode ()` Obtenha o modo de recuperação atual usado para o dispositivo.
`abstract String`	`getSerialNumber ()` Método de conveniência para obter o número de série deste dispositivo.
`abstract`	`getTombstones ()` Busca e retorna a lista de lápides dos dispositivos.
`abstract long`	`getTotalMemory ()` Retorna o tamanho total da memória física em bytes ou -1 em caso de erro interno
`abstract boolean`	`getUseFastbootErase ()` Obtenha se deseja usar o apagamento de inicialização rápida ou o formato de inicialização rápida para limpar uma partição no dispositivo.
`abstract boolean`	`isAdbRoot ()`
`abstract boolean`	`isAdbTcp ()`
`abstract boolean`	`isAppEnumerationSupported ()` Verifique se a plataforma no dispositivo oferece suporte à enumeração de aplicativos
`abstract boolean`	`isBypassLowTargetSdkBlockSupported ()` Verifique se a plataforma no dispositivo oferece suporte para ignorar o bloqueio de alvo baixo do SDK nas instalações do aplicativo
`abstract boolean`	`isDeviceEncrypted ()` Retorna se o dispositivo estiver criptografado.
`abstract boolean`	`isDirectory (String deviceFilePath)` Retorna True se o caminho no dispositivo for um diretório, false caso contrário.
`abstract boolean`	`isEncryptionSupported ()` Retorna se a criptografia for suportada no dispositivo.
`abstract boolean`	`isExecutable (String fullPath)` Retorna True se o caminho do arquivo no dispositivo for um arquivo executável, caso contrário, false.
`abstract boolean`	`isHeadless ()` Retorna true se o dispositivo for headless (sem tela), false caso contrário.
`abstract boolean`	`isRuntimePermissionSupported ()` Verifique se a plataforma no dispositivo oferece suporte à concessão de permissão de tempo de execução
`abstract boolean`	`isStateBootloaderOrFastbootd ()` Retorna verdadeiro se o dispositivo estiver em `TestDeviceState#FASTBOOT` ou `TestDeviceState.FASTBOOTD` .
`abstract boolean`	`logAnrs ( ITestLogger logger)` Coleta e registra ANRs do dispositivo.
`abstract void`	`logOnDevice (String tag, Log.LogLevel level, String format, Object... args)` Registre uma mensagem no logcat do dispositivo.
`abstract void`	`nonBlockingReboot ()` Emite um comando para reinicializar o dispositivo e retorna quando o comando é concluído e quando o dispositivo não está mais visível para o adb.
`abstract void`	`postBootSetup ()` Execute as instruções para configurar o dispositivo para testá-lo após cada inicialização.
`default void`	`postInvocationTearDown ()` Este método está obsoleto. Em vez disso, use `postInvocationTearDown(Throwable)` .
`abstract void`	`postInvocationTearDown (Throwable invocationException)` Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a conclusão da chamada.
`default void`	`preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes)` Etapas extras para configuração necessária específica do dispositivo que serão executadas no dispositivo antes do fluxo de invocação.
`abstract boolean`	`pullDir (String deviceFilePath, File localDir)` Puxe recursivamente o conteúdo do diretório do dispositivo.
`abstract File`	`pullFile (String remoteFilePath, int userId)` Recupera um arquivo do dispositivo, armazena-o em um `ERROR(/File)` temporário local e retorna esse `File` .
`abstract File`	`pullFile (String remoteFilePath)` Recupera um arquivo do dispositivo, armazena-o em um `ERROR(/File)` temporário local e retorna esse `File` .
`abstract boolean`	`pullFile (String remoteFilePath, File localFile)` Recupera um arquivo do dispositivo.
`abstract boolean`	`pullFile (String remoteFilePath, File localFile, int userId)` Recupera um arquivo do dispositivo.
`abstract String`	`pullFileContents (String remoteFilePath)` Recupera um arquivo do dispositivo e retorna o conteúdo.
`abstract File`	`pullFileFromExternal (String remoteFilePath)` Um método conveniente para recuperar um arquivo do armazenamento externo do dispositivo, armazená-lo em um `ERROR(/File)` temporário local e retornar uma referência a esse `File` .
`abstract boolean`	`pushDir (File localDir, String deviceFilePath, excludedDirectories)` `pushDir (File localDir, String deviceFilePath, excludedDirectories)` Empurre recursivamente o conteúdo do diretório para o dispositivo enquanto exclui alguns diretórios que são filtrados.
`abstract boolean`	`pushDir (File localDir, String deviceFilePath)` Empurre recursivamente o conteúdo do diretório para o dispositivo.
`abstract boolean`	`pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)` Variante de `pushFile(File, String)` que opcionalmente pode considerar a avaliação da necessidade do provedor de conteúdo.
`abstract boolean`	`pushFile (File localFile, String deviceFilePath)` Empurre um arquivo para o dispositivo.
`abstract boolean`	`pushString (String contents, String deviceFilePath)` Enviar arquivo criado a partir de uma string para o dispositivo
`abstract void`	`reboot ()` Reinicializa o dispositivo no modo adb.
`abstract void`	`reboot (String reason)` Reinicializa o dispositivo no modo adb com um determinado `reason` para persistir durante a reinicialização.
`abstract void`	`rebootIntoBootloader ()` Reinicializa o dispositivo no modo bootloader.
`abstract void`	`rebootIntoFastbootd ()` Reinicializa o dispositivo no modo fastbootd.
`abstract void`	`rebootIntoRecovery ()` Reinicializa o dispositivo no modo de recuperação adb.
`abstract void`	`rebootIntoSideload (boolean autoReboot)` Reinicializa o dispositivo no modo adb sideload (observe que este é um modo especial em recuperação) Bloqueia até que o dispositivo entre no modo sideload
`abstract void`	`rebootIntoSideload ()` Reinicializa o dispositivo no modo adb sideload (observe que este é um modo especial em recuperação) Bloqueia até que o dispositivo entre no modo sideload
`abstract void`	`rebootUntilOnline ()` Uma alternativa para `reboot()` que bloqueia apenas até que o dispositivo esteja online, ou seja, visível para adb.
`abstract void`	`rebootUntilOnline (String reason)` Uma alternativa para `reboot()` que bloqueia apenas até que o dispositivo esteja online, ou seja, visível para adb.
`abstract void`	`rebootUserspace ()` Reinicializa apenas a parte do espaço do usuário do dispositivo.
`abstract void`	`rebootUserspaceUntilOnline ()` Uma alternativa para `rebootUserspace()` ()} que bloqueia apenas até que o dispositivo esteja online, ou seja, visível para adb.
`abstract void`	`remountSystemReadOnly ()` Torne a partição do sistema no dispositivo somente leitura.
`abstract void`	`remountSystemWritable ()` Torne a partição do sistema no dispositivo gravável.
`abstract void`	`remountVendorReadOnly ()` Torne a partição do fornecedor no dispositivo somente leitura.
`abstract void`	`remountVendorWritable ()` Torne a partição do fornecedor no dispositivo gravável.
`abstract 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 ouvintes passados como parâmetros.
`abstract boolean`	`runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)` `runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)` Executa testes de instrumentação e fornece recuperação de dispositivos.
`abstract boolean`	`runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)` `runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)` Igual `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 determinado usuário.
`abstract boolean`	`runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` O mesmo que `ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)` mas executa o teste para um determinado usuário.
`abstract void`	`setDate (Date date)` Define a data no dispositivo Nota: definir a data no dispositivo requer root
`abstract void`	`setOptions ( TestDeviceOptions options)` Defina `TestDeviceOptions` para o dispositivo
`abstract boolean`	`setProperty (String propKey, String propValue)` Define o valor da propriedade fornecido no dispositivo.
`abstract void`	`setRecovery ( IDeviceRecovery recovery)` Defina o `IDeviceRecovery` a ser usado para este dispositivo.
`abstract void`	`setRecoveryMode ( ITestDevice.RecoveryMode mode)` Defina o modo de recuperação atual a ser usado para o dispositivo.
`abstract void`	`setUseFastbootErase (boolean useFastbootErase)` Defina se deseja usar o apagamento de inicialização rápida ou o formato de inicialização rápida para limpar uma partição no dispositivo.
`abstract void`	`startLogcat ()` Comece a capturar a saída logcat do dispositivo em segundo plano.
`abstract void`	`stopEmulatorOutput ()` Feche e exclua a saída do emulador.
`abstract void`	`stopLogcat ()` Pare de capturar a saída do logcat do dispositivo e descarte os dados do logcat salvos no momento.
`abstract String`	`switchToAdbTcp ()` Mude o dispositivo para o modo adb-over-tcp.
`abstract boolean`	`switchToAdbUsb ()` Mude o dispositivo para o modo adb sobre usb.
`abstract boolean`	`syncFiles (File localFileDir, String deviceFilePath)` Sincroniza incrementalmente o conteúdo de um diretório de arquivo local com o dispositivo.
`abstract boolean`	`unlockDevice ()` Desbloqueia o dispositivo se ele estiver em um estado criptografado.
`abstract boolean`	`waitForBootComplete (long timeOut)` Bloqueia até que o sinalizador de inicialização completa do dispositivo seja definido.
`abstract boolean`	`waitForDeviceAvailable ()` Aguarda até que o dispositivo seja responsivo e esteja disponível para teste.
`abstract boolean`	`waitForDeviceAvailable (long waitTime)` Aguarda até que o dispositivo seja responsivo e esteja disponível para teste.
`abstract boolean`	`waitForDeviceAvailableInRecoverPath (long waitTime)` Aguarda até que o dispositivo esteja responsivo e disponível sem considerar o caminho de recuperação.
`abstract void`	`waitForDeviceBootloader ()` Bloqueia até que o dispositivo fique visível via fastboot.
`abstract boolean`	`waitForDeviceInRecovery (long waitTime)` Blocos para o dispositivo estar no estado 'adb recovery' (observe que isso é diferente de `IDeviceRecovery` ).
`abstract boolean`	`waitForDeviceInSideload (long waitTime)` Blocos para o dispositivo estar no estado 'adb sideload'
`abstract boolean`	`waitForDeviceNotAvailable (long waitTime)` Blocos para o dispositivo não estarem disponíveis, ou seja, ausentes do adb
`abstract void`	`waitForDeviceOnline ()` Bloqueia até que o dispositivo fique visível via adb.
`abstract void`	`waitForDeviceOnline (long waitTime)` Bloqueia até que o dispositivo fique visível via adb.
`abstract boolean`	`waitForDeviceShell (long waitTime)` Aguarda que o dispositivo responda a um comando shell adb básico.

Constantes

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Valor padrão quando o nível da API não pode ser detectado

Valor constante: -1 (0xffffffff)

Métodos públicos

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Verifique se um recurso é ou não suportado no momento, dado um nível minimamente suportado. Este método leva em consideração 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 estrito que suporta o recurso.

devoluções
`boolean`	Verdadeiro se o nível for compatível. Falso caso contrário.

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

clearLogcat

public abstract void clearLogcat ()

Exclui todos os dados logcat acumulados.

Isso é útil para casos em que você deseja garantir ITestDevice#getLogcat() retorne apenas dados de log produzidos após um determinado ponto (como após o flash de uma nova compilação de dispositivo etc.).

deletarArquivo

public abstract 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.

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

dispositivoSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

devoluções
`boolean`	`true` se o dispositivo for reiniciado por software

lances
`RuntimeException`	se o dispositivo tiver um motivo de inicialização anormal
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Método auxiliar para verificar se o dispositivo reiniciou por software desde a hora UTC desde a época do dispositivo e seu ERROR(/TimeUnit) . Soft-Restart refere-se a system_server reiniciado fora de uma reinicialização forçada do dispositivo (por exemplo: reinicialização solicitada). O dispositivo atual utcEpochTime em Millisecond pode ser obtido pelo método getDeviceDate() .

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

devoluções
`boolean`	`true` se o dispositivo for reiniciado por software

lances
`RuntimeException`	se o dispositivo tiver um motivo de inicialização anormal
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableAdbRoot

public abstract boolean disableAdbRoot ()

Desativa o adb root.

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

devoluções
`boolean`	`true` se for bem-sucedido.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

doesFileExist

public abstract 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

devoluções
`boolean`	`true` se o arquivo existir, `false` caso contrário.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

devoluções
`boolean`	`true` se for bem-sucedido.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

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

executeShellCommand(String) deve ser usado sempre que possível, pois esse método fornece melhor detecção de falha e desempenho.

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

devoluções
`String`	o stdout do comando. `null` se o comando falhou ao executar.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

executeShellCommand(String) deve ser usado sempre que possível, pois esse método fornece melhor detecção de falha e desempenho.

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

devoluções
`String`	o stdout do comando. `null` se o comando falhou ao executar.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

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

executeShellCommand(String) deve ser usado sempre que possível, pois esse método fornece melhor detecção de falha e desempenho.

Parâmetros
`timeout`	`long` : o tempo em milissegundos antes que o dispositivo seja considerado sem resposta, 0L para nenhum tempo limite
`envMap`	: ambiente a definir para o comando
`commandArgs`	`String` : o comando adb e os argumentos a serem executados

devoluções
`String`	o stdout do comando. `null` se o comando falhou ao executar.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

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

Espera-se que seja usado quando o dispositivo já estiver no modo de inicialização rápida.

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

devoluções
`CommandResult`	o CommandResult contendo a saída do comando

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

Espera-se que seja usado quando o dispositivo já estiver no modo de inicialização rápida.

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

devoluções
`CommandResult`	o CommandResult contendo a saída do comando

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

Idêntico a executeFastbootCommand(String) exceto que usa um tempo limite maior.

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

devoluções
`CommandResult`	o CommandResult contendo a saída do comando

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

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 que usa um tempo limite maior.

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

devoluções
`CommandResult`	o CommandResult contendo a saída do comando

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeShellCommand

public abstract String executeShellCommand (String command)

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

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

devoluções
`String`	a saída do shell

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeShellCommand

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

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

Parâmetros
`command`	`String` : o comando adb shell a ser executado
`receiver`	`IShellOutputReceiver` : o `IShellOutputReceiver` para o qual direcionar a saída do shell.
`maxTimeToOutputShellResponse`	`long` : a quantidade máxima de tempo durante a qual o comando pode não gerar nenhuma resposta; unidade conforme especificado em `timeUnit`
`timeUnit`	`TimeUnit` : unidade para `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se `retryAttempts` for executada sem sucesso.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

Veja também:

executeShellCommand

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

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

Parâmetros
`command`	`String` : o comando adb shell a ser executado
`receiver`	`IShellOutputReceiver` : o `IShellOutputReceiver` para o qual direcionar a saída do shell.
`maxTimeoutForCommand`	`long` : o tempo limite máximo para o comando ser concluído; unidade conforme especificado em `timeUnit`
`maxTimeToOutputShellResponse`	`long` : a quantidade máxima de tempo durante a qual o comando pode não gerar nenhuma resposta; unidade conforme especificado em `timeUnit`
`timeUnit`	`TimeUnit` : unidade para `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se `retryAttempts` for executada sem sucesso.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

Veja também:

executeShellCommand

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

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

Parâmetros
`command`	`String` : O comando que deve ser executado.

devoluções
`CommandResult`	O resultado em `CommandResult` .

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

Parâmetros
`command`	`String` : O comando que deve ser executado.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` onde a saída std será redirecionada, ou null.

devoluções
`CommandResult`	O resultado em `CommandResult` .

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

Parâmetros
`command`	`String` : O comando que deve ser executado.
`pipeAsInput`	`File` : Um `ERROR(/File)` que será canalizado como entrada para o comando ou nulo.

devoluções
`CommandResult`	O resultado em `CommandResult` .

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeShellV2Command

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

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

Parâmetros
`command`	`String` : o comando adb shell a ser executado
`maxTimeoutForCommand`	`long` : o tempo limite máximo para o comando ser concluído; unidade conforme especificado em `timeUnit`
`timeUnit`	`TimeUnit` : unidade para `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se `retryAttempts` for executada sem sucesso.

devoluções
`CommandResult`

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

Veja também:

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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

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

devoluções
`CommandResult`

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

Veja também:

executeShellV2Command

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

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

Parâmetros
`command`	`String` : o comando adb shell a ser executado
`pipeAsInput`	`File` : Um `ERROR(/File)` que será canalizado como entrada para o comando ou nulo.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` onde a saída std será redirecionada, ou null.
`maxTimeoutForCommand`	`long` : o tempo limite máximo para o comando ser concluído; unidade conforme especificado em `timeUnit`
`timeUnit`	`TimeUnit` : unidade para `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se `retryAttempts` for executada sem sucesso.

devoluções
`CommandResult`

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

Veja também:

executeShellV2Command

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

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

Parâmetros
`command`	`String` : o comando adb shell a ser executado
`pipeAsInput`	`File` : Um `ERROR(/File)` que será canalizado como entrada para o comando ou nulo.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` onde a saída std será redirecionada, ou null.
`pipeToError`	`OutputStream` : `ERROR(/OutputStream)` onde o erro std será redirecionado, ou nulo.
`maxTimeoutForCommand`	`long` : o tempo limite máximo para o comando ser concluído; unidade conforme especificado em `timeUnit`
`timeUnit`	`TimeUnit` : unidade para `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se `retryAttempts` for executada sem sucesso.

devoluções
`CommandResult`

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

Veja também:

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

Espera-se que seja usado quando o dispositivo já estiver no modo de inicialização rápida.

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

devoluções
`CommandResult`	o CommandResult contendo a saída do comando

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

getApiLevel

public abstract int getApiLevel ()

Obtenha o nível de API do dispositivo. O padrão é UNKNOWN_API_LEVEL .

devoluções
`int`	um número inteiro indicando o nível de API do dispositivo

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBasebandVersion

public abstract String getBasebandVersion ()

Método de conveniência para obter a versão de banda base (rádio) deste dispositivo. Obter a versão do rádio é específico do dispositivo, portanto, pode não retornar as informações corretas para todos os dispositivos. Este 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 relatada pelo fastboot e pode não retornar a versão para o rádio CDMA. TL;DR este método relata apenas a versão precisa se a propriedade gsm.version.baseband for a mesma que a versão retornada por fastboot getvar version-baseband .

devoluções
`String`	a versão da banda base `String` ou `null` se não puder ser determinada (o dispositivo não tem rádio ou a string da versão não pode ser lida)

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

getBattery

public abstract Integer getBattery ()

Retorna o nível atual da bateria de um dispositivo ou Nulo se o nível da bateria estiver indisponível.

devoluções
`Integer`

getBooleanProperty

public abstract 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.

devoluções
`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.

lances
`DeviceNotAvailableException`

getBootHistory

public abstract  getBootHistory ()

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

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

lances
`DeviceNotAvailableException`

getBootHistoryDesde

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

lances
`DeviceNotAvailableException`

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

Tentará recuperar a versão do bootloader do estado atual do dispositivo. (ou seja, se o dispositivo estiver no modo fastboot, ele tentará recuperar a versão do fastboot)

devoluções
`String`	a versão do bootloader `String` ou `null` se não puder ser encontrado

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

getBuildAlias

public abstract String getBuildAlias ()

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

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

devoluções
`String`	o alias de compilação ou retornar ao ID de compilação se não puder ser recuperado

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildFlavor

public abstract String getBuildFlavor ()

Recupere o tipo de compilação para o dispositivo.

devoluções
`String`	o tipo de compilação ou nulo se não puder ser recuperado

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildId

public abstract String getBuildId ()

Recupere a compilação que o dispositivo está executando no momento.

devoluções
`String`	o ID de compilação ou `IBuildInfo#UNKNOWN_BUILD_ID` se não puder ser recuperado

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildSigningKeys

public abstract 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 liberação (controladas por fabricantes de dispositivos individuais)

devoluções
`String`	A chave de assinatura, se encontrada, null caso contrário.

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

devoluções
`DeviceDescriptor`

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

Parâmetros
`shortDescriptor`	`boolean` : Limita ou não o descritor a informações mínimas

devoluções
`DeviceDescriptor`

getChildren

public abstract String[] getChildren (String deviceFilePath)

Alternativa para usar IFileEntry que às vezes não funciona devido a permissões.

Parâmetros
`deviceFilePath`	`String` : é o caminho no dispositivo onde fazer a pesquisa

devoluções
`String[]`	Matriz de string contendo todo o arquivo em um caminho no dispositivo.

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getConnection

public abstract AbstractConnection getConnection ()

Retorna a conexão associada ao dispositivo.

devoluções
`AbstractConnection`

getDeviceClass

public abstract String getDeviceClass ()

Obtenha a classe do dispositivo.

devoluções
`String`	a classe de dispositivo `String` .

getDeviceDate

public abstract long getDeviceDate ()

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

devoluções
`long`	a data do dispositivo em formato de época.

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

devoluções
`DeviceDescriptor`

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

Parâmetros
`shortDescriptor`	`boolean` : Limita ou não o descritor a informações mínimas

devoluções
`DeviceDescriptor`

getDeviceState

public abstract TestDeviceState getDeviceState ()

Obtenha o estado do dispositivo.

devoluções
`TestDeviceState`

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Helper para obter a diferença de tempo entre o dispositivo e um determinado ERROR(/Date) . Use o tempo Epoch internamente.

Parâmetros
`date`	`Date`

devoluções
`long`	a diferença em milissegundos

lances
`DeviceNotAvailableException`

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Obtenha o fluxo do emulador stdout e stderr

devoluções
`InputStreamSource`	saída do emulador

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

devoluções
`long`	a quantidade de espaço livre em KB

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

getFastbootProductType

public abstract String getFastbootProductType ()

Método de conveniência para obter o tipo de produto deste dispositivo quando estiver no modo de inicialização rápida.

Este método só deve ser usado se o dispositivo estiver em inicialização rápida. É uma variante um pouco mais segura do que o método genérico getProductType() neste caso, porque o ITestDevice saberá recuperar o dispositivo no fastboot se o dispositivo estiver em estado incorreto ou não responder.

devoluções
`String`	o nome do tipo de produto `String` ou `null` se não puder ser determinado

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Método de conveniência para obter o tipo de produto deste dispositivo quando estiver no modo de inicialização rápida.

devoluções
`String`	o nome do tipo de produto `String` ou `null` se não puder ser determinado

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

devoluções
`String`

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Recupere o valor da variável fastboot fornecida do dispositivo.

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

devoluções
`String`	o valor da propriedade ou `null` se não existir

lances
	UnsupportedOperationException
`DeviceNotAvailableException`

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Recupere 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 um caminho relativo a '/'. (isto é, ambas as sintaxes "/system" e "system" são suportadas)

devoluções
`IFileEntry`	o `IFileEntry` ou `null` se o arquivo em determinado `path` não puder ser encontrado

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getIDevice

public abstract IDevice getIDevice ()

Retorna uma referência ao ddmlib IDevice associado.

Um novo IDevice pode ser alocado pelo DDMS cada vez que o dispositivo desconecta e reconecta do adb. Portanto, os chamadores não devem manter uma referência ao IDevice , porque essa referência pode se tornar obsoleta.

devoluções
`IDevice`	o `IDevice`

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Retorna o valor inteiro da propriedade fornecida 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.

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

lances
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

devoluções
`long`

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Obtenha o primeiro nível de API lançado do dispositivo. O padrão é UNKNOWN_API_LEVEL .

devoluções
`int`	um número inteiro indicando o primeiro nível de API lançado do dispositivo

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getLogcat

public abstract InputStreamSource getLogcat ()

Obtém um fluxo de instantâneo dos dados logcat.

Funciona em dois modos:

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

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

devoluções
`InputStreamSource`

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

Obtém um fluxo instantâneo dos últimos maxBytes de dados logcat capturados.

Útil para casos em que você deseja capturar instantâneos frequentes dos dados logcat capturados sem incorrer na penalidade de espaço em disco potencialmente grande de obter o instantâneo getLogcat() inteiro.

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

devoluções
`InputStreamSource`

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

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

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

devoluções
`InputStreamSource`	um `InputStreamSource` dos dados logcat. Um fluxo vazio é retornado se falhar ao capturar dados logcat.

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

Obtém um fluxo instantâneo de dados logcat capturados a partir da data fornecida. A hora no dispositivo deve ser usada getDeviceDate() .

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

devoluções
`InputStreamSource`

getMountPoint

public abstract String getMountPoint (String mountName)

Retorna um ponto de montagem.

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

TODO: mova este comportamento para IDevice#getMountPoint(String)

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

devoluções
`String`	o ponto de montagem ou `null`

Veja também:

IDevice.getMountPoint(String)

getMountPointInfo

public abstract 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`

devoluções
`ITestDevice.MountPointInfo`	Um `ERROR(/List)` de `MountPointInfo` contendo as informações em "/proc/mounts"

lances
`DeviceNotAvailableException`

Veja também:

getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

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

devoluções
	Um `ERROR(/List)` de `MountPointInfo` contendo as informações em "/proc/mounts"

lances
`DeviceNotAvailableException`

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

Parâmetros
`partition`	`String`

devoluções
`long`	a quantidade de espaço livre em KB

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

O método auxiliar executa o comando "pidof" e "stat" e retorna o objeto ProcessInfo com PID e hora de início do processo fornecido.

Parâmetros
`processName`	`String` : o nome do processo String.

devoluções
`ProcessInfo`	ProcessInfo de determinado processName

lances
`DeviceNotAvailableException`

getProcessPid

public abstract String getProcessPid (String process)

Retorna o pid do serviço ou null se algo deu errado.

Parâmetros
`process`	`String` : O nome do processo String.

devoluções
`String`

lances
`DeviceNotAvailableException`

getProductType

public abstract String getProductType ()

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

Este método funcionará se o dispositivo estiver no modo adb ou fastboot.

devoluções
`String`	o nome do tipo de produto `String` . não será nulo

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada, ou se o tipo de produto não puder ser determinado

getProductVariant

public abstract String getProductVariant ()

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

Este método funcionará se o dispositivo estiver no modo adb ou fastboot.

devoluções
`String`	o nome da variante do produto `String` ou `null` se não puder ser determinado

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

obterPropriedade

public abstract String getProperty (String name)

Recupere o valor da propriedade fornecido do dispositivo.

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

devoluções
`String`	o valor da propriedade ou `null` se não existir

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

devoluções
`ITestDevice.RecoveryMode`	o modo de recuperação atual usado para o dispositivo.

getSerialNumber

public abstract String getSerialNumber ()

Método de conveniência para obter o número de série deste dispositivo.

devoluções
`String`	o número de série `String`

getTombstones

public abstract  getTombstones ()

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

O método é o melhor esforço, portanto, se uma lápide não for extraída por qualquer motivo, ela estará ausente da lista. Somente uma DeviceNotAvailableException encerrará o método antecipadamente.

devoluções
	Uma lista de arquivos de tombstone, vazio se não houver tombstone.

lances
`DeviceNotAvailableException`

Veja também:

Documentação das lápides

getTotalMemory

public abstract long getTotalMemory ()

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

devoluções
`long`

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

Obtenha se deseja usar o apagamento de inicialização rápida ou o formato de inicialização rápida para limpar uma partição no dispositivo.

devoluções
`boolean`	`true` se fastboot erase for usado ou `false` se o formato fastboot for usado.

Veja também:

fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

devoluções
`boolean`	`true` se o dispositivo atualmente tiver adb root, `false` caso contrário.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

isAdbTcp

public abstract boolean isAdbTcp ()

devoluções
`boolean`	`true` se o dispositivo estiver conectado a adb-over-tcp, `false` caso contrário.

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

Verifique se a plataforma no dispositivo oferece suporte à enumeração de aplicativos

devoluções
`boolean`	Verdadeiro se a enumeração do aplicativo for suportada, falso caso contrário

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

Verifique se a plataforma no dispositivo oferece suporte para ignorar o bloqueio de alvo baixo do SDK nas instalações do aplicativo

devoluções
`boolean`	Verdadeiro se o bloqueio do SDK de destino baixo for suportado, falso caso contrário

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

Retorna se o dispositivo estiver criptografado.

devoluções
`boolean`	`true` se o dispositivo estiver criptografado.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

Retorna True se o caminho no dispositivo for um diretório, false caso contrário.

Parâmetros
`deviceFilePath`	`String`

devoluções
`boolean`

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

Retorna se a criptografia for suportada no dispositivo.

devoluções
`boolean`	`true` se o dispositivo oferecer suporte à criptografia.

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

éexecutável

public abstract boolean isExecutable (String fullPath)

Retorna True se o caminho do arquivo no dispositivo for um arquivo executável, caso contrário, false.

Parâmetros
`fullPath`	`String`

devoluções
`boolean`

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

é sem cabeça

public abstract boolean isHeadless ()

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

devoluções
`boolean`

lances
`DeviceNotAvailableException`

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

Verifique se a plataforma no dispositivo oferece suporte à concessão de permissão de tempo de execução

devoluções
`boolean`	Verdadeiro se a permissão de tempo de execução for suportada, caso contrário, falso.

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

Retorna verdadeiro se o dispositivo estiver em TestDeviceState#FASTBOOT ou TestDeviceState.FASTBOOTD .

devoluções
`boolean`

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

Coleta e registra ANRs do dispositivo.

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

devoluções
`boolean`	True se o registro foi bem-sucedido, false caso contrário.

lances
`DeviceNotAvailableException`

logOnDevice

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

Registre uma mensagem no logcat do dispositivo. Esta é uma chamada segura que não será lançada mesmo se o log falhar.

Parâmetros
`tag`	`String` : A tag sob a qual 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 via String.format().

nonBlockingReboot

public abstract void nonBlockingReboot ()

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

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public abstract void postBootSetup ()

Execute as instruções para configurar o dispositivo para testá-lo após cada inicialização.

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

Em circunstâncias normais, esse método não precisa ser chamado explicitamente, pois as implementações devem executar essas etapas automaticamente ao executar uma reinicialização.

Onde pode precisar ser chamado é quando o dispositivo reinicia devido a outros eventos (por exemplo, quando um comando de atualização do fastboot foi concluído)

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

postInvocationTearDown

public void postInvocationTearDown ()

Este método está obsoleto.
Em vez disso, use postInvocationTearDown(Throwable) .

Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a conclusão da chamada.

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a conclusão da chamada.

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

preInvocationSetup

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

Etapas extras para configuração necessária específica do dispositivo que serão executadas 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

lances
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

devoluções
`boolean`	`true` se o arquivo foi puxado com sucesso. `false` caso contrário.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

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

devoluções
`File`	Um `ERROR(/File)` contendo o conteúdo do arquivo do dispositivo ou `null` se a cópia falhou por qualquer motivo (incluindo problemas com o sistema de arquivos do host)

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

pullFile

public abstract File pullFile (String remoteFilePath)

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

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

devoluções
`File`	Um `ERROR(/File)` contendo o conteúdo do arquivo do dispositivo ou `null` se a cópia falhou por qualquer motivo (incluindo problemas com o sistema de arquivos do host)

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

pullFile

public abstract 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.

devoluções
`boolean`	`true` se o arquivo foi recuperado com sucesso. `false` caso contrário.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

pullFile

public abstract 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 para extrair

devoluções
`boolean`	`true` se o arquivo foi recuperado com sucesso. `false` caso contrário.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

pullFileContents

public abstract 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.

devoluções
`String`	Uma `String` contendo o conteúdo do arquivo do dispositivo ou `null` se a cópia falhou por qualquer motivo (incluindo problemas com o sistema de arquivos do host)

lances
`DeviceNotAvailableException`

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

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

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

devoluções
`File`	Um `ERROR(/File)` contendo o conteúdo do arquivo do dispositivo ou `null` se a cópia falhou por qualquer motivo (incluindo problemas com o sistema de arquivos do host)

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                 excludedDirectories)

Empurre recursivamente o conteúdo do diretório para o dispositivo enquanto exclui alguns diretórios que são filtrados.

Parâmetros
`localDir`	`File` : o diretório local para enviar
`deviceFilePath`	`String` : o caminho absoluto do arquivo do destino remoto
`excludedDirectories`	: Conjunto de nomes de diretórios excluídos que não devem ser enviados.

devoluções
`boolean`	`true` se o arquivo foi enviado com sucesso. `false` caso contrário.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

Empurre recursivamente o conteúdo do diretório para o dispositivo.

Parâmetros
`localDir`	`File` : o diretório local para enviar
`deviceFilePath`	`String` : o caminho absoluto do arquivo do destino remoto

devoluções
`boolean`	`true` se o arquivo foi enviado com êxito. `false` caso contrário.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                boolean evaluateContentProviderNeeded)

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

Parâmetros
`localFile`	`File` : o arquivo local a ser enviado
`deviceFilePath`	`String` : o caminho absoluto do arquivo de destino remoto
`evaluateContentProviderNeeded`	`boolean` : se deve verificar se precisamos do provedor de conteúdo

devoluções
`boolean`	`true` se o arquivo foi enviado com êxito. `false` caso contrário.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

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

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

devoluções
`boolean`	`true` se o arquivo foi enviado com êxito. `false` caso contrário.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

Enviar arquivo criado a partir de uma string para o dispositivo

Parâmetros
`contents`	`String` : o conteúdo do arquivo para push
`deviceFilePath`	`String` : o caminho absoluto do arquivo de destino remoto

devoluções
`boolean`	`true` se a string foi enviada com sucesso. `false` caso contrário.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

reinício

public abstract void reboot ()

Reinicializa o dispositivo no modo adb.

Bloqueia até que o dispositivo fique disponível.

lances
`DeviceNotAvailableException`	se o dispositivo não estiver disponível após a reinicialização

reinício

public abstract void reboot (String reason)

Reinicializa o dispositivo no modo adb com um determinado reason para persistir durante a reinicialização.

Bloqueia até que o dispositivo fique disponível.

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

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

lances
`DeviceNotAvailableException`	se o dispositivo não estiver disponível após a reinicialização

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

Reinicializa o dispositivo no modo bootloader.

Bloqueia até que o dispositivo esteja no modo bootloader.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

Reinicializa o dispositivo no modo fastbootd.

Bloqueia até que o dispositivo esteja no modo fastbootd.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

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

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

lances
`DeviceNotAvailableException`	se o dispositivo não estiver disponível após a reinicialização

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

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

Bloqueia até que o dispositivo entre no modo sideload

Parâmetros
`autoReboot`	`boolean` : se deve reiniciar automaticamente o dispositivo após o sideload

lances
`DeviceNotAvailableException`	se o dispositivo não estiver em sideload após a reinicialização

rebootIntoSideload

public abstract void rebootIntoSideload ()

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

Bloqueia até que o dispositivo entre no modo sideload

lances
`DeviceNotAvailableException`	se o dispositivo não estiver em sideload após a reinicialização

rebootUntilOnline

public abstract void rebootUntilOnline ()

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

lances
`DeviceNotAvailableException`	se o dispositivo não estiver disponível após a reinicialização

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

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

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

lances
`DeviceNotAvailableException`	se o dispositivo não estiver disponível após a reinicialização

Veja também:

reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

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

Bloqueia até que o dispositivo fique disponível.

AVISO. A reinicialização do espaço do usuário está atualmente em desenvolvimento ativo, use-a por sua conta e risco.

lances
`DeviceNotAvailableException`	se o dispositivo não estiver disponível após a reinicialização

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

Uma alternativa para rebootUserspace() ()} que bloqueia apenas até que o dispositivo esteja online, ou seja, visível para adb.

lances
`DeviceNotAvailableException`	se o dispositivo não estiver disponível após a reinicialização

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

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

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountSystemWritable

public abstract void remountSystemWritable ()

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

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

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

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remontarVendorWritable

public abstract void remountVendorWritable ()

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

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

runInstrumentationTests

public abstract 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 ouvintes passados como parâmetros.

Parâmetros
`runner`	`IRemoteAndroidTestRunner` : o `IRemoteAndroidTestRunner` que executa os testes
`listeners`	`ITestLifeCycleReceiver` : o(s) ouvinte(s) do resultado do teste

devoluções
`boolean`	`true` se o comando de teste for concluído. `false` se falhou ao concluir, mas a recuperação foi bem-sucedida

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada. ou seja, o comando de teste falhou ao concluir e a recuperação falhou.

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

Se a conexão com o dispositivo for perdida antes da conclusão da execução do teste e a recuperação for bem-sucedida, todos os ouvintes serão informados de testRunFailed e "false" será retornado. O comando de teste não será executado novamente. Cabe aos chamadores 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 ouvintes serão informados sobre testRunFailed e DeviceNotAvailableException será lançada.

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

devoluções
`boolean`	`true` se o comando de teste for concluído. `false` se falhou ao concluir devido à exceção de comunicação do dispositivo, mas a recuperação foi bem-sucedida

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada. ou seja, o comando de teste falhou ao concluir e a recuperação falhou.

runInstrumentationTestsAsUser

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

Igual 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 determinado usuário.

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

devoluções
`boolean`

lances
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

O mesmo que ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) mas executa o teste para um determinado usuário.

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

devoluções
`boolean`

lances
`DeviceNotAvailableException`

data marcada

public abstract void setDate (Date date)

Define a data no dispositivo

Nota: definir a data no dispositivo requer root

Parâmetros
`date`	`Date` : especifique uma data específica; usará a data do host se `null`

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

definiropções

public abstract void setOptions (TestDeviceOptions options)

Defina TestDeviceOptions para o dispositivo

Parâmetros
`options`	`TestDeviceOptions`

definirPropriedade

public abstract boolean setProperty (String propKey, 
                String propValue)

Define o valor da propriedade fornecido no dispositivo. Requer adb root é verdadeiro.

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

devoluções
`boolean`	retorna `True` se o comando setprop foi bem-sucedido, False caso contrário.

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

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

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

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

Defina o modo de recuperação atual a ser usado para o dispositivo.

Usado para controlar qual método de recuperação usar quando um problema de comunicação do dispositivo for encontrado. Recomenda-se usar este método apenas com moderação quando necessário (por exemplo, quando o framework está inoperante, etc.

Parâmetros
`mode`	`ITestDevice.RecoveryMode` : se o modo 'recuperar somente online' deve estar ativado ou não.

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

Defina se deseja usar o apagamento de inicialização rápida ou o formato de inicialização rápida para limpar uma partição no dispositivo.

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

Veja também:

fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

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

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

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

startLogcat() e stopLogcat() normalmente não precisam ser chamados dentro de um contexto de invocação do TF, pois a estrutura do TF iniciará e interromperá o logcat.

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

Feche e exclua a saída do emulador.

stopLogcat

public abstract void stopLogcat ()

Pare de capturar a saída do logcat do dispositivo e descarte os dados do logcat salvos no momento.

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

switchToAdbTcp

public abstract String switchToAdbTcp ()

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

devoluções
`String`	o número de série tcp ou `null` se o dispositivo não puder ser trocado

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

Mude o dispositivo para o modo adb sobre usb.

devoluções
`boolean`	`true` se a troca foi bem-sucedida, `false` caso contrário.

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

arquivos de sincronização

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

Decide quais arquivos enviar por push comparando timestamps de arquivos locais com seus equivalentes remotos. Somente arquivos 'mais recentes' ou inexistentes serão enviados para o dispositivo. Portanto, a sobrecarga deve ser relativamente pequena se o conjunto de arquivos no dispositivo já estiver atualizado.

Arquivos ocultos (com nomes começando com ".") serão ignorados.

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

Parâmetros
`localFileDir`	`File` : o diretório de arquivo local contendo arquivos para push recursivamente.
`deviceFilePath`	`String` : a raiz do caminho absoluto do arquivo de destino remoto. Todos os diretórios nesse caminho de arquivo devem ser legíveis. ou seja, empurrar para /data/local/tmp quando adb não é root falhará

devoluções
`boolean`	`true` se os arquivos foram sincronizados com êxito. `false` caso contrário.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

dispositivo de desbloqueio

public abstract boolean unlockDevice ()

Desbloqueia o dispositivo se ele estiver em um estado criptografado.

Este método pode reiniciar a estrutura, mas não chamará postBootSetup() . Portanto, o dispositivo pode não estar totalmente pronto para ser testado quando esse método retornar.

devoluções
`boolean`	`true` se for bem-sucedido ou se o dispositivo não estiver criptografado.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.
`UnsupportedOperationException`	se a criptografia não for compatível com o dispositivo.

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

Bloqueia até que o sinalizador de inicialização completa do dispositivo seja definido.

Parâmetros
`timeOut`	`long` : tempo em msegs para aguardar o sinalizador ser definido

devoluções
`boolean`	verdadeiro se o sinalizador de inicialização completa do dispositivo estiver definido dentro do tempo limite

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForDeviceDisponível

public abstract boolean waitForDeviceAvailable ()

Aguarda até que o dispositivo seja responsivo e esteja disponível para teste. Usa o tempo limite padrão.

devoluções
`boolean`	Verdadeiro se o dispositivo estiver disponível, Falso se a recuperação estiver desativada e indisponível.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

waitForDeviceDisponível

public abstract boolean waitForDeviceAvailable (long waitTime)

Aguarda até que o dispositivo seja responsivo e esteja disponível para teste.

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

devoluções
`boolean`	Verdadeiro se o dispositivo estiver disponível, Falso se a recuperação estiver desativada e indisponível.

lances
`DeviceNotAvailableException`	se o dispositivo ainda não responder após o waitTime expirar.

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Aguarda até que o dispositivo esteja responsivo e disponível sem considerar o caminho de recuperação.

Parâmetros
`waitTime`	`long`

devoluções
`boolean`	Verdadeiro se o dispositivo estiver disponível, Falso se não estiver disponível.

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

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

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Blocos para o dispositivo estar no estado 'adb recovery' (observe que isso é diferente de IDeviceRecovery ).

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

devoluções
`boolean`	`true` se o dispositivo for inicializado em recuperação antes do tempo expirar. `false` caso contrário

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Blocos para o dispositivo estar no estado 'adb sideload'

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

devoluções
`boolean`	`true` se o dispositivo for inicializado em sideload antes do tempo expirar. `false` caso contrário

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

Blocos para o dispositivo não estarem disponíveis, ou seja, ausentes do adb

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

devoluções
`boolean`	`true` se o dispositivo ficar indisponível antes do tempo expirar. `false` caso contrário

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

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

Observe que o dispositivo pode não responder necessariamente aos comandos após a conclusão. Em vez disso, use waitForDeviceAvailable() .

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

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

Observe que o dispositivo pode não responder necessariamente aos comandos após a conclusão. Em vez disso, use waitForDeviceAvailable() .

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

lances
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada.

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

Aguarda que o dispositivo responda a um comando shell adb básico.

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

devoluções
`boolean`	`true` se o dispositivo se tornar responsivo antes de `waitTime` terminar.