Dispositivo INativo
public interface INativeDevice
com.android.tradefed.device.INativeDevice |
Fornece uma API confiável e de nível ligeiramente superior para um IDevice
ddmlib.
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 é atualmente suportado ou não, dado um nível minimamente suportado. |
abstract void | clearLogcat () Exclui quaisquer dados acumulados do logcat. |
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 foi reiniciado suavemente, comparando o system_server atual com o system_server |
abstract boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Método auxiliar para verificar se o dispositivo foi reiniciado suavemente desde o horário UTC desde a época do dispositivo e seu |
abstract boolean | disableAdbRoot () Desativa a raiz do adb. |
abstract boolean | doesFileExist (String deviceFilePath) Método auxiliar para determinar se o arquivo no dispositivo existe. |
abstract boolean | enableAdbRoot () Ativa a raiz do adb. |
abstract String | executeAdbCommand (long timeout, String... commandArgs) Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado. |
abstract String | executeAdbCommand (String... commandArgs) Método auxiliar que executa um comando adb como um comando do sistema. |
abstract String | executeAdbCommand (long timeout, envMap, String... commandArgs) 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 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 shell adb e retorna a saída como |
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 novamente várias vezes se o comando falhar. |
abstract CommandResult | executeShellV2Command (String command) Método auxiliar que executa um comando shell adb 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 shell adb 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 não estiver disponível. |
abstract boolean | getBooleanProperty (String name, boolean defaultValue) Retorna o valor booleano da propriedade fornecida. |
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 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 conveniente para obter a versão do bootloader deste dispositivo. |
abstract String | getBuildAlias () Recupere o alias do build que o dispositivo está executando atualmente. |
abstract String | getBuildFlavor () Recupere o tipo de compilação para o dispositivo. |
abstract String | getBuildId () Recupere a compilação que o dispositivo está executando atualmente. |
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 ao uso |
abstract AbstractConnection | getConnection () Retorna a conexão associada ao dispositivo. |
abstract String | getDeviceClass () Obtenha a classe do dispositivo. |
abstract long | getDeviceDate () Retorne 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) Auxiliar para obter a diferença de horário 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 conveniente para obter o tipo de produto deste dispositivo quando estiver no modo fastboot. |
abstract String | getFastbootProductVariant () Método conveniente para obter o tipo de produto deste dispositivo quando estiver no modo fastboot. |
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 fornecido do dispositivo. |
abstract IFileEntry | getFileEntry (String path) Recuperar 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 acionaram uma reinicialização em milissegundos desde EPOCH, conforme retornado por |
abstract int | getLaunchApiLevel () Obtenha o primeiro nível de API lançado no dispositivo. |
abstract InputStreamSource | getLogcat () Captura um fluxo de instantâneo dos dados do logcat. |
abstract InputStreamSource | getLogcat (int maxBytes) Captura um fluxo de instantâneo dos últimos |
abstract InputStreamSource | getLogcatDump () Obtenha um dump do logcat atual do dispositivo. |
abstract InputStreamSource | getLogcatSince (long date) Captura um fluxo instantâneo de dados do logcat capturados a partir da data fornecida. |
abstract String | getMountPoint (String mountName) Retorna um ponto de montagem. |
abstract ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) Retorna um |
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 |
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) Recuperar 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 () Busque e retorne 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 () Defina se deseja usar o apagamento fastboot ou o formato fastboot para limpar uma partição no dispositivo. |
abstract boolean | isAdbRoot () |
abstract boolean | isAdbTcp () |
abstract boolean | isAppEnumerationSupported () Verifique se a plataforma no dispositivo suporta enumeração de aplicativos |
abstract boolean | isBypassLowTargetSdkBlockSupported () Verifique se a plataforma no dispositivo suporta ignorar o bloqueio SDK de destino baixo em instalações de aplicativos |
abstract boolean | isDebugfsMounted () Verifique se o debugfs está montado. |
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; caso contrário, false. |
abstract boolean | isEncryptionSupported () Retorna se a criptografia for compatível com o dispositivo. |
abstract boolean | isExecutable (String fullPath) Retorna True se o caminho do arquivo no dispositivo for um arquivo executável; caso contrário, retorna false. |
abstract boolean | isHeadless () Retorne verdadeiro se o dispositivo estiver sem cabeça (sem tela), caso contrário, retorne falso. |
abstract boolean | isRuntimePermissionSupported () Verifique se a plataforma no dispositivo suporta a 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 | mountDebugfs () Monte debugfs. |
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 () Siga as instruções para configurar o dispositivo para teste após cada inicialização. |
default void | postInvocationTearDown () Este método está obsoleto. Use |
abstract void | postInvocationTearDown (Throwable invocationException) Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a invocação. |
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) Extraia 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 local temporário |
abstract File | pullFile (String remoteFilePath) Recupera um arquivo do dispositivo, armazena-o em um local temporário |
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 local temporário |
abstract boolean | pushDir (File localDir, String deviceFilePath, excludedDirectories) 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 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) Envie 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 () Reinicia o dispositivo no modo adb. |
abstract void | reboot (String reason) Reinicia o dispositivo no modo adb com um determinado |
abstract void | rebootIntoBootloader () Reinicia o dispositivo no modo bootloader. |
abstract void | rebootIntoFastbootd () Reinicia o dispositivo no modo fastbootd. |
abstract void | rebootIntoRecovery () Reinicia o dispositivo no modo de recuperação adb. |
abstract void | rebootIntoSideload (boolean autoReboot) Reinicia o dispositivo no modo adb sideload (observe que este é um modo especial de recuperação) Bloqueia até que o dispositivo entre no modo sideload |
abstract void | rebootIntoSideload () Reinicia o dispositivo no modo adb sideload (observe que este é um modo especial de 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 () Reinicia apenas 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) O mesmo que |
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 pelo dispositivo. |
abstract void | setUseFastbootErase (boolean useFastbootErase) Defina se deseja usar o apagamento fastboot ou o formato fastboot para limpar uma partição no dispositivo. |
abstract void | startLogcat () Comece a capturar a saída do logcat do dispositivo em segundo plano. |
abstract void | stopEmulatorOutput () Feche e exclua a saída do emulador. |
abstract void | stopLogcat () Pare de capturar a saída do logcat do dispositivo e descarte os dados do logcat salvos atualmente. |
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 arquivos local com o dispositivo. |
abstract boolean | unlockDevice () Desbloqueia o dispositivo se ele estiver em estado criptografado. |
abstract void | unmountDebugfs () Desmonte debugfs. |
abstract boolean | waitForBootComplete (long timeOut) Bloqueia até que o sinalizador de inicialização completa do dispositivo seja definido. |
abstract boolean | waitForDeviceAvailable () Aguarda que o dispositivo responda e esteja disponível para teste. |
abstract boolean | waitForDeviceAvailable (long waitTime) Aguarda que o dispositivo responda e esteja disponível para teste. |
abstract boolean | waitForDeviceAvailableInRecoverPath (long waitTime) Aguarda que o dispositivo responda e esteja 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 no adb |
abstract void | waitForDeviceOnline () Bloqueia até que o dispositivo fique visível via adb. |
abstract void | waitForDeviceOnline (long waitTime) Bloqueia até que o dispositivo fique visível via adb. |
abstract boolean | waitForDeviceShell (long waitTime) Aguarda 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 constante: -1 (0xffffffff)
Métodos públicos
checkApiLevelAgainstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Verifique se um recurso é atualmente suportado ou não, dado um nível minimamente suportado. Este método leva em consideração recursos ainda não lançados, antes do nível da API ser aumentado.
Parâmetros | |
---|---|
strictMinLevel | int : O nível mínimo possível estrito que suporta o recurso. |
Devoluções | |
---|---|
boolean | Verdadeiro se o nível for compatível. Caso contrário, falso. |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
limparLogcat
public abstract void clearLogcat ()
Exclui quaisquer dados acumulados do logcat.
Isso é útil para casos em que você deseja garantirITestDevice#getLogcat()
retorne apenas dados de log produzidos após um determinado ponto (como após atualizar uma nova construção de dispositivo, etc.). excluir arquivo
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. |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
dispositivoSoftRestarted
public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Método auxiliar para verificar se o dispositivo foi reiniciado suavemente, comparando o system_server atual com o system_server ProcessInfo
anterior. 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 suavemente |
Lança | |
---|---|
RuntimeException | se o dispositivo tiver um motivo de inicialização anormal |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
dispositivoSoftRestartedSince
public abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Método auxiliar para verificar se o dispositivo foi reiniciado suavemente desde o horário 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 Milliseccond 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 suavemente |
Lança | |
---|---|
RuntimeException | se o dispositivo tiver um motivo de inicialização anormal |
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
desativarAdbRoot
public abstract boolean disableAdbRoot ()
Desativa a raiz do adb.
Desativar o 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. |
Lança | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
fazFileExist
public abstract boolean doesFileExist (String deviceFilePath)
Método auxiliar para determinar se o arquivo 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. |
Lança | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
ativarAdbRoot
public abstract boolean enableAdbRoot ()
Ativa a raiz do adb. Se a configuração "enable-root" for "false", registrará uma mensagem e retornará sem habilitar o root.
Ativar o 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. |
Lança | |
---|---|
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 falhas e desempenho.
Parâmetros | |
---|---|
timeout | long : o tempo em milissegundos antes que o dispositivo seja considerado sem resposta, 0L sem 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 na execução. |
Lança | |
---|---|
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 falhas 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 na execução. |
Lança | |
---|---|
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 falhas e desempenho.
Parâmetros | |
---|---|
timeout | long : o tempo em milissegundos antes que o dispositivo seja considerado sem resposta, 0L sem 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 na execução. |
Lança | |
---|---|
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 fastboot.Parâmetros | |
---|---|
timeout | long : o tempo em milissegundos antes do comando expirar |
commandArgs | String : o comando fastboot e argumentos para executar |
Devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
Lança | |
---|---|
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 fastboot.
Parâmetros | |
---|---|
commandArgs | String : o comando fastboot e argumentos para executar |
Devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
Lança | |
---|---|
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 mais longo.Parâmetros | |
---|---|
commandArgs | String : o comando fastboot e argumentos para executar |
Devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
Lança | |
---|---|
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 que usa um tempo limite mais longo.
Parâmetros | |
---|---|
envVarMap | |
commandArgs | String : o comando fastboot e argumentos para executar |
Devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
Lança | |
---|---|
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 String
.
Parâmetros | |
---|---|
command | String : o comando adb shell a ser executado |
Devoluções | |
---|---|
String | a saída do shell |
Lança | |
---|---|
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 : o tempo máximo durante o 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 forem executados sem sucesso. |
Lança | |
---|---|
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 a conclusão do comando; unidade conforme especificado em timeUnit |
maxTimeToOutputShellResponse | long : o tempo máximo durante o 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 forem executados sem sucesso. |
Lança | |
---|---|
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 novamente 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. |
Lança | |
---|---|
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 shell adb e retorna os resultados como um CommandResult
preenchido corretamente com a saída de status do comando, stdout e stderr.
Parâmetros | |
---|---|
command | String : O comando que deve ser executado. |
Devoluções | |
---|---|
CommandResult | O resultado em CommandResult . |
Lança | |
---|---|
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) para onde a saída padrão será redirecionada ou nula. |
Devoluções | |
---|---|
CommandResult | O resultado em CommandResult . |
Lança | |
---|---|
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 shell adb e retorna os resultados como um CommandResult
preenchido corretamente com a saída de status do comando, stdout e stderr.
Parâmetros | |
---|---|
command | String : O comando que 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 . |
Lança | |
---|---|
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 a conclusão do comando; 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 forem executados sem sucesso. |
Devoluções | |
---|---|
CommandResult |
Lança | |
---|---|
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 a conclusão do comando; unidade conforme especificado em timeUnit |
timeUnit | TimeUnit : unidade para maxTimeToOutputShellResponse |
Devoluções | |
---|---|
CommandResult |
Lança | |
---|---|
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) para onde 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 vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se retryAttempts forem executados sem sucesso. |
Devoluções | |
---|---|
CommandResult |
Lança | |
---|---|
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) para onde a saída padrão será redirecionada ou nula. |
pipeToError | OutputStream : ERROR(/OutputStream) para onde 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 vezes para repetir o comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será lançada se retryAttempts forem executados sem sucesso. |
Devoluções | |
---|---|
CommandResult |
Lança | |
---|---|
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
, então fastboot erase será usado para limpar a partição. O dispositivo deverá então criar um sistema de arquivos na próxima vez que for inicializado. Caso contrário, será usado o formato fastboot, que criará um novo sistema de arquivos no dispositivo. Espera-se que seja usado quando o dispositivo já estiver no modo fastboot.Parâmetros | |
---|---|
partition | String : a partição a ser limpa |
Devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
Lança | |
---|---|
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 que indica o nível de API do dispositivo |
Lança | |
---|---|
| 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. A obtenção da versão do rádio é específica do dispositivo, por isso 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 corretas da versão. Isso não é exato para alguns dispositivos CDMA e a versão retornada aqui pode não corresponder à versão relatada no fastboot e pode não retornar a versão do rádio CDMA. DR, este método relata apenas a versão precisa se a propriedade gsm.version.baseband for igual à 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) |
Lança | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
obter bateria
public abstract Integer getBattery ()
Retorna o nível atual da bateria de um dispositivo ou Nulo se o nível da bateria não estiver disponível.
Devoluções | |
---|---|
Integer |
getBooleanProperty
public abstract boolean getBooleanProperty (String name, boolean defaultValue)
Retorna o valor booleano da propriedade fornecida.
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 valor "1" , "y" , "yes" , "on" ou "true" , false se a propriedade tiver valor de "0" , "n" , "no" , "off" , "false" ou defaultValue caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException |
getBootHistory
public abstractgetBootHistory ()
O método auxiliar coleta o mapa do histórico de inicialização com o tempo 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 |
Lança | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
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 dispositivo atual utcEpochTime em milissegundos pode ser obtido pelo método getDeviceDate()
.
Parâmetros | |
---|---|
utcEpochTime | long : o tempo do dispositivo desde a Época. |
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 |
Lança | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public abstract String getBootloaderVersion ()
Método conveniente para obter a versão do bootloader 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 |
Lança | |
---|---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getBuildAlias
public abstract String getBuildAlias ()
Recupere o alias do build que o dispositivo está executando atualmente.
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 |
Lança | |
---|---|
| 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 |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
Recupere a compilação que o dispositivo está executando atualmente.
Devoluções | |
---|---|
String | o ID de compilação ou IBuildInfo#UNKNOWN_BUILD_ID se não puder ser recuperado |
Lança | |
---|---|
| 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, nula caso contrário. |
Lança | |
---|---|
| 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 : limitar ou não o descritor às informações mínimas |
Devoluções | |
---|---|
DeviceDescriptor |
obterCrianças
public abstract String[] getChildren (String deviceFilePath)
Alternativa ao uso IFileEntry
que às vezes não funciona devido a permissões.
Parâmetros | |
---|---|
deviceFilePath | String : é o caminho no dispositivo onde fazer a busca |
Devoluções | |
---|---|
String[] | Matriz de string contendo todos os arquivos em um caminho no dispositivo. |
Lança | |
---|---|
| 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 ()
Retorne a data do dispositivo em milissegundos desde a época.
Devoluções | |
---|---|
long | a data do dispositivo no formato de época. |
Lança | |
---|---|
| 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 : limitar ou não o descritor às 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)
Auxiliar para obter a diferença de horário entre o dispositivo e um determinado ERROR(/Date)
. Use o horário da Época internamente.
Parâmetros | |
---|---|
date | Date |
Devoluções | |
---|---|
long | a diferença em milissegundos |
Lança | |
---|---|
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 |
Lança | |
---|---|
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 obter o tipo de produto deste dispositivo quando estiver no modo fastboot.
Este método só deve ser usado se o dispositivo estiver em fastboot. É uma variante um pouco mais segura do que o métodogetProductType()
genérico neste caso, porque ITestDevice saberá como 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 |
Lança | |
---|---|
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 obter o tipo de produto deste dispositivo quando estiver no modo fastboot.
Este método só deve ser usado se o dispositivo estiver em fastboot. É uma variante um pouco mais segura do que o métodogetProductType()
genérico neste caso, porque ITestDevice saberá como 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 |
Lança | |
---|---|
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 |
getFastbootVariável
public abstract String getFastbootVariable (String variableName)
Recupere o valor da variável fastboot fornecido do dispositivo.
Parâmetros | |
---|---|
variableName | String : o nome da variável |
Devoluções | |
---|---|
String | o valor da propriedade ou null se não existir |
Lança | |
---|---|
| UnsupportedOperationException |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Recuperar uma referência a um arquivo remoto no dispositivo.
Parâmetros | |
---|---|
path | String : o caminho do arquivo a ser recuperado. Pode ser um caminho absoluto ou relativo a '/'. (ou seja, a sintaxe "/system" e "system" é suportada) |
Devoluções | |
---|---|
IFileEntry | o IFileEntry ou null se o arquivo em determinado path não puder ser encontrado |
Lança | |
---|---|
| 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 se desconecta e reconecta do adb. Assim, os chamadores não devem manter uma referência ao IDevice
, porque essa referência pode ficar 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. |
Lança | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
Retorna a última vez que as APIs comerciais desencadearam uma reinicialização em milissegundos desde que a época retornada pelo System.currentTimeMillis()
.
Devoluções | |
---|---|
long |
GetLaunchApilevel
public abstract int getLaunchApiLevel ()
Obtenha o primeiro nível de API lançado do dispositivo. Padrão para UNKNOWN_API_LEVEL
.
Devoluções | |
---|---|
int | um número inteiro indicando o primeiro nível de dispositivo da API lançado |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
Pega um fluxo de instantâneos 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)
Pega um fluxo de instantâneos dos últimos maxBytes
dos dados do logcat capturados.
Útil para casos quando você deseja capturar instantâneos frequentes dos dados do 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 ser retornada. Deve ser uma quantidade que possa se encaixar confortavelmente na memória |
Devoluções | |
---|---|
InputStreamSource |
getLogcatdump
public abstract InputStreamSource getLogcatDump ()
Obtenha um despejo do logcat atual para o dispositivo. Ao contrário do getLogcat()
, esse método sempre retornará um despejo estático do logcat.
Tem a desvantagem de que nada será devolvido 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. |
getLogcats ,nce
public abstract InputStreamSource getLogcatSince (long date)
Pega um fluxo de instantâneos de dados de logcat capturados iniciando a data fornecida. O tempo no dispositivo deve ser usado getDeviceDate()
.
Parâmetros | |
---|---|
date | long : em milissegundo desde o formato de época de quando iniciar o instantâneo até o presente. (pode ser obtido usando 'data +%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 esse 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 MountPoint especificado, ou null
se esse caminho não tiver nada montado ou não aparecer em /proc /montar como um MountPoint.
Parâmetros | |
---|---|
mountpoint | String |
Devoluções | |
---|---|
ITestDevice.MountPointInfo | Um ERROR(/List) de MountPointInfo contendo as informações em "/proc/montars" |
Lança | |
---|---|
DeviceNotAvailableException |
Veja também:
getMountPointInfo
public abstractgetMountPointInfo ()
Retorna uma versão analisada das informações em /proc /montar no dispositivo
Devoluções | |
---|---|
Um ERROR(/List) de MountPointInfo contendo as informações em "/proc/montars" |
Lança | |
---|---|
DeviceNotAvailableException |
getPartitionFreespace
public abstract long getPartitionFreeSpace (String partition)
Método Helper 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 |
Lança | |
---|---|
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 Helper executa o comando "PIDOF" e "Stat" e retorna o objeto ProcessInfo
com PID e Horário de início do processo do processo fornecido.
Parâmetros | |
---|---|
processName | String : A sequência de nome do Proces. |
Devoluções | |
---|---|
ProcessInfo | ProcessInfo de determinado nome do processo |
Lança | |
---|---|
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 sequência de nome do Proces. |
Devoluções | |
---|---|
String |
Lança | |
---|---|
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 |
Lança | |
---|---|
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 |
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getProperty
public abstract String getProperty (String name)
Recuperar o valor da propriedade fornecida do dispositivo.
Parâmetros | |
---|---|
name | String : o nome da propriedade |
Devoluções | |
---|---|
String | o valor da propriedade ou null se não existir |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
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 ()
Pegue e retorne a lista de lápides dos dispositivos. Requer root.
O método é o melhor esforço, portanto, se uma lápide não for puxada por qualquer motivo, ele estará faltando na lista. Somente um DeviceNotAvailableException
encerrará o método mais cedo.
Devoluções | |
---|---|
Uma lista de arquivos da Tombstone, vazia se não houver lápide. |
Lança | |
---|---|
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 o formato de apagar ou fastboot de fastboot ou fastboot para limpar uma partição no dispositivo.
Devoluções | |
---|---|
boolean | true se a apagamento fastboot será usada 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 root adb, false caso contrário. |
Lança | |
---|---|
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 ao ADB-over-tcp, false caso contrário. |
isappenumerations suportado
public abstract boolean isAppEnumerationSupported ()
Verifique se a plataforma no dispositivo suporta a enumeração do aplicativo
Devoluções | |
---|---|
boolean | Verdadeiro se a enumeração do aplicativo for suportada, false caso contrário |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
isbypasslowtargetsdkblocksupported
public abstract boolean isBypassLowTargetSdkBlockSupported ()
Verifique se a plataforma no dispositivo suporta ignorando o bloco SDK de baixo destino nas instalações de aplicativos
Devoluções | |
---|---|
boolean | Verdadeiro se o Bloco SDK de Alvo Baixo de Alvo é suportado, FALSE, caso contrário, caso contrário |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
IsdebugfsMorted
public abstract boolean isDebugfsMounted ()
Verifique se o Debugfs está montado.
Devoluções | |
---|---|
boolean | true se Debugfs estiver montado |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
IsdeviceCrypted
public abstract boolean isDeviceEncrypted ()
Retorna se o dispositivo for criptografado.
Devoluções | |
---|---|
boolean | true se o dispositivo for criptografado. |
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
IsDirectory
public abstract boolean isDirectory (String deviceFilePath)
Retorne true se o caminho no dispositivo for um diretório, false caso contrário.
Parâmetros | |
---|---|
deviceFilePath | String |
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
ISENCRYPTIONSUPORTADO
public abstract boolean isEncryptionSupported ()
Retorna se a criptografia for suportada no dispositivo.
Devoluções | |
---|---|
boolean | true se o dispositivo suportar criptografia. |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
isExecutable
public abstract boolean isExecutable (String fullPath)
Retorna true se o caminho do arquivo no dispositivo for um arquivo executável, false caso contrário.
Parâmetros | |
---|---|
fullPath | String |
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
Isheadless
public abstract boolean isHeadless ()
Retorne true se o dispositivo estiver sem cabeça (sem tela), false caso contrário.
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
IsruntimePermissionsUpported
public abstract boolean isRuntimePermissionSupported ()
Verifique se a plataforma no dispositivo suporta a 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, falsa caso contrário. |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
isStateBootLoaderorFastBootd
public abstract boolean isStateBootloaderOrFastbootd ()
Retorna true se o dispositivo estiver no 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 | É verdade que se o registro fosse bem -sucedido, false caso contrário. |
Lança | |
---|---|
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 que o registro falhe.
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 args a serem substituídos via string.format (). |
Mountdebugfs
public abstract void mountDebugfs ()
Mount Debugfs.
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
Não -BlockingReboot
public abstract void nonBlockingReboot ()
Emite um comando para reiniciar o dispositivo e retornar no comando completo e quando o dispositivo não estiver mais visível para o ADB.
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
PostBootsetup
public abstract void postBootSetup ()
Execute instruções para configurar o dispositivo para testar isso 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 ser necessário ser chamado é quando o dispositivo é reiniciado devido a outros eventos (por exemplo, quando um comando de atualização Fastboot é concluído)Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
PostInvocationTearDown
public void postInvocationTearDown ()
Este método está preguiçoso.
Use postInvocationTearDown(Throwable)
.
Etapas extras para limpeza necessária necessária específica do dispositivo que serão executadas após a conclusão da invocação.
PostInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
Etapas extras para limpeza necessária necessária específica do dispositivo que serão executadas após a conclusão da invocação.
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á executada no dispositivo antes do fluxo de invocação.
Parâmetros | |
---|---|
info | IBuildInfo : o IBuildInfo do dispositivo. |
attributes | MultiMap : os atributos armazenados no contexto de invocação |
Lança | |
---|---|
| com.android.tradefed.targetprep.targetSetUperror |
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException | |
TargetSetupError |
Pulldir
public abstract boolean pullDir (String deviceFilePath, File localDir)
Recursivamente puxe o conteúdo do diretório do dispositivo.
Parâmetros | |
---|---|
deviceFilePath | String : o caminho do arquivo absoluto da fonte remota |
localDir | File : o diretório local para puxar arquivos |
Devoluções | |
---|---|
boolean | true se o arquivo foi puxado com sucesso. false caso contrário. |
Lança | |
---|---|
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 dispositivo Off de arquivo, o armazena em um ERROR(/File)
e retorna esse File
.
Parâmetros | |
---|---|
remoteFilePath | String : o caminho absoluto para arquivar no dispositivo. |
userId | int : o ID do usuário para puxar de |
Devoluções | |
---|---|
File | Um ERROR(/File) contendo o conteúdo do arquivo de dispositivo ou null se a cópia falhou por qualquer motivo (incluindo problemas com o sistema de arquivos host) |
Lança | |
---|---|
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 dispositivo Off de arquivo, o armazena em um ERROR(/File)
e retorna esse File
.
Parâmetros | |
---|---|
remoteFilePath | String : o caminho absoluto para arquivar no dispositivo. |
Devoluções | |
---|---|
File | Um ERROR(/File) contendo o conteúdo do arquivo de dispositivo ou null se a cópia falhou por qualquer motivo (incluindo problemas com o sistema de arquivos host) |
Lança | |
---|---|
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 dispositivo de desligamento de arquivo.
Parâmetros | |
---|---|
remoteFilePath | String : o caminho absoluto para arquivar no dispositivo. |
localFile | File : O arquivo local para armazenar o conteúdo. Se não vazio, o conteúdo será substituído. |
Devoluções | |
---|---|
boolean | true se o arquivo foi recuperado com sucesso. false caso contrário. |
Lança | |
---|---|
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 dispositivo de desligamento de arquivo.
Parâmetros | |
---|---|
remoteFilePath | String : o caminho absoluto para arquivar no dispositivo. |
localFile | File : O arquivo local para armazenar o conteúdo. Se não vazio, o conteúdo será substituído. |
userId | int : o ID do usuário para puxar de |
Devoluções | |
---|---|
boolean | true se o arquivo foi recuperado com sucesso. false caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
PULLFILECONTENTES
public abstract String pullFileContents (String remoteFilePath)
Recupera um dispositivo de desligamento de arquivo e retorna o conteúdo.
Parâmetros | |
---|---|
remoteFilePath | String : o caminho absoluto para arquivar no dispositivo. |
Devoluções | |
---|---|
String | Uma String que contém o conteúdo do arquivo de dispositivo ou null se a cópia falhou por qualquer motivo (incluindo problemas com o sistema de arquivos host) |
Lança | |
---|---|
DeviceNotAvailableException |
PullfileFileFromexternal
public abstract File pullFileFromExternal (String remoteFilePath)
Um método de conveniência para recuperar um arquivo do armazenamento externo do dispositivo, o armazena em um ERROR(/File)
e retorne uma referência a esse File
.
Parâmetros | |
---|---|
remoteFilePath | String : O caminho para arquivo no dispositivo, em relação ao ponto de montagem de armazenamento externo do dispositivo |
Devoluções | |
---|---|
File | Um ERROR(/File) contendo o conteúdo do arquivo de dispositivo ou null se a cópia falhou por qualquer motivo (incluindo problemas com o sistema de arquivos host) |
Lança | |
---|---|
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 filtrados.
Parâmetros | |
---|---|
localDir | File : o diretório local para empurrar |
deviceFilePath | String : o caminho do arquivo absoluto do destino remoto |
excludedDirectories |
Devoluções | |
---|---|
boolean | true se o arquivo foi pressionado com sucesso. false caso contrário. |
Lança | |
---|---|
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)
Empurrar recursivamente o conteúdo do diretório para o dispositivo.
Parâmetros | |
---|---|
localDir | File : o diretório local para empurrar |
deviceFilePath | String : o caminho do arquivo absoluto do destino remoto |
Devoluções | |
---|---|
boolean | true se o arquivo foi pressionado com sucesso. false caso contrário. |
Lança | |
---|---|
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 do pushFile(File, String)
que, opcionalmente, pode considerar avaliar a necessidade do provedor de conteúdo.
Parâmetros | |
---|---|
localFile | File : o arquivo local para empurrar |
deviceFilePath | String : o caminho do arquivo absoluto de destino remoto |
evaluateContentProviderNeeded | boolean : se deve verificar se precisamos do provedor de conteúdo |
Devoluções | |
---|---|
boolean | true se o arquivo foi pressionado com sucesso. false caso contrário. |
Lança | |
---|---|
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 para empurrar |
deviceFilePath | String : o caminho do arquivo absoluto de destino remoto |
Devoluções | |
---|---|
boolean | true se o arquivo foi pressionado com sucesso. false caso contrário. |
Lança | |
---|---|
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)
Push arquivo criado de uma string para dispositivo
Parâmetros | |
---|---|
contents | String : o conteúdo do arquivo para empurrar |
deviceFilePath | String : o caminho do arquivo absoluto de destino remoto |
Devoluções | |
---|---|
boolean | true se a string foi pressionada com sucesso. false caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
reinício
public abstract void reboot ()
Reinicie o dispositivo no modo Adb.
Blocos até que o dispositivo fique disponível.Lança | |
---|---|
DeviceNotAvailableException | Se o dispositivo não estiver disponível após a reinicialização |
reinício
public abstract void reboot (String reason)
Reinicie o dispositivo no modo ADB com determinada reason
a ser persistida na reinicialização.
Blocos até que o dispositivo fique disponível.
A última razão de reinicialização pode ser obtida consultando a profeta sys.boot.reason
.
Parâmetros | |
---|---|
reason | String : um motivo para esta reinicialização ou null se nenhum motivo for especificado. |
Lança | |
---|---|
DeviceNotAvailableException | Se o dispositivo não estiver disponível após a reinicialização |
REBOOTINTOBOOTLOWER
public abstract void rebootIntoBootloader ()
Reinicie o dispositivo no modo de carregador de inicialização.
Blocos até que o dispositivo esteja no modo de carregador de inicialização.Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
REBOOTINTOFASTBOOTD
public abstract void rebootIntoFastbootd ()
Reinicie o dispositivo no modo FastBootd.
Blocos até que o dispositivo esteja no modo FastBootd.
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
reinicialize -secovery
public abstract void rebootIntoRecovery ()
Reinicie o dispositivo no modo de recuperação do ADB.
Blocos até que o dispositivo entre na recuperaçãoLança | |
---|---|
DeviceNotAvailableException | Se o dispositivo não estiver disponível após a reinicialização |
Rebootintosideload
public abstract void rebootIntoSideload (boolean autoReboot)
Reinicie o dispositivo no modo ADB Sideload (observe que este é um modo especial em recuperação)
Blocks até que o dispositivo entre no modo Sideload
Parâmetros | |
---|---|
autoReboot | boolean : se deve reiniciar automaticamente o dispositivo após o Sideload |
Lança | |
---|---|
DeviceNotAvailableException | Se o dispositivo não estiver em margem depois da reinicialização |
Rebootintosideload
public abstract void rebootIntoSideload ()
Reinicie o dispositivo no modo ADB Sideload (observe que este é um modo especial em recuperação)
Blocks até que o dispositivo entre no modo Sideload
Lança | |
---|---|
DeviceNotAvailableException | Se o dispositivo não estiver em margem depois da reinicialização |
Rebootuntilonline
public abstract void rebootUntilOnline ()
Uma alternativa para reboot()
que apenas bloqueia até que o dispositivo esteja online, ou seja, visível para o ADB.
Lança | |
---|---|
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 apenas bloqueia até que o dispositivo esteja online, ou seja, visível para o ADB.
Parâmetros | |
---|---|
reason | String : um motivo para esta reinicialização ou null se nenhum motivo for especificado. |
Lança | |
---|---|
DeviceNotAvailableException | Se o dispositivo não estiver disponível após a reinicialização |
Veja também:
REBOOTUSERSPACE
public abstract void rebootUserspace ()
Reinicia apenas os usuários em parte do dispositivo.
Blocos até que o dispositivo fique disponível.
AVISO. A reinicialização do UsersPace está atualmente em desenvolvimento ativo, use -o por seu próprio risco.
Lança | |
---|---|
DeviceNotAvailableException | Se o dispositivo não estiver disponível após a reinicialização |
REBOOTUSERSPACEUNTILONLINE
public abstract void rebootUserspaceUntilOnline ()
Um alternativo para rebootUserspace()
()} que apenas bloqueia até que o dispositivo esteja online, ou seja, visível para o ADB.
Lança | |
---|---|
DeviceNotAvailableException | Se o dispositivo não estiver disponível após a reinicialização |
RemountSystemReadonly
public abstract void remountSystemReadOnly ()
Faça a partição do sistema no dispositivo somente leitura. Pode reiniciar o dispositivo.
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
RemountSystemwrity
public abstract void remountSystemWritable ()
Torne a partição do sistema no dispositivo gravável. Pode reiniciar o dispositivo.
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
RemountVendeReRadonly
public abstract void remountVendorReadOnly ()
Faça a partição do fornecedor somente leitura do dispositivo. Pode reiniciar o dispositivo.
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
RemountVendorWritable
public abstract void remountVendorWritable ()
Torne a partição do fornecedor no dispositivo gravável. Pode reiniciar o dispositivo.
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
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 (s) |
Devoluções | |
---|---|
boolean | true se o comando de teste concluído. false se falhou ao concluir, mas a recuperação foi bem -sucedida |
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. ou seja, o comando de teste falhou em 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 sobre o testRunfailed e "false" será retornado. O comando de teste não será executado. É deixado para os chamadores tentarem 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 o testRunFailed e o DeviceNotAvailableException será lançado.
Parâmetros | |
---|---|
runner | IRemoteAndroidTestRunner : o IRemoteAndroidTestRunner que executa os testes |
listeners |
Devoluções | |
---|---|
boolean | true se o comando de teste concluído. false se falhou ao concluir devido à exceção de comunicação do dispositivo, mas a recuperação foi bem -sucedida |
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. ou seja, o comando de teste falhou em concluir e a recuperação falhou. |
runinstrumentationTestsasuser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
but runs the test para o usuário fornecido.
Parâmetros | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
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 |
Lança | |
---|---|
DeviceNotAvailableException |
setDate
public abstract void setDate (Date date)
Define a data no dispositivo
Nota: A data de configuração no dispositivo requer root
Parâmetros | |
---|---|
date | Date : especifique uma data específica; usará a data do host se null |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
SETOPTIONS
public abstract void setOptions (TestDeviceOptions options)
Defina as TestDeviceOptions
para o dispositivo
Parâmetros | |
---|---|
options | TestDeviceOptions |
setProperty
public abstract boolean setProperty (String propKey, String propValue)
Define o valor da propriedade fornecida no dispositivo. Requer raiz do adb é verdadeira.
Parâmetros | |
---|---|
propKey | String : a chave direcionada para ser definida. |
propValue | String : o valor da propriedade a ser definido. |
Devoluções | |
---|---|
boolean | Retorna True se o comando setprop tiver sido bem -sucedido, false caso contrário. |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
Setrecovery
public abstract void setRecovery (IDeviceRecovery recovery)
Defina a IDeviceRecovery
a ser usada para este dispositivo. Deve ser definido quando o dispositivo for alocado pela primeira vez.
Parâmetros | |
---|---|
recovery | IDeviceRecovery : A 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 de dispositivo é encontrado. É recomendado usar apenas esse método com moderação quando necessário (por exemplo, quando a estrutura está baixa, etc.Parâmetros | |
---|---|
mode | ITestDevice.RecoveryMode : se 'recuperar até o modo online' deve estar ligado ou não. |
SetuseFastBooterase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Defina se o Fastboot apaga ou o formato Fastboot apaga para limpar uma partição no dispositivo.
Parâmetros | |
---|---|
useFastbootErase | boolean : true se a apagamento fastboot deve ser usada ou false se o formato Fastboot for 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 do logcat já estiver sendo capturada. Os dados podem ser recuperados posteriormente via getLogCat. Quando o dispositivo não está mais em uso,stopLogcat()
deve ser chamado. startLogcat()
e stopLogcat()
normalmente não precisam ser chamados quando dentro de um contexto de invocação TF, pois a estrutura do TF iniciará e interrompe 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 logcat do dispositivo e descarte os dados do logcat atualmente salvos.
Não terá efeito se a saída do logcat não estiver sendo capturada.SwitchTOADBTCP
public abstract String switchToAdbTcp ()
Alterne o dispositivo para o modo ADB-over-TCP.
Devoluções | |
---|---|
String | o número de série do TCP ou null se o dispositivo não pudesse ser alterado |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
switchtoadbusb
public abstract boolean switchToAdbUsb ()
Alterne o dispositivo para o modo ADB sobre USB.
Devoluções | |
---|---|
boolean | true se o Switch foi bem -sucedido, false de outra forma. |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
SYNCFILES
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
Sincroniza incrementalmente o conteúdo de um diretório de arquivos local ao dispositivo.
Decida quais arquivos pressionam comparando registros de data e hora de arquivos locais com seus equivalentes remotos. Somente arquivos 'mais recentes' ou inexistentes serão empurrados para o dispositivo. Assim, a sobrecarga deve ser relativamente pequena se o arquivo definido no dispositivo já estiver atualizado. Os arquivos ocultos (com nomes começando com ".") Serão ignorados. Exemplo de uso: Syncfiles ("/tmp/files", "/sdcard") criará o diretório A/SDCARD/FILS, se ainda não existir, e pressionará o conteúdo/tmp/arquivos para/sdcard/arquivos.Parâmetros | |
---|---|
localFileDir | File : O diretório de arquivos local que contém arquivos para pressionar recursivamente. |
deviceFilePath | String : o destino remoto do caminho absoluto PATH ROOT. Todos os diretórios no caminho do arquivo devem ser legíveis. ou seja, pressionando para/dados/local/tmp quando o adb não for root falhará |
Devoluções | |
---|---|
boolean | true se os arquivos foram sincronizados com sucesso. false caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
desbloqueio
public abstract boolean unlockDevice ()
Desbloqueia o dispositivo se o dispositivo estiver em um estado criptografado.
Este método pode reiniciar a estrutura, mas não ligará parapostBootSetup()
. Portanto, o dispositivo pode não estar totalmente pronto para ser testado quando esse método retornar.Devoluções | |
---|---|
boolean | true se bem -sucedido ou se o dispositivo não for criptografado. |
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
UnsupportedOperationException | Se a criptografia não for suportada no dispositivo. |
desmoundDebugfs
public abstract void unmountDebugfs ()
Desmontando debugfs.
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
WaitForBootComplete
public abstract boolean waitForBootComplete (long timeOut)
Bloqueia até que o sinalizador completo de inicialização do dispositivo esteja definido.
Parâmetros | |
---|---|
timeOut | long : tempo em ms para esperar a bandeira ser definida |
Devoluções | |
---|---|
boolean | true se a bandeira completa de inicialização do dispositivo estiver definida dentro do tempo limite |
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvilableException |
DeviceNotAvailableException |
WaitfordEviceAvicable
public abstract boolean waitForDeviceAvailable ()
Aguarda o dispositivo ser responsivo e disponível para teste. Usa tempo limite padrão.
Devoluções | |
---|---|
boolean | True Se o dispositivo estiver disponível, False se a recuperação estiver desativada e indisponível. |
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
WaitfordEviceAvicable
public abstract boolean waitForDeviceAvailable (long waitTime)
Aguarda o dispositivo ser responsivo e disponível para teste.
Parâmetros | |
---|---|
waitTime | long : o tempo em MS para esperar |
Devoluções | |
---|---|
boolean | True Se o dispositivo estiver disponível, False se a recuperação estiver desativada e indisponível. |
Lança | |
---|---|
DeviceNotAvailableException | Se o dispositivo ainda não responder após o término da Waittime. |
WaitfordfordEviceAvailableInRecoverPath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Aguarda o dispositivo ser 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 indisponível. |
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
WaitfordEviceBootLoader
public abstract void waitForDeviceBootloader ()
Blocos até que o dispositivo seja visível via fastboot. Use o tempo limite padrão.
Lança | |
---|---|
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 de 'recuperação do ADB' (observe que isso é distinto da IDeviceRecovery
).
Parâmetros | |
---|---|
waitTime | long : o tempo em MS para esperar |
Devoluções | |
---|---|
boolean | true se o dispositivo inicializar para a recuperação antes que o tempo expire. 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 inicializar para o desvio antes do tempo expirar. false caso contrário |
WaitfordEviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Blocos para o dispositivo não estar disponível, ou seja, faltando no ADB
Parâmetros | |
---|---|
waitTime | long : o tempo em MS para esperar |
Devoluções | |
---|---|
boolean | true se o dispositivo não estiver disponível antes que o tempo expire. false caso contrário |
WaitfordEviceOnline
public abstract void waitForDeviceOnline ()
Blocos até que o dispositivo seja visível via Adb. Usa tempo limite padrão
Observe que o dispositivo pode não ser necessariamente responsivo aos comandos na conclusão. UsewaitForDeviceAvailable()
.Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
WaitfordEviceOnline
public abstract void waitForDeviceOnline (long waitTime)
Blocos até que o dispositivo seja visível via Adb.
Observe que o dispositivo pode não ser necessariamente responsivo aos comandos na conclusão. UsewaitForDeviceAvailable()
.Parâmetros | |
---|---|
waitTime | long : o tempo em MS para esperar |
Lança | |
---|---|
DeviceNotAvailableException | Se a conexão com o dispositivo for perdida e não puder ser recuperada. |
WaitfordEviceshell
public abstract boolean waitForDeviceShell (long waitTime)
Aguarda o dispositivo ser responsivo a um comando básico de shell adb.
Parâmetros | |
---|---|
waitTime | long : o tempo em MS para esperar |
Devoluções | |
---|---|
boolean | true se o dispositivo se tornar responsivo antes que waitTime decida. |