INativeDevice
public interface INativeDevice
com.android.tradefed.device.INativeDevice |
Fornece uma API confiável e de nível ligeiramente superior para um ddmlib IDevice
.
Resumo
Constantes | |
---|---|
int | UNKNOWN_API_LEVEL Valor padrão quando o nível da API não pode ser detectado |
Métodos públicos | |
---|---|
abstract boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) Verifique se um recurso é ou não suportado no momento, dado um nível minimamente suportado. |
abstract void | clearLogcat () Exclui todos os dados logcat acumulados. |
abstract void | deleteFile (String deviceFilePath) Método auxiliar para excluir um arquivo ou diretório no dispositivo. |
abstract boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) Método auxiliar para verificar se o dispositivo reiniciou por software comparando o system_server atual com o system_server anterior |
abstract boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Método auxiliar para verificar se o dispositivo reiniciou por software desde a hora UTC desde a época do dispositivo e seu |
abstract boolean | disableAdbRoot () Desativa o adb root. |
abstract boolean | doesFileExist (String deviceFilePath) Método auxiliar para determinar se o arquivo no dispositivo existe. |
abstract boolean | enableAdbRoot () Ativa 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) executeAdbCommand (long timeout, envMap, String... commandArgs) Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado. |
abstract CommandResult | executeFastbootCommand (long timeout, String... commandArgs) Método auxiliar que executa um comando fastboot como um comando do sistema. |
abstract CommandResult | executeFastbootCommand (String... commandArgs) Método auxiliar que executa um comando fastboot como um comando do sistema com um tempo limite padrão de 2 minutos. |
abstract CommandResult | executeLongFastbootCommand (String... commandArgs) Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema. |
abstract CommandResult | executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs) Método auxiliar que executa um comando de inicialização rápida de longa duração como um comando do sistema com variáveis de ambiente do sistema. |
abstract String | executeShellCommand (String command) Método auxiliar que executa um comando shell adb e retorna a saída como uma |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver) Executa o comando adb shell fornecido, tentando várias vezes se o comando falhar. |
abstract CommandResult | executeShellV2Command (String command) Método auxiliar que executa um comando adb shell e retorna os resultados como um |
abstract CommandResult | executeShellV2Command (String command, OutputStream pipeToOutput) Método auxiliar que executa um comando shell adb e retorna os resultados como um |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput) Método auxiliar que executa um comando adb shell e retorna os resultados como um |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando. |
abstract CommandResult | executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit) Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando. |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando. |
abstract CommandResult | executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando. |
abstract CommandResult | fastbootWipePartition (String partition) Método auxiliar que limpa uma partição do dispositivo. |
abstract int | getApiLevel () Obtenha o nível de API do dispositivo. |
abstract String | getBasebandVersion () Método de conveniência para obter a versão de banda base (rádio) deste dispositivo. |
abstract Integer | getBattery () Retorna o nível atual da bateria de um dispositivo ou Nulo se o nível da bateria estiver indisponível. |
abstract boolean | getBooleanProperty (String name, boolean defaultValue) Retorna o valor booleano da propriedade especificada. |
abstract | getBootHistory () O método auxiliar coleta o mapa do histórico de inicialização com o tempo de inicialização e o motivo da inicialização. |
abstract | getBootHistorySince (long utcEpochTime, TimeUnit timeUnit) O método auxiliar coleta o mapa do histórico de inicialização com o tempo de inicialização e o motivo da inicialização desde o tempo determinado desde a época do dispositivo e a unidade de tempo especificada. |
abstract String | getBootloaderVersion () Método de conveniência para obter a versão do carregador de inicialização deste dispositivo. |
abstract String | getBuildAlias () Recupere o alias da compilação que o dispositivo está executando no momento. |
abstract String | getBuildFlavor () Recupere o tipo de compilação para o dispositivo. |
abstract String | getBuildId () Recupere a compilação 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 liberação (controladas por fabricantes de dispositivos individuais) |
abstract DeviceDescriptor | getCachedDeviceDescriptor () Retorna um |
abstract DeviceDescriptor | getCachedDeviceDescriptor (boolean shortDescriptor) Retorna um |
abstract String[] | getChildren (String deviceFilePath) Alternativa para usar |
abstract AbstractConnection | getConnection () Retorna a conexão associada ao dispositivo. |
abstract String | getDeviceClass () Obtenha a classe do dispositivo. |
abstract long | getDeviceDate () Retorna a data do dispositivo em milissegundos desde a época. |
abstract DeviceDescriptor | getDeviceDescriptor () Retorne um |
abstract DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) Retorne um |
abstract TestDeviceState | getDeviceState () Obtenha o estado do dispositivo. |
abstract long | getDeviceTimeOffset (Date date) Helper para obter a diferença de tempo entre o dispositivo e um determinado |
abstract InputStreamSource | getEmulatorOutput () Obtenha o fluxo do emulador stdout e stderr |
abstract long | getExternalStoreFreeSpace () Método auxiliar para determinar a quantidade de espaço livre no armazenamento externo do dispositivo. |
abstract String | getFastbootProductType () Método de conveniência para obter o tipo de produto deste dispositivo quando estiver no modo de inicialização rápida. |
abstract String | getFastbootProductVariant () Método de conveniência para obter o tipo de produto deste dispositivo quando estiver no modo de inicialização rápida. |
abstract String | getFastbootSerialNumber () Retorna o número de série do modo fastboot. |
abstract String | getFastbootVariable (String variableName) Recupere o valor da variável fastboot fornecida do dispositivo. |
abstract IFileEntry | getFileEntry (String path) Recupere uma referência a um arquivo remoto no dispositivo. |
abstract IDevice | getIDevice () Retorna uma referência ao ddmlib |
abstract long | getIntProperty (String name, long defaultValue) Retorna o valor inteiro da propriedade fornecida do dispositivo. |
abstract long | getLastExpectedRebootTimeMillis () Retorna a última vez que as APIs Tradefed dispararam uma reinicialização em milissegundos desde EPOCH conforme retornado por |
abstract int | getLaunchApiLevel () Obtenha o primeiro nível de API lançado do dispositivo. |
abstract InputStreamSource | getLogcat () Obtém um fluxo de instantâneo dos dados logcat. |
abstract InputStreamSource | getLogcat (int maxBytes) Obtém um fluxo instantâneo dos últimos |
abstract InputStreamSource | getLogcatDump () Obtenha um despejo do logcat atual para o dispositivo. |
abstract InputStreamSource | getLogcatSince (long date) Obtém um fluxo instantâneo de dados 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 |
abstract | getMountPointInfo () Retorna uma versão analisada das informações em /proc/mounts no dispositivo |
abstract long | getPartitionFreeSpace (String partition) Método auxiliar para determinar a quantidade de espaço livre na partição do dispositivo. |
abstract ProcessInfo | getProcessByName (String processName) O método auxiliar executa o comando "pidof" e "stat" e retorna o objeto |
abstract String | getProcessPid (String process) Retorna o pid do serviço ou null se algo deu errado. |
abstract String | getProductType () Método de conveniência para obter o tipo de produto deste dispositivo. |
abstract String | getProductVariant () Método de conveniência para obter a variante do produto deste dispositivo. |
abstract String | getProperty (String name) Recupere o valor da propriedade fornecido do dispositivo. |
abstract ITestDevice.RecoveryMode | getRecoveryMode () Obtenha o modo de recuperação atual usado para o dispositivo. |
abstract String | getSerialNumber () Método de conveniência para obter o número de série deste dispositivo. |
abstract | getTombstones () 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 |
abstract boolean | getUseFastbootErase () Obtenha se deseja usar o apagamento de inicialização rápida ou o formato de inicialização rápida para limpar uma partição no dispositivo. |
abstract boolean | isAdbRoot () |
abstract boolean | isAdbTcp () |
abstract boolean | isAppEnumerationSupported () Verifique se a plataforma no dispositivo oferece suporte à enumeração de aplicativos |
abstract boolean | isBypassLowTargetSdkBlockSupported () Verifique se a plataforma no dispositivo oferece suporte para ignorar o bloqueio de alvo baixo do SDK nas instalações do aplicativo |
abstract boolean | isDeviceEncrypted () Retorna se o dispositivo estiver criptografado. |
abstract boolean | isDirectory (String deviceFilePath) Retorna True se o caminho no dispositivo for um diretório, false caso contrário. |
abstract boolean | isEncryptionSupported () Retorna se a criptografia for suportada no dispositivo. |
abstract boolean | isExecutable (String fullPath) Retorna True se o caminho do arquivo no dispositivo for um arquivo executável, caso contrário, false. |
abstract boolean | isHeadless () Retorna true se o dispositivo for headless (sem tela), false caso contrário. |
abstract boolean | isRuntimePermissionSupported () Verifique se a plataforma no dispositivo oferece suporte à concessão de permissão de tempo de execução |
abstract boolean | isStateBootloaderOrFastbootd () Retorna verdadeiro se o dispositivo estiver em |
abstract boolean | logAnrs ( ITestLogger logger) Coleta e registra ANRs do dispositivo. |
abstract void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Registre uma mensagem no logcat do dispositivo. |
abstract void | nonBlockingReboot () Emite um comando para reinicializar o dispositivo e retorna quando o comando é concluído e quando o dispositivo não está mais visível para o adb. |
abstract void | postBootSetup () Execute as instruções para configurar o dispositivo para testá-lo após cada inicialização. |
default void | postInvocationTearDown () Este método está obsoleto. Em vez disso, use |
abstract void | postInvocationTearDown (Throwable invocationException) Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a conclusão da chamada. |
default void | preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes) Etapas extras para configuração necessária específica do dispositivo que serão executadas no dispositivo antes do fluxo de invocação. |
abstract boolean | pullDir (String deviceFilePath, File localDir) Puxe recursivamente o conteúdo do diretório do dispositivo. |
abstract File | pullFile (String remoteFilePath, int userId) Recupera um arquivo do dispositivo, armazena-o em um |
abstract File | pullFile (String remoteFilePath) Recupera um arquivo do dispositivo, armazena-o em um |
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 |
abstract boolean | pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories) Empurre recursivamente o conteúdo do diretório para o dispositivo enquanto exclui alguns diretórios que são filtrados. |
abstract boolean | pushDir (File localDir, String deviceFilePath) Empurre recursivamente o conteúdo do diretório para o dispositivo. |
abstract boolean | pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded) Variante de |
abstract boolean | pushFile (File localFile, String deviceFilePath) Empurre um arquivo para o dispositivo. |
abstract boolean | pushString (String contents, String deviceFilePath) Enviar arquivo criado a partir de uma string para o dispositivo |
abstract void | reboot () Reinicializa o dispositivo no modo adb. |
abstract void | reboot (String reason) Reinicializa o dispositivo no modo adb com um determinado |
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 adb. |
abstract void | rebootIntoSideload (boolean autoReboot) Reinicializa o dispositivo no modo adb sideload (observe que este é um modo especial em recuperação) Bloqueia até que o dispositivo entre no modo sideload |
abstract void | rebootIntoSideload () Reinicializa o dispositivo no modo adb sideload (observe que este é um modo especial em recuperação) Bloqueia até que o dispositivo entre no modo sideload |
abstract void | rebootUntilOnline () Uma alternativa para |
abstract void | rebootUntilOnline (String reason) Uma alternativa para |
abstract void | rebootUserspace () Reinicializa apenas a parte do espaço do usuário do dispositivo. |
abstract void | rebootUserspaceUntilOnline () Uma alternativa para |
abstract void | remountSystemReadOnly () Torne a partição do sistema no dispositivo somente leitura. |
abstract void | remountSystemWritable () Torne a partição do sistema no dispositivo gravável. |
abstract void | remountVendorReadOnly () Torne a partição do fornecedor no dispositivo somente leitura. |
abstract void | remountVendorWritable () Torne a partição do fornecedor no dispositivo gravável. |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Método de conveniência para executar |
abstract boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Executa testes de instrumentação e fornece recuperação de dispositivos. |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) Igual |
abstract boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) O mesmo que |
abstract void | setDate (Date date) Define a data no dispositivo Nota: definir a data no dispositivo requer root |
abstract void | setOptions ( TestDeviceOptions options) Defina |
abstract boolean | setProperty (String propKey, String propValue) Define o valor da propriedade fornecido no dispositivo. |
abstract void | setRecovery ( IDeviceRecovery recovery) Defina o |
abstract void | setRecoveryMode ( ITestDevice.RecoveryMode mode) Defina o modo de recuperação atual a ser usado para o dispositivo. |
abstract void | setUseFastbootErase (boolean useFastbootErase) Defina se deseja usar o apagamento de inicialização rápida ou o formato de inicialização rápida para limpar uma partição no dispositivo. |
abstract void | startLogcat () Comece a capturar a saída logcat do dispositivo em segundo plano. |
abstract void | stopEmulatorOutput () Feche e exclua a saída do emulador. |
abstract void | stopLogcat () Pare de capturar a saída do logcat do dispositivo e descarte os dados do logcat salvos no momento. |
abstract String | switchToAdbTcp () Mude o dispositivo para o modo adb-over-tcp. |
abstract boolean | switchToAdbUsb () Mude o dispositivo para o modo adb sobre usb. |
abstract boolean | syncFiles (File localFileDir, String deviceFilePath) Sincroniza incrementalmente o conteúdo de um diretório de arquivo local com o dispositivo. |
abstract boolean | unlockDevice () Desbloqueia o dispositivo se ele estiver em um estado criptografado. |
abstract boolean | waitForBootComplete (long timeOut) Bloqueia até que o sinalizador de inicialização completa do dispositivo seja definido. |
abstract boolean | waitForDeviceAvailable () Aguarda até que o dispositivo seja responsivo e esteja disponível para teste. |
abstract boolean | waitForDeviceAvailable (long waitTime) Aguarda até que o dispositivo seja responsivo e esteja disponível para teste. |
abstract boolean | waitForDeviceAvailableInRecoverPath (long waitTime) Aguarda até que o dispositivo esteja responsivo e disponível sem considerar o caminho de recuperação. |
abstract void | waitForDeviceBootloader () Bloqueia até que o dispositivo fique visível via fastboot. |
abstract boolean | waitForDeviceInRecovery (long waitTime) Blocos para o dispositivo estar no estado 'adb recovery' (observe que isso é diferente de |
abstract boolean | waitForDeviceInSideload (long waitTime) Blocos para o dispositivo estar no estado 'adb sideload' |
abstract boolean | waitForDeviceNotAvailable (long waitTime) Blocos para o dispositivo não estarem disponíveis, ou seja, ausentes 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) Aguarda que o dispositivo responda a um comando shell adb básico. |
Constantes
UNKNOWN_API_LEVEL
public static final int UNKNOWN_API_LEVEL
Valor padrão quando o nível da API não pode ser detectado
Valor constante: -1 (0xffffffff)
Métodos públicos
checkApiLevelAgainstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Verifique se um recurso é ou não suportado no momento, dado um nível minimamente suportado. Este método leva em consideração recursos ainda não lançados, antes que o nível da API seja elevado.
Parâmetros | |
---|---|
strictMinLevel | int : O nível mínimo possível estrito que suporta o recurso. |
devoluções | |
---|---|
boolean | Verdadeiro se o nível for compatível. Falso caso contrário. |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
clearLogcat
public abstract void clearLogcat ()
Exclui todos os dados logcat acumulados.
Isso é útil para casos em que você deseja garantirITestDevice#getLogcat()
retorne apenas dados de log produzidos após um determinado ponto (como após o flash de uma nova compilação de dispositivo etc.). deletarArquivo
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. |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
dispositivoSoftRestarted
public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Método auxiliar para verificar se o dispositivo reiniciou por software comparando o system_server atual com o system_server anterior ProcessInfo
. Use getProcessByName(String)
para obter ProcessInfo
.
Parâmetros | |
---|---|
prevSystemServerProcess | ProcessInfo : o processo system_server anterior ProcessInfo . |
devoluções | |
---|---|
boolean | true se o dispositivo for reiniciado por software |
lances | |
---|---|
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 reiniciou por software desde a hora UTC desde a época do dispositivo e seu ERROR(/TimeUnit)
. Soft-Restart refere-se a system_server reiniciado fora de uma reinicialização forçada do dispositivo (por exemplo: reinicialização solicitada). O dispositivo atual utcEpochTime em Millisecond pode ser obtido pelo método getDeviceDate()
.
Parâmetros | |
---|---|
utcEpochTime | long : o tempo do dispositivo em segundos desde a época. |
timeUnit | TimeUnit : a unidade de tempo TimeUnit para o utcEpochTime fornecido. |
devoluções | |
---|---|
boolean | true se o dispositivo for reiniciado por software |
lances | |
---|---|
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 adb root pode fazer com que o dispositivo se desconecte do adb. Este método será bloqueado até que o dispositivo esteja disponível.devoluções | |
---|---|
boolean | true se for bem-sucedido. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
doesFileExist
public abstract boolean doesFileExist (String deviceFilePath)
Método auxiliar para determinar se o arquivo no dispositivo existe.
Parâmetros | |
---|---|
deviceFilePath | String : o caminho absoluto do arquivo no dispositivo a ser verificado |
devoluções | |
---|---|
boolean | true se o arquivo existir, false caso contrário. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
enableAdbRoot
public abstract boolean enableAdbRoot ()
Ativa adb root. Se a configuração "enable-root" for "false", registrará uma mensagem e retornará sem habilitar o root.
Habilitar adb root pode fazer com que o dispositivo se desconecte do adb. Este método será bloqueado até que o dispositivo esteja disponível.devoluções | |
---|---|
boolean | true se for bem-sucedido. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeAdbCommand
public abstract String executeAdbCommand (long timeout, String... commandArgs)
Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.
executeShellCommand(String)
deve ser usado sempre que possível, pois esse método fornece melhor detecção de falha e desempenho.
Parâmetros | |
---|---|
timeout | long : o tempo em milissegundos antes que o dispositivo seja considerado sem resposta, 0L para nenhum tempo limite |
commandArgs | String : o comando adb e os argumentos a serem executados |
devoluções | |
---|---|
String | o stdout do comando. null se o comando falhou ao executar. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeAdbCommand
public abstract String executeAdbCommand (String... commandArgs)
Método auxiliar que executa um comando adb como um comando do sistema.
executeShellCommand(String)
deve ser usado sempre que possível, pois esse método fornece melhor detecção de falha e desempenho.Parâmetros | |
---|---|
commandArgs | String : o comando adb e os argumentos a serem executados |
devoluções | |
---|---|
String | o stdout do comando. null se o comando falhou ao executar. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeAdbCommand
public abstract String executeAdbCommand (long timeout,envMap, String... commandArgs)
Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.
executeShellCommand(String)
deve ser usado sempre que possível, pois esse método fornece melhor detecção de falha e desempenho.
Parâmetros | |
---|---|
timeout | long : o tempo em milissegundos antes que o dispositivo seja considerado sem resposta, 0L para nenhum tempo limite |
envMap | |
commandArgs | String : o comando adb e os argumentos a serem executados |
devoluções | |
---|---|
String | o stdout do comando. null se o comando falhou ao executar. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeFastbootCommand
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
Método auxiliar que executa um comando fastboot como um comando do sistema.
Espera-se que seja usado quando o dispositivo já estiver no modo de inicialização rápida.Parâmetros | |
---|---|
timeout | long : o tempo em milissegundos antes do comando expirar |
commandArgs | String : o comando fastboot e os argumentos a serem executados |
devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeFastbootCommand
public abstract CommandResult executeFastbootCommand (String... commandArgs)
Método auxiliar que executa um comando fastboot como um comando do sistema com um tempo limite padrão de 2 minutos.
Espera-se que seja usado quando o dispositivo já estiver no modo de inicialização rápida.
Parâmetros | |
---|---|
commandArgs | String : o comando fastboot e os argumentos a serem executados |
devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
lances | |
---|---|
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 aexecuteFastbootCommand(String)
exceto que usa um tempo limite maior.Parâmetros | |
---|---|
commandArgs | String : o comando fastboot e os argumentos a serem executados |
devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
Método auxiliar que executa um comando de inicialização rápida de longa duração como um comando do sistema com variáveis de ambiente do sistema.
Idêntico a executeFastbootCommand(String)
exceto que usa um tempo limite maior.
Parâmetros | |
---|---|
envVarMap | |
commandArgs | String : o comando fastboot e os argumentos a serem executados |
devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellCommand
public abstract String executeShellCommand (String command)
Método auxiliar que executa um comando shell adb e retorna a saída como uma String
.
Parâmetros | |
---|---|
command | String : o comando adb shell a ser executado |
devoluções | |
---|---|
String | a saída do shell |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command | String : o comando adb shell a ser executado |
receiver | IShellOutputReceiver : o IShellOutputReceiver para o qual direcionar a saída do shell. |
maxTimeToOutputShellResponse | long : a quantidade máxima de tempo durante a qual o comando pode não gerar nenhuma resposta; unidade conforme especificado em timeUnit |
timeUnit | TimeUnit : unidade para maxTimeToOutputShellResponse |
retryAttempts | int : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se retryAttempts for executada sem sucesso. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command | String : o comando adb shell a ser executado |
receiver | IShellOutputReceiver : o IShellOutputReceiver para o qual direcionar a saída do shell. |
maxTimeoutForCommand | long : o tempo limite máximo para o comando ser concluído; unidade conforme especificado em timeUnit |
maxTimeToOutputShellResponse | long : a quantidade máxima de tempo durante a qual o comando pode não gerar nenhuma resposta; unidade conforme especificado em timeUnit |
timeUnit | TimeUnit : unidade para maxTimeToOutputShellResponse |
retryAttempts | int : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se retryAttempts for executada sem sucesso. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver)
Executa o comando adb shell fornecido, tentando várias vezes se o comando falhar.
Uma forma mais simples deexecuteShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
com valores padrão.Parâmetros | |
---|---|
command | String : o comando adb shell a ser executado |
receiver | IShellOutputReceiver : o IShellOutputReceiver para o qual direcionar a saída do shell. |
lances | |
---|---|
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 adb shell e retorna os resultados como um CommandResult
preenchido corretamente com a saída de status do comando, stdout e stderr.
Parâmetros | |
---|---|
command | String : O comando que deve ser executado. |
devoluções | |
---|---|
CommandResult | O resultado em CommandResult . |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
Método auxiliar que executa um comando shell adb e retorna os resultados como um CommandResult
preenchido corretamente com a saída de status do comando e stderr. stdout é direcionado para o fluxo especificado.
Parâmetros | |
---|---|
command | String : O comando que deve ser executado. |
pipeToOutput | OutputStream : ERROR(/OutputStream) onde a saída std será redirecionada, ou null. |
devoluções | |
---|---|
CommandResult | O resultado em CommandResult . |
lances | |
---|---|
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 adb shell e retorna os resultados como um CommandResult
preenchido corretamente com a saída de status do comando, stdout e stderr.
Parâmetros | |
---|---|
command | String : O comando que deve ser executado. |
pipeAsInput | File : Um ERROR(/File) que será canalizado como entrada para o comando ou nulo. |
devoluções | |
---|---|
CommandResult | O resultado em CommandResult . |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command | String : o comando adb shell a ser executado |
maxTimeoutForCommand | long : o tempo limite máximo para o comando ser concluído; unidade conforme especificado em timeUnit |
timeUnit | TimeUnit : unidade para maxTimeToOutputShellResponse |
retryAttempts | int : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se retryAttempts for executada sem sucesso. |
devoluções | |
---|---|
CommandResult |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
Veja também:
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command | String : o comando adb shell a ser executado |
maxTimeoutForCommand | long : o tempo limite máximo para o comando ser concluído; unidade conforme especificado em timeUnit |
timeUnit | TimeUnit : unidade para maxTimeToOutputShellResponse |
devoluções | |
---|---|
CommandResult |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
Veja também:
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command | String : o comando adb shell a ser executado |
pipeAsInput | File : Um ERROR(/File) que será canalizado como entrada para o comando ou nulo. |
pipeToOutput | OutputStream : ERROR(/OutputStream) onde a saída std será redirecionada, ou null. |
maxTimeoutForCommand | long : o tempo limite máximo para o comando ser concluído; unidade conforme especificado em timeUnit |
timeUnit | TimeUnit : unidade para maxTimeToOutputShellResponse |
retryAttempts | int : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se retryAttempts for executada sem sucesso. |
devoluções | |
---|---|
CommandResult |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
Veja também:
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command | String : o comando adb shell a ser executado |
pipeAsInput | File : Um ERROR(/File) que será canalizado como entrada para o comando ou nulo. |
pipeToOutput | OutputStream : ERROR(/OutputStream) onde a saída std será redirecionada, ou null. |
pipeToError | OutputStream : ERROR(/OutputStream) onde o erro std será redirecionado, ou nulo. |
maxTimeoutForCommand | long : o tempo limite máximo para o comando ser concluído; unidade conforme especificado em timeUnit |
timeUnit | TimeUnit : unidade para maxTimeToOutputShellResponse |
retryAttempts | int : o número máximo de vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se retryAttempts for executada sem sucesso. |
devoluções | |
---|---|
CommandResult |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
Veja também:
fastbootWipePartition
public abstract CommandResult fastbootWipePartition (String partition)
Método auxiliar que limpa uma partição do dispositivo.
SegetUseFastbootErase()
for true
, o fastboot erase será usado para limpar a partição. O dispositivo deve então criar um sistema de arquivos na próxima vez que o dispositivo for inicializado. Caso contrário, o formato fastboot é usado, o que criará um novo sistema de arquivos no dispositivo. Espera-se que seja usado quando o dispositivo já estiver no modo de inicialização rápida.Parâmetros | |
---|---|
partition | String : a partição a ser limpa |
devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getApiLevel
public abstract int getApiLevel ()
Obtenha o nível de API do dispositivo. O padrão é UNKNOWN_API_LEVEL
.
devoluções | |
---|---|
int | um número inteiro indicando o nível de API do dispositivo |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBasebandVersion
public abstract String getBasebandVersion ()
Método de conveniência para obter a versão de banda base (rádio) deste dispositivo. Obter a versão do rádio é específico do dispositivo, portanto, pode não retornar as informações corretas para todos os dispositivos. Este método depende da propriedade gsm.version.baseband para retornar as informações de versão corretas. Isso não é preciso para alguns dispositivos CDMA e a versão retornada aqui pode não corresponder à versão relatada pelo fastboot e pode não retornar a versão para o rádio CDMA. TL;DR este método relata apenas a versão precisa se a propriedade gsm.version.baseband for a mesma que a versão retornada por fastboot getvar version-baseband
.
devoluções | |
---|---|
String | a versão da banda base String ou null se não puder ser determinada (o dispositivo não tem rádio ou a string da versão não pode ser lida) |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getBattery
public abstract Integer getBattery ()
Retorna o nível atual da bateria de um dispositivo ou Nulo se o nível da bateria estiver indisponível.
devoluções | |
---|---|
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. |
devoluções | |
---|---|
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. |
lances | |
---|---|
DeviceNotAvailableException |
getBootHistory
public abstractgetBootHistory ()
O método auxiliar coleta o mapa do histórico de inicialização com o tempo de inicialização e o motivo da inicialização.
devoluções | |
---|---|
Mapa do tempo de inicialização (horário UTC em segundos desde a época) e motivo da inicialização |
lances | |
---|---|
DeviceNotAvailableException |
getBootHistoryDesde
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
O método auxiliar coleta o mapa do histórico de inicialização com o tempo de inicialização e o motivo da inicialização desde o tempo determinado desde a época do dispositivo e a unidade de tempo especificada. O utcEpochTime do dispositivo atual em milissegundos pode ser obtido pelo método getDeviceDate()
.
Parâmetros | |
---|---|
utcEpochTime | long : o tempo do dispositivo desde a Epoch. |
timeUnit | TimeUnit : a unidade de tempo TimeUnit . |
devoluções | |
---|---|
Mapa do tempo de inicialização (horário UTC em segundos desde a época) e motivo da inicialização |
lances | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public abstract String getBootloaderVersion ()
Método de conveniência para obter a versão do carregador de inicialização deste dispositivo.
Tentará recuperar a versão do bootloader do estado atual do dispositivo. (ou seja, se o dispositivo estiver no modo fastboot, ele tentará recuperar a versão do fastboot)devoluções | |
---|---|
String | a versão do bootloader String ou null se não puder ser encontrado |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getBuildAlias
public abstract String getBuildAlias ()
Recupere o alias da compilação que o dispositivo está executando no momento.
O alias de compilação geralmente é uma string mais legível do que o id de compilação (normalmente um número para compilações do Nexus). Por exemplo, a versão final do Android 4.2 tem o alias de compilação JDQ39 e o ID de compilação 573038
devoluções | |
---|---|
String | o alias de compilação ou retornar ao ID de compilação se não puder ser recuperado |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildFlavor
public abstract String getBuildFlavor ()
Recupere o tipo de compilação para o dispositivo.
devoluções | |
---|---|
String | o tipo de compilação ou nulo se não puder ser recuperado |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
Recupere a compilação que o dispositivo está executando no momento.
devoluções | |
---|---|
String | o ID de compilação ou IBuildInfo#UNKNOWN_BUILD_ID se não puder ser recuperado |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildSigningKeys
public abstract String getBuildSigningKeys ()
Retorna o tipo de chave usado para assinar a imagem do dispositivo
Normalmente, os dispositivos Android podem ser assinados com chaves de teste (como no AOSP) ou chaves de liberação (controladas por fabricantes de dispositivos individuais)
devoluções | |
---|---|
String | A chave de assinatura, se encontrada, null caso contrário. |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
Retorna um DeviceDescriptor
armazenado em cache se o dispositivo estiver alocado, caso contrário, retorna o DeviceDescriptor
atual.
devoluções | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Retorna um DeviceDescriptor
armazenado em cache se o dispositivo estiver alocado, caso contrário, retorna o DeviceDescriptor
atual.
Parâmetros | |
---|---|
shortDescriptor | boolean : Limita ou não o descritor a informações mínimas |
devoluções | |
---|---|
DeviceDescriptor |
getChildren
public abstract String[] getChildren (String deviceFilePath)
Alternativa para usar IFileEntry
que às vezes não funciona devido a permissões.
Parâmetros | |
---|---|
deviceFilePath | String : é o caminho no dispositivo onde fazer a pesquisa |
devoluções | |
---|---|
String[] | Matriz de string contendo todo o arquivo em um caminho no dispositivo. |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getConnection
public abstract AbstractConnection getConnection ()
Retorna a conexão associada ao dispositivo.
devoluções | |
---|---|
AbstractConnection |
getDeviceClass
public abstract String getDeviceClass ()
Obtenha a classe do dispositivo.
devoluções | |
---|---|
String | a classe de dispositivo String . |
getDeviceDate
public abstract long getDeviceDate ()
Retorna a data do dispositivo em milissegundos desde a época.
devoluções | |
---|---|
long | a data do dispositivo em formato de época. |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
Retorne um DeviceDescriptor
das informações do dispositivo para obter informações sobre ele sem passar o objeto do dispositivo real.
devoluções | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Retorne um DeviceDescriptor
das informações do dispositivo para obter informações sobre ele sem passar o objeto do dispositivo real.
Parâmetros | |
---|---|
shortDescriptor | boolean : Limita ou não o descritor a informações mínimas |
devoluções | |
---|---|
DeviceDescriptor |
getDeviceState
public abstract TestDeviceState getDeviceState ()
Obtenha o estado do dispositivo.
devoluções | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
Helper para obter a diferença de tempo entre o dispositivo e um determinado ERROR(/Date)
. Use o tempo Epoch internamente.
Parâmetros | |
---|---|
date | Date |
devoluções | |
---|---|
long | a diferença em milissegundos |
lances | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
Obtenha o fluxo do emulador stdout e stderr
devoluções | |
---|---|
InputStreamSource | saída do emulador |
getExternalStoreFreeSpace
public abstract long getExternalStoreFreeSpace ()
Método auxiliar para determinar a quantidade de espaço livre no armazenamento externo do dispositivo.
devoluções | |
---|---|
long | a quantidade de espaço livre em KB |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getFastbootProductType
public abstract String getFastbootProductType ()
Método de conveniência para obter o tipo de produto deste dispositivo quando estiver no modo de inicialização rápida.
Este método só deve ser usado se o dispositivo estiver em inicialização rápida. É uma variante um pouco mais segura do que o método genéricogetProductType()
neste caso, porque o ITestDevice saberá recuperar o dispositivo no fastboot se o dispositivo estiver em estado incorreto ou não responder.devoluções | |
---|---|
String | o nome do tipo de produto String ou null se não puder ser determinado |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
Método de conveniência para obter o tipo de produto deste dispositivo quando estiver no modo de inicialização rápida.
Este método só deve ser usado se o dispositivo estiver em inicialização rápida. É uma variante um pouco mais segura do que o método genéricogetProductType()
neste caso, porque o ITestDevice saberá recuperar o dispositivo no fastboot se o dispositivo estiver em estado incorreto ou não responder.devoluções | |
---|---|
String | o nome do tipo de produto String ou null se não puder ser determinado |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getFastbootSerialNumber
public abstract String getFastbootSerialNumber ()
Retorna o número de série do modo fastboot.
devoluções | |
---|---|
String |
getFastbootVariable
public abstract String getFastbootVariable (String variableName)
Recupere o valor da variável fastboot fornecida do dispositivo.
Parâmetros | |
---|---|
variableName | String : o nome da variável |
devoluções | |
---|---|
String | o valor da propriedade ou null se não existir |
lances | |
---|---|
| UnsupportedOperationException |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Recupere 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 um caminho relativo a '/'. (isto é, ambas as sintaxes "/system" e "system" são suportadas) |
devoluções | |
---|---|
IFileEntry | o IFileEntry ou null se o arquivo em determinado path não puder ser encontrado |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getIDevice
public abstract IDevice getIDevice ()
Retorna uma referência ao ddmlib IDevice
associado.
IDevice
pode ser alocado pelo DDMS cada vez que o dispositivo desconecta e reconecta do adb. Portanto, os chamadores não devem manter uma referência ao IDevice
, porque essa referência pode se tornar obsoleta.devoluções | |
---|---|
IDevice | o IDevice |
getIntProperty
public abstract long getIntProperty (String name, long defaultValue)
Retorna o valor inteiro da propriedade fornecida do dispositivo.
Parâmetros | |
---|---|
name | String : o nome da propriedade |
defaultValue | long : valor padrão a ser retornado se a propriedade estiver vazia ou não existir. |
devoluções | |
---|---|
long | o valor da propriedade ou defaultValue se a propriedade estiver vazia, não existir ou não tiver um valor inteiro. |
lances | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
Retorna a última vez que as APIs Tradefed dispararam uma reinicialização em milissegundos desde EPOCH conforme retornado por System.currentTimeMillis()
.
devoluções | |
---|---|
long |
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
Obtenha o primeiro nível de API lançado do dispositivo. O padrão é UNKNOWN_API_LEVEL
.
devoluções | |
---|---|
int | um número inteiro indicando o primeiro nível de API lançado do dispositivo |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
Obtém um fluxo de instantâneo dos dados logcat.
Funciona em dois modos:
TestDeviceOptions.getMaxLogcatDataSize()
bytes do conteúdo atual da captura de logcat em segundo planodevoluções | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
Obtém um fluxo instantâneo dos últimos maxBytes
de dados logcat capturados.
Útil para casos em que você deseja capturar instantâneos frequentes dos dados logcat capturados sem incorrer na penalidade de espaço em disco potencialmente grande de obter o instantâneo getLogcat()
inteiro.
Parâmetros | |
---|---|
maxBytes | int : a quantidade máxima de dados a serem retornados. Deve ser uma quantia que caiba confortavelmente na memória |
devoluções | |
---|---|
InputStreamSource |
getLogcatDump
public abstract InputStreamSource getLogcatDump ()
Obtenha um despejo do logcat atual para o dispositivo. Ao contrário de getLogcat()
, esse método sempre retornará um dump estático do logcat.
Tem a desvantagem de que nada será retornado se o dispositivo não estiver acessível.
devoluções | |
---|---|
InputStreamSource | um InputStreamSource dos dados logcat. Um fluxo vazio é retornado se falhar ao capturar dados logcat. |
getLogcatSince
public abstract InputStreamSource getLogcatSince (long date)
Obtém um fluxo instantâneo de dados logcat capturados a partir da data fornecida. A hora no dispositivo deve ser usada getDeviceDate()
.
Parâmetros | |
---|---|
date | long : em milissegundos desde o formato de época de quando iniciar o instantâneo até o presente. (pode ser obtido usando 'date +%s') |
devoluções | |
---|---|
InputStreamSource |
getMountPoint
public abstract String getMountPoint (String mountName)
Retorna um ponto de montagem.
Consulta o dispositivo diretamente se as informações em cache noIDevice
não estiverem disponíveis. TODO: mova este comportamento para IDevice#getMountPoint(String)
Parâmetros | |
---|---|
mountName | String : o nome do ponto de montagem |
devoluções | |
---|---|
String | o ponto de montagem ou null |
Veja também:
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 |
devoluções | |
---|---|
ITestDevice.MountPointInfo | Um ERROR(/List) de MountPointInfo contendo as informações em "/proc/mounts" |
lances | |
---|---|
DeviceNotAvailableException |
Veja também:
getMountPointInfo
public abstractgetMountPointInfo ()
Retorna uma versão analisada das informações em /proc/mounts no dispositivo
devoluções | |
---|---|
Um ERROR(/List) de MountPointInfo contendo as informações em "/proc/mounts" |
lances | |
---|---|
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 |
devoluções | |
---|---|
long | a quantidade de espaço livre em KB |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getProcessByName
public abstract ProcessInfo getProcessByName (String processName)
O método auxiliar executa o comando "pidof" e "stat" e retorna o objeto ProcessInfo
com PID e hora de início do processo fornecido.
Parâmetros | |
---|---|
processName | String : o nome do processo String. |
devoluções | |
---|---|
ProcessInfo | ProcessInfo de determinado processName |
lances | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
Retorna o pid do serviço ou null se algo deu errado.
Parâmetros | |
---|---|
process | String : O nome do processo String. |
devoluções | |
---|---|
String |
lances | |
---|---|
DeviceNotAvailableException |
getProductType
public abstract String getProductType ()
Método de conveniência para obter o tipo de produto deste dispositivo.
Este método funcionará se o dispositivo estiver no modo adb ou fastboot.devoluções | |
---|---|
String | o nome do tipo de produto String . não será nulo |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada, ou se o tipo de produto não puder ser determinado |
getProductVariant
public abstract String getProductVariant ()
Método de conveniência para obter a variante do produto deste dispositivo.
Este método funcionará se o dispositivo estiver no modo adb ou fastboot.devoluções | |
---|---|
String | o nome da variante do produto String ou null se não puder ser determinado |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
obterPropriedade
public abstract String getProperty (String name)
Recupere o valor da propriedade fornecido do dispositivo.
Parâmetros | |
---|---|
name | String : o nome da propriedade |
devoluções | |
---|---|
String | o valor da propriedade ou null se não existir |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getRecoveryMode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
Obtenha o modo de recuperação atual usado para o dispositivo.
devoluções | |
---|---|
ITestDevice.RecoveryMode | o modo de recuperação atual usado para o dispositivo. |
getSerialNumber
public abstract String getSerialNumber ()
Método de conveniência para obter o número de série deste dispositivo.
devoluções | |
---|---|
String | o número de série String |
getTombstones
public abstractgetTombstones ()
Busca e retorna a lista de lápides dos dispositivos. Requer raiz.
O método é o melhor esforço, portanto, se uma lápide não for extraída por qualquer motivo, ela estará ausente da lista. Somente uma DeviceNotAvailableException
encerrará o método antecipadamente.
devoluções | |
---|---|
Uma lista de arquivos de tombstone, vazio se não houver tombstone. |
lances | |
---|---|
DeviceNotAvailableException |
Veja 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
devoluções | |
---|---|
long |
getUseFastbootErase
public abstract boolean getUseFastbootErase ()
Obtenha se deseja usar o apagamento de inicialização rápida ou o formato de inicialização rápida para limpar uma partição no dispositivo.
devoluções | |
---|---|
boolean | true se fastboot erase for usado ou false se o formato fastboot for usado. |
Veja também:
isAdbRoot
public abstract boolean isAdbRoot ()
devoluções | |
---|---|
boolean | true se o dispositivo atualmente tiver adb root, false caso contrário. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
isAdbTcp
public abstract boolean isAdbTcp ()
devoluções | |
---|---|
boolean | true se o dispositivo estiver conectado a adb-over-tcp, false caso contrário. |
isAppEnumerationSupported
public abstract boolean isAppEnumerationSupported ()
Verifique se a plataforma no dispositivo oferece suporte à enumeração de aplicativos
devoluções | |
---|---|
boolean | Verdadeiro se a enumeração do aplicativo for suportada, falso caso contrário |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public abstract boolean isBypassLowTargetSdkBlockSupported ()
Verifique se a plataforma no dispositivo oferece suporte para ignorar o bloqueio de alvo baixo do SDK nas instalações do aplicativo
devoluções | |
---|---|
boolean | Verdadeiro se o bloqueio do SDK de destino baixo for suportado, falso caso contrário |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isDeviceEncrypted
public abstract boolean isDeviceEncrypted ()
Retorna se o dispositivo estiver criptografado.
devoluções | |
---|---|
boolean | true se o dispositivo estiver criptografado. |
lances | |
---|---|
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, false caso contrário.
Parâmetros | |
---|---|
deviceFilePath | String |
devoluções | |
---|---|
boolean |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isEncryptionSupported
public abstract boolean isEncryptionSupported ()
Retorna se a criptografia for suportada no dispositivo.
devoluções | |
---|---|
boolean | true se o dispositivo oferecer suporte à criptografia. |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
éexecutável
public abstract boolean isExecutable (String fullPath)
Retorna True se o caminho do arquivo no dispositivo for um arquivo executável, caso contrário, false.
Parâmetros | |
---|---|
fullPath | String |
devoluções | |
---|---|
boolean |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
é sem cabeça
public abstract boolean isHeadless ()
Retorna true se o dispositivo for headless (sem tela), false caso contrário.
devoluções | |
---|---|
boolean |
lances | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public abstract boolean isRuntimePermissionSupported ()
Verifique se a plataforma no dispositivo oferece suporte à concessão de permissão de tempo de execução
devoluções | |
---|---|
boolean | Verdadeiro se a permissão de tempo de execução for suportada, caso contrário, falso. |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public abstract boolean isStateBootloaderOrFastbootd ()
Retorna verdadeiro se o dispositivo estiver em TestDeviceState#FASTBOOT
ou TestDeviceState.FASTBOOTD
.
devoluções | |
---|---|
boolean |
logAnrs
public abstract boolean logAnrs (ITestLogger logger)
Coleta e registra ANRs do dispositivo.
Parâmetros | |
---|---|
logger | ITestLogger : um ITestLogger para registrar os ANRs. |
devoluções | |
---|---|
boolean | True se o registro foi bem-sucedido, false caso contrário. |
lances | |
---|---|
DeviceNotAvailableException |
logOnDevice
public abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Registre uma mensagem no logcat do dispositivo. Esta é uma chamada segura que não será lançada mesmo se o log falhar.
Parâmetros | |
---|---|
tag | String : A tag sob a qual registramos nossa mensagem no logcat. |
level | Log.LogLevel : o nível de depuração da mensagem no logcat. |
format | String : O formato da mensagem. |
args | Object : os argumentos a serem substituídos via String.format(). |
nonBlockingReboot
public abstract void nonBlockingReboot ()
Emite um comando para reinicializar o dispositivo e retorna quando o comando é concluído e quando o dispositivo não está mais visível para o adb.
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postBootSetup
public abstract void postBootSetup ()
Execute as instruções para configurar o dispositivo para testá-lo após cada inicialização.
Deve ser chamado depois que o dispositivo estiver totalmente inicializado/disponível Em circunstâncias normais, esse método não precisa ser chamado explicitamente, pois as implementações devem executar essas etapas automaticamente ao executar uma reinicialização. Onde pode precisar ser chamado é quando o dispositivo reinicia devido a outros eventos (por exemplo, quando um comando de atualização do fastboot foi concluído)lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
postInvocationTearDown
public void postInvocationTearDown ()
Este método está obsoleto.
Em vez disso, use postInvocationTearDown(Throwable)
.
Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a conclusão da chamada.
postInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a conclusão da chamada.
Parâmetros | |
---|---|
invocationException | Throwable : se houver, a exceção final levantada pela falha de invocação. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Etapas extras para configuração necessária específica do dispositivo que serão executadas no dispositivo antes do fluxo de invocação.
Parâmetros | |
---|---|
info | IBuildInfo : O IBuildInfo do dispositivo. |
attributes | MultiMap : Os atributos armazenados no contexto de invocação |
lances | |
---|---|
| com.android.tradefed.targetprep.TargetSetupError |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException | |
TargetSetupError |
pullDir
public abstract boolean pullDir (String deviceFilePath, File localDir)
Puxe 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 onde os arquivos serão puxados |
devoluções | |
---|---|
boolean | true se o arquivo foi puxado com sucesso. false caso contrário. |
lances | |
---|---|
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-o 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 para extrair |
devoluções | |
---|---|
File | Um ERROR(/File) contendo 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) |
lances | |
---|---|
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-o em um ERROR(/File)
temporário local e retorna esse File
.
Parâmetros | |
---|---|
remoteFilePath | String : o caminho absoluto para o arquivo no dispositivo. |
devoluções | |
---|---|
File | Um ERROR(/File) contendo 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) |
lances | |
---|---|
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. |
devoluções | |
---|---|
boolean | true se o arquivo foi recuperado com sucesso. false caso contrário. |
lances | |
---|---|
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 para extrair |
devoluções | |
---|---|
boolean | true se o arquivo foi recuperado com sucesso. false caso contrário. |
lances | |
---|---|
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. |
devoluções | |
---|---|
String | Uma String contendo 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) |
lances | |
---|---|
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 de armazenamento externo do dispositivo |
devoluções | |
---|---|
File | Um ERROR(/File) contendo 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) |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
Empurre recursivamente o conteúdo do diretório para o dispositivo enquanto exclui alguns diretórios que são filtrados.
Parâmetros | |
---|---|
localDir | File : o diretório local para enviar |
deviceFilePath | String : o caminho absoluto do arquivo do destino remoto |
excludedDirectories |
devoluções | |
---|---|
boolean | true se o arquivo foi enviado com sucesso. false caso contrário. |
lances | |
---|---|
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)
Empurre recursivamente o conteúdo do diretório para o dispositivo.
Parâmetros | |
---|---|
localDir | File : o diretório local para enviar |
deviceFilePath | String : o caminho absoluto do arquivo do destino remoto |
devoluções | |
---|---|
boolean | true se o arquivo foi enviado com êxito. false caso contrário. |
lances | |
---|---|
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 opcionalmente pode considerar a avaliação da necessidade do provedor de conteúdo.
Parâmetros | |
---|---|
localFile | File : o arquivo local a ser enviado |
deviceFilePath | String : o caminho absoluto do arquivo de destino remoto |
evaluateContentProviderNeeded | boolean : se deve verificar se precisamos do provedor de conteúdo |
devoluções | |
---|---|
boolean | true se o arquivo foi enviado com êxito. false caso contrário. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath)
Empurre um arquivo para o dispositivo. Por padrão, usando um provedor de conteúdo.
Parâmetros | |
---|---|
localFile | File : o arquivo local a ser enviado |
deviceFilePath | String : o caminho absoluto do arquivo de destino remoto |
devoluções | |
---|---|
boolean | true se o arquivo foi enviado com êxito. false caso contrário. |
lances | |
---|---|
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 a partir de uma string para o dispositivo
Parâmetros | |
---|---|
contents | String : o conteúdo do arquivo para push |
deviceFilePath | String : o caminho absoluto do arquivo de destino remoto |
devoluções | |
---|---|
boolean | true se a string foi enviada com sucesso. false caso contrário. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
reinício
public abstract void reboot ()
Reinicializa o dispositivo no modo adb.
Bloqueia até que o dispositivo fique disponível.lances | |
---|---|
DeviceNotAvailableException | se o dispositivo não estiver disponível após a reinicialização |
reinício
public abstract void reboot (String reason)
Reinicializa o dispositivo no modo adb com um determinado reason
para persistir 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. |
lances | |
---|---|
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 bootloader.lances | |
---|---|
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.
lances | |
---|---|
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 adb.
Bloqueia até que o dispositivo entre em recuperaçãolances | |
---|---|
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 este é um modo especial em recuperação)
Bloqueia até que o dispositivo entre no modo sideload
Parâmetros | |
---|---|
autoReboot | boolean : se deve reiniciar automaticamente o dispositivo após o sideload |
lances | |
---|---|
DeviceNotAvailableException | se o dispositivo não estiver em sideload após a reinicialização |
rebootIntoSideload
public abstract void rebootIntoSideload ()
Reinicializa o dispositivo no modo adb sideload (observe que este é um modo especial em recuperação)
Bloqueia até que o dispositivo entre no modo sideload
lances | |
---|---|
DeviceNotAvailableException | se o dispositivo não estiver em sideload após a reinicialização |
rebootUntilOnline
public abstract void rebootUntilOnline ()
Uma alternativa para reboot()
que bloqueia apenas até que o dispositivo esteja online, ou seja, visível para adb.
lances | |
---|---|
DeviceNotAvailableException | se o dispositivo não estiver disponível após a reinicialização |
rebootUntilOnline
public abstract void rebootUntilOnline (String reason)
Uma alternativa para reboot()
que bloqueia apenas até que o dispositivo esteja online, ou seja, visível para adb.
Parâmetros | |
---|---|
reason | String : um motivo para essa reinicialização ou null se nenhum motivo for especificado. |
lances | |
---|---|
DeviceNotAvailableException | se o dispositivo não estiver disponível após a reinicialização |
Veja 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á atualmente em desenvolvimento ativo, use-a por sua conta e risco.
lances | |
---|---|
DeviceNotAvailableException | se o dispositivo não estiver disponível após a reinicialização |
rebootUserspaceUntilOnline
public abstract void rebootUserspaceUntilOnline ()
Uma alternativa para rebootUserspace()
()} que bloqueia apenas até que o dispositivo esteja online, ou seja, visível para adb.
lances | |
---|---|
DeviceNotAvailableException | se o dispositivo não estiver disponível após a reinicialização |
remountSystemReadOnly
public abstract void remountSystemReadOnly ()
Torne a partição do sistema no dispositivo somente leitura. Pode reiniciar o dispositivo.
lances | |
---|---|
| 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.
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountVendorReadOnly
public abstract void remountVendorReadOnly ()
Torne a partição do fornecedor no dispositivo somente leitura. Pode reiniciar o dispositivo.
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remontarVendorWritable
public abstract void remountVendorWritable ()
Torne a partição do fornecedor no dispositivo gravável. Pode reiniciar o dispositivo.
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Método de conveniência para executar ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
com um ou mais ouvintes passados como parâmetros.
Parâmetros | |
---|---|
runner | IRemoteAndroidTestRunner : o IRemoteAndroidTestRunner que executa os testes |
listeners | ITestLifeCycleReceiver : o(s) ouvinte(s) do resultado do teste |
devoluções | |
---|---|
boolean | true se o comando de teste for concluído. false se falhou ao concluir, mas a recuperação foi bem-sucedida |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. ou seja, o comando de teste falhou ao concluir e a recuperação falhou. |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Executa testes de instrumentação e fornece recuperação de dispositivos.
Se a conexão com o dispositivo for perdida antes da conclusão da execução do teste e a recuperação for bem-sucedida, todos os ouvintes serão informados de testRunFailed e "false" será retornado. O comando de teste não será executado novamente. Cabe aos chamadores tentar novamente, se necessário.
Se a conexão com o dispositivo for perdida antes da conclusão da execução do teste e a recuperação falhar, todos os ouvintes serão informados sobre testRunFailed e DeviceNotAvailableException será lançada.
Parâmetros | |
---|---|
runner | IRemoteAndroidTestRunner : o IRemoteAndroidTestRunner que executa os testes |
listeners |
devoluções | |
---|---|
boolean | true se o comando de teste for concluído. false se falhou ao concluir devido à exceção de comunicação do dispositivo, mas a recuperação foi bem-sucedida |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. ou seja, o comando de teste falhou ao concluir e a recuperação falhou. |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Igual 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 determinado usuário.
Parâmetros | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
devoluções | |
---|---|
boolean |
lances | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
O mesmo que ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
mas executa o teste para um determinado usuário.
Parâmetros | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
devoluções | |
---|---|
boolean |
lances | |
---|---|
DeviceNotAvailableException |
data marcada
public abstract void setDate (Date date)
Define a data no dispositivo
Nota: definir a data no dispositivo requer root
Parâmetros | |
---|---|
date | Date : especifique uma data específica; usará a data do host se null |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
definiropções
public abstract void setOptions (TestDeviceOptions options)
Defina TestDeviceOptions
para o dispositivo
Parâmetros | |
---|---|
options | TestDeviceOptions |
definirPropriedade
public abstract boolean setProperty (String propKey, String propValue)
Define o valor da propriedade fornecido no dispositivo. Requer adb root é verdadeiro.
Parâmetros | |
---|---|
propKey | String : a chave de destino a ser definida. |
propValue | String : O valor da propriedade a ser definido. |
devoluções | |
---|---|
boolean | retorna True se o comando setprop foi bem-sucedido, False caso contrário. |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRecovery
public abstract void setRecovery (IDeviceRecovery recovery)
Defina o IDeviceRecovery
a ser usado para este 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)
Defina o modo de recuperação atual a ser usado para o dispositivo.
Usado para controlar qual método de recuperação usar quando um problema de comunicação do dispositivo for encontrado. Recomenda-se usar este método apenas com moderação quando necessário (por exemplo, quando o framework está inoperante, etc.Parâmetros | |
---|---|
mode | ITestDevice.RecoveryMode : se o modo 'recuperar somente online' deve estar ativado ou não. |
setUseFastbootErase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Defina se deseja usar o apagamento de inicialização rápida ou o formato de inicialização rápida para limpar uma partição no dispositivo.
Parâmetros | |
---|---|
useFastbootErase | boolean : true se o fastboot erase deve ser usado ou false se o formato fastboot deve ser usado. |
Veja também:
startLogcat
public abstract void startLogcat ()
Comece a capturar a saída logcat do dispositivo em segundo plano.
Não terá efeito se a saída logcat já estiver sendo capturada. Os dados podem ser recuperados posteriormente via getLogcat. Quando o dispositivo não estiver mais em uso,stopLogcat()
deve ser chamado. startLogcat()
e stopLogcat()
normalmente não precisam ser chamados dentro de um contexto de invocação do TF, pois a estrutura do TF iniciará e interromperá o logcat.stopEmulatorOutput
public abstract void stopEmulatorOutput ()
Feche e exclua a saída do emulador.
stopLogcat
public abstract void stopLogcat ()
Pare de capturar a saída do logcat do dispositivo e descarte os dados do logcat salvos no momento.
Não terá efeito se a saída logcat não estiver sendo capturada.switchToAdbTcp
public abstract String switchToAdbTcp ()
Mude o dispositivo para o modo adb-over-tcp.
devoluções | |
---|---|
String | o número de série tcp ou null se o dispositivo não puder ser trocado |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
switchToAdbUsb
public abstract boolean switchToAdbUsb ()
Mude o dispositivo para o modo adb sobre usb.
devoluções | |
---|---|
boolean | true se a troca foi bem-sucedida, false caso contrário. |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
arquivos de sincronização
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
Sincroniza incrementalmente o conteúdo de um diretório de arquivo local com o dispositivo.
Decide quais arquivos enviar por push comparando timestamps de arquivos locais com seus equivalentes remotos. Somente arquivos 'mais recentes' ou inexistentes serão enviados para o dispositivo. Portanto, a sobrecarga deve ser relativamente pequena se o conjunto de arquivos no dispositivo já estiver atualizado. Arquivos ocultos (com nomes começando com ".") serão ignorados. Exemplo de uso: syncFiles("/tmp/files", "/sdcard") criará um diretório /sdcard/files se ainda não existir e enviará recursivamente o conteúdo de /tmp/files para /sdcard/files.Parâmetros | |
---|---|
localFileDir | File : o diretório de arquivo local contendo arquivos para push recursivamente. |
deviceFilePath | String : a raiz do caminho absoluto do arquivo de destino remoto. Todos os diretórios nesse caminho de arquivo devem ser legíveis. ou seja, empurrar para /data/local/tmp quando adb não é root falhará |
devoluções | |
---|---|
boolean | true se os arquivos foram sincronizados com êxito. false caso contrário. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
dispositivo de desbloqueio
public abstract boolean unlockDevice ()
Desbloqueia o dispositivo se ele estiver em um estado criptografado.
Este método pode reiniciar a estrutura, mas não chamarápostBootSetup()
. Portanto, o dispositivo pode não estar totalmente pronto para ser testado quando esse método retornar.devoluções | |
---|---|
boolean | true se for bem-sucedido ou se o dispositivo não estiver criptografado. |
lances | |
---|---|
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. |
waitForBootComplete
public abstract boolean waitForBootComplete (long timeOut)
Bloqueia até que o sinalizador de inicialização completa do dispositivo seja definido.
Parâmetros | |
---|---|
timeOut | long : tempo em msegs para aguardar o sinalizador ser definido |
devoluções | |
---|---|
boolean | verdadeiro se o sinalizador de inicialização completa do dispositivo estiver definido dentro do tempo limite |
lances | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
waitForDeviceDisponível
public abstract boolean waitForDeviceAvailable ()
Aguarda até que o dispositivo seja responsivo e esteja disponível para teste. Usa o tempo limite padrão.
devoluções | |
---|---|
boolean | Verdadeiro se o dispositivo estiver disponível, Falso se a recuperação estiver desativada e indisponível. |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
waitForDeviceDisponível
public abstract boolean waitForDeviceAvailable (long waitTime)
Aguarda até que o dispositivo seja responsivo e esteja disponível para teste.
Parâmetros | |
---|---|
waitTime | long : o tempo em ms para esperar |
devoluções | |
---|---|
boolean | Verdadeiro se o dispositivo estiver disponível, Falso se a recuperação estiver desativada e indisponível. |
lances | |
---|---|
DeviceNotAvailableException | se o dispositivo ainda não responder após o waitTime expirar. |
waitForDeviceAvailableInRecoverPath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Aguarda até que o dispositivo esteja responsivo e disponível sem considerar o caminho de recuperação.
Parâmetros | |
---|---|
waitTime | long |
devoluções | |
---|---|
boolean | Verdadeiro se o dispositivo estiver disponível, Falso se não estiver disponível. |
lances | |
---|---|
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. Use o tempo limite padrão.
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
waitForDeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
Blocos para o dispositivo estar no estado 'adb recovery' (observe que isso é diferente de IDeviceRecovery
).
Parâmetros | |
---|---|
waitTime | long : o tempo em ms para esperar |
devoluções | |
---|---|
boolean | true se o dispositivo for inicializado em recuperação antes do tempo expirar. false caso contrário |
waitForDeviceInSideload
public abstract boolean waitForDeviceInSideload (long waitTime)
Blocos para o dispositivo estar no estado 'adb sideload'
Parâmetros | |
---|---|
waitTime | long : o tempo em ms para esperar |
devoluções | |
---|---|
boolean | true se o dispositivo for inicializado em sideload antes do tempo expirar. false caso contrário |
waitForDeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Blocos para o dispositivo não estarem disponíveis, ou seja, ausentes do adb
Parâmetros | |
---|---|
waitTime | long : o tempo em ms para esperar |
devoluções | |
---|---|
boolean | true se o dispositivo ficar indisponível antes do tempo expirar. 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
Observe que o dispositivo pode não responder necessariamente aos comandos após a conclusão. Em vez disso, usewaitForDeviceAvailable()
.lances | |
---|---|
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.
Observe que o dispositivo pode não responder necessariamente aos comandos após a conclusão. Em vez disso, usewaitForDeviceAvailable()
.Parâmetros | |
---|---|
waitTime | long : o tempo em ms para esperar |
lances | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
waitForDeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
Aguarda que o dispositivo responda a um comando shell adb básico.
Parâmetros | |
---|---|
waitTime | long : o tempo em ms para esperar |
devoluções | |
---|---|
boolean | true se o dispositivo se tornar responsivo antes de waitTime terminar. |