INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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.

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.

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.

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.

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.

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.

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.

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.

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

    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

    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

    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.

    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:

    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.

    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.