DispositivoINative
public
interface
INativeDevice
com.android.tradefed.device.INativeDevice |
Fornece uma API confiável e de nível um pouco mais alto para um IDevice
ddmlib.
Repete comandos do dispositivo por um valor configurável e fornece uma interface de recuperação para dispositivos que não respondem.
Resumo
Constantes | |
---|---|
int |
UNKNOWN_API_LEVEL
Valor padrão quando o nível da API não pode ser detectado |
Métodos públicos | |
---|---|
abstract
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Verifique se um recurso tem suporte no momento de acordo com um nível com suporte mínimo. |
abstract
void
|
clearLogcat()
Exclui todos os dados acumulados do logcat. |
abstract
void
|
deleteFile(String deviceFilePath)
Método auxiliar para excluir um arquivo ou diretório do dispositivo. |
abstract
void
|
deleteFile(String deviceFilePath, int userId)
Método auxiliar para excluir um arquivo ou diretório do dispositivo. |
abstract
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
Método auxiliar para verificar se o dispositivo foi reiniciado de forma reversível, comparando o system_server atual com o |
abstract
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Método auxiliar para verificar se o dispositivo foi reiniciado de forma reversível desde o horário UTC desde a época do
dispositivo e da |
abstract
boolean
|
disableAdbRoot()
Desativa a raiz do adb. |
abstract
boolean
|
doesFileExist(String deviceFilePath)
Método auxiliar para determinar se o arquivo existe no dispositivo. |
abstract
boolean
|
enableAdbRoot()
Ativa a raiz do adb. |
abstract
String
|
executeAdbCommand(long timeout, String... commandArgs)
Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado. |
abstract
String
|
executeAdbCommand(String... commandArgs)
Método auxiliar que executa um comando adb como um comando do sistema. |
abstract
String
|
executeAdbCommand(long timeout,
Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado. |
abstract
CommandResult
|
executeFastbootCommand(long timeout, String... commandArgs)
Método auxiliar que executa um comando fastboot como um comando do sistema. |
abstract
CommandResult
|
executeFastbootCommand(String... commandArgs)
Método auxiliar que executa um comando fastboot como um comando do sistema com um tempo limite padrão de dois minutos. |
abstract
CommandResult
|
executeLongFastbootCommand(String... commandArgs)
Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema. |
abstract
CommandResult
|
executeLongFastbootCommand(
Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema com variáveis de ambiente do sistema. |
abstract
String
|
executeShellCommand(String command)
Método auxiliar que executa um comando do shell do adb e retorna a saída como um |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando. |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando. |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Executa o comando do shell do adb fornecido, tentando várias vezes se o comando falhar. |
abstract
CommandResult
|
executeShellV2Command(String command)
Método auxiliar que executa um comando do shell do adb e retorna os resultados como um |
abstract
CommandResult
|
executeShellV2Command(String command, OutputStream pipeToOutput)
Método auxiliar que executa um comando do shell do adb e retorna os resultados como uma |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput)
Método auxiliar que executa um comando do shell do adb e retorna os resultados como um |
abstract
CommandResult
|
executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando. |
abstract
CommandResult
|
executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando. |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando. |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando. |
abstract
CommandResult
|
fastbootWipePartition(String partition)
Método auxiliar que apaga uma partição do dispositivo. |
abstract
int
|
getApiLevel()
Acessa o nível da API do dispositivo. |
abstract
String
|
getBasebandVersion()
Método de conveniência para obter a versão de banda de base (rádio) deste dispositivo. |
abstract
Integer
|
getBattery()
Retorna o nível de bateria atual de um dispositivo ou "Nulo" se o nível de bateria estiver indisponível. |
abstract
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Retorna o valor booleano da propriedade especificada. |
abstract
|
getBootHistory()
O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização. |
abstract
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização, desde o período especificado no dispositivo até a unidade de tempo especificada. |
abstract
String
|
getBootloaderVersion()
Método de conveniência para obter a versão do carregador de inicialização do dispositivo. |
abstract
String
|
getBuildAlias()
Recupera o alias da compilação que o dispositivo está executando no momento. |
abstract
String
|
getBuildFlavor()
Recuperar a variação de build do dispositivo. |
abstract
String
|
getBuildId()
Recupere o build que o dispositivo está executando no momento. |
abstract
String
|
getBuildSigningKeys()
Retorna o tipo de chave usado para assinar a imagem do dispositivo Normalmente, os dispositivos Android podem ser assinados com chaves de teste (como no AOSP) ou com chaves de lançamento (controladas por fabricantes de dispositivos individuais). |
abstract
DeviceDescriptor
|
getCachedDeviceDescriptor()
Retorna um |
abstract
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Retorna um |
abstract
String[]
|
getChildren(String deviceFilePath)
Alternativa ao uso de |
abstract
AbstractConnection
|
getConnection()
Retorna a conexão associada ao dispositivo. |
abstract
String
|
getDeviceClass()
Acessa a classe do dispositivo. |
abstract
long
|
getDeviceDate()
Retorna a data do dispositivo em milissegundos desde a época. |
abstract
DeviceDescriptor
|
getDeviceDescriptor()
Retorne um |
abstract
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Retorne um |
abstract
TestDeviceState
|
getDeviceState()
Recebe o estado do dispositivo. |
abstract
long
|
getDeviceTimeOffset(Date date)
Ajuda para mostrar a diferença de horário entre o dispositivo e um determinado |
abstract
InputStreamSource
|
getEmulatorOutput()
Acessar o stream do emulador stdout e stderr |
abstract
long
|
getExternalStoreFreeSpace()
Método auxiliar para determinar a quantidade de espaço livre no armazenamento externo do dispositivo. |
abstract
String
|
getFastbootProductType()
Método de conveniência para obter o tipo de produto deste dispositivo quando ele está no modo fastboot. |
abstract
String
|
getFastbootProductVariant()
Método de conveniência para obter o tipo de produto deste dispositivo quando ele está no modo fastboot. |
abstract
String
|
getFastbootSerialNumber()
Retorna o número de série do modo fastboot. |
abstract
String
|
getFastbootVariable(String variableName)
Recupera o valor da variável fastboot fornecido do dispositivo. |
abstract
IFileEntry
|
getFileEntry(String path)
Recupera uma referência a um arquivo remoto no dispositivo. |
abstract
IDevice
|
getIDevice()
Retorna uma referência ao |
abstract
long
|
getIntProperty(String name, long defaultValue)
Retorna o valor inteiro da propriedade especificada do dispositivo. |
abstract
long
|
getLastExpectedRebootTimeMillis()
Retorna a última vez que as APIs do Tradefed acionaram uma reinicialização em milissegundos desde EPOCH, conforme
retornado por |
abstract
int
|
getLaunchApiLevel()
Consiga o primeiro nível de API iniciado do dispositivo. |
abstract
InputStreamSource
|
getLogcat()
Captura um stream de snapshot dos dados do logcat. |
abstract
InputStreamSource
|
getLogcat(int maxBytes)
Extrai um stream de snapshot dos últimos |
abstract
InputStreamSource
|
getLogcatDump()
Receba um despejo do logcat atual para o dispositivo. |
abstract
InputStreamSource
|
getLogcatSince(long date)
Captura um fluxo de snapshot dos dados do logcat capturados a partir da data fornecida. |
abstract
String
|
getMountPoint(String mountName)
Retorna um ponto de montagem. |
abstract
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Retorna um |
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 retorna nulo se algo der errado. |
abstract
String
|
getProductType()
Método de conveniência para obter o tipo de produto deste dispositivo. |
abstract
String
|
getProductVariant()
Método de conveniência para receber a variante do produto deste dispositivo. |
abstract
String
|
getProperty(String name)
Recupera o valor da propriedade fornecido do dispositivo. |
abstract
ITestDevice.RecoveryMode
|
getRecoveryMode()
Descubra o modo de recuperação atual usado para o dispositivo. |
abstract
String
|
getSerialNumber()
Método de conveniência para obter o número de série deste dispositivo. |
abstract
|
getTombstones()
Busque e retorne a lista de tombstones dos dispositivos. |
abstract
long
|
getTotalMemory()
Retorna o tamanho total da memória física em bytes ou -1 em caso de erro interno |
abstract
boolean
|
getUseFastbootErase()
Escolha se você quer usar o formato "fastboot" ou "fastboot" para excluir permanentemente uma partição no dispositivo. |
abstract
boolean
|
isAdbRoot()
|
abstract
boolean
|
isAdbTcp()
|
abstract
boolean
|
isAppEnumerationSupported()
Verificar se a plataforma do dispositivo oferece suporte à enumeração de apps |
abstract
boolean
|
isBypassLowTargetSdkBlockSupported()
Verificar se a plataforma no dispositivo oferece suporte à evasão de blocos de SDKs de destino baixos em instalações de apps |
abstract
boolean
|
isDebugfsMounted()
Verifique se o debugfs está ativado. |
abstract
boolean
|
isDeviceEncrypted()
Retorna se o dispositivo está criptografado. |
abstract
boolean
|
isDirectory(String deviceFilePath)
Retorna "True" se o caminho no dispositivo é um diretório. Caso contrário, retorna "false". |
abstract
boolean
|
isEncryptionSupported()
Retorna se a criptografia for compatível com o dispositivo. |
abstract
boolean
|
isExecutable(String fullPath)
Retorna "True" se o caminho do arquivo no dispositivo é um arquivo executável. Caso contrário, retorna "false". |
abstract
boolean
|
isHeadless()
Retorna "true" se o dispositivo for headless (sem tela). Caso contrário, retorna "false". |
abstract
boolean
|
isRuntimePermissionSupported()
Verificar se a plataforma do dispositivo é compatível com a concessão de permissões de execução |
abstract
boolean
|
isStateBootloaderOrFastbootd()
Retorna "true" se o dispositivo está em |
abstract
boolean
|
logAnrs(ITestLogger logger)
Coleta e registra ANRs do dispositivo. |
abstract
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Registre uma mensagem no logcat do dispositivo. |
abstract
void
|
mountDebugfs()
Montar debugfs. |
abstract
void
|
nonBlockingReboot()
Emite um comando para reinicializar o dispositivo e é retornado quando o comando é concluído, quando o dispositivo não está mais visível para o adb. |
abstract
void
|
postBootSetup()
Siga as instruções para configurar o dispositivo e fazer esses testes após cada inicialização. |
default
void
|
postInvocationTearDown()
Esse método foi descontinuado.
Use |
abstract
void
|
postInvocationTearDown(Throwable invocationException)
Etapas extras para a limpeza específica do dispositivo exigem a limpeza que será executada após a conclusão da invocação. |
default
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Etapas extras para uma configuração específica do dispositivo exigem que ele seja executado antes do fluxo de invocação. |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir)
Extraia recursivamente o conteúdo do diretório do dispositivo. |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Extraia recursivamente o conteúdo do diretório do dispositivo. |
abstract
File
|
pullFile(String remoteFilePath, int userId)
Recupera um arquivo do dispositivo, o armazena em um |
abstract
File
|
pullFile(String remoteFilePath)
Recupera um arquivo do dispositivo, o armazena 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 prático para recuperar um arquivo do armazenamento externo do dispositivo, o armazena em um |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath, int userId)
Enviar recursivamente o conteúdo do diretório para o dispositivo. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath,
Envie recursivamente o conteúdo do diretório para o dispositivo, excluindo alguns diretórios que são filtrados. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath)
Enviar recursivamente o conteúdo do diretório para o dispositivo. |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
Variante de |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath)
Envie um arquivo para o dispositivo. |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, int userId)
Envie um arquivo para o dispositivo. |
abstract
boolean
|
pushString(String contents, String deviceFilePath)
Enviar por push o arquivo criado a partir de uma string para o dispositivo |
abstract
void
|
reboot()
Reinicializa o dispositivo no modo adb. |
abstract
void
|
reboot(String reason)
Reinicializa o dispositivo no modo adb com o |
abstract
void
|
rebootIntoBootloader()
Reinicializa o dispositivo no modo de carregador de inicialização. |
abstract
void
|
rebootIntoFastbootd()
Reinicializa o dispositivo no modo fastbootd. |
abstract
void
|
rebootIntoRecovery()
Reinicializa o dispositivo no modo de recuperação do adb. |
abstract
void
|
rebootIntoSideload(boolean autoReboot)
Reinicializa o dispositivo no modo de sideload do adb. Observe que esse é um modo especial em recuperação. Bloqueia até que o dispositivo entre no modo de sideload |
abstract
void
|
rebootIntoSideload()
Reinicializa o dispositivo no modo de sideload do adb. Observe que esse é um modo especial em recuperação. Bloqueia até que o dispositivo entre no modo de sideload |
abstract
void
|
rebootUntilOnline()
Uma alternativa para |
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()
Tornar 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,
Executa testes de instrumentação e fornece recuperação de dispositivo. |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Igual a |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Igual a |
abstract
void
|
setDate(Date date)
Define a data no dispositivo Observação: para definir a data no dispositivo, é necessário ter acesso root |
abstract
void
|
setOptions(TestDeviceOptions options)
Definir o |
abstract
boolean
|
setProperty(String propKey, String propValue)
Define o valor da propriedade fornecido no dispositivo. |
abstract
void
|
setRecovery(IDeviceRecovery recovery)
Defina a |
abstract
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Define o modo de recuperação atual a ser usado no dispositivo. |
abstract
void
|
setUseFastbootErase(boolean useFastbootErase)
Defina se você quer usar o formato de limpeza do fastboot ou do fastboot para excluir permanentemente uma partição no dispositivo. |
abstract
void
|
startLogcat()
Começa a capturar a saída do logcat do dispositivo em segundo plano. |
abstract
void
|
stopEmulatorOutput()
Feche e exclua a saída do emulador. |
abstract
void
|
stopLogcat()
Interrompe a captura da saída do logcat do dispositivo e descarta os dados salvos atualmente. |
abstract
String
|
switchToAdbTcp()
Alterna o dispositivo para o modo adb-over-tcp. |
abstract
boolean
|
switchToAdbUsb()
Alterna o dispositivo para adb no modo usb. |
abstract
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Sincroniza de forma incremental o conteúdo de um diretório de arquivos local com o dispositivo. |
abstract
boolean
|
unlockDevice()
Desbloqueia o dispositivo se ele estiver em um estado criptografado. |
abstract
void
|
unmountDebugfs()
Desmonte debugfs. |
abstract
boolean
|
waitForBootComplete(long timeOut)
Bloqueia até que a flag de inicialização do dispositivo seja definida. |
abstract
boolean
|
waitForDeviceAvailable()
Espera o dispositivo responder e ficar disponível para testes. |
abstract
boolean
|
waitForDeviceAvailable(long waitTime)
Espera o dispositivo responder e ficar disponível para testes. |
abstract
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Espera o dispositivo responder e ficar disponível sem considerar o caminho de recuperação. |
abstract
void
|
waitForDeviceBootloader()
Bloqueia até que o dispositivo fique visível pelo fastboot. |
abstract
boolean
|
waitForDeviceInRecovery(long waitTime)
Bloqueia o dispositivo no estado "recuperação adb" (observe que isso é diferente de
|
abstract
boolean
|
waitForDeviceInSideload(long waitTime)
Bloqueia o dispositivo no estado "adb sideload" |
abstract
boolean
|
waitForDeviceNotAvailable(long waitTime)
Bloqueios para que o dispositivo não esteja disponível, ou seja, ausentes no adb |
abstract
void
|
waitForDeviceOnline()
Bloqueia até que o dispositivo fique visível via adb. |
abstract
void
|
waitForDeviceOnline(long waitTime)
Bloqueia até que o dispositivo fique visível via adb. |
abstract
boolean
|
waitForDeviceShell(long waitTime)
Espera o dispositivo responder a um comando básico do shell do adb. |
Constantes
NÍVEL_DE_API_DESCONHECIDO
public static final int UNKNOWN_API_LEVEL
Valor padrão quando o nível da API não pode ser detectado
Valor da constante: -1 (0xffffffff)
Métodos públicos
checkApiLevelAgainstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Verifique se um recurso tem suporte no momento de acordo com um nível com suporte mínimo. Esse método considera recursos ainda não lançados antes que o nível da API seja aumentado.
Parâmetros | |
---|---|
strictMinLevel |
int : o nível mínimo possível rigoroso que oferece suporte ao recurso. |
Retorna | |
---|---|
boolean |
Verdadeiro se o nível for compatível. Falso, do contrário. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
limparLogcat
public abstract void clearLogcat ()
Exclui todos os dados acumulados do logcat.
Isso é útil para os casos em que você quer garantir que o ITestDevice#getLogcat()
retorne apenas
dados de registro produzidos após um determinado ponto (por exemplo, após atualizar um novo build do dispositivo etc.).
deleteFile
public abstract void deleteFile (String deviceFilePath)
Método auxiliar para excluir um arquivo ou diretório do dispositivo.
Parâmetros | |
---|---|
deviceFilePath |
String : o caminho absoluto do arquivo no dispositivo. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
deleteFile
public abstract void deleteFile (String deviceFilePath, int userId)
Método auxiliar para excluir um arquivo ou diretório do dispositivo.
Parâmetros | |
---|---|
deviceFilePath |
String : o caminho absoluto do arquivo no dispositivo. |
userId |
int : o ID do usuário que será excluído |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
deviceSoftReiniciado
public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Método auxiliar para verificar se o dispositivo foi reiniciado de forma reversível, comparando o system_server atual com o ProcessInfo
system_server anterior. Use getProcessByName(String)
para receber ProcessInfo
.
Parâmetros | |
---|---|
prevSystemServerProcess |
ProcessInfo : o processo system_server anterior ProcessInfo . |
Retorna | |
---|---|
boolean |
true se o dispositivo for reiniciado de forma reversível |
Gera | |
---|---|
RuntimeException |
se o dispositivo tiver um motivo de inicialização anormal |
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
deviceSoftRestartedSince
public abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Método auxiliar para verificar se o dispositivo foi reiniciado de forma reversível desde o horário UTC desde a época do
dispositivo e da ERROR(/TimeUnit)
dele. "Reinicialização em segundo plano" se refere ao system_server reiniciado fora de uma
reinicialização forçada do dispositivo (por exemplo: reinicialização solicitada). O utcEpochTime do dispositivo atual em
Milliseccond pode ser obtido pelo método getDeviceDate()
.
Parâmetros | |
---|---|
utcEpochTime |
long : o horário do dispositivo em segundos desde a época. |
timeUnit |
TimeUnit : a unidade de tempo TimeUnit para o utcEpochTime especificado. |
Retorna | |
---|---|
boolean |
true se o dispositivo for reiniciado de forma reversível |
Gera | |
---|---|
RuntimeException |
se o dispositivo tiver um motivo de inicialização anormal |
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
desativarAdbRoot
public abstract boolean disableAdbRoot ()
Desativa a raiz do adb.
Desativar a raiz do adb pode fazer com que o dispositivo se desconecte do adb. Esse método ficará bloqueado até que o dispositivo esteja disponível.
Retorna | |
---|---|
boolean |
true se for bem-sucedido. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
fazFileExist
public abstract boolean doesFileExist (String deviceFilePath)
Método auxiliar para determinar se o arquivo existe no dispositivo.
Parâmetros | |
---|---|
deviceFilePath |
String : o caminho absoluto do arquivo no dispositivo a ser verificado. |
Retorna | |
---|---|
boolean |
true se o arquivo existir. Caso contrário, retorna false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
enableAdbRoot
public abstract boolean enableAdbRoot ()
Ativa a raiz do adb. Se a configuração "enable-root" for "false", registrará uma mensagem e retornará sem ativar a raiz.
A ativação da raiz do adb pode fazer com que o dispositivo se desconecte do adb. Esse método ficará bloqueado até que o dispositivo esteja disponível.
Retorna | |
---|---|
boolean |
true se for bem-sucedido. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeAdbCommand
public abstract String executeAdbCommand (long timeout, String... commandArgs)
Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.
Use executeShellCommand(String)
sempre que possível, porque esse método melhora a detecção de falhas e o desempenho.
Parâmetros | |
---|---|
timeout |
long : tempo em milissegundos até o dispositivo deixar de responder, 0L sem tempo limite. |
commandArgs |
String : o comando e os argumentos do adb a serem executados. |
Retorna | |
---|---|
String |
a stdout do comando. null se o comando não for executado. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeAdbCommand
public abstract String executeAdbCommand (String... commandArgs)
Método auxiliar que executa um comando adb como um comando do sistema.
Use executeShellCommand(String)
sempre que possível, porque esse método melhora a detecção de falhas e o desempenho.
Parâmetros | |
---|---|
commandArgs |
String : o comando e os argumentos do adb a serem executados. |
Retorna | |
---|---|
String |
a stdout do comando. null se o comando não for executado. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeAdbCommand
public abstract String executeAdbCommand (long timeout,envMap, String... commandArgs)
Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado.
Use executeShellCommand(String)
sempre que possível, porque esse método melhora a detecção de falhas e o desempenho.
Parâmetros | |
---|---|
timeout |
long : tempo em milissegundos até o dispositivo deixar de responder, 0L sem tempo limite. |
envMap |
: ambiente a ser definido para o comando. |
commandArgs |
String : o comando e os argumentos do adb a serem executados. |
Retorna | |
---|---|
String |
a stdout do comando. null se o comando não for executado. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeFastbootCommand
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
Método auxiliar que executa um comando fastboot como um comando do sistema.
Deve ser usado quando o dispositivo já estiver no modo fastboot (Fastboot mode).
Parâmetros | |
---|---|
timeout |
long : o tempo em milissegundos antes da expiração do comando. |
commandArgs |
String : o comando fastboot e os argumentos a serem executados |
Retorna | |
---|---|
CommandResult |
CommandResult que contém a saída do comando |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeFastbootCommand
public abstract CommandResult executeFastbootCommand (String... commandArgs)
Método auxiliar que executa um comando fastboot como um comando do sistema com um tempo limite padrão de dois minutos.
Deve ser usado quando o dispositivo já estiver no modo fastboot (Fastboot mode).
Parâmetros | |
---|---|
commandArgs |
String : o comando fastboot e os argumentos a serem executados |
Retorna | |
---|---|
CommandResult |
CommandResult que contém a saída do comando |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema.
Idêntico a executeFastbootCommand(String)
, mas usa um tempo limite maior.
Parâmetros | |
---|---|
commandArgs |
String : o comando fastboot e os argumentos a serem executados |
Retorna | |
---|---|
CommandResult |
CommandResult que contém a saída do comando |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema com variáveis de ambiente do sistema.
Idêntico a executeFastbootCommand(String)
, mas usa um tempo limite maior.
Parâmetros | |
---|---|
envVarMap |
: as variáveis de ambiente do sistema com que o comando fastboot é executado |
commandArgs |
String : o comando fastboot e os argumentos a serem executados |
Retorna | |
---|---|
CommandResult |
CommandResult que contém a saída do comando |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellCommand
public abstract String executeShellCommand (String command)
Método auxiliar que executa um comando do shell do adb e retorna a saída como um String
.
Parâmetros | |
---|---|
command |
String : o comando do shell do adb a ser executado. |
Retorna | |
---|---|
String |
a saída do shell |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command |
String : o comando do shell do adb a ser executado. |
receiver |
IShellOutputReceiver : o IShellOutputReceiver para onde direcionar a saída do shell. |
maxTimeToOutputShellResponse |
long : o período máximo em que o comando
não tem permissão para gerar nenhuma resposta. Unidade conforme especificado em timeUnit |
timeUnit |
TimeUnit : unidade de maxTimeToOutputShellResponse |
retryAttempts |
int : o número máximo de vezes que o comando é repetido se falhar devido a uma
exceção. DeviceNotResponsiveException será gerada se retryAttempts
forem executadas sem sucesso. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
Confira também:
executeShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command |
String : o comando do shell do adb a ser executado. |
receiver |
IShellOutputReceiver : o IShellOutputReceiver para onde direcionar a saída do shell. |
maxTimeoutForCommand |
long : o tempo limite máximo para a conclusão do comando. Unidade conforme
especificada em timeUnit . |
maxTimeToOutputShellResponse |
long : o período máximo em que o comando
não tem permissão para gerar nenhuma resposta. Unidade conforme especificado em timeUnit |
timeUnit |
TimeUnit : unidade de maxTimeToOutputShellResponse |
retryAttempts |
int : o número máximo de vezes que o comando é repetido se falhar devido a uma
exceção. DeviceNotResponsiveException será gerada se retryAttempts for
executada sem sucesso. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
Confira também:
executeShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver)
Executa o comando do shell do adb fornecido, tentando várias vezes se o comando falhar.
Uma forma mais simples de
executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
com
valores padrão.
Parâmetros | |
---|---|
command |
String : o comando do shell do adb a ser executado. |
receiver |
IShellOutputReceiver : o IShellOutputReceiver para onde direcionar a saída do shell. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command)
Método auxiliar que executa um comando do shell do adb e retorna os resultados como um CommandResult
preenchido corretamente com a saída de status do comando, stdout e stderr.
Parâmetros | |
---|---|
command |
String : o comando que será executado. |
Retorna | |
---|---|
CommandResult |
O resultado em CommandResult . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
Método auxiliar que executa um comando do shell do adb e retorna os resultados como um CommandResult
preenchido corretamente com a saída de status do comando e stderr. stdout é direcionado para o stream especificado.
Parâmetros | |
---|---|
command |
String : o comando que será executado. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) em que a saída std será redirecionada ou nula. |
Retorna | |
---|---|
CommandResult |
O resultado em CommandResult . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
Método auxiliar que executa um comando do shell do adb e retorna os resultados como um CommandResult
preenchido corretamente com a saída de status do comando, stdout e stderr.
Parâmetros | |
---|---|
command |
String : o comando que será executado. |
pipeAsInput |
File : uma ERROR(/File) que será encadeada como entrada para o comando ou nula. |
Retorna | |
---|---|
CommandResult |
O resultado em CommandResult . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command |
String : o comando do shell do adb a ser executado. |
maxTimeoutForCommand |
long : o tempo limite máximo para a conclusão do comando. Unidade conforme
especificada em timeUnit . |
timeUnit |
TimeUnit : unidade de maxTimeToOutputShellResponse |
retryAttempts |
int : o número máximo de vezes que o comando é repetido se falhar devido a uma
exceção. DeviceNotResponsiveException será gerada se retryAttempts for
executada sem sucesso. |
Retorna | |
---|---|
CommandResult |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
Confira também:
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command |
String : o comando do shell do adb a ser executado. |
maxTimeoutForCommand |
long : o tempo limite máximo para a conclusão do comando. Unidade conforme
especificada em timeUnit . |
timeUnit |
TimeUnit : unidade de maxTimeToOutputShellResponse |
Retorna | |
---|---|
CommandResult |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
Confira também:
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command |
String : o comando do shell do adb a ser executado. |
pipeAsInput |
File : uma ERROR(/File) que será encadeada como entrada para o comando ou nula. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) em que a saída std será redirecionada ou nula. |
maxTimeoutForCommand |
long : o tempo limite máximo para a conclusão do comando. Unidade conforme
especificada em timeUnit . |
timeUnit |
TimeUnit : unidade de maxTimeToOutputShellResponse |
retryAttempts |
int : o número máximo de vezes que o comando é repetido se falhar devido a uma
exceção. DeviceNotResponsiveException será gerada se retryAttempts for
executada sem sucesso. |
Retorna | |
---|---|
CommandResult |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
Confira também:
executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command |
String : o comando do shell do adb a ser executado. |
pipeAsInput |
File : uma ERROR(/File) que será encadeada como entrada para o comando ou nula. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) em que a saída std será redirecionada ou nula. |
pipeToError |
OutputStream : ERROR(/OutputStream) em que o erro padrão será redirecionado ou nulo. |
maxTimeoutForCommand |
long : o tempo limite máximo para a conclusão do comando. Unidade conforme
especificada em timeUnit . |
timeUnit |
TimeUnit : unidade de maxTimeToOutputShellResponse |
retryAttempts |
int : o número máximo de vezes que o comando é repetido se falhar devido a uma
exceção. DeviceNotResponsiveException será gerada se retryAttempts for
executada sem sucesso. |
Retorna | |
---|---|
CommandResult |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
Confira também:
fastbootWipePartition
public abstract CommandResult fastbootWipePartition (String partition)
Método auxiliar que apaga uma partição do dispositivo.
Se getUseFastbootErase()
for true
, a limpeza do fastboot será usada para excluir permanentemente a partição. O dispositivo deverá criar um sistema de arquivos na próxima vez que for inicializado.
Caso contrário, o formato fastboot é usado, o que cria um novo sistema de arquivos no dispositivo.
Deve ser usado quando o dispositivo já estiver no modo fastboot (Fastboot mode).
Parâmetros | |
---|---|
partition |
String : a partição a ser excluída permanentemente. |
Retorna | |
---|---|
CommandResult |
CommandResult que contém a saída do comando |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getApiLevel
public abstract int getApiLevel ()
Acessa o nível da API do dispositivo. O valor padrão é UNKNOWN_API_LEVEL
.
Retorna | |
---|---|
int |
Um número inteiro que indica o nível de API do dispositivo |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBasebandVersion
public abstract String getBasebandVersion ()
Método de conveniência para obter a versão de banda de base (rádio) deste dispositivo. A versão do rádio
é específica do dispositivo e, portanto, pode não retornar as informações corretas para todos os dispositivos. Esse
método depende da propriedade gsm.version.baseband para retornar as informações corretas de versão.
Essa ação não é precisa para alguns dispositivos CDMA, e a versão retornada pode não corresponder à versão informada pelo fastboot e não retornar a versão para o rádio CDMA.
Texto longo, leia o resumo: esse método só informará a versão precisa se a propriedade gsm.version.baseband for a
mesma que a versão retornada por fastboot getvar version-baseband
.
Retorna | |
---|---|
String |
a versão da banda de base String ou null se não for possível determiná-la
(o dispositivo não tem rádio ou a string de versão não pode ser lida) |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getBateria
public abstract Integer getBattery ()
Retorna o nível de bateria atual de um dispositivo ou "Nulo" se o nível de bateria estiver indisponível.
Retorna | |
---|---|
Integer |
getBooleanProperty
public abstract boolean getBooleanProperty (String name, boolean defaultValue)
Retorna o valor booleano da propriedade especificada.
Parâmetros | |
---|---|
name |
String : o nome da propriedade. |
defaultValue |
boolean : valor padrão a ser retornado se a propriedade estiver vazia ou não existir. |
Retorna | |
---|---|
boolean |
true se a propriedade tiver o valor "1" , "y" , "yes" , "on" ou "true" , false se a propriedade tiver o valor "0" , "n" , "no" , "off" , "false" ou defaultValue de outra forma. |
Gera | |
---|---|
DeviceNotAvailableException |
getBootHistory
public abstractgetBootHistory ()
O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização.
Retorna | |
---|---|
|
Mapa do tempo de inicialização (horário UTC em segundo desde o período) e motivo da inicialização |
Gera | |
---|---|
DeviceNotAvailableException |
getbootHistorySince
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização, desde o período especificado no dispositivo até a unidade de tempo especificada. O utcEpochTime em milissegundos do dispositivo atual pode ser obtido pelo método getDeviceDate()
.
Parâmetros | |
---|---|
utcEpochTime |
long : o tempo do dispositivo desde o período. |
timeUnit |
TimeUnit : a unidade de tempo TimeUnit . |
Retorna | |
---|---|
|
Mapa do tempo de inicialização (horário UTC em segundo desde o período) e motivo da inicialização |
Gera | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public abstract String getBootloaderVersion ()
Método de conveniência para obter a versão do carregador de inicialização do dispositivo.
Tentará recuperar a versão do carregador de inicialização do estado atual do dispositivo. Ou seja, se o dispositivo estiver no modo fastboot, ele vai tentar recuperar a versão do fastboot
Retorna | |
---|---|
String |
a versão do carregador de inicialização String ou null se ela não for encontrada; |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getBuildAlias
public abstract String getBuildAlias ()
Recupera o alias da compilação que o dispositivo está executando no momento.
O alias de build geralmente é uma string mais legível do que o ID do build (normalmente, um número para builds do Nexus). Por exemplo, a versão final do Android 4.2 tem o alias de build JDQ39 e o ID 573038.
Retorna | |
---|---|
String |
o alias de build ou o ID de build se não for possível recuperá-lo. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildFlavor
public abstract String getBuildFlavor ()
Recuperar a variação de build do dispositivo.
Retorna | |
---|---|
String |
a variação de build ou nulo, se não for possível recuperá-lo |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
Recupere o build que o dispositivo está executando no momento.
Retorna | |
---|---|
String |
o ID do build ou IBuildInfo#UNKNOWN_BUILD_ID se não for possível recuperá-lo |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildSigningKeys
public abstract String getBuildSigningKeys ()
Retorna o tipo de chave usado para assinar a imagem do dispositivo
Normalmente, os dispositivos Android podem ser assinados com chaves de teste (como no AOSP) ou com chaves de lançamento (controladas por fabricantes de dispositivos individuais).
Retorna | |
---|---|
String |
A chave de assinatura, se encontrada. Caso contrário, retorna nulo. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
Retorna um DeviceDescriptor
armazenado em cache se o dispositivo estiver alocado. Caso contrário, retorna o
DeviceDescriptor
atual.
Retorna | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Retorna um DeviceDescriptor
armazenado em cache se o dispositivo estiver alocado. Caso contrário, retorna o
DeviceDescriptor
atual.
Parâmetros | |
---|---|
shortDescriptor |
boolean : se o descritor será limitado ao mínimo de informações. |
Retorna | |
---|---|
DeviceDescriptor |
getChildren
public abstract String[] getChildren (String deviceFilePath)
Alternativa ao uso de IFileEntry
, que às vezes não funciona devido às permissões.
Parâmetros | |
---|---|
deviceFilePath |
String : é o caminho no dispositivo em que a pesquisa será feita. |
Retorna | |
---|---|
String[] |
Matriz de strings que contém todo o arquivo em um caminho no dispositivo. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getConnection
public abstract AbstractConnection getConnection ()
Retorna a conexão associada ao dispositivo.
Retorna | |
---|---|
AbstractConnection |
getDeviceClass
public abstract String getDeviceClass ()
Acessa a classe do dispositivo.
Retorna | |
---|---|
String |
a classe de dispositivo String . |
getDeviceDate
public abstract long getDeviceDate ()
Retorna a data do dispositivo em milissegundos desde a época.
Retorna | |
---|---|
long |
a data do dispositivo em formato de época. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
Retorne um DeviceDescriptor
das informações do dispositivo para receber informações sobre ele sem transmitir o objeto real do dispositivo.
Retorna | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Retorne um DeviceDescriptor
das informações do dispositivo para receber informações sobre ele sem transmitir o objeto real do dispositivo.
Parâmetros | |
---|---|
shortDescriptor |
boolean : se o descritor será limitado ao mínimo de informações. |
Retorna | |
---|---|
DeviceDescriptor |
getDeviceState
public abstract TestDeviceState getDeviceState ()
Recebe o estado do dispositivo.
Retorna | |
---|---|
TestDeviceState |
getDeviceTimeShift
public abstract long getDeviceTimeOffset (Date date)
Ajuda para mostrar a diferença de horário entre o dispositivo e um determinado ERROR(/Date)
. Use o horário de época
internamente.
Parâmetros | |
---|---|
date |
Date |
Retorna | |
---|---|
long |
a diferença em milissegundos |
Gera | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
Acessar o stream do emulador stdout e stderr
Retorna | |
---|---|
InputStreamSource |
saída do emulador |
getExternalStoreFreeSpace
public abstract long getExternalStoreFreeSpace ()
Método auxiliar para determinar a quantidade de espaço livre no armazenamento externo do dispositivo.
Retorna | |
---|---|
long |
a quantidade de espaço livre em KB |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getFastbootProductType
public abstract String getFastbootProductType ()
Método de conveniência para obter o tipo de produto deste dispositivo quando ele está no modo fastboot.
Esse método só deve ser usado quando o dispositivo precisa estar no fastboot. É uma variante um pouco mais segura
do que o método getProductType()
genérico nesse caso, porque o ITestDevice
saberá recuperar o dispositivo no fastboot se ele estiver no estado incorreto ou não
responder.
Retorna | |
---|---|
String |
o nome do tipo de produto String ou null se não for possível determinar |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
Método de conveniência para obter o tipo de produto deste dispositivo quando ele está no modo fastboot.
Esse método só deve ser usado quando o dispositivo precisa estar no fastboot. É uma variante um pouco mais segura
do que o método getProductType()
genérico nesse caso, porque o ITestDevice
saberá recuperar o dispositivo no fastboot se ele estiver no estado incorreto ou não
responder.
Retorna | |
---|---|
String |
o nome do tipo de produto String ou null se não for possível determinar |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getFastbootSerialNumber
public abstract String getFastbootSerialNumber ()
Retorna o número de série do modo fastboot.
Retorna | |
---|---|
String |
getFastbootVariable
public abstract String getFastbootVariable (String variableName)
Recupera o valor da variável fastboot fornecido do dispositivo.
Parâmetros | |
---|---|
variableName |
String : o nome da variável. |
Retorna | |
---|---|
String |
o valor da propriedade ou null se ele não existir |
Gera | |
---|---|
|
supportedOperationException |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Recupera uma referência a um arquivo remoto no dispositivo.
Parâmetros | |
---|---|
path |
String : o caminho do arquivo a ser recuperado. Pode ser um caminho absoluto ou relativo a "/". Ou seja, as sintaxes "/system" e "system" são compatíveis. |
Retorna | |
---|---|
IFileEntry |
IFileEntry ou null se o arquivo em path não puder ser encontrado |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getIDevice
public abstract IDevice getIDevice ()
Retorna uma referência ao IDevice
ddmlib associado.
Um novo IDevice
pode ser alocado pelo DDMS sempre que o dispositivo se desconectar e
se reconectar do adb. Portanto, os autores das chamadas não devem manter uma referência ao IDevice
, porque essa referência pode ficar desatualizada.
Retorna | |
---|---|
IDevice |
IDevice |
getIntProperty
public abstract long getIntProperty (String name, long defaultValue)
Retorna o valor inteiro da propriedade especificada do dispositivo.
Parâmetros | |
---|---|
name |
String : o nome da propriedade. |
defaultValue |
long : valor padrão a ser retornado se a propriedade estiver vazia ou não existir. |
Retorna | |
---|---|
long |
O valor da propriedade ou defaultValue se a propriedade estiver vazia, não existir ou não tiver um valor inteiro. |
Gera | |
---|---|
DeviceNotAvailableException |
getLastLastRestartTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
Retorna a última vez que as APIs do Tradefed acionaram uma reinicialização em milissegundos desde EPOCH, conforme
retornado por System.currentTimeMillis()
.
Retorna | |
---|---|
long |
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
Consiga o primeiro nível de API iniciado do dispositivo. O valor padrão é UNKNOWN_API_LEVEL
.
Retorna | |
---|---|
int |
Um número inteiro que indica o primeiro nível de API iniciado do dispositivo |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
Captura um stream de snapshot dos dados do logcat.
Funciona de dois modos:
TestDeviceOptions.getMaxLogcatDataSize()
bytes do conteúdo atual da captura em segundo plano
Retorna | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
Extrai um stream de snapshot dos últimos maxBytes
de dados do Logcat capturados.
Útil para os casos em que você quer capturar snapshots frequentes dos dados do Logcat capturados sem incorrer na penalidade de espaço em disco potencialmente grande de conseguir o snapshot getLogcat()
inteiro.
Parâmetros | |
---|---|
maxBytes |
int : a quantidade máxima de dados a serem retornados. Precisa ser uma quantidade que possa
caber confortavelmente na memória |
Retorna | |
---|---|
InputStreamSource |
getLogcatDump
public abstract InputStreamSource getLogcatDump ()
Receba um despejo do logcat atual para o dispositivo. Ao contrário de getLogcat()
, esse método sempre retornará um despejo estático do Logcat.
Tem a desvantagem de que nada será retornado se o dispositivo não estiver acessível.
Retorna | |
---|---|
InputStreamSource |
uma InputStreamSource dos dados do Logcat. Um stream vazio será retornado se não for possível capturar os dados do Logcat. |
getLogcatSince
public abstract InputStreamSource getLogcatSince (long date)
Captura um fluxo de snapshot dos dados do logcat capturados a partir da data fornecida. O horário no
dispositivo precisa ser usado como getDeviceDate()
.
Parâmetros | |
---|---|
date |
long : em milissegundos desde o formato de época do momento em que o snapshot será iniciado até o presente.
(pode ser obtido usando 'data +%s') |
Retorna | |
---|---|
InputStreamSource |
getMountPoint
public abstract String getMountPoint (String mountName)
Retorna um ponto de montagem.
Consulta o dispositivo diretamente se as informações armazenadas em cache em IDevice
não estiverem disponíveis.
O que fazer: mover esse comportamento para IDevice#getMountPoint(String)
Parâmetros | |
---|---|
mountName |
String : o nome do ponto de montagem. |
Retorna | |
---|---|
String |
o ponto de montagem ou null |
Confira também:
getMountPointInfo
public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Retorna um MountPointInfo
correspondente ao caminho de ponto de montagem especificado, ou
null
se esse caminho não tiver nada montado ou não aparecer em
/proc/mounts como um ponto de montagem.
Parâmetros | |
---|---|
mountpoint |
String |
Retorna | |
---|---|
ITestDevice.MountPointInfo |
Um ERROR(/List) de MountPointInfo contendo as informações em "/proc/mounts" |
Gera | |
---|---|
DeviceNotAvailableException |
Confira também:
getMountPointInfo
public abstractgetMountPointInfo ()
Retorna uma versão analisada das informações em /proc/mounts no dispositivo
Retorna | |
---|---|
|
Um ERROR(/List) de MountPointInfo contendo as informações em "/proc/mounts" |
Gera | |
---|---|
DeviceNotAvailableException |
getPartitionFreeSpace
public abstract long getPartitionFreeSpace (String partition)
Método auxiliar para determinar a quantidade de espaço livre na partição do dispositivo.
Parâmetros | |
---|---|
partition |
String |
Retorna | |
---|---|
long |
a quantidade de espaço livre em KB |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getProcessByName
public abstract ProcessInfo getProcessByName (String processName)
O método auxiliar executa os comandos "pidof" e "stat" e retorna o objeto ProcessInfo
com PID e horário de início do processo especificado.
Parâmetros | |
---|---|
processName |
String : a string do nome do processo. |
Retorna | |
---|---|
ProcessInfo |
ProcessInfo de determinado processName |
Gera | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
Retorna o pid do serviço ou retorna nulo se algo der errado.
Parâmetros | |
---|---|
process |
String : a string do nome do processo. |
Retorna | |
---|---|
String |
Gera | |
---|---|
DeviceNotAvailableException |
getProductType
public abstract String getProductType ()
Método de conveniência para obter o tipo de produto deste dispositivo.
Esse método funciona se o dispositivo estiver no modo adb ou fastboot.
Retorna | |
---|---|
String |
o nome do tipo de produto String . Não será nulo |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada ou se não for possível determinar o tipo de produto |
getProductVariant
public abstract String getProductVariant ()
Método de conveniência para receber a variante do produto deste dispositivo.
Esse método funciona se o dispositivo estiver no modo adb ou fastboot.
Retorna | |
---|---|
String |
O nome da variante do produto String ou null se não for possível determinar |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
getProperty
public abstract String getProperty (String name)
Recupera o valor da propriedade fornecido do dispositivo.
Parâmetros | |
---|---|
name |
String : o nome da propriedade. |
Retorna | |
---|---|
String |
o valor da propriedade ou null se ele não existir |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getRecoveryMode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
Descubra o modo de recuperação atual usado para o dispositivo.
Retorna | |
---|---|
ITestDevice.RecoveryMode |
o modo de recuperação atual usado para o dispositivo. |
getSerialNumber
public abstract String getSerialNumber ()
Método de conveniência para obter o número de série deste dispositivo.
Retorna | |
---|---|
String |
o número de série String |
getTombstones
public abstractgetTombstones ()
Busque e retorne a lista de tombstones dos dispositivos. Requer acesso root.
é o melhor esforço para que, se uma tombstone não for extraída por qualquer motivo, ela estará
faltando na lista. Apenas um DeviceNotAvailableException
encerrará o método antecipadamente.
Retorna | |
---|---|
|
Uma lista de arquivos de tombstone, vazia se não houver nenhuma. |
Gera | |
---|---|
DeviceNotAvailableException |
Confira também:
getTotalMemory
public abstract long getTotalMemory ()
Retorna o tamanho total da memória física em bytes ou -1 em caso de erro interno
Retorna | |
---|---|
long |
getUseFastbootApagar
public abstract boolean getUseFastbootErase ()
Escolha se você quer usar o formato "fastboot" ou "fastboot" para excluir permanentemente uma partição no dispositivo.
Retorna | |
---|---|
boolean |
true se a limpeza do fastboot for usada, ou false se o formato fastboot for
usado. |
Confira também:
AdbRoot
public abstract boolean isAdbRoot ()
Retorna | |
---|---|
boolean |
true se o dispositivo tiver a raiz adb no momento. Caso contrário, será false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
isAdbTcp
public abstract boolean isAdbTcp ()
Retorna | |
---|---|
boolean |
true se o dispositivo estiver conectado a adb-over-tcp. Caso contrário, false . |
isAppEnumerationsupported
public abstract boolean isAppEnumerationSupported ()
Verificar se a plataforma do dispositivo oferece suporte à enumeração de apps
Retorna | |
---|---|
boolean |
Verdadeiro se a enumeração do app for compatível. Caso contrário, é falso. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isBypassLowTargetSdkBlockAllowed
public abstract boolean isBypassLowTargetSdkBlockSupported ()
Verificar se a plataforma no dispositivo oferece suporte à evasão de blocos de SDKs de destino baixos em instalações de apps
Retorna | |
---|---|
boolean |
Verdadeiro se o bloco do SDK de destino inferior for compatível. Caso contrário, será falso |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isDebugfsMounted
public abstract boolean isDebugfsMounted ()
Verifique se o debugfs está ativado.
Retorna | |
---|---|
boolean |
true se o debugfs estiver ativado |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
IsDeviceEncrypted
public abstract boolean isDeviceEncrypted ()
Retorna se o dispositivo está criptografado.
Retorna | |
---|---|
boolean |
true se o dispositivo estiver criptografado. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
Diretório isDirectory
public abstract boolean isDirectory (String deviceFilePath)
Retorna "True" se o caminho no dispositivo é um diretório. Caso contrário, retorna "false".
Parâmetros | |
---|---|
deviceFilePath |
String |
Retorna | |
---|---|
boolean |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isEncryptionsupported
public abstract boolean isEncryptionSupported ()
Retorna se a criptografia for compatível com o dispositivo.
Retorna | |
---|---|
boolean |
true se o dispositivo for compatível com criptografia. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
IsExecutável
public abstract boolean isExecutable (String fullPath)
Retorna "True" se o caminho do arquivo no dispositivo é um arquivo executável. Caso contrário, retorna "false".
Parâmetros | |
---|---|
fullPath |
String |
Retorna | |
---|---|
boolean |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isHeadless
public abstract boolean isHeadless ()
Retorna "true" se o dispositivo for headless (sem tela). Caso contrário, retorna "false".
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionAllowed
public abstract boolean isRuntimePermissionSupported ()
Verificar se a plataforma do dispositivo é compatível com a concessão de permissões de execução
Retorna | |
---|---|
boolean |
Verdadeiro se a permissão de execução for compatível. Caso contrário, retorna falso. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isStatebootloaderOrFastbootd
public abstract boolean isStateBootloaderOrFastbootd ()
Retorna "true" se o dispositivo está em TestDeviceState#FASTBOOT
ou TestDeviceState.FASTBOOTD
.
Retorna | |
---|---|
boolean |
LogAnrs
public abstract boolean logAnrs (ITestLogger logger)
Coleta e registra ANRs do dispositivo.
Parâmetros | |
---|---|
logger |
ITestLogger : um ITestLogger para registrar os ANRs. |
Retorna | |
---|---|
boolean |
True, se a geração de registros foi bem-sucedida. Caso contrário, false. |
Gera | |
---|---|
DeviceNotAvailableException |
LogOnDevice
public abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Registre uma mensagem no logcat do dispositivo. Essa é uma chamada segura que não será gerada mesmo se a geração de registros falhar.
Parâmetros | |
---|---|
tag |
String : a tag em que registramos nossa mensagem no Logcat. |
level |
Log.LogLevel : o nível de depuração da mensagem no logcat. |
format |
String : o formato da mensagem. |
args |
Object : os argumentos a serem substituídos por String.format(). |
mountDebugfs
public abstract void mountDebugfs ()
Montar debugfs.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
nonBlockingReiniciar
public abstract void nonBlockingReboot ()
Emite um comando para reinicializar o dispositivo e é retornado quando o comando é concluído, quando o dispositivo não está mais visível para o adb.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pós-inicialização
public abstract void postBootSetup ()
Siga as instruções para configurar o dispositivo e fazer esses testes após cada inicialização.
Deve ser chamado quando o dispositivo estiver totalmente inicializado/disponível
Em circunstâncias normais, esse método não precisa ser chamado explicitamente, já que as implementações precisam realizar essas etapas automaticamente ao realizar uma reinicialização.
Talvez ele precise ser chamado quando o dispositivo for reinicializado devido a outros eventos (por exemplo, quando um comando de atualização do fastboot for concluído).
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
postInvocationTearDown
public void postInvocationTearDown ()
Esse método foi descontinuado.
Use postInvocationTearDown(Throwable)
.
Etapas extras para a limpeza específica do dispositivo exigem a limpeza que será executada após a conclusão da invocação.
postInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
Etapas extras para a limpeza específica do dispositivo exigem a limpeza que será executada após a conclusão da invocação.
Parâmetros | |
---|---|
invocationException |
Throwable : se houver, a exceção final gerada pela falha de invocação. |
Configuração preInvocation
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Etapas extras para uma configuração específica do dispositivo exigem que ele seja executado antes do fluxo de invocação.
Parâmetros | |
---|---|
info |
IBuildInfo : o IBuildInfo do dispositivo. |
attributes |
MultiMap : os atributos armazenados no contexto de invocação |
Gera | |
---|---|
|
com.android.tradefed.targetprep.TargetSetupError |
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
TargetSetupError |
PullDir
public abstract boolean pullDir (String deviceFilePath, File localDir)
Extraia recursivamente o conteúdo do diretório do dispositivo.
Parâmetros | |
---|---|
deviceFilePath |
String : o caminho absoluto do arquivo da origem remota. |
localDir |
File : o diretório local para onde os arquivos serão extraídos |
Retorna | |
---|---|
boolean |
true se o arquivo foi extraído. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
PullDir
public abstract boolean pullDir (String deviceFilePath, File localDir, int userId)
Extraia recursivamente o conteúdo do diretório do dispositivo.
Parâmetros | |
---|---|
deviceFilePath |
String : o caminho absoluto do arquivo da origem remota. |
localDir |
File : o diretório local para onde os arquivos serão extraídos |
userId |
int : o ID do usuário do qual extrair |
Retorna | |
---|---|
boolean |
true se o arquivo foi extraído. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pullFile
public abstract File pullFile (String remoteFilePath, int userId)
Recupera um arquivo do dispositivo, o armazena em um ERROR(/File)
temporário local e retorna esse
File
.
Parâmetros | |
---|---|
remoteFilePath |
String : o caminho absoluto para o arquivo no dispositivo. |
userId |
int : o ID do usuário de onde extrair |
Retorna | |
---|---|
File |
Um ERROR(/File) contendo o conteúdo do arquivo do dispositivo ou null se a
cópia falhar por qualquer motivo (incluindo problemas com o sistema de arquivos do host) |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pullFile
public abstract File pullFile (String remoteFilePath)
Recupera um arquivo do dispositivo, o armazena em um ERROR(/File)
temporário local e retorna esse
File
.
Parâmetros | |
---|---|
remoteFilePath |
String : o caminho absoluto para o arquivo no dispositivo. |
Retorna | |
---|---|
File |
Um ERROR(/File) contendo o conteúdo do arquivo do dispositivo ou null se a
cópia falhar por qualquer motivo (incluindo problemas com o sistema de arquivos do host) |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pullFile
public abstract boolean pullFile (String remoteFilePath, File localFile)
Recupera um arquivo do dispositivo.
Parâmetros | |
---|---|
remoteFilePath |
String : o caminho absoluto para o arquivo no dispositivo. |
localFile |
File : o arquivo local em que o conteúdo será armazenado. Se não estiver vazio, o conteúdo será
substituído. |
Retorna | |
---|---|
boolean |
true se o arquivo tiver sido recuperado. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pullFile
public abstract boolean pullFile (String remoteFilePath, File localFile, int userId)
Recupera um arquivo do dispositivo.
Parâmetros | |
---|---|
remoteFilePath |
String : o caminho absoluto para o arquivo no dispositivo. |
localFile |
File : o arquivo local em que o conteúdo será armazenado. Se não estiver vazio, o conteúdo será
substituído. |
userId |
int : o ID do usuário de onde extrair |
Retorna | |
---|---|
boolean |
true se o arquivo tiver sido recuperado. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pullFileContents
public abstract String pullFileContents (String remoteFilePath)
Recupera um arquivo do dispositivo e retorna o conteúdo.
Parâmetros | |
---|---|
remoteFilePath |
String : o caminho absoluto para o arquivo no dispositivo. |
Retorna | |
---|---|
String |
Um String contendo o conteúdo do arquivo do dispositivo ou null se a
cópia falhar por qualquer motivo (incluindo problemas com o sistema de arquivos do host) |
Gera | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public abstract File pullFileFromExternal (String remoteFilePath)
Um método prático para recuperar um arquivo do armazenamento externo do dispositivo, o armazena em um ERROR(/File)
temporário local e retorna uma referência a esse File
.
Parâmetros | |
---|---|
remoteFilePath |
String : o caminho para o arquivo no dispositivo, relativo ao ponto de montagem de armazenamento
externo do dispositivo |
Retorna | |
---|---|
File |
Um ERROR(/File) contendo o conteúdo do arquivo do dispositivo ou null se a
cópia falhar por qualquer motivo (incluindo problemas com o sistema de arquivos do host) |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath, int userId)
Enviar recursivamente o conteúdo do diretório para o dispositivo.
Parâmetros | |
---|---|
localDir |
File : o diretório local a ser enviado por push |
deviceFilePath |
String : o caminho absoluto do arquivo do destino remoto |
userId |
int : o ID do usuário a ser enviado. |
Retorna | |
---|---|
boolean |
true se o arquivo foi enviado. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
Envie recursivamente o conteúdo do diretório para o dispositivo, excluindo alguns diretórios que são filtrados.
Parâmetros | |
---|---|
localDir |
File : o diretório local a ser enviado por push |
deviceFilePath |
String : o caminho absoluto do arquivo do destino remoto |
excludedDirectories |
: conjunto de nomes de diretórios excluídos que não devem ser enviados. |
Retorna | |
---|---|
boolean |
true se o arquivo foi enviado. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath)
Enviar recursivamente o conteúdo do diretório para o dispositivo.
Parâmetros | |
---|---|
localDir |
File : o diretório local a ser enviado por push |
deviceFilePath |
String : o caminho absoluto do arquivo do destino remoto |
Retorna | |
---|---|
boolean |
true se o arquivo foi enviado. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
Variante de pushFile(File, String)
que pode, opcionalmente, avaliar a necessidade do provedor de conteúdo.
Parâmetros | |
---|---|
localFile |
File : o arquivo local a ser enviado. |
deviceFilePath |
String : o caminho absoluto do arquivo de destino remoto |
evaluateContentProviderNeeded |
boolean : se é necessário verificar se precisamos do provedor de conteúdo. |
Retorna | |
---|---|
boolean |
true se o arquivo foi enviado. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath)
Envie um arquivo para o dispositivo. Por padrão, usando um provedor de conteúdo.
Parâmetros | |
---|---|
localFile |
File : o arquivo local a ser enviado. |
deviceFilePath |
String : o caminho absoluto do arquivo de destino remoto |
Retorna | |
---|---|
boolean |
true se o arquivo foi enviado. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pushFile
public abstract boolean pushFile (File localFile, String deviceFilePath, int userId)
Envie um arquivo para o dispositivo. Por padrão, usando um provedor de conteúdo.
Parâmetros | |
---|---|
localFile |
File : o arquivo local a ser enviado. |
deviceFilePath |
String : o caminho absoluto do arquivo de destino remoto |
userId |
int : o userId a ser enviado. |
Retorna | |
---|---|
boolean |
true se o arquivo foi enviado. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
pushString
public abstract boolean pushString (String contents, String deviceFilePath)
Enviar por push o arquivo criado a partir de uma string para o dispositivo
Parâmetros | |
---|---|
contents |
String : o conteúdo do arquivo a ser enviado |
deviceFilePath |
String : o caminho absoluto do arquivo de destino remoto |
Retorna | |
---|---|
boolean |
true se a string foi enviada. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
reiniciar
public abstract void reboot ()
Reinicializa o dispositivo no modo adb.
Bloqueia até que o dispositivo fique disponível.
Gera | |
---|---|
DeviceNotAvailableException |
se o dispositivo não estiver disponível após a reinicialização |
reiniciar
public abstract void reboot (String reason)
Reinicializa o dispositivo no modo adb com o reason
especificado a ser mantido durante a reinicialização.
Bloqueia até que o dispositivo fique disponível.
O último motivo da reinicialização pode ser encontrado consultando a propriedade sys.boot.reason
.
Parâmetros | |
---|---|
reason |
String : um motivo para essa reinicialização ou null se nenhum motivo for especificado. |
Gera | |
---|---|
DeviceNotAvailableException |
se o dispositivo não estiver disponível após a reinicialização |
reinicializarIntobootloader
public abstract void rebootIntoBootloader ()
Reinicializa o dispositivo no modo de carregador de inicialização.
Bloqueia até que o dispositivo entre no modo de carregador de inicialização.
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
reinicializarIntoFastbootd
public abstract void rebootIntoFastbootd ()
Reinicializa o dispositivo no modo fastbootd.
Bloqueia até que o dispositivo entre no modo fastbootd.
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
reinicializarIntoRecovery
public abstract void rebootIntoRecovery ()
Reinicializa o dispositivo no modo de recuperação do adb.
Bloqueia até que o dispositivo inicie a recuperação
Gera | |
---|---|
DeviceNotAvailableException |
se o dispositivo não estiver disponível após a reinicialização |
reinicializarIntoSideload
public abstract void rebootIntoSideload (boolean autoReboot)
Reinicializa o dispositivo no modo de sideload do adb. Observe que esse é um modo especial em recuperação.
Bloqueia até que o dispositivo entre no modo de sideload
Parâmetros | |
---|---|
autoReboot |
boolean : se o dispositivo será reinicializado automaticamente após o sideload. |
Gera | |
---|---|
DeviceNotAvailableException |
se o dispositivo não estiver no sideload após a reinicialização |
reinicializarIntoSideload
public abstract void rebootIntoSideload ()
Reinicializa o dispositivo no modo de sideload do adb. Observe que esse é um modo especial em recuperação.
Bloqueia até que o dispositivo entre no modo de sideload
Gera | |
---|---|
DeviceNotAvailableException |
se o dispositivo não estiver no sideload após a reinicialização |
reinicializarUntilOnline
public abstract void rebootUntilOnline ()
Uma alternativa para reboot()
que bloqueia apenas até que o dispositivo esteja on-line, ou seja, visível para o adb.
Gera | |
---|---|
DeviceNotAvailableException |
se o dispositivo não estiver disponível após a reinicialização |
reinicializarUntilOnline
public abstract void rebootUntilOnline (String reason)
Uma alternativa para reboot()
que bloqueia apenas até que o dispositivo esteja on-line, ou seja, visível para o adb.
Parâmetros | |
---|---|
reason |
String : um motivo para essa reinicialização ou null se nenhum motivo for especificado. |
Gera | |
---|---|
DeviceNotAvailableException |
se o dispositivo não estiver disponível após a reinicialização |
Confira também:
Reinicializar espaço do usuário
public abstract void rebootUserspace ()
Reinicializa apenas a parte do espaço do usuário do dispositivo.
Bloqueia até que o dispositivo fique disponível.
AVISO. A reinicialização do espaço do usuário está em desenvolvimento ativo. Use-a por sua conta e risco.
Gera | |
---|---|
DeviceNotAvailableException |
se o dispositivo não estiver disponível após a reinicialização |
reinicializarUserspaceUntilOnline
public abstract void rebootUserspaceUntilOnline ()
Uma alternativa para rebootUserspace()
()} que só é bloqueada até que o dispositivo esteja on-line, ou seja,
visível para o adb.
Gera | |
---|---|
DeviceNotAvailableException |
se o dispositivo não estiver disponível após a reinicialização |
remountSystemReadOnly
public abstract void remountSystemReadOnly ()
Torne a partição do sistema no dispositivo somente leitura. Pode reinicializar o dispositivo.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountSystemWritable
public abstract void remountSystemWritable ()
Torne a partição do sistema no dispositivo gravável. Pode reinicializar o dispositivo.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountVendorReadOnly
public abstract void remountVendorReadOnly ()
Torne a partição do fornecedor no dispositivo somente leitura. Pode reinicializar o dispositivo.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountVendorWritable
public abstract void remountVendorWritable ()
Tornar a partição do fornecedor no dispositivo gravável. Pode reinicializar o dispositivo.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Método de conveniência para executar ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
com um ou mais listeners transmitidos como parâmetros.
Parâmetros | |
---|---|
runner |
IRemoteAndroidTestRunner : o IRemoteAndroidTestRunner que executa os testes. |
listeners |
ITestLifeCycleReceiver : os listeners de resultado do teste |
Retorna | |
---|---|
boolean |
true se o comando de teste tiver sido concluído. false se não foi possível
concluir, mas a recuperação foi bem-sucedida |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada, ou seja, o comando de teste não foi concluído e a recuperação falhou. |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Executa testes de instrumentação e fornece recuperação de dispositivo.
Se a conexão com o dispositivo for perdida antes da conclusão da execução do teste e a recuperação for bem-sucedida, todos os listeners serão informados sobre testRunFailed, e "false" será retornado. O comando de teste não será executado novamente. Os autores da chamada podem tentar novamente, se necessário.
Se a conexão com o dispositivo for perdida antes da conclusão da execução do teste e a recuperação falhar, todos os listeners serão informados sobre testRunFailed, e DeviceNotAvailableException será gerada.
Parâmetros | |
---|---|
runner |
IRemoteAndroidTestRunner : o IRemoteAndroidTestRunner que executa os testes. |
listeners |
: os listeners do resultado do teste. |
Retorna | |
---|---|
boolean |
true se o comando de teste tiver sido concluído. false se ela não for concluída devido a uma exceção de comunicação do dispositivo, mas a recuperação for bem-sucedida |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada, ou seja, o comando de teste não foi concluído e a recuperação falhou. |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Igual a ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
, mas executa o teste para o usuário especificado.
Parâmetros | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Igual a ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
, mas executa o teste para um determinado usuário.
Parâmetros | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
definirData
public abstract void setDate (Date date)
Define a data no dispositivo
Observação: para definir a data no dispositivo, é necessário ter acesso root
Parâmetros | |
---|---|
date |
Date : especifica uma data específica. A data do host será usada se null . |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setOptions
public abstract void setOptions (TestDeviceOptions options)
Definir o TestDeviceOptions
para o dispositivo
Parâmetros | |
---|---|
options |
TestDeviceOptions |
setProperty
public abstract boolean setProperty (String propKey, String propValue)
Define o valor da propriedade fornecido no dispositivo. Exige que a raiz do adb seja verdadeira.
Parâmetros | |
---|---|
propKey |
String : a chave de destino a ser definida. |
propValue |
String : o valor da propriedade a ser definido. |
Retorna | |
---|---|
boolean |
retorna True se o comando setprop tiver sido bem-sucedido. Caso contrário, retorna False. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRecovery
public abstract void setRecovery (IDeviceRecovery recovery)
Defina a IDeviceRecovery
que será usada neste dispositivo. Precisa ser definido quando o dispositivo é alocado pela primeira vez.
Parâmetros | |
---|---|
recovery |
IDeviceRecovery : o IDeviceRecovery |
setRecoveryMode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
Define o modo de recuperação atual a ser usado no dispositivo.
Usado para controlar o método de recuperação a ser usado quando um problema de comunicação do dispositivo for encontrado. É recomendável usar esse método apenas quando necessário (por exemplo, quando o framework estiver inativo etc.).
Parâmetros | |
---|---|
mode |
ITestDevice.RecoveryMode : se o modo "recuperar até apenas on-line" precisa estar ativado ou não. |
definirUsarFastbootLimpar
public abstract void setUseFastbootErase (boolean useFastbootErase)
Defina se você quer usar o formato de limpeza do fastboot ou do fastboot para excluir permanentemente uma partição no dispositivo.
Parâmetros | |
---|---|
useFastbootErase |
boolean : true se for necessário usar a limpeza do fastboot ou false se o
formato fastboot precisar ser usado. |
Confira também:
startLogcat
public abstract void startLogcat ()
Começa a capturar a saída do logcat do dispositivo em segundo plano.
Não terá efeito se a saída do logcat já estiver sendo capturada. Os dados podem ser recuperados mais tarde pelo getLogcat.
Quando o dispositivo não estiver mais em uso, será necessário chamar stopLogcat()
.
startLogcat()
e stopLogcat()
normalmente não precisam ser chamados quando
dentro de um contexto de invocação do TF, já que o framework do TF iniciará e interromperá o Logcat.
stopEmulatorOutput
public abstract void stopEmulatorOutput ()
Feche e exclua a saída do emulador.
stopLogcat
public abstract void stopLogcat ()
Interrompe a captura da saída do logcat do dispositivo e descarta os dados salvos atualmente.
Não terá efeito se a saída do logcat não estiver sendo capturada.
switchToAdbTcp
public abstract String switchToAdbTcp ()
Alterna o dispositivo para o modo adb-over-tcp.
Retorna | |
---|---|
String |
O número de série TCP ou null se não for possível alternar o dispositivo |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
switchToAdbUsb
public abstract boolean switchToAdbUsb ()
Alterna o dispositivo para adb no modo usb.
Retorna | |
---|---|
boolean |
true se a troca for bem-sucedida. Caso contrário, false . |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
syncFiles
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
Sincroniza de forma incremental o conteúdo de um diretório de arquivos local com o dispositivo.
decide quais arquivos enviar comparando carimbos de data/hora de arquivos locais com os equivalentes remotos. Apenas arquivos "mais recentes" ou inexistentes serão enviados ao dispositivo. Assim, a sobrecarga será relativamente pequena se o arquivo definido no dispositivo já estiver atualizado.
Os arquivos ocultos (com nomes que começam com ".") serão ignorados.
Exemplo de uso: syncFiles("/tmp/files", "/sdcard") cria um diretório /sdcard/files se ele ainda não existe e envia recursivamente o conteúdo /tmp/files para /sdcard/files.
Parâmetros | |
---|---|
localFileDir |
File : o diretório de arquivos local que contém os arquivos a serem enviados recursivamente. |
deviceFilePath |
String : a raiz do caminho absoluto do arquivo de destino remoto. Todos os diretórios nesse caminho
de arquivo precisam ser legíveis. Ou seja, enviar para /data/local/tmp quando o adb não for raiz
vai falhar |
Retorna | |
---|---|
boolean |
true se os arquivos foram sincronizados. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
desbloquearDispositivo
public abstract boolean unlockDevice ()
Desbloqueia o dispositivo se ele estiver em um estado criptografado.
Esse método pode reiniciar o framework, mas não vai chamarpostBootSetup()
. Portanto,
o dispositivo pode não estar totalmente pronto para ser testado quando esse método retornar.
Retorna | |
---|---|
boolean |
true se for bem-sucedido ou se o dispositivo não estiver criptografado. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
UnsupportedOperationException |
se a criptografia não for compatível com o dispositivo. |
unmountDebugfs
public abstract void unmountDebugfs ()
Desmonte debugfs.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
"waitForBootComplete"
public abstract boolean waitForBootComplete (long timeOut)
Bloqueia até que a flag de inicialização do dispositivo seja definida.
Parâmetros | |
---|---|
timeOut |
long : tempo em ms para aguardar a definição da flag. |
Retorna | |
---|---|
boolean |
verdadeiro se a sinalização de inicialização do dispositivo estiver definida dentro do tempo limite |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
"waitForDeviceAvailable"
public abstract boolean waitForDeviceAvailable ()
Espera o dispositivo responder e ficar disponível para testes. Usa o tempo limite padrão.
Retorna | |
---|---|
boolean |
Verdadeiro se o dispositivo estiver disponível. Falso se a recuperação estiver desativada e indisponível. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
"waitForDeviceAvailable"
public abstract boolean waitForDeviceAvailable (long waitTime)
Espera o dispositivo responder e ficar disponível para testes.
Parâmetros | |
---|---|
waitTime |
long : o tempo de espera em ms |
Retorna | |
---|---|
boolean |
Verdadeiro se o dispositivo estiver disponível. Falso se a recuperação estiver desativada e indisponível. |
Gera | |
---|---|
DeviceNotAvailableException |
se o dispositivo ainda não estiver respondendo após o período de espera. |
"waitForDeviceAvailableInRecoverPath"
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Espera o dispositivo responder e ficar disponível sem considerar o caminho de recuperação.
Parâmetros | |
---|---|
waitTime |
long |
Retorna | |
---|---|
boolean |
Verdadeiro se o dispositivo estiver disponível. Falso se não estiver disponível. |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
"waitForDeviceBootloader"
public abstract void waitForDeviceBootloader ()
Bloqueia até que o dispositivo fique visível pelo fastboot. Usar tempo limite padrão.
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
"waitForDeviceInRecovery"
public abstract boolean waitForDeviceInRecovery (long waitTime)
Bloqueia o dispositivo no estado "recuperação adb" (observe que isso é diferente de
IDeviceRecovery
).
Parâmetros | |
---|---|
waitTime |
long : o tempo de espera em ms |
Retorna | |
---|---|
boolean |
true se o dispositivo for inicializado para a recuperação antes de o tempo expirar.
Caso contrário, false |
"waitForDeviceInSideload"
public abstract boolean waitForDeviceInSideload (long waitTime)
Bloqueia o dispositivo no estado "adb sideload"
Parâmetros | |
---|---|
waitTime |
long : o tempo de espera em ms |
Retorna | |
---|---|
boolean |
true se o dispositivo for inicializado no sideload antes de o tempo expirar. Caso contrário, false
|
"waitForDeviceNotAvailable"
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Bloqueios para que o dispositivo não esteja disponível, ou seja, ausentes no adb
Parâmetros | |
---|---|
waitTime |
long : o tempo de espera em ms |
Retorna | |
---|---|
boolean |
true se o dispositivo não estiver disponível antes de o tempo expirar.
Caso contrário, false |
"waitForDeviceOnline"
public abstract void waitForDeviceOnline ()
Bloqueia até que o dispositivo fique visível via adb. Usa o tempo limite padrão
O dispositivo pode não ser necessariamente responsivo a comandos após a conclusão. Use
waitForDeviceAvailable()
.
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
"waitForDeviceOnline"
public abstract void waitForDeviceOnline (long waitTime)
Bloqueia até que o dispositivo fique visível via adb.
O dispositivo pode não ser necessariamente responsivo a comandos após a conclusão. Use
waitForDeviceAvailable()
.
Parâmetros | |
---|---|
waitTime |
long : o tempo de espera em ms |
Gera | |
---|---|
DeviceNotAvailableException |
se a conexão com o dispositivo for perdida e não puder ser recuperada. |
"waitForDeviceShell"
public abstract boolean waitForDeviceShell (long waitTime)
Espera o dispositivo responder a um comando básico do shell do adb.
Parâmetros | |
---|---|
waitTime |
long : o tempo de espera em ms |
Retorna | |
---|---|
boolean |
true se o dispositivo começar a responder antes de waitTime. |