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