INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

Fornece uma API confiável e de nível um pouco mais alto para uma ddmlib IDevice.

Tenta novamente comandos do dispositivo por um valor configurável e fornece uma interface de recuperação 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)

Verifica se um recurso tem suporte no momento, considerando um nível mínimo de suporte.

abstract void clearLogcat()

Exclui todos os dados de logcat acumulados.

abstract void deleteFile(String deviceFilePath)

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

abstract void deleteFile(String deviceFilePath, int userId)

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 por software comparando o system_server atual com o ProcessInfo do system_server anterior.

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

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

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)

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 de inicialização rápida como um comando do sistema.

abstract CommandResult executeFastbootCommand(String... commandArgs)

Método auxiliar que executa um comando de inicialização rápida como um comando do sistema com um tempo limite padrão de 2 minutos.

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

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

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

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

abstract String executeShellCommand(String command)

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

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

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

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

Executa o comando adb shell fornecido, tentando várias vezes se o comando falhar.

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

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

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

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

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

Executa um comando adb shell 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 adb shell 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 adb shell 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()

Receber o nível da API do dispositivo.

abstract String getBasebandVersion()

Método de conveniência para acessar a versão da banda de base (rádio) desse 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 especificada.

abstract getBootHistory()

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

abstract String getBootloaderVersion()

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

abstract String getBuildAlias()

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

abstract String getBuildFlavor()

Extrai o sabor do build para o dispositivo.

abstract String getBuildId()

Extrair o build que está sendo executado no dispositivo.

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 lançamento (controladas por fabricantes de dispositivos individuais).

abstract DeviceDescriptor getCachedDeviceDescriptor()

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

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

abstract String[] getChildren(String deviceFilePath)

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

abstract AbstractConnection getConnection()

Retorna a conexão associada ao dispositivo.

abstract String getDeviceClass()

Receba a classe do dispositivo.

abstract long getDeviceDate()

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

abstract DeviceDescriptor getDeviceDescriptor()

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

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

abstract TestDeviceState getDeviceState()

Acesse o estado do dispositivo.

abstract long getDeviceTimeOffset(Date date)

Auxílio para conseguir a diferença de horário entre o dispositivo e um determinado ERROR(/Date).

abstract InputStreamSource getEmulatorOutput()

Receber o fluxo de stdout e stderr do emulador

abstract long getExternalStoreFreeSpace()

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

abstract String getFastbootProductType()

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

abstract String getFastbootProductVariant()

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

abstract String getFastbootSerialNumber()

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

abstract String getFastbootVariable(String variableName)

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

abstract IFileEntry getFileEntry(String path)

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

abstract IDevice getIDevice()

Retorna uma referência ao IDevice da ddmlib associado.

abstract long getIntProperty(String name, long defaultValue)

Retorna o valor inteiro da propriedade especificada do dispositivo.

abstract long getLastExpectedRebootTimeMillis()

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

abstract int getLaunchApiLevel()

Receba o nível da API lançado pela primeira vez no dispositivo.

abstract InputStreamSource getLogcat()

Extrai um fluxo de snapshot dos dados do logcat.

abstract InputStreamSource getLogcat(int maxBytes)

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

abstract InputStreamSource getLogcatDump()

Receba um despejo do logcat atual do dispositivo.

abstract InputStreamSource getLogcatSince(long date)

Extrai um fluxo de snapshot 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 o comando "pidof" e "stat" e retorna o objeto ProcessInfo com o PID e o horário de início do processo.

abstract String getProcessPid(String process)

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

abstract String getProductType()

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

abstract String getProductVariant()

Método de conveniência para acessar a variante do produto desse dispositivo.

abstract String getProperty(String name)

Extraia o valor da propriedade fornecido do dispositivo.

abstract ITestDevice.RecoveryMode getRecoveryMode()

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

abstract String getSerialNumber()

Método prático para conseguir o número de série deste dispositivo.

abstract getTombstones()

Buscar e retornar a lista de túmulos dos dispositivos.

abstract long getTotalMemory()

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

default String getTrackingSerial()

Para fins de gerenciamento de dispositivos, acesse o número de série usado para rastrear o dispositivo.

abstract boolean getUseFastbootErase()

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

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

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

abstract boolean isBypassLowTargetSdkBlockSupported()

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

abstract boolean isDebugfsMounted()

Verifique se o debugfs está montado.

abstract boolean isDeviceEncrypted()

Retorna se o dispositivo está criptografado.

abstract boolean isDirectory(String deviceFilePath)

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

abstract boolean isEncryptionSupported()

Retorna se a criptografia é 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()

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

abstract boolean isRuntimePermissionSupported()

Verificar se a plataforma no dispositivo oferece suporte à concessão de permissão no momento da 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)

Registra uma mensagem no logcat do dispositivo.

abstract void mountDebugfs()

Ative o debugfs.

abstract void nonBlockingReboot()

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

abstract void postBootSetup()

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

default void postInvocationTearDown()

Este método foi descontinuado. Use postInvocationTearDown(Throwable).

abstract void postInvocationTearDown(Throwable invocationException)

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

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

Etapas extras para a configuração necessária específica do dispositivo que será executada no dispositivo antes do fluxo de invocação.

abstract boolean pullDir(String deviceFilePath, File localDir)

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

abstract boolean pullDir(String deviceFilePath, File localDir, int userId)

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

abstract File pullFile(String remoteFilePath, int userId)

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

abstract File pullFile(String remoteFilePath)

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

abstract boolean pullFile(String remoteFilePath, File localFile)

Recupera um arquivo do dispositivo.

abstract boolean pullFile(String remoteFilePath, File localFile, int userId)

Recupera um arquivo do dispositivo.

abstract String pullFileContents(String remoteFilePath)

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

abstract File pullFileFromExternal(String remoteFilePath)

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

abstract boolean pushDir(File localDir, String deviceFilePath, int userId)

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

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

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

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

abstract boolean pushFile(File localFile, String deviceFilePath)

Enviar um arquivo para o dispositivo.

abstract boolean pushFile(File localFile, String deviceFilePath, int userId)

Enviar um arquivo para o dispositivo.

abstract boolean pushString(String contents, String deviceFilePath)

Enviar um 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 o reason fornecido para ser mantido durante a reinicialização.

abstract void rebootIntoBootloader()

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

abstract void rebootIntoFastbootd()

Reinicia o dispositivo no modo fastboot.

abstract void rebootIntoRecovery()

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

abstract void rebootIntoSideload(boolean autoReboot)

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

Bloqueia até que o dispositivo entre no modo de sideload

abstract void rebootIntoSideload()

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

Bloqueia até que o dispositivo entre no modo de sideload

abstract void rebootUntilOnline()

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

abstract void rebootUntilOnline(String reason)

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

abstract void rebootUserspace()

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

abstract void rebootUserspaceUntilOnline()

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

abstract void remountSystemReadOnly()

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

Tornar 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 listeners transmitidos como parâmetros.

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

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

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

Igual a ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), mas executa o teste para o usuário especificado.

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

Igual a ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), mas executa o teste para um determinado usuário.

abstract void setDate(Date date)

Define a data no dispositivo

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

abstract void setOptions(TestDeviceOptions options)

Definir o TestDeviceOptions do dispositivo

abstract boolean setProperty(String propKey, String propValue)

Define o valor da propriedade especificada no dispositivo.

abstract void setRecovery(IDeviceRecovery recovery)

Defina o IDeviceRecovery a ser usado para este dispositivo.

abstract void setRecoveryMode(ITestDevice.RecoveryMode mode)

Define o modo de recuperação atual a ser usado no dispositivo.

abstract void setTrackingSerial(String trackingSerial)

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

abstract void setUseFastbootErase(boolean useFastbootErase)

Defina se você quer usar a exclusão ou o formato do 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()

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

abstract String switchToAdbTcp()

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

abstract boolean switchToAdbUsb()

Mude o dispositivo para o modo adb por USB.

abstract boolean syncFiles(File localFileDir, String deviceFilePath)

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

abstract boolean unlockDevice()

Desbloqueia o dispositivo se ele estiver em um estado criptografado.

abstract void unmountDebugfs()

Desmonte o debugfs.

abstract boolean waitForBootComplete(long timeOut)

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

abstract boolean waitForDeviceAvailable()

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

abstract boolean waitForDeviceAvailable(long waitTime)

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

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Aguarda o dispositivo responder e ficar disponível sem considerar o caminho de recuperação.

abstract void waitForDeviceBootloader()

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

abstract boolean waitForDeviceInRecovery(long waitTime)

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

abstract boolean waitForDeviceInSideload(long waitTime)

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

abstract boolean waitForDeviceNotAvailable(long waitTime)

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

abstract void waitForDeviceOnline()

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

abstract void waitForDeviceOnline(long waitTime)

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

abstract boolean waitForDeviceShell(long waitTime)

Espera 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 da constante: -1 (0xffffffff)

Métodos públicos

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Verifica se um recurso tem suporte no momento, considerando um nível mínimo de suporte. Esse método considera 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 que oferece suporte ao recurso.
Retorna
boolean Verdadeiro se o nível tiver suporte. Falso em outros casos.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

clearLogcat

public abstract void clearLogcat ()

Exclui todos os dados de logcat acumulados.

Isso é útil para casos em que você quer garantir que ITestDevice.getLogcat() só retorne dados de registro produzidos após um determinado ponto (por exemplo, depois de atualizar uma nova versão do dispositivo etc.).

deleteFile

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.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

Parâmetros
deviceFilePath String: o caminho absoluto do arquivo no dispositivo.
userId int: o ID do usuário a ser excluído
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

Parâmetros
prevSystemServerProcess ProcessInfo: o processo ProcessInfo do system_server anterior.
Retorna
boolean true se o dispositivo for reiniciado
Gera
RuntimeException se o dispositivo tiver um motivo de inicialização anormal
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Método auxiliar para verificar se o dispositivo foi reiniciado desde o horário UTC desde a época do dispositivo e do ERROR(/TimeUnit). A reinicialização suave se refere ao system_server reiniciado fora de uma reinicialização forçada do dispositivo (por exemplo, reinicialização solicitada). O utcEpochTime atual do dispositivo em milissegundos pode ser obtido pelo método getDeviceDate().

Parâmetros
utcEpochTime long: o tempo do dispositivo em segundos desde o período.
timeUnit TimeUnit: a unidade de tempo TimeUnit para o utcEpochTime fornecido.
Retorna
boolean true se o dispositivo for reiniciado
Gera
RuntimeException se o dispositivo tiver um motivo de inicialização anormal
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableAdbRoot

public abstract boolean disableAdbRoot ()

Desativa a raiz do adb.

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

Retorna
boolean true em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

Parâmetros
deviceFilePath String: o caminho absoluto do arquivo no dispositivo a ser verificado
Retorna
boolean true se o arquivo existir, false caso contrário.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

Retorna
boolean true em caso de sucesso.
Gera
DeviceNotAvailableException 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.

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

Parâmetros
timeout long: o tempo em milissegundos antes que o dispositivo seja considerado não responsivo, 0L para sem tempo limite
commandArgs String: o comando adb e os argumentos a serem executados
Retorna
String o stdout do comando. null se o comando não for executado.
Gera
DeviceNotAvailableException 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.

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

Parâmetros
commandArgs String: o comando adb e os argumentos a serem executados
Retorna
String o stdout do comando. null se o comando não for executado.
Gera
DeviceNotAvailableException 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.

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

Parâmetros
timeout long: o tempo em milissegundos antes que o dispositivo seja considerado não responsivo, 0L para sem tempo limite
envMap : ambiente a ser definido para o comando
commandArgs String: o comando adb e os argumentos a serem executados
Retorna
String o stdout do comando. null se o comando não for executado.
Gera
DeviceNotAvailableException 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 de inicialização rápida como um comando do sistema.

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

Parâmetros
timeout long: o tempo em milissegundos antes do comando expirar
commandArgs String: o comando fastboot e os argumentos a serem executados
Retorna
CommandResult o CommandResult que contém a saída do comando
Gera
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 de inicialização rápida 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 os argumentos a serem executados
Retorna
CommandResult o CommandResult que contém a saída do comando
Gera
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 de inicialização rápida de longa duração como um comando do sistema.

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

Parâmetros
commandArgs String: o comando fastboot e os argumentos a serem executados
Retorna
CommandResult o CommandResult que contém a saída do comando
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeLongFastbootCommand

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

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

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

Parâmetros
envVarMap : as variáveis de ambiente do sistema com que o comando fastboot é executado
commandArgs String: o comando fastboot e os argumentos a serem executados
Retorna
CommandResult o CommandResult que contém a saída do comando
Gera
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 do shell adb e retorna a saída como um String.

Parâmetros
command String: o comando adb shell a ser executado
Retorna
String a saída do shell
Gera
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 adb shell 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 direcionar a saída do shell.
maxTimeToOutputShellResponse long: o tempo máximo durante o qual o comando pode não gerar nenhuma resposta. A unidade é especificada em timeUnit.
timeUnit TimeUnit: unidade de maxTimeToOutputShellResponse
retryAttempts int: o número máximo de vezes que o comando será tentado novamente se ele falhar devido a uma exceção. A DeviceNotResponsiveException será gerada se a retryAttempts for executada sem sucesso.
Gera
DeviceNotAvailableException 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 adb shell 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 direcionar a saída do shell.
maxTimeoutForCommand long: o tempo limite máximo para a conclusão do comando. A unidade é especificada em timeUnit.
maxTimeToOutputShellResponse long: o tempo máximo durante o qual o comando pode não gerar nenhuma resposta. A unidade é especificada em timeUnit.
timeUnit TimeUnit: unidade de maxTimeToOutputShellResponse
retryAttempts int: o número máximo de vezes que o comando será tentado novamente se ele falhar devido a uma exceção. A DeviceNotResponsiveException será gerada se a retryAttempts for executada sem sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Executa o comando adb shell fornecido, tentando várias vezes se o comando falhar.

Uma forma mais simples de executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) com valores padrão.

Parâmetros
command String: o comando adb shell a ser executado
receiver IShellOutputReceiver: o IShellOutputReceiver para direcionar a saída do shell.
Gera
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 de shell do adb e retorna os resultados como um CommandResult preenchido corretamente com a saída de status do comando, stdout e stderr.

Parâmetros
command String: o comando que precisa ser executado.
Retorna
CommandResult O resultado em CommandResult.
Gera
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 de shell adb e retorna os resultados como um CommandResult preenchido corretamente com a saída de status do comando e o stderr. O stdout é direcionado para o stream especificado.

Parâmetros
command String: o comando que precisa ser executado.
pipeToOutput OutputStream: ERROR(/OutputStream) em que a saída padrão será redirecionada ou nula.
Retorna
CommandResult O resultado em CommandResult.
Gera
DeviceNotAvailableException 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 do 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 precisa ser executado.
pipeAsInput File: um ERROR(/File) que será canalizado como entrada para o comando ou nulo.
Retorna
CommandResult O resultado em CommandResult.
Gera
DeviceNotAvailableException 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 adb shell 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. A unidade é especificada em timeUnit.
timeUnit TimeUnit: unidade de maxTimeToOutputShellResponse
retryAttempts int: o número máximo de vezes que o comando será tentado novamente se ele falhar devido a uma exceção. A DeviceNotResponsiveException será gerada se a retryAttempts for executada sem sucesso.
Retorna
CommandResult

Gera
DeviceNotAvailableException 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 adb shell 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. A unidade é especificada em timeUnit.
timeUnit TimeUnit: unidade de maxTimeToOutputShellResponse
Retorna
CommandResult

Gera
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 adb shell 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) em que a saída padrão será redirecionada ou nula.
maxTimeoutForCommand long: o tempo limite máximo para a conclusão do comando. A unidade é especificada em timeUnit.
timeUnit TimeUnit: unidade de maxTimeToOutputShellResponse
retryAttempts int: o número máximo de vezes que o comando será tentado novamente se ele falhar devido a uma exceção. A DeviceNotResponsiveException será gerada se a retryAttempts for executada sem sucesso.
Retorna
CommandResult

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

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

Se getUseFastbootErase() for true, o apagamento de fastboot será usado para limpar a partição. O dispositivo precisa criar um sistema de arquivos na próxima inicialização. Caso contrário, o formato de inicialização rápida será usado, o 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 apagada
Retorna
CommandResult o CommandResult que contém a saída do comando
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

getApiLevel

public abstract int getApiLevel ()

Receber o nível da API do dispositivo. O valor padrão é UNKNOWN_API_LEVEL.

Retorna
int Um número inteiro que indica o nível da API do dispositivo
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

Método de conveniência para acessar a versão da banda de base (rádio) desse dispositivo. A obtenção da versão do rádio é específica do dispositivo. Por isso, ela pode não retornar as informações corretas para todos os dispositivos. Esse método depende da propriedade gsm.version.baseband para retornar as informações de versão corretas. Isso não é preciso para alguns dispositivos CDMA, e a versão retornada aqui pode não corresponder à versão informada pelo fastboot e não retornar a versão para o rádio CDMA. Resumo: esse método só informa a versão precisa se a propriedade gsm.version.baseband for igual à versão retornada por fastboot getvar version-baseband.

Retorna
String a versão da banda de base String ou null, se não puder ser determinada (o dispositivo não tem rádio ou a string de versão não pode ser lida)
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

getBattery

public abstract Integer getBattery ()

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

Retorna
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Retorna o valor booleano da propriedade especificada.

Parâmetros
name String: o nome da propriedade
defaultValue boolean: valor padrão a ser retornado se a propriedade estiver vazia ou não existir.
Retorna
boolean true se a propriedade tiver o valor "1", "y", "yes", "on" ou "true", false se a propriedade tiver o valor "0", "n", "no", "off", "false" ou defaultValue caso contrário.
Gera
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

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

Retorna
Mapa do tempo de inicialização (horário UTC em segundos desde a época) e motivo da inicialização
Gera
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 e o motivo da inicialização desde o tempo fornecido desde a época do dispositivo e a unidade de tempo especificada. O utcEpochTime atual do dispositivo em milissegundos pode ser obtido pelo método getDeviceDate().

Parâmetros
utcEpochTime long: o tempo do dispositivo desde a Era Unix.
timeUnit TimeUnit: a unidade de tempo TimeUnit.
Retorna
Mapa do tempo de inicialização (horário UTC em segundos desde a época) e motivo da inicialização
Gera
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

Retorna
String a versão do carregador de inicialização String ou null, se não for possível encontrá-la
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

getBuildAlias

public abstract String getBuildAlias ()

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

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

Retorna
String o alias de build ou o ID de build se não for possível recuperar
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Extrai o sabor do build para o dispositivo.

Retorna
String o sabor do build ou null se não for possível extrair
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

Extrair o build que está sendo executado no dispositivo.

Retorna
String o ID do build ou IBuildInfo.UNKNOWN_BUILD_ID se não puder ser recuperado
Gera
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 lançamento (controladas por fabricantes de dispositivos individuais).

Retorna
String A chave de assinatura, se encontrada, ou nulo.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Retorna
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

Parâmetros
deviceFilePath String: é o caminho no dispositivo em que a pesquisa será feita.
Retorna
String[] Matriz de string que contém todo o arquivo em um caminho no dispositivo.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Retorna a conexão associada ao dispositivo.

Retorna
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Receba a classe do dispositivo.

Retorna
String a classe de dispositivo String.

getDeviceDate

public abstract long getDeviceDate ()

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

Retorna
long a data do dispositivo no formato de época.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

Retorna
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

getDeviceState

public abstract TestDeviceState getDeviceState ()

Acesse o estado do dispositivo.

Retorna
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Auxílio para conseguir a diferença de horário entre o dispositivo e um determinado ERROR(/Date). Use o tempo Epoch internamente.

Parâmetros
date Date

Retorna
long a diferença em milissegundos
Gera
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Receber o fluxo de stdout e stderr do emulador

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

Retorna
long a quantidade de espaço livre em KB
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

getFastbootProductType

public abstract String getFastbootProductType ()

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

Esse método só deve ser usado se o dispositivo estiver no modo fastboot. Essa é uma variante um pouco mais segura do método getProductType() genérico nesse caso, porque ITestDevice vai saber como recuperar o dispositivo na inicialização rápida se ele estiver no estado incorreto ou não responder.

Retorna
String o nome do tipo de produto String ou null se não for possível determinar
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

Esse método só deve ser usado se o dispositivo estiver no modo fastboot. Essa é uma variante um pouco mais segura do método getProductType() genérico nesse caso, porque ITestDevice vai saber como recuperar o dispositivo na inicialização rápida se ele estiver no estado incorreto ou não responder.

Retorna
String o nome do tipo de produto String ou null se não for possível determinar
Gera
DeviceNotAvailableException 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.

Retorna
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

Parâmetros
variableName String: o nome da variável
Retorna
String o valor da propriedade ou null, se não existir
Gera
UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

Parâmetros
path String: o caminho do arquivo a ser recuperado. Pode ser um caminho absoluto ou relativo a "/". Ou seja, a sintaxe "/system" e "system" são compatíveis.
Retorna
IFileEntry o IFileEntry ou null se o arquivo no path fornecido não puder ser encontrado
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Retorna uma referência ao IDevice da ddmlib associado.

Uma nova IDevice pode ser alocada pelo DDMS sempre que o dispositivo se desconecta e se reconecta do adb. Portanto, os autores de chamadas não devem manter uma referência ao IDevice, porque essa referência pode ficar desatualizada.

Retorna
IDevice o IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Retorna o valor inteiro da propriedade especificada do dispositivo.

Parâmetros
name String: o nome da propriedade
defaultValue long: valor padrão a ser retornado se a propriedade estiver vazia ou não existir.
Retorna
long o valor da propriedade ou defaultValue se a propriedade estiver vazia, não existir ou não tiver um valor inteiro.
Gera
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Retorna
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

Retorna
int Um número inteiro que indica o primeiro nível de API lançado do dispositivo
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

Extrai um fluxo de snapshot dos dados do logcat.

Funciona em dois modos:

  • Se o logcat estiver sendo capturado em segundo plano, ele vai retornar até TestDeviceOptions.getMaxLogcatDataSize() bytes do conteúdo atual da captura do logcat em segundo plano.
  • Caso contrário, vai retornar um despejo estático dos dados do logcat se o dispositivo estiver respondendo.

    Retorna
    InputStreamSource

    • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

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

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

    Retorna
    InputStreamSource uma InputStreamSource dos dados do logcat. Um stream vazio é retornado se não for possível capturar dados do Logcat.

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

    Extrai um fluxo de snapshot de dados do Logcat capturados a partir da data fornecida. O tempo no dispositivo precisa ser usado getDeviceDate().

    Parâmetros
    date long: em milissegundos desde a época, no formato de quando iniciar o snapshot até o presente. (pode ser obtido usando "data +%s")
    Retorna
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Retorna um ponto de montagem.

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

    O que fazer: mover esse comportamento para IDevice.getMountPoint(String)

    Parâmetros
    mountName String: o nome do ponto de montagem
    Retorna
    String o ponto de montagem ou null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Retorna um MountPointInfo correspondente ao caminho do ponto de montagem especificado ou null se esse caminho não tiver nada montado ou não aparecer em /proc/mounts como um ponto de montagem.

    Parâmetros
    mountpoint String

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

    Confira também:

    getMountPointInfo

    public abstract  getMountPointInfo ()

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

    Retorna
    Um ERROR(/List) de MountPointInfo contendo as informações em "/proc/mounts"
    Gera
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

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

    Parâmetros
    partition String

    Retorna
    long a quantidade de espaço livre em KB
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

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

    Parâmetros
    processName String: a string do nome do processo.
    Retorna
    ProcessInfo ProcessInfo do nome do processo fornecido
    Gera
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

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

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

    Gera
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

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

    Esse método vai funcionar se o dispositivo estiver no modo adb ou fastboot.

    Retorna
    String o nome do tipo de produto String. Não será nulo
    Gera
    DeviceNotAvailableException 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 acessar a variante do produto desse dispositivo.

    Esse método vai funcionar se o dispositivo estiver no modo adb ou fastboot.

    Retorna
    String o nome da variante do produto String ou null, se não for possível determinar
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    getProperty

    public abstract String getProperty (String name)

    Extraia o valor da propriedade fornecido do dispositivo.

    Parâmetros
    name String: o nome da propriedade
    Retorna
    String o valor da propriedade ou null, se não existir
    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getSerialNumber

    public abstract String getSerialNumber ()

    Método prático para conseguir o número de série deste dispositivo.

    Retorna
    String o número de série String

    getTombstones

    public abstract  getTombstones ()

    Buscar e retornar a lista de túmulos dos dispositivos. Requer acesso root.

    O método faz o possível, então, se uma lápide falhar ao ser extraída por qualquer motivo, ela vai estar ausente da lista. Somente um DeviceNotAvailableException encerrará o método com antecedência.

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

    Confira também:

    getTotalMemory

    public abstract long getTotalMemory ()

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

    Retorna
    long

    getTrackingSerial

    public String getTrackingSerial ()

    Para fins de gerenciamento de dispositivos, acesse o número de série usado para rastrear o dispositivo.

    Retorna
    String

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

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

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

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Retorna
    boolean true se o dispositivo tiver raiz adb, false, caso contrário.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    isAdbTcp

    public abstract boolean isAdbTcp ()

    Retorna
    boolean true se o dispositivo estiver conectado ao adb-over-tcp, false caso contrário.

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

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

    Retorna
    boolean Verdadeiro se a enumeração de apps tiver suporte. Caso contrário, será falso.
    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

    Retorna
    boolean Verdadeiro se o bloqueio de sdk de destino baixo é aceito. Caso contrário, é falso.
    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Verifique se o debugfs está montado.

    Retorna
    boolean true se o debugfs estiver montado
    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Retorna se o dispositivo está criptografado.

    Retorna
    boolean true se o dispositivo estiver criptografado.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

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

    Parâmetros
    deviceFilePath String

    Retorna
    boolean

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

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

    Retorna
    boolean true se o dispositivo oferece suporte à criptografia.
    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isExecutable

    public abstract boolean isExecutable (String fullPath)

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

    Parâmetros
    fullPath String

    Retorna
    boolean

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

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

    Retorna
    boolean

    Gera
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

    Verificar se a plataforma no dispositivo oferece suporte à concessão de permissão no momento da execução

    Retorna
    boolean Verdadeiro se a permissão de execução tiver suporte. Caso contrário, será falso.
    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

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

    Retorna
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Coleta e registra ANRs do dispositivo.

    Parâmetros
    logger ITestLogger: um ITestLogger para registrar os ANRs.
    Retorna
    boolean Verdadeiro se a geração de registros foi bem-sucedida. Caso contrário, é falso.
    Gera
    DeviceNotAvailableException

    logOnDevice

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

    Registra uma mensagem no logcat do dispositivo. Essa é uma chamada segura que não será gerada mesmo se a geração de registros falhar.

    Parâmetros
    tag String: a tag em que registramos nossa mensagem no Logcat.
    level Log.LogLevel: o nível de depuração da mensagem no Logcat.
    format String: o formato da mensagem.
    args Object: os argumentos a serem substituídos por String.format().

    mountDebugfs

    public abstract void mountDebugfs ()

    Ative o debugfs.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

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

    Precisa ser chamado depois que o dispositivo for totalmente inicializado/disponível

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

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

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

    postInvocationTearDown

    public void postInvocationTearDown ()

    Este método foi descontinuado.
    Use postInvocationTearDown(Throwable).

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

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

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

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

    preInvocationSetup

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

    Etapas extras para a configuração necessária específica do dispositivo que será executada no dispositivo antes do fluxo de invocação.

    Parâmetros
    info IBuildInfo: o IBuildInfo do dispositivo.
    attributes MultiMap: os atributos armazenados no contexto de invocação
    Gera
    com.android.tradefed.targetprep.TargetSetupError
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

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

    Parâmetros
    deviceFilePath String: o caminho de arquivo absoluto da origem remota
    localDir File: o diretório local para extrair arquivos
    Retorna
    boolean true se o arquivo foi extraído. false se não forem.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

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

    Parâmetros
    deviceFilePath String: o caminho de arquivo absoluto da origem remota
    localDir File: o diretório local para extrair arquivos
    userId int: o ID do usuário de onde será extraído
    Retorna
    boolean true se o arquivo foi extraído. false se não forem.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                int userId)

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

    Parâmetros
    remoteFilePath String: o caminho absoluto para o arquivo no dispositivo.
    userId int: o ID do usuário de onde será extraído
    Retorna
    File Um ERROR(/File) contendo o conteúdo do arquivo do dispositivo ou null se a cópia falhar por qualquer motivo (incluindo problemas com o sistema de arquivos do host)
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pullFile

    public abstract File pullFile (String remoteFilePath)

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

    Parâmetros
    remoteFilePath String: o caminho absoluto para o arquivo no dispositivo.
    Retorna
    File Um ERROR(/File) contendo o conteúdo do arquivo do dispositivo ou null se a cópia falhar por qualquer motivo (incluindo problemas com o sistema de arquivos do host)
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

    Recupera um arquivo do dispositivo.

    Parâmetros
    remoteFilePath String: o caminho absoluto para o arquivo no dispositivo.
    localFile File: o arquivo local para armazenar o conteúdo. Se não estiver vazio, o conteúdo será substituído.
    Retorna
    boolean true se o arquivo foi recuperado. false se não forem.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

    Recupera um arquivo do dispositivo.

    Parâmetros
    remoteFilePath String: o caminho absoluto para o arquivo no dispositivo.
    localFile File: o arquivo local para armazenar o conteúdo. Se não estiver vazio, o conteúdo será substituído.
    userId int: o ID do usuário de onde será extraído
    Retorna
    boolean true se o arquivo foi recuperado. false se não forem.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

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

    Parâmetros
    remoteFilePath String: o caminho absoluto para o arquivo no dispositivo.
    Retorna
    String Um String contendo o conteúdo do arquivo do dispositivo ou null se a cópia falhar por qualquer motivo (incluindo problemas com o sistema de arquivos do host)
    Gera
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract File pullFileFromExternal (String remoteFilePath)

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

    Parâmetros
    remoteFilePath String: o caminho para o arquivo no dispositivo, relativo ao ponto de montagem do armazenamento externo do dispositivo
    Retorna
    File Um ERROR(/File) contendo o conteúdo do arquivo do dispositivo ou null se a cópia falhar por qualquer motivo (incluindo problemas com o sistema de arquivos do host)
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pushDir

    public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                int userId)

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

    Parâmetros
    localDir File: o diretório local a ser enviado
    deviceFilePath String: o caminho de arquivo absoluto do destino remoto
    userId int: o ID do usuário para o push
    Retorna
    boolean true se o arquivo foi enviado. false se não forem.
    Gera
    DeviceNotAvailableException 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)

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

    Parâmetros
    localDir File: o diretório local a ser enviado
    deviceFilePath String: o caminho de arquivo absoluto do destino remoto
    excludedDirectories : conjunto de nomes de diretórios excluídos que não devem ser enviados.
    Retorna
    boolean true se o arquivo foi enviado. false se não forem.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pushDir

    public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

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

    Parâmetros
    localDir File: o diretório local a ser enviado
    deviceFilePath String: o caminho de arquivo absoluto do destino remoto
    Retorna
    boolean true se o arquivo foi enviado. false se não forem.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pushFile

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

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

    Parâmetros
    localFile File: o arquivo local a ser enviado
    deviceFilePath String: o caminho de arquivo absoluto do destino remoto
    evaluateContentProviderNeeded boolean: se é necessário verificar se o provedor de conteúdo
    Retorna
    boolean true se o arquivo foi enviado. false se não forem.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pushFile

    public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

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

    Parâmetros
    localFile File: o arquivo local a ser enviado
    deviceFilePath String: o caminho de arquivo absoluto do destino remoto
    Retorna
    boolean true se o arquivo foi enviado. false se não forem.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pushFile

    public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                int userId)

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

    Parâmetros
    localFile File: o arquivo local a ser enviado
    deviceFilePath String: o caminho de arquivo absoluto do destino remoto
    userId int: o userId para enviar.
    Retorna
    boolean true se o arquivo foi enviado. false se não forem.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    pushString

    public abstract boolean pushString (String contents, 
                String deviceFilePath)

    Enviar um arquivo criado a partir de uma string para o dispositivo

    Parâmetros
    contents String: o conteúdo do arquivo a ser enviado
    deviceFilePath String: o caminho de arquivo absoluto do destino remoto
    Retorna
    boolean true se a string foi enviada. false se não forem.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    reiniciar

    public abstract void reboot ()

    Reinicia o dispositivo no modo adb.

    Bloqueia até que o dispositivo fique disponível.

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

    reiniciar

    public abstract void reboot (String reason)

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

    Bloqueia até que o dispositivo fique disponível.

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

    Parâmetros
    reason String: um motivo para a reinicialização ou null se nenhum motivo for especificado.
    Gera
    DeviceNotAvailableException Se o dispositivo não estiver disponível após a reinicialização

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

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

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

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

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Reinicia o dispositivo no modo fastboot.

    Bloqueia até que o dispositivo esteja no modo fastboot.

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

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

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

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

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

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

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

    Bloqueia até que o dispositivo entre no modo de sideload

    Parâmetros
    autoReboot boolean: se o dispositivo será reinicializado automaticamente após o sideload
    Gera
    DeviceNotAvailableException Se o dispositivo não estiver em sideload após a reinicialização

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

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

    Bloqueia até que o dispositivo entre no modo de sideload

    Gera
    DeviceNotAvailableException Se o dispositivo não estiver em sideload após a reinicialização

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

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

    Gera
    DeviceNotAvailableException 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 só bloqueia até que o dispositivo esteja on-line, ou seja, visível para o adb.

    Parâmetros
    reason String: um motivo para a reinicialização ou null se nenhum motivo for especificado.
    Gera
    DeviceNotAvailableException Se o dispositivo não estiver disponível após a reinicialização

    Confira também:

    rebootUserspace

    public abstract void rebootUserspace ()

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

    Bloqueia até que o dispositivo fique disponível.

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

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

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

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

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

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

    Tornar a partição do sistema no dispositivo somente leitura. Reiniciar o dispositivo.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountSystemWritable

    public abstract void remountSystemWritable ()

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorReadOnly

    public abstract void remountVendorReadOnly ()

    Tornar a partição do fornecedor no dispositivo somente leitura. Reiniciar o dispositivo.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    runInstrumentationTests

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

    Método de conveniência para executar ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) com um ou mais listeners transmitidos como parâmetros.

    Parâmetros
    runner IRemoteAndroidTestRunner: o IRemoteAndroidTestRunner que executa os testes.
    listeners ITestLifeCycleReceiver: os listeners de resultado do teste
    Retorna
    boolean true se o comando de teste foi concluído. false se a conclusão não foi concluída, mas a recuperação foi bem-sucedida
    Gera
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada. Por exemplo, o comando de teste não foi concluído e a recuperação falhou.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

    Se a conexão com o dispositivo for perdida antes da conclusão do teste e a recuperação for bem-sucedida, todos os listeners vão ser informados sobre o testRunFailed, e "false" será retornado. O comando de teste não será executado novamente. Os autores das chamadas precisam tentar novamente, se necessário.

    Se a conexão com o dispositivo for perdida antes da conclusão da execução do teste e a recuperação falhar, todos os listeners vão ser informados sobre testRunFailed e DeviceNotAvailableException será gerado.

    Parâmetros
    runner IRemoteAndroidTestRunner: o IRemoteAndroidTestRunner que executa os testes.
    listeners : os listeners de resultados de teste
    Retorna
    boolean true se o comando de teste foi concluído. false, se não for possível concluir devido a uma exceção de comunicação do dispositivo, mas a recuperação tiver sucesso
    Gera
    DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada. Por exemplo, o comando de teste não foi concluído e a recuperação falhou.

    runInstrumentationTestsAsUser

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

    Igual a ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), mas executa o teste para o usuário especificado.

    Parâmetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Retorna
    boolean

    Gera
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Igual a ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), mas executa o teste para um determinado usuário.

    Parâmetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Retorna
    boolean

    Gera
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Define a data no dispositivo

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

    Parâmetros
    date Date: especifica uma data específica. Usará a data do host se null.
    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Definir o TestDeviceOptions do dispositivo

    Parâmetros
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                String propValue)

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

    Parâmetros
    propKey String: a chave que será definida.
    propValue String: o valor da propriedade a ser definido.
    Retorna
    boolean Retorna True se o comando setprop tiver sido bem-sucedido. Caso contrário, retorna False.
    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

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

    Parâmetros
    recovery IDeviceRecovery: o IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Define o modo de recuperação atual a ser usado no dispositivo.

    É usado para controlar qual método de recuperação usar quando um problema de comunicação do dispositivo é encontrado. É recomendável usar esse método apenas quando necessário (por exemplo, quando o framework estiver inativo etc.

    Parâmetros
    mode ITestDevice.RecoveryMode: se o modo "recuperar até ficar somente on-line" precisa ser ativado ou não.

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

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

    Parâmetros
    trackingSerial String

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Defina se você quer usar a exclusão ou o formato do fastboot para limpar uma partição no dispositivo.

    Parâmetros
    useFastbootErase boolean: true se o apagamento de fastboot for usado ou false se o formato de fastboot for usado.

    startLogcat

    public abstract void startLogcat ()

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

    Não vai ter efeito se a saída do logcat já estiver sendo capturada. Os dados podem ser recuperados mais tarde pelo getLogcat.

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

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

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Feche e exclua a saída do emulador.

    stopLogcat

    public abstract void stopLogcat ()

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

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

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

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

    Retorna
    String o número de série do TCP ou null se o dispositivo não puder ser alternado
    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Mude o dispositivo para o modo adb por USB.

    Retorna
    boolean true se a troca foi bem-sucedida, false caso contrário.
    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

    Decide quais arquivos serão enviados comparando os carimbos de data/hora dos arquivos locais com os equivalentes remotos. Somente arquivos "mais recentes" ou inativos serão enviados ao dispositivo. Assim, o overhead será relativamente pequeno se o conjunto de arquivos no dispositivo já estiver atualizado.

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

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

    Parâmetros
    localFileDir File: o diretório de arquivos local que contém arquivos para envio recursivo.
    deviceFilePath String: a raiz do caminho absoluto do arquivo de destino remoto. Todos os diretórios no caminho da unidade precisam ser legíveis. Ou seja, o envio para /data/local/tmp quando o adb não é raiz vai falhar.
    Retorna
    boolean true se os arquivos foram sincronizados. false se não forem.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    unlockDevice

    public abstract boolean unlockDevice ()

    Desbloqueia o dispositivo se ele estiver em um estado criptografado.

    Esse método pode reiniciar o framework, mas não vai chamar postBootSetup(). Portanto, o dispositivo pode não estar totalmente pronto para ser testado quando esse método retornar.

    Retorna
    boolean true em caso de sucesso ou se o dispositivo não estiver criptografado.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
    UnsupportedOperationException se a criptografia não for compatível com o dispositivo.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Desmonte o debugfs.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

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

    Parâmetros
    timeOut long: tempo em milissegundos para aguardar a definição da flag
    Retorna
    boolean "true" se a flag de inicialização completa do dispositivo for definida dentro do tempo limite
    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

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

    Retorna
    boolean True se o dispositivo estiver disponível, False se a recuperação estiver desativada e indisponível.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

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

    Parâmetros
    waitTime long: o tempo em ms para aguardar
    Retorna
    boolean True se o dispositivo estiver disponível, False se a recuperação estiver desativada e indisponível.
    Gera
    DeviceNotAvailableException Se o dispositivo ainda não responder após o vencimento do waitTime.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Aguarda o dispositivo responder e ficar disponível sem considerar o caminho de recuperação.

    Parâmetros
    waitTime long

    Retorna
    boolean Verdadeiro se o dispositivo estiver disponível, falso se não estiver.
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

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

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

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

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

    Parâmetros
    waitTime long: o tempo em ms para aguardar
    Retorna
    boolean true se o dispositivo for inicializado na recuperação antes do tempo expirar. false caso contrário

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

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

    Parâmetros
    waitTime long: o tempo em ms para aguardar
    Retorna
    boolean true se o dispositivo for inicializado no sideload antes que o tempo expire. false caso contrário

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

    Parâmetros
    waitTime long: o tempo em ms para aguardar
    Retorna
    boolean true se o dispositivo não estiver disponível antes do tempo expirar. false caso contrário

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

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

    O dispositivo pode não responder aos comandos após a conclusão. Use waitForDeviceAvailable().

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

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

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

    O dispositivo pode não responder aos comandos após a conclusão. Use waitForDeviceAvailable().

    Parâmetros
    waitTime long: o tempo em ms para aguardar
    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

    Parâmetros
    waitTime long: o tempo em ms para aguardar
    Retorna
    boolean true se o dispositivo responder antes que o waitTime expire.