Dispositivo INativo

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

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 é atualmente suportado ou não, dado um nível minimamente suportado.

abstract void clearLogcat ()

Exclui quaisquer dados acumulados do logcat.

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 foi reiniciado suavemente, comparando o system_server atual com o system_server ProcessInfo anterior.

abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

Método auxiliar para verificar se o dispositivo foi reiniciado suavemente desde o horário UTC desde a época do dispositivo e seu ERROR(/TimeUnit) .

abstract boolean disableAdbRoot ()

Desativa a raiz do adb.

abstract boolean doesFileExist (String deviceFilePath)

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

abstract boolean enableAdbRoot ()

Ativa a raiz do adb.

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 fastboot 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 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 novamente várias vezes se o comando falhar.

abstract CommandResult executeShellV2Command (String command)

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, 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 shell adb 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 não estiver disponível.

abstract boolean getBooleanProperty (String name, boolean defaultValue)

Retorna o valor booleano da propriedade fornecida.

abstract getBootHistory ()

O método auxiliar coleta o mapa do histórico de inicialização com o tempo 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 conveniente para obter a versão do bootloader deste dispositivo.

abstract String getBuildAlias ()

Recupere o alias do build que o dispositivo está executando atualmente.

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

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

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

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

Auxiliar para obter a diferença de horário 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 conveniente para obter o tipo de produto deste dispositivo quando estiver no modo fastboot.

abstract String getFastbootProductVariant ()

Método conveniente para obter o tipo de produto deste dispositivo quando estiver no modo fastboot.

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 fornecido do dispositivo.

abstract IFileEntry getFileEntry (String path)

Recuperar 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 acionaram uma reinicialização em milissegundos desde EPOCH, conforme retornado por System.currentTimeMillis() .

abstract int getLaunchApiLevel ()

Obtenha o primeiro nível de API lançado no dispositivo.

abstract InputStreamSource getLogcat ()

Captura um fluxo de instantâneo dos dados do logcat.

abstract InputStreamSource getLogcat (int maxBytes)

Captura um fluxo de instantâneo dos últimos maxBytes de dados do logcat capturados.

abstract InputStreamSource getLogcatDump ()

Obtenha um dump do logcat atual do dispositivo.

abstract InputStreamSource getLogcatSince (long date)

Captura um fluxo instantâneo de dados do 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 os comandos "pidof" e "stat" e retorna o objeto ProcessInfo com PID e hora de início do processo determinado.

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)

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

Busque e retorne 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 ()

Defina se deseja usar o apagamento fastboot ou o formato fastboot para limpar uma partição no dispositivo.

abstract boolean isAdbRoot ()
abstract boolean isAdbTcp ()
abstract boolean isAppEnumerationSupported ()

Verifique se a plataforma no dispositivo suporta enumeração de aplicativos

abstract boolean isBypassLowTargetSdkBlockSupported ()

Verifique se a plataforma no dispositivo suporta ignorar o bloqueio SDK de destino baixo em instalações de aplicativos

abstract boolean isDebugfsMounted ()

Verifique se o debugfs está montado.

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; caso contrário, false.

abstract boolean isEncryptionSupported ()

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

abstract boolean isExecutable (String fullPath)

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

abstract boolean isHeadless ()

Retorne verdadeiro se o dispositivo estiver sem cabeça (sem tela), caso contrário, retorne falso.

abstract boolean isRuntimePermissionSupported ()

Verifique se a plataforma no dispositivo suporta a 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 mountDebugfs ()

Monte debugfs.

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

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

default void postInvocationTearDown ()

Este método está obsoleto. Use postInvocationTearDown(Throwable) em vez disso.

abstract void postInvocationTearDown (Throwable invocationException)

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

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)

Extraia 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 local temporário ERROR(/File) e retorna esse File .

abstract File pullFile (String remoteFilePath)

Recupera um arquivo do dispositivo, armazena-o em um local temporário ERROR(/File) 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 local temporário ERROR(/File) e retornar uma referência a esse File .

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

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

abstract boolean pushDir (File localDir, String deviceFilePath)

Envie 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 pode opcionalmente considerar a avaliação da necessidade do provedor de conteúdo.

abstract boolean pushFile (File localFile, String deviceFilePath)

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

Reinicia o dispositivo no modo adb.

abstract void reboot (String reason)

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

abstract void rebootIntoBootloader ()

Reinicia o dispositivo no modo bootloader.

abstract void rebootIntoFastbootd ()

Reinicia o dispositivo no modo fastbootd.

abstract void rebootIntoRecovery ()

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

abstract void rebootIntoSideload (boolean autoReboot)

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

Bloqueia até que o dispositivo entre no modo sideload

abstract void rebootIntoSideload ()

Reinicia o dispositivo no modo adb sideload (observe que este é um modo especial de 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 o adb.

abstract void rebootUntilOnline (String reason)

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

abstract void rebootUserspace ()

Reinicia apenas 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)

O mesmo que ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) mas executa o teste para o usuário determinado.

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 pelo dispositivo.

abstract void setUseFastbootErase (boolean useFastbootErase)

Defina se deseja usar o apagamento fastboot ou o formato fastboot para limpar uma partição no dispositivo.

abstract void startLogcat ()

Comece a capturar a saída do 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 atualmente.

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 arquivos local com o dispositivo.

abstract boolean unlockDevice ()

Desbloqueia o dispositivo se ele estiver em estado criptografado.

abstract void unmountDebugfs ()

Desmonte debugfs.

abstract boolean waitForBootComplete (long timeOut)

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

abstract boolean waitForDeviceAvailable ()

Aguarda que o dispositivo responda e esteja disponível para teste.

abstract boolean waitForDeviceAvailable (long waitTime)

Aguarda que o dispositivo responda e esteja disponível para teste.

abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Aguarda que o dispositivo responda e esteja 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 no 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 básico do shell adb.

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 é atualmente suportado ou não, dado um nível minimamente suportado. Este método leva em consideração recursos ainda não lançados, antes do nível da API ser aumentado.

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. Caso contrário, falso.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

limparLogcat

public abstract void clearLogcat ()

Exclui quaisquer dados acumulados do logcat.

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 atualizar uma nova construção de dispositivo, etc.).

excluir arquivo

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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

dispositivoSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

dispositivoSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Método auxiliar para verificar se o dispositivo foi reiniciado suavemente desde o horário 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 Milliseccond 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 suavemente

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

desativarAdbRoot

public abstract boolean disableAdbRoot ()

Desativa a raiz do adb.

Desativar o 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.

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

fazFileExist

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.

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

ativarAdbRoot

public abstract boolean enableAdbRoot ()

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

Ativar o 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.

Lança
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 falhas e desempenho.

Parâmetros
timeout long : o tempo em milissegundos antes que o dispositivo seja considerado sem resposta, 0L sem 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 na execução.

Lança
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 falhas 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 na execução.

Lança
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 falhas e desempenho.

Parâmetros
timeout long : o tempo em milissegundos antes que o dispositivo seja considerado sem resposta, 0L sem tempo limite

envMap : ambiente a ser definido 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 na execução.

Lança
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 fastboot.

Parâmetros
timeout long : o tempo em milissegundos antes do comando expirar

commandArgs String : o comando fastboot e argumentos para executar

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

Lança
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 fastboot.

Parâmetros
commandArgs String : o comando fastboot e argumentos para executar

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

Lança
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 mais longo.

Parâmetros
commandArgs String : o comando fastboot e argumentos para executar

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

Lança
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 fastboot 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 mais longo.

Parâmetros
envVarMap : as variáveis ​​de ambiente do sistema com as quais o comando fastboot é executado

commandArgs String : o comando fastboot e argumentos para executar

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

Lança
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 String .

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

Devoluções
String a saída do shell

Lança
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 : o tempo máximo durante o 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 forem executados sem sucesso.

Lança
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 a conclusão do comando; unidade conforme especificado em timeUnit

maxTimeToOutputShellResponse long : o tempo máximo durante o 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 forem executados sem sucesso.

Lança
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 novamente 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.

Lança
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 shell adb 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 .

Lança
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) para onde a saída padrão será redirecionada ou nula.

Devoluções
CommandResult O resultado em CommandResult .

Lança
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 shell adb 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 .

Lança
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 a conclusão do comando; 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 forem executados sem sucesso.

Devoluções
CommandResult

Lança
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 a conclusão do comando; unidade conforme especificado em timeUnit

timeUnit TimeUnit : unidade para maxTimeToOutputShellResponse

Devoluções
CommandResult

Lança
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) para onde a saída padrão será redirecionada ou nula.

maxTimeoutForCommand long : o tempo limite máximo para a conclusão do comando; unidade conforme especificado em timeUnit

timeUnit TimeUnit : unidade para maxTimeToOutputShellResponse

retryAttempts int : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se retryAttempts forem executados sem sucesso.

Devoluções
CommandResult

Lança
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) para onde a saída padrão será redirecionada ou nula.

pipeToError OutputStream : ERROR(/OutputStream) para onde o erro padrão será redirecionado ou nulo.

maxTimeoutForCommand long : o tempo limite máximo para a conclusão do comando; unidade conforme especificado em timeUnit

timeUnit TimeUnit : unidade para maxTimeToOutputShellResponse

retryAttempts int : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se retryAttempts forem executados sem sucesso.

Devoluções
CommandResult

Lança
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 , então fastboot erase será usado para limpar a partição. O dispositivo deverá então criar um sistema de arquivos na próxima vez que for inicializado. Caso contrário, será usado o formato fastboot, que criará um novo sistema de arquivos no dispositivo.

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

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

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

Lança
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 que indica o nível de API do dispositivo

Lança
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. A obtenção da versão do rádio é específica do dispositivo, por isso 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 corretas da versão. Isso não é exato para alguns dispositivos CDMA e a versão retornada aqui pode não corresponder à versão relatada no fastboot e pode não retornar a versão do rádio CDMA. DR, este método relata apenas a versão precisa se a propriedade gsm.version.baseband for igual à 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)

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

obter bateria

public abstract Integer getBattery ()

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

Devoluções
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Retorna o valor booleano da propriedade fornecida.

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 valor "1" , "y" , "yes" , "on" ou "true" , false se a propriedade tiver valor de "0" , "n" , "no" , "off" , "false" ou defaultValue caso contrário.

Lança
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

O método auxiliar coleta o mapa do histórico de inicialização com o tempo 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

Lança
DeviceNotAvailableException

getBootHistorySince

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 dispositivo atual utcEpochTime em milissegundos pode ser obtido pelo método getDeviceDate() .

Parâmetros
utcEpochTime long : o tempo do dispositivo desde a Época.

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

Lança
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Método conveniente para obter a versão do bootloader 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

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

getBuildAlias

public abstract String getBuildAlias ()

Recupere o alias do build que o dispositivo está executando atualmente.

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

Lança
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

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

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

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

Lança
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, nula caso contrário.

Lança
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 : limitar ou não o descritor às informações mínimas

Devoluções
DeviceDescriptor

obterCrianças

public abstract String[] getChildren (String deviceFilePath)

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

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

Devoluções
String[] Matriz de string contendo todos os arquivos em um caminho no dispositivo.

Lança
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 ()

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

Devoluções
long a data do dispositivo no formato de época.

Lança
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 : limitar ou não o descritor às 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)

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

Parâmetros
date Date

Devoluções
long a diferença em milissegundos

Lança
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

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

getFastbootProductType

public abstract String getFastbootProductType ()

Método conveniente para obter o tipo de produto deste dispositivo quando estiver no modo fastboot.

Este método só deve ser usado se o dispositivo estiver em fastboot. É uma variante um pouco mais segura do que o método getProductType() genérico neste caso, porque ITestDevice saberá como 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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Método conveniente para obter o tipo de produto deste dispositivo quando estiver no modo fastboot.

Este método só deve ser usado se o dispositivo estiver em fastboot. É uma variante um pouco mais segura do que o método getProductType() genérico neste caso, porque ITestDevice saberá como 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

Lança
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

getFastbootVariável

public abstract String getFastbootVariable (String variableName)

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

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

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

Lança
UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

Parâmetros
path String : o caminho do arquivo a ser recuperado. Pode ser um caminho absoluto ou relativo a '/'. (ou seja, a sintaxe "/system" e "system" é suportada)

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

Lança
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 se desconecta e reconecta do adb. Assim, os chamadores não devem manter uma referência ao IDevice , porque essa referência pode ficar 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.

Lança
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Retorna a última vez que as APIs comerciais desencadearam uma reinicialização em milissegundos desde que a época retornada pelo System.currentTimeMillis() .

Devoluções
long

GetLaunchApilevel

public abstract int getLaunchApiLevel ()

Obtenha o primeiro nível de API lançado do dispositivo. Padrão para UNKNOWN_API_LEVEL .

Devoluções
int um número inteiro indicando o primeiro nível de dispositivo da API lançado

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

Pega um fluxo de instantâneos dos dados logcat.

Funciona em dois modos:

  • Se o logcat estiver sendo capturado em segundo plano, retornará ao TestDeviceOptions.getMaxLogcatDataSize() bytes do conteúdo atual da captura de logcat em segundo plano
  • Caso contrário, retornará um depósito estático dos dados do logcat se o dispositivo estiver respondendo atualmente

    Devoluções
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    Pega um fluxo de instantâneos dos últimos maxBytes dos dados do logcat capturados.

    Útil para casos quando você deseja capturar instantâneos frequentes dos dados do 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 ser retornada. Deve ser uma quantidade que possa se encaixar confortavelmente na memória

    Devoluções
    InputStreamSource

    getLogcatdump

    public abstract InputStreamSource getLogcatDump ()

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

    Tem a desvantagem de que nada será devolvido 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.

    getLogcats ,nce

    public abstract InputStreamSource getLogcatSince (long date)

    Pega um fluxo de instantâneos de dados de logcat capturados iniciando a data fornecida. O tempo no dispositivo deve ser usado getDeviceDate() .

    Parâmetros
    date long : em milissegundo desde o formato de época de quando iniciar o instantâneo até o presente. (pode ser obtido usando 'data +%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 esse 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 MountPoint especificado, ou null se esse caminho não tiver nada montado ou não aparecer em /proc /montar como um MountPoint.

    Parâmetros
    mountpoint String

    Devoluções
    ITestDevice.MountPointInfo Um ERROR(/List) de MountPointInfo contendo as informações em "/proc/montars"

    Lança
    DeviceNotAvailableException

    Veja também:

    getMountPointInfo

    public abstract  getMountPointInfo ()

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

    Devoluções
    Um ERROR(/List) de MountPointInfo contendo as informações em "/proc/montars"

    Lança
    DeviceNotAvailableException

    getPartitionFreespace

    public abstract long getPartitionFreeSpace (String partition)

    Método Helper 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

    Lança
    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 Helper executa o comando "PIDOF" e "Stat" e retorna o objeto ProcessInfo com PID e Horário de início do processo do processo fornecido.

    Parâmetros
    processName String : A sequência de nome do Proces.

    Devoluções
    ProcessInfo ProcessInfo de determinado nome do processo

    Lança
    DeviceNotAvailableException

    getProcesspid

    public abstract String getProcessPid (String process)

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

    Parâmetros
    process String : A sequência de nome do Proces.

    Devoluções
    String

    Lança
    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

    Lança
    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

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    getProperty

    public abstract String getProperty (String name)

    Recuperar o valor da propriedade fornecida do dispositivo.

    Parâmetros
    name String : o nome da propriedade

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

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    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 ()

    Pegue e retorne a lista de lápides dos dispositivos. Requer root.

    O método é o melhor esforço, portanto, se uma lápide não for puxada por qualquer motivo, ele estará faltando na lista. Somente um DeviceNotAvailableException encerrará o método mais cedo.

    Devoluções
    Uma lista de arquivos da Tombstone, vazia se não houver lápide.

    Lança
    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 o formato de apagar ou fastboot de fastboot ou fastboot para limpar uma partição no dispositivo.

    Devoluções
    boolean true se a apagamento fastboot será usada ou false se o formato Fastboot for usado.

    Isadbroot

    public abstract boolean isAdbRoot ()

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

    Lança
    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 ao ADB-over-tcp, false caso contrário.

    isappenumerations suportado

    public abstract boolean isAppEnumerationSupported ()

    Verifique se a plataforma no dispositivo suporta a enumeração do aplicativo

    Devoluções
    boolean Verdadeiro se a enumeração do aplicativo for suportada, false caso contrário

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    isbypasslowtargetsdkblocksupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

    Verifique se a plataforma no dispositivo suporta ignorando o bloco SDK de baixo destino nas instalações de aplicativos

    Devoluções
    boolean Verdadeiro se o Bloco SDK de Alvo Baixo de Alvo é suportado, FALSE, caso contrário, caso contrário

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    IsdebugfsMorted

    public abstract boolean isDebugfsMounted ()

    Verifique se o Debugfs está montado.

    Devoluções
    boolean true se Debugfs estiver montado

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    IsdeviceCrypted

    public abstract boolean isDeviceEncrypted ()

    Retorna se o dispositivo for criptografado.

    Devoluções
    boolean true se o dispositivo for criptografado.

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    IsDirectory

    public abstract boolean isDirectory (String deviceFilePath)

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

    Parâmetros
    deviceFilePath String

    Devoluções
    boolean

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    ISENCRYPTIONSUPORTADO

    public abstract boolean isEncryptionSupported ()

    Retorna se a criptografia for suportada no dispositivo.

    Devoluções
    boolean true se o dispositivo suportar criptografia.

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    isExecutable

    public abstract boolean isExecutable (String fullPath)

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

    Parâmetros
    fullPath String

    Devoluções
    boolean

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    Isheadless

    public abstract boolean isHeadless ()

    Retorne true se o dispositivo estiver sem cabeça (sem tela), false caso contrário.

    Devoluções
    boolean

    Lança
    DeviceNotAvailableException

    IsruntimePermissionsUpported

    public abstract boolean isRuntimePermissionSupported ()

    Verifique se a plataforma no dispositivo suporta a 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, falsa caso contrário.

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    isStateBootLoaderorFastBootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Retorna true se o dispositivo estiver no 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 É verdade que se o registro fosse bem -sucedido, false caso contrário.

    Lança
    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 que o registro falhe.

    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 args a serem substituídos via string.format ().

    Mountdebugfs

    public abstract void mountDebugfs ()

    Mount Debugfs.

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    Não -BlockingReboot

    public abstract void nonBlockingReboot ()

    Emite um comando para reiniciar o dispositivo e retornar no comando completo e quando o dispositivo não estiver mais visível para o ADB.

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    PostBootsetup

    public abstract void postBootSetup ()

    Execute instruções para configurar o dispositivo para testar isso 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 ser necessário ser chamado é quando o dispositivo é reiniciado devido a outros eventos (por exemplo, quando um comando de atualização Fastboot é concluído)

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    PostInvocationTearDown

    public void postInvocationTearDown ()

    Este método está preguiçoso.
    Use postInvocationTearDown(Throwable) .

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

    PostInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

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

    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á executada no dispositivo antes do fluxo de invocação.

    Parâmetros
    info IBuildInfo : o IBuildInfo do dispositivo.

    attributes MultiMap : os atributos armazenados no contexto de invocação

    Lança
    com.android.tradefed.targetprep.targetSetUperror
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException
    TargetSetupError

    Pulldir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    Recursivamente puxe o conteúdo do diretório do dispositivo.

    Parâmetros
    deviceFilePath String : o caminho do arquivo absoluto da fonte remota

    localDir File : o diretório local para puxar arquivos

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

    Lança
    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 dispositivo Off de arquivo, o armazena em um ERROR(/File) e retorna esse File .

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

    userId int : o ID do usuário para puxar de

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

    Lança
    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 dispositivo Off de arquivo, o armazena em um ERROR(/File) e retorna esse File .

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

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

    Lança
    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 dispositivo de desligamento de arquivo.

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

    localFile File : O arquivo local para armazenar o conteúdo. Se não vazio, o conteúdo será substituído.

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

    Lança
    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 dispositivo de desligamento de arquivo.

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

    localFile File : O arquivo local para armazenar o conteúdo. Se não vazio, o conteúdo será substituído.

    userId int : o ID do usuário para puxar de

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

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    PULLFILECONTENTES

    public abstract String pullFileContents (String remoteFilePath)

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

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

    Devoluções
    String Uma String que contém o conteúdo do arquivo de dispositivo ou null se a cópia falhou por qualquer motivo (incluindo problemas com o sistema de arquivos host)

    Lança
    DeviceNotAvailableException

    PullfileFileFromexternal

    public abstract File pullFileFromExternal (String remoteFilePath)

    Um método de conveniência para recuperar um arquivo do armazenamento externo do dispositivo, o armazena em um ERROR(/File) e retorne uma referência a esse File .

    Parâmetros
    remoteFilePath String : O caminho para arquivo no dispositivo, em relação ao ponto de montagem de armazenamento externo do dispositivo

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

    Lança
    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 filtrados.

    Parâmetros
    localDir File : o diretório local para empurrar

    deviceFilePath String : o caminho do arquivo absoluto do destino remoto

    excludedDirectories : Conjunto de nomes de diretórios excluídos que não devem ser pressionados.

    Devoluções
    boolean true se o arquivo foi pressionado com sucesso. false caso contrário.

    Lança
    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)

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

    Parâmetros
    localDir File : o diretório local para empurrar

    deviceFilePath String : o caminho do arquivo absoluto do destino remoto

    Devoluções
    boolean true se o arquivo foi pressionado com sucesso. false caso contrário.

    Lança
    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 do pushFile(File, String) que, opcionalmente, pode considerar avaliar a necessidade do provedor de conteúdo.

    Parâmetros
    localFile File : o arquivo local para empurrar

    deviceFilePath String : o caminho do arquivo absoluto de destino remoto

    evaluateContentProviderNeeded boolean : se deve verificar se precisamos do provedor de conteúdo

    Devoluções
    boolean true se o arquivo foi pressionado com sucesso. false caso contrário.

    Lança
    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 para empurrar

    deviceFilePath String : o caminho do arquivo absoluto de destino remoto

    Devoluções
    boolean true se o arquivo foi pressionado com sucesso. false caso contrário.

    Lança
    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)

    Push arquivo criado de uma string para dispositivo

    Parâmetros
    contents String : o conteúdo do arquivo para empurrar

    deviceFilePath String : o caminho do arquivo absoluto de destino remoto

    Devoluções
    boolean true se a string foi pressionada com sucesso. false caso contrário.

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    reinício

    public abstract void reboot ()

    Reinicie o dispositivo no modo Adb.

    Blocos até que o dispositivo fique disponível.

    Lança
    DeviceNotAvailableException Se o dispositivo não estiver disponível após a reinicialização

    reinício

    public abstract void reboot (String reason)

    Reinicie o dispositivo no modo ADB com determinada reason a ser persistida na reinicialização.

    Blocos até que o dispositivo fique disponível.

    A última razão de reinicialização pode ser obtida consultando a profeta sys.boot.reason .

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

    Lança
    DeviceNotAvailableException Se o dispositivo não estiver disponível após a reinicialização

    REBOOTINTOBOOTLOWER

    public abstract void rebootIntoBootloader ()

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

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

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    REBOOTINTOFASTBOOTD

    public abstract void rebootIntoFastbootd ()

    Reinicie o dispositivo no modo FastBootd.

    Blocos até que o dispositivo esteja no modo FastBootd.

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    reinicialize -secovery

    public abstract void rebootIntoRecovery ()

    Reinicie o dispositivo no modo de recuperação do ADB.

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

    Lança
    DeviceNotAvailableException Se o dispositivo não estiver disponível após a reinicialização

    Rebootintosideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Reinicie o dispositivo no modo ADB Sideload (observe que este é um modo especial em recuperação)

    Blocks até que o dispositivo entre no modo Sideload

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

    Lança
    DeviceNotAvailableException Se o dispositivo não estiver em margem depois da reinicialização

    Rebootintosideload

    public abstract void rebootIntoSideload ()

    Reinicie o dispositivo no modo ADB Sideload (observe que este é um modo especial em recuperação)

    Blocks até que o dispositivo entre no modo Sideload

    Lança
    DeviceNotAvailableException Se o dispositivo não estiver em margem depois da reinicialização

    Rebootuntilonline

    public abstract void rebootUntilOnline ()

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

    Lança
    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 apenas bloqueia até que o dispositivo esteja online, ou seja, visível para o ADB.

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

    Lança
    DeviceNotAvailableException Se o dispositivo não estiver disponível após a reinicialização

    Veja também:

    REBOOTUSERSPACE

    public abstract void rebootUserspace ()

    Reinicia apenas os usuários em parte do dispositivo.

    Blocos até que o dispositivo fique disponível.

    AVISO. A reinicialização do UsersPace está atualmente em desenvolvimento ativo, use -o por seu próprio risco.

    Lança
    DeviceNotAvailableException Se o dispositivo não estiver disponível após a reinicialização

    REBOOTUSERSPACEUNTILONLINE

    public abstract void rebootUserspaceUntilOnline ()

    Um alternativo para rebootUserspace() ()} que apenas bloqueia até que o dispositivo esteja online, ou seja, visível para o ADB.

    Lança
    DeviceNotAvailableException Se o dispositivo não estiver disponível após a reinicialização

    RemountSystemReadonly

    public abstract void remountSystemReadOnly ()

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

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    RemountSystemwrity

    public abstract void remountSystemWritable ()

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

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    RemountVendeReRadonly

    public abstract void remountVendorReadOnly ()

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

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    RemountVendorWritable

    public abstract void remountVendorWritable ()

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

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    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 (s)

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

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada. ou seja, o comando de teste falhou em 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 sobre o testRunfailed e "false" será retornado. O comando de teste não será executado. É deixado para os chamadores tentarem 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 o testRunFailed e o DeviceNotAvailableException será lançado.

    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 concluído. false se falhou ao concluir devido à exceção de comunicação do dispositivo, mas a recuperação foi bem -sucedida

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada. ou seja, o comando de teste falhou em concluir e a recuperação falhou.

    runinstrumentationTestsasuser

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

    Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test para o usuário fornecido.

    Parâmetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Devoluções
    boolean

    Lança
    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

    Lança
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Define a data no dispositivo

    Nota: A data de configuração no dispositivo requer root

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

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    SETOPTIONS

    public abstract void setOptions (TestDeviceOptions options)

    Defina as TestDeviceOptions para o dispositivo

    Parâmetros
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Define o valor da propriedade fornecida no dispositivo. Requer raiz do adb é verdadeira.

    Parâmetros
    propKey String : a chave direcionada para ser definida.

    propValue String : o valor da propriedade a ser definido.

    Devoluções
    boolean Retorna True se o comando setprop tiver sido bem -sucedido, false caso contrário.

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    Setrecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

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

    Parâmetros
    recovery IDeviceRecovery : A 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 de dispositivo é encontrado. É recomendado usar apenas esse método com moderação quando necessário (por exemplo, quando a estrutura está baixa, etc.

    Parâmetros
    mode ITestDevice.RecoveryMode : se 'recuperar até o modo online' deve estar ligado ou não.

    SetuseFastBooterase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Defina se o Fastboot apaga ou o formato Fastboot apaga para limpar uma partição no dispositivo.

    Parâmetros
    useFastbootErase boolean : true se a apagamento fastboot deve ser usada ou false se o formato Fastboot for 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 do logcat já estiver sendo capturada. Os dados podem ser recuperados posteriormente via getLogCat.

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

    startLogcat() e stopLogcat() normalmente não precisam ser chamados quando dentro de um contexto de invocação TF, pois a estrutura do TF iniciará e interrompe 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 logcat do dispositivo e descarte os dados do logcat atualmente salvos.

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

    SwitchTOADBTCP

    public abstract String switchToAdbTcp ()

    Alterne o dispositivo para o modo ADB-over-TCP.

    Devoluções
    String o número de série do TCP ou null se o dispositivo não pudesse ser alterado

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    switchtoadbusb

    public abstract boolean switchToAdbUsb ()

    Alterne o dispositivo para o modo ADB sobre USB.

    Devoluções
    boolean true se o Switch foi bem -sucedido, false de outra forma.

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    SYNCFILES

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

    Decida quais arquivos pressionam comparando registros de data e hora de arquivos locais com seus equivalentes remotos. Somente arquivos 'mais recentes' ou inexistentes serão empurrados para o dispositivo. Assim, a sobrecarga deve ser relativamente pequena se o arquivo definido no dispositivo já estiver atualizado.

    Os arquivos ocultos (com nomes começando com ".") Serão ignorados.

    Exemplo de uso: Syncfiles ("/tmp/files", "/sdcard") criará o diretório A/SDCARD/FILS, se ainda não existir, e pressionará o conteúdo/tmp/arquivos para/sdcard/arquivos.

    Parâmetros
    localFileDir File : O diretório de arquivos local que contém arquivos para pressionar recursivamente.

    deviceFilePath String : o destino remoto do caminho absoluto PATH ROOT. Todos os diretórios no caminho do arquivo devem ser legíveis. ou seja, pressionando para/dados/local/tmp quando o adb não for root falhará

    Devoluções
    boolean true se os arquivos foram sincronizados com sucesso. false caso contrário.

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    desbloqueio

    public abstract boolean unlockDevice ()

    Desbloqueia o dispositivo se o dispositivo estiver em um estado criptografado.

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

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

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.
    UnsupportedOperationException Se a criptografia não for suportada no dispositivo.

    desmoundDebugfs

    public abstract void unmountDebugfs ()

    Desmontando debugfs.

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    WaitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Bloqueia até que o sinalizador completo de inicialização do dispositivo esteja definido.

    Parâmetros
    timeOut long : tempo em ms para esperar a bandeira ser definida

    Devoluções
    boolean true se a bandeira completa de inicialização do dispositivo estiver definida dentro do tempo limite

    Lança
    com.android.tradefed.device.DeviceNotAvilableException
    DeviceNotAvailableException

    WaitfordEviceAvicable

    public abstract boolean waitForDeviceAvailable ()

    Aguarda o dispositivo ser responsivo e disponível para teste. Usa tempo limite padrão.

    Devoluções
    boolean True Se o dispositivo estiver disponível, False se a recuperação estiver desativada e indisponível.

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    WaitfordEviceAvicable

    public abstract boolean waitForDeviceAvailable (long waitTime)

    Aguarda o dispositivo ser responsivo e disponível para teste.

    Parâmetros
    waitTime long : o tempo em MS para esperar

    Devoluções
    boolean True Se o dispositivo estiver disponível, False se a recuperação estiver desativada e indisponível.

    Lança
    DeviceNotAvailableException Se o dispositivo ainda não responder após o término da Waittime.

    WaitfordfordEviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Aguarda o dispositivo ser 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 indisponível.

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    WaitfordEviceBootLoader

    public abstract void waitForDeviceBootloader ()

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

    Lança
    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 de 'recuperação do ADB' (observe que isso é distinto da IDeviceRecovery ).

    Parâmetros
    waitTime long : o tempo em MS para esperar

    Devoluções
    boolean true se o dispositivo inicializar para a recuperação antes que o tempo expire. 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 inicializar para o desvio antes do tempo expirar. false caso contrário

    WaitfordEviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blocos para o dispositivo não estar disponível, ou seja, faltando no ADB

    Parâmetros
    waitTime long : o tempo em MS para esperar

    Devoluções
    boolean true se o dispositivo não estiver disponível antes que o tempo expire. false caso contrário

    WaitfordEviceOnline

    public abstract void waitForDeviceOnline ()

    Blocos até que o dispositivo seja visível via Adb. Usa tempo limite padrão

    Observe que o dispositivo pode não ser necessariamente responsivo aos comandos na conclusão. Use waitForDeviceAvailable() .

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    WaitfordEviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

    Blocos até que o dispositivo seja visível via Adb.

    Observe que o dispositivo pode não ser necessariamente responsivo aos comandos na conclusão. Use waitForDeviceAvailable() .

    Parâmetros
    waitTime long : o tempo em MS para esperar

    Lança
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

    WaitfordEviceshell

    public abstract boolean waitForDeviceShell (long waitTime)

    Aguarda o dispositivo ser responsivo a um comando básico de shell adb.

    Parâmetros
    waitTime long : o tempo em MS para esperar

    Devoluções
    boolean true se o dispositivo se tornar responsivo antes que waitTime decida.