DispositivoINative

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

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

Verifique se um recurso tem suporte no momento de acordo com um nível com suporte mínimo.

abstract void clearLogcat()

Exclui todos os dados acumulados do logcat.

abstract void deleteFile(String deviceFilePath)

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

abstract void deleteFile(String deviceFilePath, int userId)

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

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Método auxiliar para verificar se o dispositivo foi reiniciado de forma reversível, comparando o system_server atual com o ProcessInfo system_server anterior.

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Método auxiliar para verificar se o dispositivo foi reiniciado de forma reversível desde o horário UTC desde a época do dispositivo e da ERROR(/TimeUnit) dele.

abstract boolean disableAdbRoot()

Desativa a raiz do adb.

abstract boolean doesFileExist(String deviceFilePath)

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

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 fastboot como um comando do sistema.

abstract CommandResult executeFastbootCommand(String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

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

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

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

abstract String executeShellCommand(String command)

Método auxiliar que executa um comando do shell do 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 do shell do adb, com mais parâmetros para controlar o comportamento do comando.

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

Método auxiliar que executa um comando do 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, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

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

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

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

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

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

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

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

abstract CommandResult fastbootWipePartition(String partition)

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

abstract int getApiLevel()

Acessa o nível da API do dispositivo.

abstract String getBasebandVersion()

Método de conveniência para obter a versão de banda de base (rádio) deste dispositivo.

abstract Integer getBattery()

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

abstract boolean getBooleanProperty(String name, boolean defaultValue)

Retorna o valor booleano da propriedade especificada.

abstract getBootHistory()

O método auxiliar coleta o mapa do histórico de inicialização com o tempo 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 período especificado no dispositivo até a unidade de tempo especificada.

abstract String getBootloaderVersion()

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

abstract String getBuildAlias()

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

abstract String getBuildFlavor()

Recuperar a variação de build do dispositivo.

abstract String getBuildId()

Recupere o build que o dispositivo está executando no momento.

abstract String getBuildSigningKeys()

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

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

abstract DeviceDescriptor getCachedDeviceDescriptor()

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

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

abstract String[] getChildren(String deviceFilePath)

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

abstract AbstractConnection getConnection()

Retorna a conexão associada ao dispositivo.

abstract String getDeviceClass()

Acessa a classe do dispositivo.

abstract long getDeviceDate()

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

abstract DeviceDescriptor getDeviceDescriptor()

Retorne um DeviceDescriptor das informações do dispositivo para 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()

Recebe o estado do dispositivo.

abstract long getDeviceTimeOffset(Date date)

Ajuda para mostrar a diferença de horário entre o dispositivo e um determinado ERROR(/Date).

abstract InputStreamSource getEmulatorOutput()

Acessar o stream do emulador stdout e stderr

abstract long getExternalStoreFreeSpace()

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

abstract String getFastbootProductType()

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

abstract String getFastbootProductVariant()

Método de conveniência para obter o tipo de produto deste 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)

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

abstract IFileEntry getFileEntry(String path)

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

abstract IDevice getIDevice()

Retorna uma referência ao IDevice 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 do Tradefed acionaram uma reinicialização em milissegundos desde EPOCH, conforme retornado por System.currentTimeMillis().

abstract int getLaunchApiLevel()

Consiga o primeiro nível de API iniciado do dispositivo.

abstract InputStreamSource getLogcat()

Captura um stream de snapshot dos dados do logcat.

abstract InputStreamSource getLogcat(int maxBytes)

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

abstract InputStreamSource getLogcatDump()

Receba um despejo do logcat atual para o dispositivo.

abstract InputStreamSource getLogcatSince(long date)

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

abstract getMountPointInfo()

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

abstract long getPartitionFreeSpace(String partition)

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

abstract ProcessInfo getProcessByName(String processName)

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

abstract String getProcessPid(String process)

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

abstract String getProductType()

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

abstract String getProductVariant()

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

abstract String getProperty(String name)

Recupera o valor da propriedade fornecido do dispositivo.

abstract ITestDevice.RecoveryMode getRecoveryMode()

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

abstract String getSerialNumber()

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

abstract getTombstones()

Busque e retorne a lista de tombstones dos dispositivos.

abstract long getTotalMemory()

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

abstract boolean getUseFastbootErase()

Escolha se você quer usar o formato "fastboot" ou "fastboot" para excluir permanentemente uma partição no dispositivo.

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

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

abstract boolean isBypassLowTargetSdkBlockSupported()

Verificar se a plataforma no dispositivo oferece suporte à evasão de blocos de SDKs de destino baixos em instalações de apps

abstract boolean isDebugfsMounted()

Verifique se o debugfs está ativado.

abstract boolean isDeviceEncrypted()

Retorna se o dispositivo está criptografado.

abstract boolean isDirectory(String deviceFilePath)

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

abstract boolean isEncryptionSupported()

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

abstract boolean isExecutable(String fullPath)

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

abstract boolean isHeadless()

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

abstract boolean isRuntimePermissionSupported()

Verificar se a plataforma do dispositivo é compatível com a concessão de permissões de execução

abstract boolean isStateBootloaderOrFastbootd()

Retorna "true" se o dispositivo está em TestDeviceState#FASTBOOT ou TestDeviceState.FASTBOOTD.

abstract boolean logAnrs(ITestLogger logger)

Coleta e registra ANRs do dispositivo.

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

Registre uma mensagem no logcat do dispositivo.

abstract void mountDebugfs()

Montar debugfs.

abstract void nonBlockingReboot()

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

abstract void postBootSetup()

Siga as instruções para configurar o dispositivo e fazer esses testes após cada inicialização.

default void postInvocationTearDown()

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

abstract void postInvocationTearDown(Throwable invocationException)

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

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

Etapas extras para uma configuração específica do dispositivo exigem que ele seja executado antes do fluxo de invocação.

abstract boolean pullDir(String deviceFilePath, File localDir)

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

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

Extraia 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 prático para recuperar um arquivo do armazenamento externo do dispositivo, o armazena em um ERROR(/File) temporário local e retorna uma referência a esse File.

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)

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

abstract boolean pushDir(File localDir, String deviceFilePath)

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, opcionalmente, avaliar a necessidade do provedor de conteúdo.

abstract boolean pushFile(File localFile, String deviceFilePath)

Envie um arquivo para o dispositivo.

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

Envie um arquivo para o dispositivo.

abstract boolean pushString(String contents, String deviceFilePath)

Enviar por push o arquivo criado a partir de uma string para o dispositivo

abstract void reboot()

Reinicializa o dispositivo no modo adb.

abstract void reboot(String reason)

Reinicializa o dispositivo no modo adb com o reason especificado a ser mantido durante a reinicialização.

abstract void rebootIntoBootloader()

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

abstract void rebootIntoFastbootd()

Reinicializa o dispositivo no modo fastbootd.

abstract void rebootIntoRecovery()

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

abstract void rebootIntoSideload(boolean autoReboot)

Reinicializa o dispositivo no modo de sideload do adb. Observe que esse é um modo especial em recuperação.

Bloqueia até que o dispositivo entre no modo de sideload

abstract void rebootIntoSideload()

Reinicializa o dispositivo no modo de sideload do adb. Observe que esse é um modo especial em recuperação.

Bloqueia até que o dispositivo entre no modo de sideload

abstract void rebootUntilOnline()

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

abstract void rebootUntilOnline(String reason)

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

abstract void rebootUserspace()

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

abstract void rebootUserspaceUntilOnline()

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

abstract void remountSystemReadOnly()

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

abstract void remountSystemWritable()

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

abstract void remountVendorReadOnly()

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

abstract void remountVendorWritable()

Tornar 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 fornece recuperação de dispositivo.

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: para definir a data no dispositivo, é necessário ter acesso root

abstract void setOptions(TestDeviceOptions options)

Definir o TestDeviceOptions para o dispositivo

abstract boolean setProperty(String propKey, String propValue)

Define o valor da propriedade fornecido no dispositivo.

abstract void setRecovery(IDeviceRecovery recovery)

Defina a IDeviceRecovery que será usada neste dispositivo.

abstract void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

abstract void setUseFastbootErase(boolean useFastbootErase)

Defina se você quer usar o formato de limpeza do fastboot ou do fastboot para excluir permanentemente uma partição no dispositivo.

abstract void startLogcat()

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

Interrompe a captura da saída do logcat do dispositivo e descarta os dados salvos atualmente.

abstract String switchToAdbTcp()

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

abstract boolean switchToAdbUsb()

Alterna o dispositivo para adb no modo 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 debugfs.

abstract boolean waitForBootComplete(long timeOut)

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

abstract boolean waitForDeviceAvailable()

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

abstract boolean waitForDeviceAvailable(long waitTime)

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

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Espera 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 no estado "recuperação adb" (observe que isso é diferente de IDeviceRecovery).

abstract boolean waitForDeviceInSideload(long waitTime)

Bloqueia o dispositivo no estado "adb sideload"

abstract boolean waitForDeviceNotAvailable(long waitTime)

Bloqueios para que o dispositivo não esteja disponível, ou seja, ausentes no adb

abstract void waitForDeviceOnline()

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

abstract void waitForDeviceOnline(long waitTime)

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

abstract boolean waitForDeviceShell(long waitTime)

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

Constantes

NÍVEL_DE_API_DESCONHECIDO

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)

Verifique se um recurso tem suporte no momento de acordo com um nível com suporte mínimo. Esse método considera recursos ainda não lançados antes que o nível da API seja aumentado.

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

Retorna
boolean Verdadeiro se o nível for compatível. Falso, do contrário.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

limparLogcat

public abstract void clearLogcat ()

Exclui todos os dados acumulados do logcat.

Isso é útil para os casos em que você quer garantir que o ITestDevice#getLogcat() retorne apenas dados de registro produzidos após um determinado ponto (por exemplo, após atualizar um novo build do dispositivo etc.).

deleteFile

public abstract void deleteFile (String deviceFilePath)

Método auxiliar para excluir um arquivo ou diretório do 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 do dispositivo.

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

userId int: o ID do usuário que será excluído

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftReiniciado

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Método auxiliar para verificar se o dispositivo foi reiniciado de forma reversível, comparando o system_server atual com o ProcessInfo system_server anterior. Use getProcessByName(String) para receber ProcessInfo.

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

Retorna
boolean true se o dispositivo for reiniciado de forma reversível

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 de forma reversível desde o horário UTC desde a época do dispositivo e da ERROR(/TimeUnit) dele. "Reinicialização em segundo plano" se refere ao system_server reiniciado fora de uma reinicialização forçada do dispositivo (por exemplo: reinicialização solicitada). O utcEpochTime do dispositivo atual em Milliseccond pode ser obtido pelo método getDeviceDate().

Parâmetros
utcEpochTime long: o horário do dispositivo em segundos desde a época.

timeUnit TimeUnit: a unidade de tempo TimeUnit para o utcEpochTime especificado.

Retorna
boolean true se o dispositivo for reiniciado de forma reversível

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

desativarAdbRoot

public abstract boolean disableAdbRoot ()

Desativa a raiz do adb.

Desativar a raiz do adb pode fazer com que o dispositivo se desconecte do adb. Esse método ficará bloqueado até que o dispositivo esteja disponível.

Retorna
boolean true se for bem-sucedido.

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

fazFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

Parâmetros
deviceFilePath String: o caminho absoluto do arquivo no dispositivo a ser verificado.

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

Gera
DeviceNotAvailableException 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", registrará uma mensagem e retornará sem ativar a raiz.

A ativação da raiz do adb pode fazer com que o dispositivo se desconecte do adb. Esse método ficará bloqueado até que o dispositivo esteja disponível.

Retorna
boolean true se for bem-sucedido.

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.

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

Parâmetros
timeout long: tempo em milissegundos até o dispositivo deixar de responder, 0L sem tempo limite.

commandArgs String: o comando e os argumentos do adb a serem executados.

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

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

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

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

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

Parâmetros
timeout long: tempo em milissegundos até o dispositivo deixar de responder, 0L sem tempo limite.

envMap : ambiente a ser definido para o comando.

commandArgs String: o comando e os argumentos do adb a serem executados.

Retorna
String a 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 fastboot como um comando do sistema.

Deve ser usado quando o dispositivo já estiver no modo fastboot (Fastboot mode).

Parâmetros
timeout long: o tempo em milissegundos antes da expiração do comando.

commandArgs String: o comando fastboot e os argumentos a serem executados

Retorna
CommandResult 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 fastboot como um comando do sistema com um tempo limite padrão de dois minutos.

Deve ser usado quando o dispositivo já estiver no modo fastboot (Fastboot mode).

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

Retorna
CommandResult 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 fastboot de longa duração como um comando do sistema.

Idêntico a executeFastbootCommand(String), mas usa um tempo limite maior.

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

Retorna
CommandResult 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 fastboot de longa duração como um comando do sistema com variáveis de ambiente do sistema.

Idêntico a executeFastbootCommand(String), mas usa um tempo limite maior.

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 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 do adb e retorna a saída como um String.

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

Retorna
String a saída do shell

Gera
DeviceNotAvailableException 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 do shell do adb, com mais parâmetros para controlar o comportamento do comando.

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

receiver IShellOutputReceiver: o IShellOutputReceiver para onde direcionar a saída do shell.

maxTimeToOutputShellResponse long: o período máximo em que o comando não tem permissão para gerar nenhuma resposta. Unidade conforme especificado em timeUnit

timeUnit TimeUnit: unidade de maxTimeToOutputShellResponse

retryAttempts int: o número máximo de vezes que o comando é repetido se falhar devido a uma exceção. DeviceNotResponsiveException será gerada se retryAttempts forem executadas 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 do shell do adb, com mais parâmetros para controlar o comportamento do comando.

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

receiver IShellOutputReceiver: o IShellOutputReceiver para onde direcionar a saída do shell.

maxTimeoutForCommand long: o tempo limite máximo para a conclusão do comando. Unidade conforme especificada em timeUnit.

maxTimeToOutputShellResponse long: o período máximo em que o comando não tem permissão para gerar nenhuma resposta. Unidade conforme especificado em timeUnit

timeUnit TimeUnit: unidade de maxTimeToOutputShellResponse

retryAttempts int: o número máximo de vezes que o comando é repetido se falhar devido a uma exceção. DeviceNotResponsiveException será gerada se 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 do shell do adb fornecido, tentando várias vezes se o comando falhar.

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

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

receiver IShellOutputReceiver: o IShellOutputReceiver para onde 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 do shell do adb e retorna os resultados como um CommandResult preenchido corretamente com a saída de status do comando, stdout e stderr.

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

Parâmetros
command String: o comando que será executado.

pipeToOutput OutputStream: ERROR(/OutputStream) em que a saída std 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 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 será executado.

pipeAsInput File: uma ERROR(/File) que será encadeada como entrada para o comando 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, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

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

maxTimeoutForCommand long: o tempo limite máximo para a conclusão do comando. Unidade conforme especificada em timeUnit.

timeUnit TimeUnit: unidade de maxTimeToOutputShellResponse

retryAttempts int: o número máximo de vezes que o comando é repetido se falhar devido a uma exceção. DeviceNotResponsiveException será gerada se 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 do shell do adb, com mais parâmetros para controlar o comportamento do comando.

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

maxTimeoutForCommand long: o tempo limite máximo para a conclusão do comando. Unidade conforme 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 do shell do adb, com mais parâmetros para controlar o comportamento do comando.

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

pipeAsInput File: uma ERROR(/File) que será encadeada como entrada para o comando ou nula.

pipeToOutput OutputStream: ERROR(/OutputStream) em que a saída std será redirecionada ou nula.

maxTimeoutForCommand long: o tempo limite máximo para a conclusão do comando. Unidade conforme especificada em timeUnit.

timeUnit TimeUnit: unidade de maxTimeToOutputShellResponse

retryAttempts int: o número máximo de vezes que o comando é repetido se falhar devido a uma exceção. DeviceNotResponsiveException será gerada se 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 do shell do adb, com mais parâmetros para controlar o comportamento do comando.

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

pipeAsInput File: uma ERROR(/File) que será encadeada como entrada para o comando ou nula.

pipeToOutput OutputStream: ERROR(/OutputStream) em que a saída std 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. Unidade conforme especificada em timeUnit.

timeUnit TimeUnit: unidade de maxTimeToOutputShellResponse

retryAttempts int: o número máximo de vezes que o comando é repetido se falhar devido a uma exceção. DeviceNotResponsiveException será gerada se 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 apaga uma partição do dispositivo.

Se getUseFastbootErase() for true, a limpeza do fastboot será usada para excluir permanentemente a partição. O dispositivo deverá criar um sistema de arquivos na próxima vez que for inicializado. Caso contrário, o formato fastboot é usado, o que cria um novo sistema de arquivos no dispositivo.

Deve ser usado quando o dispositivo já estiver no modo fastboot (Fastboot mode).

Parâmetros
partition String: a partição a ser excluída permanentemente.

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

Acessa 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 de API do dispositivo

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

Método de conveniência para obter a versão de banda de base (rádio) deste dispositivo. A versão do rádio é específica do dispositivo e, portanto, 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 corretas de versão. Essa ação não é precisa para alguns dispositivos CDMA, e a versão retornada pode não corresponder à versão informada pelo fastboot e não retornar a versão para o rádio CDMA. Texto longo, leia o resumo: esse método só informará a versão precisa se a propriedade gsm.version.baseband for a mesma que a versão retornada por fastboot getvar version-baseband.

Retorna
String a versão da banda de base String ou null se não for possível determiná-la (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.

getBateria

public abstract Integer getBattery ()

Retorna o nível de bateria atual de um dispositivo ou "Nulo" se o nível de bateria estiver indisponí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 de outra forma.

Gera
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

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

Retorna
Mapa do tempo de inicialização (horário UTC em segundo desde o período) e motivo da inicialização

Gera
DeviceNotAvailableException

getbootHistorySince

public 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 período especificado no dispositivo até a unidade de tempo especificada. O utcEpochTime em milissegundos do dispositivo atual pode ser obtido pelo método getDeviceDate().

Parâmetros
utcEpochTime long: o tempo do dispositivo desde o período.

timeUnit TimeUnit: a unidade de tempo TimeUnit.

Retorna
Mapa do tempo de inicialização (horário UTC em segundo desde o período) e motivo da inicialização

Gera
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

Tentará recuperar a versão do carregador de inicialização do estado atual do dispositivo. Ou seja, se o dispositivo estiver no modo fastboot, ele vai tentar recuperar a versão do fastboot

Retorna
String a versão do carregador de inicialização String ou null se ela não for encontrada;

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

Retorna
String o alias de build ou o ID de build se não for possível recuperá-lo.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Recuperar a variação de build do dispositivo.

Retorna
String a variação de build ou nulo, se não for possível recuperá-lo

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

Recupere o build que o dispositivo está executando no momento.

Retorna
String o ID do build ou IBuildInfo#UNKNOWN_BUILD_ID se não for possível recuperá-lo

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

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

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Retorna
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

Parâmetros
shortDescriptor boolean: se o descritor será limitado ao mínimo de informações.

Retorna
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

Retorna
String[] Matriz de strings 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 ()

Acessa a classe do dispositivo.

Retorna
String a classe de dispositivo String.

getDeviceDate

public abstract long getDeviceDate ()

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

Retorna
long a data do dispositivo em 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 será limitado ao mínimo de informações.

Retorna
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Recebe o estado do dispositivo.

Retorna
TestDeviceState

getDeviceTimeShift

public abstract long getDeviceTimeOffset (Date date)

Ajuda para mostrar a diferença de horário entre o dispositivo e um determinado ERROR(/Date). Use o horário de época internamente.

Parâmetros
date Date

Retorna
long a diferença em milissegundos

Gera
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Acessar o stream do emulador stdout e stderr

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 obter o tipo de produto deste dispositivo quando ele está no modo fastboot.

Esse método só deve ser usado quando o dispositivo precisa estar no fastboot. É uma variante um pouco mais segura do que o método getProductType() genérico nesse caso, porque o ITestDevice saberá recuperar o dispositivo no fastboot 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 obter o tipo de produto deste dispositivo quando ele está no modo fastboot.

Esse método só deve ser usado quando o dispositivo precisa estar no fastboot. É uma variante um pouco mais segura do que o método getProductType() genérico nesse caso, porque o ITestDevice saberá recuperar o dispositivo no fastboot 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)

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

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

Retorna
String o valor da propriedade ou null se ele não existir

Gera
supportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Recupera 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, as sintaxes "/system" e "system" são compatíveis.

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

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Retorna uma referência ao IDevice ddmlib associado.

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

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

getLastLastRestartTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Retorna
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Consiga o primeiro nível de API iniciado do dispositivo. O valor padrão é UNKNOWN_API_LEVEL.

Retorna
int Um número inteiro que indica o primeiro nível de API iniciado do dispositivo

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

Captura um stream de snapshot dos dados do logcat.

Funciona de dois modos:

  • Se o Logcat está sendo capturado em segundo plano, ele retorna até TestDeviceOptions.getMaxLogcatDataSize() bytes do conteúdo atual da captura em segundo plano
  • Caso contrário, retorna 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 do Logcat capturados.

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

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

    Retorna
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

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

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

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

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

    Captura um fluxo de snapshot dos dados do logcat capturados a partir da data fornecida. O horário no dispositivo precisa ser usado como getDeviceDate().

    Parâmetros
    date long: em milissegundos desde o formato de época do momento em que o snapshot será iniciado 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 armazenadas em cache em IDevice não estiverem disponíveis.

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

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

    Retorna
    String o ponto de montagem ou null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Retorna um MountPointInfo correspondente ao caminho de 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 os comandos "pidof" e "stat" e retorna o objeto ProcessInfo com PID e horário de início do processo especificado.

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

    Retorna
    ProcessInfo ProcessInfo de determinado processName

    Gera
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Retorna o pid do serviço ou retorna 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 obter o tipo de produto deste dispositivo.

    Esse método funciona 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 não for possível determinar o tipo de produto

    getProductVariant

    public abstract String getProductVariant ()

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

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

    Recupera o valor da propriedade fornecido do dispositivo.

    Parâmetros
    name String: o nome da propriedade.

    Retorna
    String o valor da propriedade ou null se ele não existir

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Descubra 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 de conveniência para obter o número de série deste dispositivo.

    Retorna
    String o número de série String

    getTombstones

    public abstract  getTombstones ()

    Busque e retorne a lista de tombstones dos dispositivos. Requer acesso root.

    é o melhor esforço para que, se uma tombstone não for extraída por qualquer motivo, ela estará faltando na lista. Apenas um DeviceNotAvailableException encerrará o método antecipadamente.

    Retorna
    Uma lista de arquivos de tombstone, vazia se não houver nenhuma.

    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

    getUseFastbootApagar

    public abstract boolean getUseFastbootErase ()

    Escolha se você quer usar o formato "fastboot" ou "fastboot" para excluir permanentemente uma partição no dispositivo.

    Retorna
    boolean true se a limpeza do fastboot for usada, ou false se o formato fastboot for usado.

    AdbRoot

    public abstract boolean isAdbRoot ()

    Retorna
    boolean true se o dispositivo tiver a raiz adb no momento. Caso contrário, será false.

    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 a adb-over-tcp. Caso contrário, false.

    isAppEnumerationsupported

    public abstract boolean isAppEnumerationSupported ()

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

    Retorna
    boolean Verdadeiro se a enumeração do app for compatível. Caso contrário, é falso.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockAllowed

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

    Verificar se a plataforma no dispositivo oferece suporte à evasão de blocos de SDKs de destino baixos em instalações de apps

    Retorna
    boolean Verdadeiro se o bloco do SDK de destino inferior for compatível. Caso contrário, será falso

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Verifique se o debugfs está ativado.

    Retorna
    boolean true se o debugfs estiver ativado

    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.

    Diretório isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

    Retorna "True" se o caminho no dispositivo é 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 for compatível com o dispositivo.

    Retorna
    boolean true se o dispositivo for compatível com criptografia.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    IsExecutável

    public abstract boolean isExecutable (String fullPath)

    Retorna "True" se o caminho do arquivo no dispositivo é 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 headless (sem tela). Caso contrário, retorna "false".

    Retorna
    boolean

    Gera
    DeviceNotAvailableException

    isRuntimePermissionAllowed

    public abstract boolean isRuntimePermissionSupported ()

    Verificar se a plataforma do dispositivo é compatível com a concessão de permissões de execução

    Retorna
    boolean Verdadeiro se a permissão de execução for compatível. Caso contrário, retorna falso.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStatebootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Retorna "true" se o dispositivo está 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 True, se a geração de registros foi bem-sucedida. Caso contrário, false.

    Gera
    DeviceNotAvailableException

    LogOnDevice

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

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

    Montar debugfs.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    nonBlockingReiniciar

    public abstract void nonBlockingReboot ()

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pós-inicialização

    public abstract void postBootSetup ()

    Siga as instruções para configurar o dispositivo e fazer esses testes após cada inicialização.

    Deve ser chamado quando o dispositivo estiver 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 realizar uma reinicialização.

    Talvez ele precise ser chamado quando o dispositivo for reinicializado devido a outros eventos (por exemplo, quando um comando de atualização do fastboot for concluído).

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

    postInvocationTearDown

    public void postInvocationTearDown ()

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

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

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

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

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

    Configuração preInvocation

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

    Etapas extras para uma configuração específica do dispositivo exigem que ele seja executado antes do fluxo de invocação.

    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)

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

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

    localDir File: o diretório local para onde os arquivos serão extraídos

    Retorna
    boolean true se o arquivo foi extraído. Caso contrário, false.

    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)

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

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

    localDir File: o diretório local para onde os arquivos serão extraídos

    userId int: o ID do usuário do qual extrair

    Retorna
    boolean true se o arquivo foi extraído. Caso contrário, false.

    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 extrair

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

    Gera
    DeviceNotAvailableException 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 em que o conteúdo será armazenado. Se não estiver vazio, o conteúdo será substituído.

    Retorna
    boolean true se o arquivo tiver sido recuperado. Caso contrário, false.

    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 em que o conteúdo será armazenado. Se não estiver vazio, o conteúdo será substituído.

    userId int: o ID do usuário de onde extrair

    Retorna
    boolean true se o arquivo tiver sido recuperado. Caso contrário, false.

    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 prático para recuperar um arquivo do armazenamento externo do dispositivo, o armazena em um ERROR(/File) temporário local e retorna uma referência a esse File.

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

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

    Gera
    DeviceNotAvailableException 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 por push

    deviceFilePath String: o caminho absoluto do arquivo do destino remoto

    userId int: o ID do usuário a ser enviado.

    Retorna
    boolean true se o arquivo foi enviado. Caso contrário, false.

    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)

    Envie 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 por push

    deviceFilePath String: o caminho absoluto do arquivo do destino remoto

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

    Retorna
    boolean true se o arquivo foi enviado. Caso contrário, false.

    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 por push

    deviceFilePath String: o caminho absoluto do arquivo do destino remoto

    Retorna
    boolean true se o arquivo foi enviado. Caso contrário, false.

    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, opcionalmente, avaliar a necessidade do provedor de conteúdo.

    Parâmetros
    localFile File: o arquivo local a ser enviado.

    deviceFilePath String: o caminho absoluto do arquivo de destino remoto

    evaluateContentProviderNeeded boolean: se é necessário verificar se precisamos do provedor de conteúdo.

    Retorna
    boolean true se o arquivo foi enviado. Caso contrário, false.

    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)

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

    Parâmetros
    localFile File: o arquivo local a ser enviado.

    deviceFilePath String: o caminho absoluto do arquivo de destino remoto

    Retorna
    boolean true se o arquivo foi enviado. Caso contrário, false.

    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)

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

    Parâmetros
    localFile File: o arquivo local a ser enviado.

    deviceFilePath String: o caminho absoluto do arquivo de destino remoto

    userId int: o userId a ser enviado.

    Retorna
    boolean true se o arquivo foi enviado. Caso contrário, false.

    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 por push o arquivo criado a partir de uma string para o dispositivo

    Parâmetros
    contents String: o conteúdo do arquivo a ser enviado

    deviceFilePath String: o caminho absoluto do arquivo de destino remoto

    Retorna
    boolean true se a string foi enviada. Caso contrário, false.

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

    reiniciar

    public abstract void reboot ()

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

    Reinicializa o dispositivo no modo adb com o reason especificado a ser mantido durante a reinicialização.

    Bloqueia até que o dispositivo fique disponível.

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

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

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

    reinicializarIntobootloader

    public abstract void rebootIntoBootloader ()

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

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

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

    reinicializarIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Reinicializa o dispositivo no modo fastbootd.

    Bloqueia até que o dispositivo entre no modo fastbootd.

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

    reinicializarIntoRecovery

    public abstract void rebootIntoRecovery ()

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

    Bloqueia até que o dispositivo inicie a recuperação

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

    reinicializarIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Reinicializa o dispositivo no modo de sideload do adb. Observe que esse é um modo especial em 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 no sideload após a reinicialização

    reinicializarIntoSideload

    public abstract void rebootIntoSideload ()

    Reinicializa o dispositivo no modo de sideload do adb. Observe que esse é um modo especial em recuperação.

    Bloqueia até que o dispositivo entre no modo de sideload

    Gera
    DeviceNotAvailableException se o dispositivo não estiver no sideload após a reinicialização

    reinicializarUntilOnline

    public abstract void rebootUntilOnline ()

    Uma alternativa para reboot() que bloqueia apenas 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

    reinicializarUntilOnline

    public abstract void rebootUntilOnline (String reason)

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

    Parâmetros
    reason String: um motivo para essa 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:

    Reinicializar espaço do usuário

    public abstract void rebootUserspace ()

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

    Bloqueia até que o dispositivo fique disponível.

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

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

    reinicializarUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

    Uma alternativa para rebootUserspace() ()} que só é bloqueada 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 ()

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountSystemWritable

    public abstract void remountSystemWritable ()

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorReadOnly

    public abstract void remountVendorReadOnly ()

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

    Tornar a partição do fornecedor no dispositivo gravável. Pode reinicializar 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 tiver sido concluído. false se não foi possível concluir, mas a recuperação foi bem-sucedida

    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada, ou seja, 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 fornece recuperação de dispositivo.

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

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

    Parâmetros
    runner IRemoteAndroidTestRunner: o IRemoteAndroidTestRunner que executa os testes.

    listeners : os listeners do resultado do teste.

    Retorna
    boolean true se o comando de teste tiver sido concluído. false se ela não for concluída devido a uma exceção de comunicação do dispositivo, mas a recuperação for bem-sucedida

    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada, ou seja, 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

    definirData

    public abstract void setDate (Date date)

    Define a data no dispositivo

    Observação: para definir a data no dispositivo, é necessário ter acesso root

    Parâmetros
    date Date: especifica uma data específica. A data do host será usada se null.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Definir o TestDeviceOptions para o dispositivo

    Parâmetros
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Define o valor da propriedade fornecido no dispositivo. Exige que a raiz do adb seja verdadeira.

    Parâmetros
    propKey String: a chave de destino a 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 a IDeviceRecovery que será usada neste dispositivo. Precisa ser definido quando o dispositivo é 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 o método de recuperação a ser usado quando um problema de comunicação do dispositivo for encontrado. É recomendável usar esse método apenas quando necessário (por exemplo, quando o framework estiver inativo etc.).

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

    definirUsarFastbootLimpar

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Defina se você quer usar o formato de limpeza do fastboot ou do fastboot para excluir permanentemente uma partição no dispositivo.

    Parâmetros
    useFastbootErase boolean: true se for necessário usar a limpeza do fastboot ou false se o formato fastboot precisar ser usado.

    startLogcat

    public abstract void startLogcat ()

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

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

    Quando o dispositivo não estiver mais em uso, será necessário chamar stopLogcat().

    startLogcat() e stopLogcat() normalmente não precisam ser chamados quando dentro de um contexto de invocação do TF, já que o framework do TF iniciará e interromperá o Logcat.

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Feche e exclua a saída do emulador.

    stopLogcat

    public abstract void stopLogcat ()

    Interrompe a captura da saída do logcat do dispositivo e descarta os dados salvos atualmente.

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

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

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

    Retorna
    String O número de série TCP ou null se não for possível alternar o dispositivo

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Alterna o dispositivo para adb no modo usb.

    Retorna
    boolean true se a troca for bem-sucedida. Caso contrário, false.

    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 enviar comparando carimbos de data/hora de arquivos locais com os equivalentes remotos. Apenas arquivos "mais recentes" ou inexistentes serão enviados ao dispositivo. Assim, a sobrecarga será relativamente pequena se o arquivo definido no dispositivo já estiver atualizado.

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

    Exemplo de uso: syncFiles("/tmp/files", "/sdcard") cria um diretório /sdcard/files se ele ainda não existe e envia recursivamente o conteúdo /tmp/files para /sdcard/files.

    Parâmetros
    localFileDir File: o diretório de arquivos local que contém os arquivos a serem enviados recursivamente.

    deviceFilePath String: a raiz do caminho absoluto do arquivo de destino remoto. Todos os diretórios nesse caminho de arquivo precisam ser legíveis. Ou seja, enviar para /data/local/tmp quando o adb não for raiz vai falhar

    Retorna
    boolean true se os arquivos foram sincronizados. Caso contrário, false.

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

    desbloquearDispositivo

    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 se for bem-sucedido 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 debugfs.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    "waitForBootComplete"

    public abstract boolean waitForBootComplete (long timeOut)

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

    Parâmetros
    timeOut long: tempo em ms para aguardar a definição da flag.

    Retorna
    boolean verdadeiro se a sinalização de inicialização do dispositivo estiver definida dentro do tempo limite

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    "waitForDeviceAvailable"

    public abstract boolean waitForDeviceAvailable ()

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

    Retorna
    boolean Verdadeiro se o dispositivo estiver disponível. Falso 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)

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

    Parâmetros
    waitTime long: o tempo de espera em ms

    Retorna
    boolean Verdadeiro se o dispositivo estiver disponível. Falso se a recuperação estiver desativada e indisponível.

    Gera
    DeviceNotAvailableException se o dispositivo ainda não estiver respondendo após o período de espera.

    "waitForDeviceAvailableInRecoverPath"

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Parâmetros
    waitTime long

    Retorna
    boolean Verdadeiro se o dispositivo estiver disponível. Falso se não estiver disponível.

    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 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 no estado "recuperação adb" (observe que isso é diferente de IDeviceRecovery).

    Parâmetros
    waitTime long: o tempo de espera em ms

    Retorna
    boolean true se o dispositivo for inicializado para a recuperação antes de o tempo expirar. Caso contrário, false

    "waitForDeviceInSideload"

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Bloqueia o dispositivo no estado "adb sideload"

    Parâmetros
    waitTime long: o tempo de espera em ms

    Retorna
    boolean true se o dispositivo for inicializado no sideload antes de o tempo expirar. Caso contrário, false

    "waitForDeviceNotAvailable"

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Bloqueios para que o dispositivo não esteja disponível, ou seja, ausentes no adb

    Parâmetros
    waitTime long: o tempo de espera em ms

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

    "waitForDeviceOnline"

    public abstract void waitForDeviceOnline ()

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

    O dispositivo pode não ser necessariamente responsivo a 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 via adb.

    O dispositivo pode não ser necessariamente responsivo a comandos após a conclusão. Use waitForDeviceAvailable().

    Parâmetros
    waitTime long: o tempo de espera em ms

    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 o dispositivo responder a um comando básico do shell do adb.

    Parâmetros
    waitTime long: o tempo de espera em ms

    Retorna
    boolean true se o dispositivo começar a responder antes de waitTime.