INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

Tenta novamente os comandos do dispositivo por um período configurável e fornece uma interface de recuperação para dispositivos que não respondem.

Resumo

Constantes

int UNKNOWN_API_LEVEL

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

Métodos públicos

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Verifica se um recurso é compatível com um nível de 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 no dispositivo.

abstract void deleteFile(String deviceFilePath, int userId)

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

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Método auxiliar para verificar se o dispositivo foi reiniciado por software comparando o system_server atual com o system_server anterior ProcessInfo.

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

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

abstract boolean disableAdbRoot()

Desativa o adb root.

abstract boolean doesFileExist(String deviceFilePath)

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

abstract boolean enableAdbRoot()

Ativa o adb root.

abstract String executeAdbCommand(long timeout, String... commandArgs)

Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.

abstract String executeAdbCommand(String... commandArgs)

Método auxiliar que executa um comando adb como um comando do sistema.

abstract String executeAdbCommand(long timeout, envMap, String... commandArgs)

Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.

abstract CommandResult executeAdbV2Command(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 executeAdbV2Command(String... commandArgs)

Método auxiliar que executa um comando adb como um comando do sistema.

abstract CommandResult executeAdbV2Command(long timeout, 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 do sistema com variáveis de ambiente do sistema.

abstract String executeShellCommand(String command)

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

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

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

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

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

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

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

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

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

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

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

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

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

abstract CommandResult fastbootWipePartition(String partition)

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

abstract int getApiLevel()

Recebe o nível da API do dispositivo.

abstract String getBasebandVersion()

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

abstract Integer getBattery()

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

abstract boolean getBooleanProperty(String name, boolean defaultValue)

Retorna o valor booleano da propriedade especificada.

abstract getBootHistory()

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

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização desde o tempo especificado desde a época do dispositivo e a unidade de tempo especificada.

abstract String getBootloaderVersion()

Método conveniente para receber a versão do carregador de inicialização deste dispositivo.

abstract String getBuildAlias()

Recupera o alias da build que o dispositivo está executando no momento.

abstract String getBuildFlavor()

Recupere a variante 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 (controladas por fabricantes de dispositivos individuais).

abstract DeviceDescriptor getCachedDeviceDescriptor()

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

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Retorna um DeviceDescriptor 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 a permissões.

abstract AbstractConnection getConnection()

Retorna a conexão associada ao dispositivo.

abstract String getDeviceClass()

Receba a classe do dispositivo.

abstract long getDeviceDate()

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

abstract DeviceDescriptor getDeviceDescriptor()

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

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

abstract TestDeviceState getDeviceState()

Acessa o estado do dispositivo.

abstract long getDeviceTimeOffset(Date date)

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

abstract InputStreamSource getEmulatorOutput()

Receber o fluxo de stdout e stderr do emulador

abstract long getExternalStoreFreeSpace()

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

abstract String getFastbootProductType()

Método conveniente para receber o tipo de produto deste dispositivo quando ele está no modo fastboot.

abstract String getFastbootProductVariant()

Método conveniente para receber 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 especificada do dispositivo.

abstract IFileEntry getFileEntry(String path)

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

abstract IDevice getIDevice()

Retorna uma referência à IDevice ddmlib associada.

abstract long getIntProperty(String name, long defaultValue)

Retorna o valor inteiro da propriedade especificada do dispositivo.

abstract long getLastExpectedRebootTimeMillis()

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

abstract int getLaunchApiLevel()

Recebe o primeiro nível da API iniciada do dispositivo.

abstract InputStreamSource getLogcat()

Captura um fluxo de snapshot dos dados do logcat.

abstract InputStreamSource getLogcat(int maxBytes)

Captura um fluxo de snapshot dos últimos maxBytes dados de logcat capturados.

abstract InputStreamSource getLogcatDump()

Receba um despejo do logcat atual do dispositivo.

abstract InputStreamSource getLogcatSince(long date)

Extrai um fluxo de snapshot dos dados do logcat capturados a partir da data fornecida.

abstract String getMountPoint(String mountName)

Retorna um ponto de montagem.

abstract ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

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

abstract getMountPointInfo()

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

abstract long getPartitionFreeSpace(String partition)

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

abstract ProcessInfo getProcessByName(String processName)

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

abstract String getProcessPid(String process)

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

abstract String getProductType()

Método de conveniência para receber o tipo de produto 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 especificada do dispositivo.

abstract ITestDevice.RecoveryMode getRecoveryMode()

Recebe o modo de recuperação atual usado no dispositivo.

abstract String getSerialNumber()

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

abstract getTombstones()

Busca e retorna a lista de lápides dos dispositivos.

abstract long getTotalMemory()

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

default String getTrackingSerial()

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

abstract boolean getUseFastbootErase()

Recebe se é necessário usar "fastboot erase" ou "fastboot format" para limpar uma partição no dispositivo.

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

Verificar se a plataforma no dispositivo é compatível com a enumeração de apps

abstract boolean isBypassLowTargetSdkBlockSupported()

Verifique se a plataforma no dispositivo permite ignorar o bloqueio de SDK de destino baixo nas instalações de apps

abstract boolean isDebugfsMounted()

Verifique se o debugfs está montado.

abstract boolean isDeviceEncrypted()

Retorna se o dispositivo está criptografado.

abstract boolean isDirectory(String deviceFilePath)

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

abstract boolean isEncryptionSupported()

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

abstract boolean isExecutable(String fullPath)

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

abstract boolean isHeadless()

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

abstract boolean isRuntimePermissionSupported()

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

abstract boolean isStateBootloaderOrFastbootd()

Retorna "true" se o dispositivo estiver em TestDeviceState.FASTBOOT ou TestDeviceState.FASTBOOTD.

abstract boolean logAnrs(ITestLogger logger)

Coleta e registra erros de ANR do dispositivo.

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

Registre uma mensagem no logcat do dispositivo.

abstract void mountDebugfs()

Monte o debugfs.

abstract void nonBlockingReboot()

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

abstract void postBootSetup()

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

default void postInvocationTearDown()

Esse método foi descontinuado. Use postInvocationTearDown(Throwable), em vez disso.

abstract void postInvocationTearDown(Throwable invocationException)

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

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

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

abstract boolean pullDir(String deviceFilePath, File localDir)

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

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

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

abstract File pullFile(String remoteFilePath, int userId)

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

abstract File pullFile(String remoteFilePath)

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

abstract boolean pullFile(String remoteFilePath, File localFile)

Recupera um arquivo do dispositivo.

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

Recupera um arquivo do dispositivo.

abstract String pullFileContents(String remoteFilePath)

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

abstract File pullFileFromExternal(String remoteFilePath)

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

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

Envie o conteúdo do diretório de maneira recursiva para o dispositivo.

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

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

abstract boolean pushDir(File localDir, String deviceFilePath)

Envie o conteúdo do diretório de maneira recursiva para o dispositivo.

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

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

abstract boolean pushFile(File localFile, String deviceFilePath)

Envie um arquivo por push para o dispositivo.

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

Envie um arquivo por push para o dispositivo.

abstract boolean pushString(String contents, String deviceFilePath)

Enviar arquivo criado 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 para ser mantido durante a reinicialização.

abstract void rebootIntoBootloader()

Reinicializa o dispositivo no modo bootloader.

abstract void rebootIntoFastbootd()

Reinicializa o dispositivo no modo fastbootd.

abstract void rebootIntoRecovery()

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

abstract void rebootIntoSideload(boolean autoReboot)

Reinicializa o dispositivo no modo adb sideload (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 adb sideload (observe que esse é um modo especial em recuperação)

Bloqueia até que o dispositivo entre no modo de sideload

abstract void rebootUntilOnline()

Uma alternativa a 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 a 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 a rebootUserspace() ()} que só bloqueia até que o dispositivo esteja on-line, ou seja, visível para o adb.

abstract void remountSystemReadOnly()

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

abstract void remountSystemWritable()

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

abstract void remountVendorReadOnly()

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

abstract void remountVendorWritable()

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

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

Método conveniente para realizar ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) com um ou mais listeners transmitidos como parâmetros.

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

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

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

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

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

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

abstract void setDate(Date date)

Define a data no dispositivo.

Observação: definir a data no dispositivo requer 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 especificada no dispositivo.

abstract void setRecovery(IDeviceRecovery recovery)

Defina o IDeviceRecovery a ser usado 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, rastreamos o número de série que usamos para fazer referência ao dispositivo.

abstract void setUseFastbootErase(boolean useFastbootErase)

Defina se você quer usar "fastboot erase" ou "fastboot format" para limpar uma partição no dispositivo.

abstract void startLogcat()

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

abstract boolean startTradeInModeTesting(int timeoutMs)

Ativa o modo de teste de troca.

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 do logcat salvos no momento.

abstract void stopTradeInModeTesting()

Pare de testar o modo Revenda.

abstract String switchToAdbTcp()

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

abstract boolean switchToAdbUsb()

Coloque o dispositivo no modo adb por USB.

abstract boolean syncFiles(File localFileDir, String deviceFilePath)

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

abstract boolean unlockDevice()

Desbloqueia o dispositivo se ele estiver criptografado.

abstract void unmountDebugfs()

Desmonte o debugfs.

abstract boolean waitForBootComplete(long timeOut)

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

abstract boolean waitForDeviceAvailable()

Aguarde até que o dispositivo esteja responsivo e disponível para testes.

abstract boolean waitForDeviceAvailable(long waitTime)

Aguarde até que o dispositivo esteja responsivo e disponível para testes.

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Aguarde que o dispositivo responda e fique disponível sem considerar o caminho de recuperação.

abstract void waitForDeviceBootloader()

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

abstract boolean waitForDeviceInRecovery(long waitTime)

Bloqueia para que o dispositivo esteja no estado "adb recovery". Isso é diferente de IDeviceRecovery.

abstract boolean waitForDeviceInSideload(long waitTime)

Bloqueia para que o dispositivo fique no estado "adb sideload".

abstract boolean waitForDeviceNotAvailable(long waitTime)

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

abstract void waitForDeviceOnline()

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

abstract void waitForDeviceOnline(long waitTime)

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

abstract boolean waitForDeviceShell(long waitTime)

Aguarde até que o dispositivo responda a um comando básico do shell adb.

Constantes

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

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

Valor da constante: -1 (0xffffffff)

Métodos públicos

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Verifica se um recurso é compatível com um nível de suporte mínimo. Esse método considera recursos não lançados antes do aumento do nível da API.

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

Retorna
boolean Verdadeiro se o nível for compatível. Caso contrário, retorna "falso".

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

clearLogcat

public abstract void clearLogcat ()

Exclui todos os dados acumulados do logcat.

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

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

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

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Método auxiliar para verificar se o dispositivo foi reiniciado por software comparando o system_server atual com o 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 suave

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 por software desde o horário UTC desde a época do dispositivo e seu ERROR(/TimeUnit). A reinicialização suave se refere ao system_server reiniciado fora de uma reinicialização forçada do dispositivo (por exemplo, uma reinicialização solicitada). O utcEpochTime do dispositivo atual em milissegundos pode ser obtido pelo método getDeviceDate().

Parâmetros
utcEpochTime long: o horário do dispositivo em segundos desde o período.

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

Retorna
boolean true se o dispositivo for reiniciado de forma suave

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

disableAdbRoot

public abstract boolean disableAdbRoot ()

Desativa o adb root.

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

Retorna
boolean true se for bem-sucedido.

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

Retorna
boolean true se for bem-sucedido.

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

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

Parâmetros
timeout long: o tempo em milissegundos antes de o dispositivo ser considerado sem resposta, 0L para sem tempo limite.

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

Retorna
String o stdout do comando. null se o comando não for executado.

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

Método auxiliar que executa um comando adb como um comando do sistema.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

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

Retorna
String o stdout do comando. null se o comando não for executado.

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

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

Parâmetros
timeout long: o tempo em milissegundos antes de o dispositivo ser considerado sem resposta, 0L para sem tempo limite.

envMap : ambiente a ser definido para o comando

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

Retorna
String o stdout do comando. null se o comando não for executado.

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... commandArgs)

Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

Parâmetros
timeout long: o tempo em milissegundos antes de o dispositivo ser considerado sem resposta, 0L para sem tempo limite.

envMap : ambiente a ser definido para o comando

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

Retorna
CommandResult o CommandResult que contém a saída do comando.

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

Método auxiliar que executa um comando adb como um comando do sistema.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

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

Retorna
CommandResult o CommandResult que contém a saída do comando.

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                String... commandArgs)

Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.

Sempre que possível, use executeShellCommand(String), já que esse método oferece melhor detecção de falhas e performance.

Parâmetros
timeout long: o tempo em milissegundos antes de o dispositivo ser considerado sem resposta, 0L para sem tempo limite.

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

Retorna
CommandResult o CommandResult que contém a saída do comando.

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

Método auxiliar que executa um comando fastboot como um comando do sistema.

Deve ser usado quando o dispositivo já está no modo fastboot.

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

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

Retorna
CommandResult o CommandResult que contém a saída do comando

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

Deve ser usado quando o dispositivo já está no modo fastboot.

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

Retorna
CommandResult o CommandResult que contém a saída do comando

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

Retorna
CommandResult o CommandResult que contém a saída do comando

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

executeLongFastbootCommand

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

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

Idêntico a executeFastbootCommand(String), exceto por usar um tempo limite 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 o CommandResult que contém a saída do comando

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

executeShellCommand

public abstract String executeShellCommand (String command)

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

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

Retorna
String a saída do shell

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

executeShellCommand

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

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

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

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

maxTimeToOutputShellResponse long: o período máximo em que o comando pode ficar sem gerar uma resposta. A unidade é especificada em timeUnit.

timeUnit TimeUnit: unidade para maxTimeToOutputShellResponse

retryAttempts int: o número máximo de novas tentativas de execução do comando se ele falhar devido a uma exceção. A exceção "DeviceNotResponsiveException" será gerada se retryAttempts forem executadas sem sucesso.

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

executeShellCommand

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

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

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

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

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

maxTimeToOutputShellResponse long: o período máximo em que o comando pode ficar sem gerar uma resposta. A unidade é especificada em timeUnit.

timeUnit TimeUnit: unidade para maxTimeToOutputShellResponse

retryAttempts int: o número máximo de novas tentativas de execução do comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será gerado se retryAttempts forem executados sem sucesso.

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

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

Retorna
CommandResult O resultado em CommandResult.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

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

Retorna
CommandResult O resultado em CommandResult.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

pipeAsInput File: um ERROR(/File) que será transmitido como entrada para o comando ou nulo.

Retorna
CommandResult O resultado em CommandResult.

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

executeShellV2Command

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

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

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

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

timeUnit TimeUnit: unidade para maxTimeToOutputShellResponse

retryAttempts int: o número máximo de novas tentativas de execução do comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será gerado se retryAttempts forem executados sem sucesso.

Retorna
CommandResult

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

executeShellV2Command

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

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

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

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

timeUnit TimeUnit: unidade para maxTimeToOutputShellResponse

Retorna
CommandResult

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

executeShellV2Command

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

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

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

pipeAsInput File: um ERROR(/File) que será transmitido como entrada para o comando ou nulo.

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

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

timeUnit TimeUnit: unidade para maxTimeToOutputShellResponse

retryAttempts int: o número máximo de novas tentativas de execução do comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será gerado se retryAttempts forem executados sem sucesso.

Retorna
CommandResult

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

executeShellV2Command

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

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

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

pipeAsInput File: um ERROR(/File) que será transmitido como entrada para o comando ou nulo.

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

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

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

timeUnit TimeUnit: unidade para maxTimeToOutputShellResponse

retryAttempts int: o número máximo de novas tentativas de execução do comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será gerado se retryAttempts forem executados sem sucesso.

Retorna
CommandResult

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

Se getUseFastbootErase() for true, o comando fastboot erase será usado para limpar a partição. O dispositivo vai criar um sistema de arquivos na próxima vez que for inicializado. Caso contrário, o formato fastboot será usado, o que vai criar um novo sistema de arquivos no dispositivo.

Deve ser usado quando o dispositivo já está no modo fastboot.

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

Retorna
CommandResult o CommandResult que contém a saída do comando

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

getApiLevel

public abstract int getApiLevel ()

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

Retorna
int um número inteiro que indica o nível de API do dispositivo

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

Método de conveniência para receber a versão da banda de base (rádio) deste dispositivo. A versão do rádio é específica do dispositivo, então pode não retornar as informações corretas para todos os dispositivos. Esse método depende da propriedade gsm.version.baseband para retornar as informações corretas da versão. Isso não é preciso para alguns dispositivos CDMA, e a versão retornada aqui pode não corresponder à versão informada pelo fastboot e pode não retornar a versão do rádio CDMA. Resumindo, esse método só informa a versão correta se a propriedade gsm.version.baseband for a mesma que a versão retornada por fastboot getvar version-baseband.

Retorna
String a versão da banda de base String ou null se não for possível determinar (o dispositivo não tem rádio ou a string de versão não pode ser lida)

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

getBattery

public abstract Integer getBattery ()

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

Retorna
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Retorna o valor booleano da propriedade especificada.

Parâmetros
name String: o nome da propriedade

defaultValue boolean: valor padrão a ser retornado se a propriedade estiver vazia ou não existir.

Retorna
boolean true se a propriedade tiver o valor "1", "y", "yes", "on" ou "true", false se a propriedade tiver o valor "0", "n", "no", "off", "false" ou defaultValue caso contrário.

Gera
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

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

Retorna
Mapa do horário de inicialização (horário UTC em segundos desde a época) e motivo da inicialização.

Gera
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização desde o tempo especificado desde a época do dispositivo e a unidade de tempo especificada. O utcEpochTime do dispositivo atual em milissegundos pode ser obtido pelo método getDeviceDate().

Parâmetros
utcEpochTime long: o tempo do dispositivo desde a Era Unix.

timeUnit TimeUnit: a unidade de tempo TimeUnit.

Retorna
Mapa do horário de inicialização (horário UTC em segundos desde a época) e motivo da inicialização.

Gera
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

Método conveniente para receber a versão do carregador de inicialização deste dispositivo.

Tenta recuperar a versão do carregador de inicialização do estado atual do dispositivo. (ou seja, se o dispositivo estiver no modo fastboot, ele tentará recuperar a versão do fastboot)

Retorna
String a versão do carregador de inicialização String ou null se não for possível encontrá-la

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

getBuildAlias

public abstract String getBuildAlias ()

Recupera o alias da build que o dispositivo está executando no momento.

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

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

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

Recupere a variante de build do dispositivo.

Retorna
String o sabor do 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 (controladas por fabricantes de dispositivos individuais).

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

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Retorna um DeviceDescriptor 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 em cache se o dispositivo estiver alocado. Caso contrário, retorna o DeviceDescriptor atual.

Parâmetros
shortDescriptor boolean: se o descritor deve 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 a permissões.

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

Retorna
String[] Matriz de string que contém todos os arquivos em um caminho no dispositivo.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getConnection

public abstract AbstractConnection getConnection ()

Retorna a conexão associada ao dispositivo.

Retorna
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

Receba a classe do dispositivo.

Retorna
String a classe de dispositivo String.

getDeviceDate

public abstract long getDeviceDate ()

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

Retorna
long a data do dispositivo no formato de época.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

Retorna
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Retorna
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

Acessa o estado do dispositivo.

Retorna
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

Parâmetros
date Date

Retorna
long a diferença em milissegundos

Gera
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Receber o fluxo de stdout e stderr do emulador

Retorna
InputStreamSource saída do emulador

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

Retorna
long a quantidade de espaço livre em KB

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

getFastbootProductType

public abstract String getFastbootProductType ()

Método conveniente para receber o tipo de produto deste dispositivo quando ele está no modo fastboot.

Esse método só deve ser usado se o dispositivo estiver no modo fastboot. É uma variante um pouco mais segura do que o método genérico getProductType() nesse caso, porque o ITestDevice vai saber como recuperar o dispositivo no fastboot se ele estiver em um estado incorreto ou não estiver respondendo.

Retorna
String o nome do tipo de produto String ou null se não for possível determinar

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Método conveniente para receber o tipo de produto deste dispositivo quando ele está no modo fastboot.

Esse método só deve ser usado se o dispositivo estiver no modo fastboot. É uma variante um pouco mais segura do que o método genérico getProductType() nesse caso, porque o ITestDevice vai saber como recuperar o dispositivo no fastboot se ele estiver em um estado incorreto ou não estiver respondendo.

Retorna
String o nome do tipo de produto String ou null se não for possível determinar

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

Retorna
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

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

Retorna
IFileEntry o IFileEntry ou null se o arquivo no path especificado não for encontrado

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

Retorna uma referência à IDevice ddmlib associada.

Um novo IDevice pode ser alocado pelo DDMS sempre que o dispositivo é desconectado e reconectado do adb. Portanto, os chamadores não devem manter uma referência ao IDevice, porque ela pode ficar desatualizada.

Retorna
IDevice o IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Retorna o valor inteiro da propriedade especificada do dispositivo.

Parâmetros
name String: o nome da propriedade

defaultValue long: valor padrão a ser retornado se a propriedade estiver vazia ou não existir.

Retorna
long o valor da propriedade ou defaultValue se a propriedade estiver vazia, não existir ou não tiver um valor inteiro.

Gera
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Retorna
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Recebe 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 fluxo de snapshot dos dados do logcat.

Funciona em dois modos:

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

    Retorna
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    Captura um fluxo de snapshot dos últimos maxBytes dados de logcat capturados.

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

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

    Retorna
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

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

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

    Retorna
    InputStreamSource um InputStreamSource dos dados do logcat. Um fluxo vazio será retornado se não for possível capturar dados de logcat.

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

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

    Parâmetros
    date long: em milissegundos desde o formato de época de quando iniciar o snapshot até o presente. (pode ser obtido usando "date +%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.

    TODO: mover esse comportamento para IDevice.getMountPoint(String)

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

    Retorna
    String o ponto de montagem ou null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Parâmetros
    mountpoint String

    Retorna
    ITestDevice.MountPointInfo Um ERROR(/List) de MountPointInfo que contém 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 que contém as informações em "/proc/mounts"

    Gera
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

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

    Parâmetros
    partition String

    Retorna
    long a quantidade de espaço livre em KB

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

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

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

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

    Retorna
    ProcessInfo ProcessInfo do determinado processName

    Gera
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

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

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

    Retorna
    String

    Gera
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

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

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

    Retorna
    String o nome do tipo de produto String. Não será nulo

    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada ou se o tipo de produto não puder ser determinado

    getProductVariant

    public abstract String getProductVariant ()

    Método conveniente para receber a variante do produto deste dispositivo.

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

    Retorna
    String o nome da variante do produto String ou null se não for possível determinar

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

    getProperty

    public abstract String getProperty (String name)

    Recupera o valor da propriedade especificada do dispositivo.

    Parâmetros
    name String: o nome da propriedade

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Recebe o modo de recuperação atual usado no dispositivo.

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

    getSerialNumber

    public abstract String getSerialNumber ()

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

    Retorna
    String o número de série String

    getTombstones

    public abstract  getTombstones ()

    Busca e retorna a lista de lápides dos dispositivos. Requer acesso root.

    O método é de melhor esforço. Portanto, se um marcador não for extraído por qualquer motivo, ele vai ficar faltando na lista. Apenas um DeviceNotAvailableException vai encerrar o método antes do tempo.

    Retorna
    Uma lista de arquivos de lápide, vazia se não houver lápide.

    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, receba o número de série usado para rastrear o dispositivo.

    Retorna
    String

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Recebe se é necessário usar "fastboot erase" ou "fastboot format" para limpar uma partição no dispositivo.

    Retorna
    boolean true se o fastboot erase for usado ou false se o fastboot format for usado.

    isAdbRoot

    public abstract boolean isAdbRoot ()

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

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

    isAdbTcp

    public abstract boolean isAdbTcp ()

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

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

    Verificar se a plataforma no dispositivo é compatível com a enumeração de apps

    Retorna
    boolean True se a enumeração de apps for compatível. Caso contrário, false.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

    Verifique se a plataforma no dispositivo permite ignorar o bloqueio de SDK de destino baixo nas instalações de apps

    Retorna
    boolean Verdadeiro se o bloqueio de SDK de destino baixo for compatível. Caso contrário, falso.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Verifique se o debugfs está montado.

    Retorna
    boolean true se debugfs estiver ativado

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Retorna se o dispositivo está criptografado.

    Retorna
    boolean true se o dispositivo estiver criptografado.

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

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

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

    Parâmetros
    deviceFilePath String

    Retorna
    boolean

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

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

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isExecutable

    public abstract boolean isExecutable (String fullPath)

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

    Parâmetros
    fullPath String

    Retorna
    boolean

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

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

    Retorna
    boolean

    Gera
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

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

    Retorna
    boolean Verdadeiro se as permissões de tempo de execução forem compatíveis. Caso contrário, será falso.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Retorna "true" se o dispositivo estiver em TestDeviceState.FASTBOOT ou TestDeviceState.FASTBOOTD.

    Retorna
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Coleta e registra erros de ANR do dispositivo.

    Parâmetros
    logger ITestLogger: um ITestLogger para registrar os ANRs.

    Retorna
    boolean True se o registro for bem-sucedido. Caso contrário, false.

    Gera
    DeviceNotAvailableException

    logOnDevice

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

    Registre uma mensagem no logcat do dispositivo. Essa é uma chamada segura que não vai gerar uma exceção mesmo que o registro falhe.

    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 usando String.format().

    mountDebugfs

    public abstract void mountDebugfs ()

    Monte o debugfs.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

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

    Deve ser chamado depois que o dispositivo estiver totalmente inicializado/disponível

    Em circunstâncias normais, não é necessário chamar esse método explicitamente, já que as implementações realizam essas etapas automaticamente ao fazer uma reinicialização.

    Ele pode precisar ser chamado quando o dispositivo for reiniciado devido a outros eventos, por exemplo, quando um comando de atualização do fastboot for concluído.

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

    postInvocationTearDown

    public void postInvocationTearDown ()

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

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

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

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

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

    preInvocationSetup

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

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

    Parâmetros
    info IBuildInfo: o IBuildInfo do dispositivo.

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

    Gera
    com.android.tradefed.targetprep.TargetSetupError
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

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

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

    localDir File: o diretório local para extrair os arquivos

    Retorna
    boolean true se o arquivo foi extraído. false se não forem.

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

    pullDir

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

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

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

    localDir File: o diretório local para extrair os arquivos

    userId int: o ID do usuário a ser extraído

    Retorna
    boolean true se o arquivo foi extraído. false se não forem.

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

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

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

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

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

    Retorna
    File Um ERROR(/File) que contém o conteúdo do arquivo do dispositivo ou null se a cópia falhou por qualquer motivo, incluindo problemas com o sistema de arquivos do host.

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

    pullFile

    public abstract File pullFile (String remoteFilePath)

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

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

    Retorna
    File Um ERROR(/File) que contém o conteúdo do arquivo do dispositivo ou null se a cópia falhou por qualquer motivo, incluindo problemas com o sistema de arquivos do host.

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

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    Recupera um arquivo do dispositivo.

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

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

    Retorna
    boolean true se o arquivo foi recuperado. false se não forem.

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

    pullFile

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

    Recupera um arquivo do dispositivo.

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

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

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

    Retorna
    boolean true se o arquivo foi recuperado. false se não forem.

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

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

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

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

    Retorna
    String Um String que contém o conteúdo do arquivo do dispositivo ou null se a cópia falhou por qualquer motivo, incluindo problemas com o sistema de arquivos do host.

    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ário local e retornar uma referência a esse File.

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

    Retorna
    File Um ERROR(/File) que contém o conteúdo do arquivo do dispositivo ou null se a cópia falhou por qualquer motivo, incluindo problemas com o sistema de arquivos do host.

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

    pushDir

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

    Envie o conteúdo do diretório de maneira recursiva 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 para enviar a notificação push.

    Retorna
    boolean true se o envio do arquivo foi concluído. false se não forem.

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

    pushDir

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

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

    Parâmetros
    localDir File: o diretório local a ser enviado por push

    deviceFilePath String: o caminho absoluto do arquivo do destino remoto

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

    Retorna
    boolean true se o envio do arquivo foi concluído. false se não forem.

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

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

    Envie o conteúdo do diretório de maneira recursiva 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 envio do arquivo foi concluído. false se não forem.

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

    pushFile

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

    Variante de pushFile(File, String) que pode considerar opcionalmente a avaliação da 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 envio do arquivo foi concluído. false se não forem.

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

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Envie um arquivo por push 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 envio do arquivo foi concluído. false se não forem.

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

    pushFile

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

    Envie um arquivo por push 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 para enviar por push.

    Retorna
    boolean true se o envio do arquivo foi concluído. false se não forem.

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

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

    Enviar arquivo criado 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 com sucesso. false se não forem.

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

    reiniciar

    public abstract void reboot ()

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

    Bloqueia até que o dispositivo fique disponível.

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

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

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

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Reinicializa o dispositivo no modo bootloader.

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

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

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Reinicializa o dispositivo no modo fastbootd.

    Bloqueia até que o dispositivo esteja no modo fastbootd.

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

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

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

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

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

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Reinicializa o dispositivo no modo adb sideload (observe que 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 carregamento lateral.

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

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

    Reinicializa o dispositivo no modo adb sideload (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

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

    Uma alternativa a 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

    rebootUntilOnline

    public abstract void rebootUntilOnline (String reason)

    Uma alternativa a 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:

    rebootUserspace

    public abstract void rebootUserspace ()

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

    Bloqueia até que o dispositivo fique disponível.

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

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

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

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

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

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountSystemWritable

    public abstract void remountSystemWritable ()

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorReadOnly

    public abstract void remountVendorReadOnly ()

    Defina a partição do fornecedor no dispositivo como somente leitura. Pode reiniciar o dispositivo.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

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

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    runInstrumentationTests

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

    Método conveniente para realizar 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 resultados de teste

    Retorna
    boolean true se o comando de teste for concluído. false se não for concluída, mas a recuperação for bem-sucedida

    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada. Por exemplo, o comando de teste não foi concluído e a recuperação falhou.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

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

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

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

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

    listeners : os listeners de resultados do teste

    Retorna
    boolean true se o comando de teste for concluído. false se a conclusão falhou devido a uma exceção de comunicação do dispositivo, mas a recuperação foi bem-sucedida

    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada. Por exemplo, o comando de teste não foi concluído e a recuperação falhou.

    runInstrumentationTestsAsUser

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

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

    Parâmetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Retorna
    boolean

    Gera
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

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

    Parâmetros
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Retorna
    boolean

    Gera
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Define a data no dispositivo.

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

    Parâmetros
    date Date: especifique uma data específica. Se null, será usada a data do host.

    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 especificada no dispositivo. Exige que adb root seja verdadeiro.

    Parâmetros
    propKey String: a chave que será definida.

    propValue String: o valor da propriedade a ser definido.

    Retorna
    boolean Retorna True se o comando setprop for bem-sucedido. Caso contrário, retorna False.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Defina o IDeviceRecovery a ser usado neste dispositivo. Deve ser definido quando o dispositivo é alocado pela primeira vez.

    Parâmetros
    recovery IDeviceRecovery: o IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

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

    Parâmetros
    trackingSerial String

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Defina se você quer usar "fastboot erase" ou "fastboot format" para limpar uma partição no dispositivo.

    Parâmetros
    useFastbootErase boolean: true se o fastboot erase precisar ser usado ou false se o fastboot format precisar ser usado.

    startLogcat

    public abstract void startLogcat ()

    Comece 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 posteriormente usando getLogcat.

    Quando o dispositivo não estiver mais em uso, chame stopLogcat().

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

    startTradeInModeTesting

    public abstract boolean startTradeInModeTesting (int timeoutMs)

    Ativa o modo de teste de troca. O dispositivo será limpo e reinicializado.

    Parâmetros
    timeoutMs int

    Retorna
    boolean True se for bem-sucedido. Caso contrário, false.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    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 do logcat salvos no momento.

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

    stopTradeInModeTesting

    public abstract void stopTradeInModeTesting ()

    Pare de testar o modo Revenda. O dispositivo será reinicializado.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

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

    Retorna
    String o número de série do TCP ou null se o dispositivo não puder ser trocado

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Coloque o dispositivo no modo adb por 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 incrementalmente o conteúdo de um diretório de arquivos local com o dispositivo.

    Decide quais arquivos enviar por push comparando os carimbos de data/hora dos arquivos locais com os equivalentes remotos. Apenas arquivos "mais recentes" ou inexistentes serão enviados por push para o dispositivo. Assim, a sobrecarga será relativamente pequena se o conjunto de arquivos no dispositivo já estiver atualizado.

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

    Exemplo de uso: syncFiles("/tmp/files", "/sdcard") vai criar um diretório /sdcard/files se ele ainda não existir e vai 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 nesse caminho de arquivo precisam ser legíveis. Ou seja, o envio para /data/local/tmp quando o adb não é raiz vai falhar.

    Retorna
    boolean true se os arquivos foram sincronizados. false se não forem.

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

    unlockDevice

    public abstract boolean unlockDevice ()

    Desbloqueia o dispositivo se ele estiver criptografado.

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

    Retorna
    boolean true se a operação for concluída ou se o dispositivo não estiver criptografado.

    Gera
    DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
    UnsupportedOperationException se a criptografia não for compatível com o dispositivo.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Desmonte o debugfs.

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

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

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

    Retorna
    boolean true se a flag de conclusão da inicialização do dispositivo for definida dentro do tempo limite

    Gera
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

    Aguarde até que o dispositivo esteja responsivo e disponível para testes. Usa o tempo limite padrão.

    Retorna
    boolean True se o dispositivo estiver disponível, False se a recuperação estiver desativada e indisponível.

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

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

    Aguarde até que o dispositivo esteja responsivo e disponível para testes.

    Parâmetros
    waitTime long: o tempo em ms para aguardar

    Retorna
    boolean True se o dispositivo estiver disponível, False se a recuperação estiver desativada e indisponível.

    Gera
    DeviceNotAvailableException se o dispositivo ainda não responder após o tempo de espera expirar.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Espera que o dispositivo responda e esteja disponível sem considerar o caminho de recuperação.

    Parâmetros
    waitTime long

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

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

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

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

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

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Bloqueia para que o dispositivo esteja no estado "adb recovery". Isso é diferente de IDeviceRecovery.

    Parâmetros
    waitTime long: o tempo em ms para aguardar

    Retorna
    boolean true se o dispositivo for inicializado na recuperação antes do tempo expirar. false caso contrário

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Bloqueia para que o dispositivo fique no estado "adb sideload".

    Parâmetros
    waitTime long: o tempo em ms para aguardar

    Retorna
    boolean true se o dispositivo for inicializado por sideload antes do tempo expirar. false caso contrário

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

    Parâmetros
    waitTime long: o tempo em ms para aguardar

    Retorna
    boolean true se o dispositivo ficar indisponível antes do prazo. false caso contrário

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

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

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

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

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

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

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

    Parâmetros
    waitTime long: o tempo em ms para aguardar

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

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

    Aguarde até que o dispositivo responda a um comando básico do shell adb.

    Parâmetros
    waitTime long: o tempo em ms para aguardar

    Retorna
    boolean true se o dispositivo responder antes do fim de waitTime.