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 uma quantidade configurável e fornece uma recuperação do dispositivo para dispositivos que não respondem.

Resumo

Constantes

int UNKNOWN_API_LEVEL

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

Métodos públicos

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Verifique se um recurso 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 system_server anterior: ProcessInfo.

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 do 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 2 minutos.

abstract CommandResult executeLongFastbootCommand(String... commandArgs)

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

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

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

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, uma vez que o método tempo desde a época do dispositivo e a unidade de tempo especificada.

abstract String getBootloaderVersion()

Método de conveniência para obter a versão do carregador de inicialização 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 chaves de lançamento. (controlado 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()

Retornar um DeviceDescriptor das informações do dispositivo para receber informações sem ele passando o objeto do dispositivo real.

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

Retornar um DeviceDescriptor das informações do dispositivo para receber informações sem ele passando o objeto do dispositivo real.

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 Tradefed acionaram uma reinicialização em milissegundos desde EPOCH como 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 snapshot de um fluxo de dados do logcat capturados a partir da data fornecida.

abstract String getMountPoint(String mountName)

Retorna um ponto de montagem.

abstract ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

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

abstract getMountPointInfo()

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

abstract long getPartitionFreeSpace(String partition)

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

abstract ProcessInfo getProcessByName(String processName)

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

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

default String getTrackingSerial()

Para fins de gerenciamento de dispositivos, acesse o número de série usado para rastreá-lo.

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

Verifica 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 retorna quando o comando termina e 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 que serão executadas após a invocação é concluída.

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

etapas extras para a configuração específica do dispositivo que serão executadas no dispositivo antes no 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 o retorna. File.

abstract File pullFile(String remoteFilePath)

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

abstract boolean pullFile(String remoteFilePath, File localFile)

Recupera um arquivo do dispositivo.

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

Recupera um arquivo do dispositivo.

abstract String pullFileContents(String remoteFilePath)

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

abstract File pullFileFromExternal(String remoteFilePath)

Um método conveniente para recuperar um arquivo do armazenamento externo do dispositivo, armazená-lo em um ERROR(/File) temporária 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 filtrada.

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 para o 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ó será bloqueada até que o dispositivo esteja on-line, ou seja, visíveis 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 setTrackingSerial(String trackingSerial)

Para fins de gerenciamento de dispositivos, rastreie o número de série que usamos para fazer referência ao 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 em "recuperação do adb" estado (diferente da IDeviceRecovery).

abstract boolean waitForDeviceInSideload(long waitTime)

Bloqueia o dispositivo para estar no "sideload do adb" estado

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. Isso considera os recursos ainda não lançados antes que o nível da API seja elevado.

Parâmetros
strictMinLevel int: o nível mínimo possível 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 ITestDevice#getLogcat() só retorne dados de registro produzidos após um certo ponto (por exemplo, após atualizar uma nova versão de 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 system_server anterior: ProcessInfo. 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 do ERROR(/TimeUnit) dele. "Reinicialização em segundo plano" se refere ao system_server reiniciado fora de um reinicialização forçada do dispositivo (por exemplo, reinicialização solicitada). O utcEpochTime atual do dispositivo em O milissegundo 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 bloqueará até estiver 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 se recuperou

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 se recuperou

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

A ativação da raiz do adb pode fazer com que o dispositivo se desconecte do adb. Esse método bloqueará até estiver 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 se recuperou

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 melhora a detecção de falhas e o desempenho.

Parâmetros
timeout long: tempo em milissegundos até o dispositivo deixar de responder. 0L para 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 se recuperou

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 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 se recuperou

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 melhora a detecção de falhas e o desempenho.

Parâmetros
timeout long: tempo em milissegundos até o dispositivo deixar de responder. 0L para 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 se recuperou

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 se recuperou

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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 se recuperou

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 se recuperou

executeLongFastbootCommand

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

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

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 se recuperou

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 se recuperou

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 tempo máximo em que o comando fica não podem gerar respostas. 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 sejam realizadas sem sucesso.

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

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 como especificado em timeUnit

maxTimeToOutputShellResponse long: o tempo máximo em que o comando fica não podem gerar respostas. 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 realizada sem sucesso.

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

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 se recuperou

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 se recuperou

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 uma CommandResult preenchida 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 se recuperou

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 se recuperou

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 como 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 realizada sem sucesso.

Retorna
CommandResult

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

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 como especificado 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 se recuperou

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 como 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 realizada sem sucesso.

Retorna
CommandResult

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

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 como 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 realizada sem sucesso.

Retorna
CommandResult

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

Se a getUseFastbootErase() for true, a limpeza do fastboot será usada para excluir permanentemente da 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 se recuperou

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 da 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. Fazer o download da versão de rádio é específico do dispositivo e, por isso, pode não retornar as informações corretas para todos os dispositivos. Isso depende da propriedade gsm.version.baseband para retornar as informações corretas de versão. Isso não é preciso para alguns dispositivos CDMA, e a versão retornada pode não corresponder a versão informada pelo fastboot e pode não retornar a versão do rádio CDMA. Texto longo, leia o resumo: esse método só relata a versão precisa se a propriedade gsm.version.baseband for a igual à 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 determinar (o dispositivo não tem uma string de 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 ser recuperados.

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

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, uma vez que o método tempo desde a época do dispositivo e a unidade de tempo especificada. O utcEpochTime atual do dispositivo em O milissegundo 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 se recuperou

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 construções do Nexus). Por exemplo, a versão final do Android 4.2 tem o alias de build JDQ39 e um ID de build. 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 chaves de lançamento. (controlado 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 ()

Retornar um DeviceDescriptor das informações do dispositivo para receber informações sem ele passando o objeto do dispositivo real.

Retorna
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Retornar um DeviceDescriptor das informações do dispositivo para receber informações sem ele passando o objeto do dispositivo real.

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). Usar tempo 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 se recuperou

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 O sistema saberá como recuperar o dispositivo para o fastboot se ele estiver no estado incorreto ou sem resposta.

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 se recuperou

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 O sistema saberá como recuperar o dispositivo para o fastboot se ele estiver no estado incorreto ou sem resposta.

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 se recuperou

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, "/system" e "sistema" sintaxe é aceita)

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

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Retorna uma referência ao ddmlib IDevice associado.

Um novo IDevice pode ser alocado pelo DDMS toda vez que o dispositivo se desconectar e é reconectado a partir do adb. Assim, os autores de 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 tem um valor inteiro.

Gera
DeviceNotAvailableException

getLastesperaRestartTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Retorna a última vez que as APIs Tradefed acionaram uma reinicialização em milissegundos desde EPOCH como 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 estiver sendo capturado em segundo plano, ele retornará até TestDeviceOptions.getMaxLogcatDataSize() bytes do conteúdo atual em segundo plano captura do logcat
  • 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 receber todo o snapshot getLogcat().

    Parâmetros
    maxBytes int: a quantidade máxima de dados a serem retornados. Deve ser um valor que possa se encaixam 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 vai 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. Se falhar, um stream vazio será retornado para capturar 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 do dia dispositivo precisa ser usado 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 do ponto de montagem especificado. null se esse caminho não tiver nada montado ou não aparecer no "/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 se recuperou

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

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

    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 recuperado 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 puder ser determinados

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

    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 será que não estão na lista. Apenas um DeviceNotAvailableException vai encerrar o método cedo.

    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

    getTrackingSerial

    public String getTrackingSerial ()

    Para fins de gerenciamento de dispositivos, acesse o número de série usado para rastreá-lo.

    Retorna
    String

    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 ser usados.

    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 se recuperou

    isAdbTcp

    public abstract boolean isAdbTcp ()

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

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

    Verifica 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 se recuperou

    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 Verdadeiro se a geração de registros for bem-sucedida. Caso contrário, é falso.

    Gera
    DeviceNotAvailableException

    LogOnDevice

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

    Registre uma mensagem no logcat do dispositivo. Esta é uma chamada segura que não será realizada, mesmo se a geração de registros vai 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 retorna quando o comando termina e 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, pois implementações devem executar 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 o comando fastboot update foi concluído).

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

    postInvocationTearDown

    public void postInvocationTearDown ()

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

    Etapas extras para a limpeza específica do dispositivo que serão executadas após a invocação é concluída.

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Etapas extras para a limpeza específica do dispositivo que serão executadas após a invocação é concluída.

    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 a configuração específica do dispositivo que serão executadas no dispositivo antes no 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 se recuperou

    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 se recuperou

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

    Recupera um arquivo do dispositivo, o armazena em um ERROR(/File) temporário local e o retorna. 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 o falha ao copiar 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 se recuperou

    pullFile

    public abstract File pullFile (String remoteFilePath)

    Recupera um arquivo do dispositivo, o armazena em um ERROR(/File) temporário local e o retorna. 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 o falha ao copiar 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 se recuperou

    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 se recuperou

    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 se recuperou

    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 o falha ao copiar por qualquer motivo (incluindo problemas com o sistema de arquivos do host)

    Gera
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract File pullFileFromExternal (String remoteFilePath)

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

    Parâmetros
    remoteFilePath String: o caminho do arquivo no dispositivo, em relação ao armazenamento externo do dispositivo. mountpoint

    Retorna
    File Um ERROR(/File) contendo o conteúdo do arquivo do dispositivo ou null se o falha ao copiar 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 se recuperou

    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 se recuperou

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

    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 se recuperou

    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 se recuperou

    pushFile

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

    Variante de pushFile(File, String) que pode, opcionalmente, avaliar a necessidade para o 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 se recuperou

    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 se recuperou

    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 se recuperou

    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 se recuperou

    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 acessado 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

    Reinicializar o carregador de inicialização

    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 se recuperou

    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 se recuperou

    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ó será bloqueada até que o dispositivo esteja on-line, ou seja, visíveis 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. Isso 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. Isso 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 for possível concluída, mas a recuperação foi bem-sucedida

    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou Ou seja, o comando "test" 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 do teste e a recuperação for bem-sucedida, todos os listeners serão informados sobre testRunFailed e "false" será retornado. O comando "test" não será executada novamente. Os autores da chamada podem tentar novamente, se necessário.

    Se a conexão com o dispositivo for perdida antes da conclusão do teste e a recuperação falhar, 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 não for possível concluída devido a uma exceção de comunicação do dispositivo, mas a recuperação foi concluída

    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou Ou seja, o comando "test" 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. usará a data do host 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. Deve ser definido quando o dispositivo é o primeiro alocada.

    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 ocorre um problema de comunicação no dispositivo encontrados. É recomendável usar esse método apenas quando necessário (por exemplo, quando a estrutura está inativa etc.

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

    setTrackSerial

    public abstract void setTrackingSerial (String trackingSerial)

    Para fins de gerenciamento de dispositivos, rastreie o número de série que usamos para fazer referência ao dispositivo.

    Parâmetros
    trackingSerial String

    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 use o formato fastboot.

    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 em um contexto de invocação do TF, já que o framework do TF inicia e interrompe o Logcat.

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Feche e exclua a saída do emulador.

    stopLogcat

    public abstract void stopLogcat ()

    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 o controle remoto equivalentes. Somente "mais recente" ou arquivos inexistentes serão enviados para o dispositivo. Portanto, sobrecarga deve ser relativamente pequeno 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 existir e enviar recursivamente o conteúdo de /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 em thos O caminho do arquivo precisa ser legível. Ou seja, enviando para /data/local/tmp quando o adb não está 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 se recuperou

    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 o teste 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 se recuperou
    UnsupportedOperationException se a criptografia não for compatível com o dispositivo.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Desconecte o 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 se recuperou

    "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 se recuperou

    "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 se recuperou

    "waitForDeviceInRecovery"

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Bloqueia o dispositivo em "recuperação do adb" estado (diferente da 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 para estar no "sideload do adb" estado

    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 responder necessariamente a comandos na conclusão. Usar waitForDeviceAvailable().

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

    "waitForDeviceOnline"

    public abstract void waitForDeviceOnline (long waitTime)

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

    O dispositivo pode não responder necessariamente a comandos na conclusão. Usar 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 se recuperou

    "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 voltar a responder antes de waitTime.