Dispositivo nativo
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.device.NativeDevice |
Implementação padrão de um dispositivo Android ITestDevice
que não é de pilha completa.
Resumo
Classes aninhadas | |
---|---|
class |
NativeDevice.AdbAction
Um |
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
Constantes | |
---|---|
int |
INVALID_USER_ID
Valor retornado para qualquer ID de usuário inválido/não encontrado: UserHandle definiu o valor -10000 |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
o número padrão de tentativas de repetição do comando a serem executadas |
Campos | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
Construtores públicos | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Cria um |
Métodos públicos | |
---|---|
void
|
batchPrefetchStartupBuildProps()
Microotimização (cerca de 400 milissegundos) por meio da pré-busca de todas as propriedades necessárias em vez de chamar "adb" getprop para cada um. |
boolean
|
canSwitchToHeadlessSystemUser()
Retorna se é permitido alternar para o usuário headless SYSTEM. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Verifica se um recurso tem suporte no momento de acordo com um nível com suporte mínimo. |
boolean
|
checkConnectivity()
Verifique se o dispositivo tem conectividade de rede. |
boolean
|
clearErrorDialogs()
Tentativa de dispensar todas as caixas de diálogo de erro exibidas no momento na interface do dispositivo. |
void
|
clearLastConnectedWifiNetwork()
Limpa a última rede Wi-Fi conectada. |
void
|
clearLogcat()
Exclui todos os dados acumulados do Logcat. |
boolean
|
connectToWifiNetwork(
Conecta-se a uma rede Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Conecta-se a uma rede Wi-Fi. |
boolean
|
connectToWifiNetwork(
Conecta-se a uma network.f |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Conecta-se a uma rede Wi-Fi. |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
Uma variante de |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
Uma variante de |
int
|
createUser(String name, boolean guest, boolean ephemeral)
Criar um usuário com um determinado nome e as flags fornecidas |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Criar um usuário com um determinado nome e as flags fornecidas |
int
|
createUser(String name)
Cria um usuário com um nome determinado e flags padrão 0. |
int
|
createUserNoThrow(String name)
Cria um usuário com um nome determinado e flags padrão 0. |
void
|
deleteFile(String deviceFilePath, int userId)
Método auxiliar para excluir um arquivo ou diretório do dispositivo. |
void
|
deleteFile(String deviceFilePath)
Método auxiliar para excluir um arquivo ou diretório do dispositivo. |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Remove o |
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: |
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 |
boolean
|
disableAdbRoot()
Desativa a raiz do adb. |
void
|
disableKeyguard()
Tenta desativar o bloqueio de teclado. |
boolean
|
disableNetworkMonitor()
Desativa o monitoramento de rede no dispositivo. |
boolean
|
disconnectFromWifi()
Desconecta de uma rede Wi-Fi. |
boolean
|
doesFileExist(String deviceFilePath, int userId)
Método auxiliar para determinar se um arquivo existente no dispositivo existe para um determinado usuário. |
boolean
|
doesFileExist(String deviceFilePath)
Método auxiliar para determinar se o arquivo existe no dispositivo. |
File
|
dumpHeap(String process, String devicePath)
Tenta despejar a heap do system_server. |
boolean
|
enableAdbRoot()
Ativa a raiz do adb. |
boolean
|
enableNetworkMonitor()
Ativa o monitoramento de rede no dispositivo. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado. |
String
|
executeAdbCommand(long timeout,
Método auxiliar que executa um comando adb como um comando do sistema com um tempo limite especificado. |
String
|
executeAdbCommand(String... cmdArgs)
Método auxiliar que executa um comando adb como um comando do sistema. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
Método auxiliar que executa um comando fastboot como um comando do sistema com um tempo limite padrão de 2 minutos. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
Método auxiliar que executa um comando fastboot como um comando do sistema. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema. |
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. |
String
|
executeShellCommand(String command)
Método auxiliar que executa um comando do shell do adb e retorna a saída como um |
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. |
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. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Executa o comando do shell do adb fornecido, tentando várias vezes se o comando falhar. |
CommandResult
|
executeShellV2Command(String cmd)
Método auxiliar que executa um comando do shell do adb e retorna os resultados como um |
CommandResult
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
Método auxiliar que executa um comando do shell do adb e retorna os resultados como uma |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
Método auxiliar que executa um comando do shell do adb e retorna os resultados como um |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando. |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando. |
CommandResult
|
executeShellV2Command(String cmd, 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. |
CommandResult
|
executeShellV2Command(String cmd, 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. |
CommandResult
|
fastbootWipePartition(String partition)
Método auxiliar que apaga uma partição do dispositivo. |
|
getActiveApexes()
Busque as informações sobre os APEXs ativados no dispositivo. |
|
getAllSettings(String namespace)
Retorna pares de chave-valor do namespace solicitado. |
DeviceAllocationState
|
getAllocationState()
Retorna o estado de alocação atual do dispositivo |
String
|
getAndroidId(int userId)
Encontre e retorne o android-id associado a um userId. Ele será nulo se não for encontrado. |
|
getAndroidIds()
Cria um mapa de IDs do Android encontrados que correspondem a IDs de usuário. |
int
|
getApiLevel()
Acessa o nível da API do dispositivo. |
PackageInfo
|
getAppPackageInfo(String packageName)
Busca informações sobre um pacote instalado no dispositivo. |
|
getAppPackageInfos()
Busca informações dos pacotes instalados no dispositivo. |
String
|
getBasebandVersion()
Método de conveniência para obter a versão de banda de base (rádio) deste dispositivo. |
Integer
|
getBattery()
Retorna o nível de bateria atual de um dispositivo ou "Nulo" se o nível de bateria estiver indisponível. |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Retorna o valor booleano da propriedade especificada. |
|
getBootHistory()
O método auxiliar coleta o mapa do histórico de inicialização com o tempo e o motivo da inicialização. |
|
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. |
String
|
getBootloaderVersion()
Método de conveniência para obter a versão do carregador de inicialização do dispositivo. |
InputStreamSource
|
getBugreport()
Recupera um relatório de bug do dispositivo. |
InputStreamSource
|
getBugreportz()
Recupera um relatório de bugs do dispositivo. |
String
|
getBuildAlias()
Recupera o alias da compilação que o dispositivo está executando no momento. |
String
|
getBuildFlavor()
Recuperar a variação de build do dispositivo. |
String
|
getBuildId()
Recupere o build que o dispositivo está executando no momento. |
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) |
DeviceDescriptor
|
getCachedDeviceDescriptor()
Retorna um |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Retorna um |
String[]
|
getChildren(String path)
Alternativa ao uso de |
AbstractConnection
|
getConnection()
A conexão atual associada ao dispositivo. |
ContentProviderHandler
|
getContentProvider(int userId)
Retorna o |
DeviceFoldableState
|
getCurrentFoldableState()
Retorna o estado atual do dobrável do dispositivo ou retorna nulo caso ocorram problemas. |
int
|
getCurrentUser()
Retorna o ID do usuário em execução no momento. |
String
|
getDeviceClass()
Acessa a classe do dispositivo. |
long
|
getDeviceDate()
Retorna a data do dispositivo em milissegundos desde a época. |
DeviceDescriptor
|
getDeviceDescriptor()
Retornar um |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Retornar um |
TestDeviceState
|
getDeviceState()
Recebe o estado do dispositivo. |
long
|
getDeviceTimeOffset(Date date)
Ajuda para mostrar a diferença de horário entre o dispositivo e um determinado |
InputStreamSource
|
getEmulatorOutput()
Acessar o stream do emulador stdout e stderr |
Process
|
getEmulatorProcess()
Retorne o |
final
File
|
getExecuteShellCommandLog()
O registro que contém todos os registros |
long
|
getExternalStoreFreeSpace()
Método auxiliar para determinar a quantidade de espaço livre no armazenamento externo do dispositivo. |
String
|
getFastbootPath()
Retorna o caminho do binário fastboot sendo usado. |
String
|
getFastbootProductType()
Método de conveniência para obter o tipo de produto deste dispositivo quando ele está no modo fastboot. |
String
|
getFastbootProductVariant()
Método de conveniência para obter o tipo de produto deste dispositivo quando ele está no modo fastboot. |
String
|
getFastbootSerialNumber()
Retorna o número de série do modo fastboot. |
String
|
getFastbootVariable(String variableName)
Recupera o valor da variável fastboot fornecido do dispositivo. |
String
|
getFastbootVersion()
Retorna a string da versão do binário fastboot sendo usado. |
IFileEntry
|
getFileEntry(String path)
Recupera uma referência a um arquivo remoto no dispositivo. |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Assistente não oficial para receber um |
|
getFoldableStates()
Retorna a lista de estados dobráveis no dispositivo. |
IDevice
|
getIDevice()
Retorna uma referência ao |
|
getInstalledPackageNames()
Busque os nomes dos pacotes de apps presentes no dispositivo. |
long
|
getIntProperty(String name, long defaultValue)
Retorna o valor inteiro da propriedade especificada do dispositivo. |
String
|
getIpAddress()
Extrai o endereço IP do dispositivo. |
KeyguardControllerState
|
getKeyguardState()
Retorne um objeto para obter o estado atual do bloqueio de teclado ou nulo, se não houver suporte. |
long
|
getLastExpectedRebootTimeMillis()
Retorna a última vez que as APIs Tradefed acionaram uma reinicialização em milissegundos desde EPOCH como
retornado por |
int
|
getLaunchApiLevel()
Consiga o primeiro nível de API iniciado do dispositivo. |
InputStreamSource
|
getLogcat()
Captura um stream de snapshot dos dados do logcat. |
InputStreamSource
|
getLogcat(int maxBytes)
Extrai um stream de snapshot dos últimos |
InputStreamSource
|
getLogcatDump()
Receba um despejo do logcat atual para o dispositivo. |
InputStreamSource
|
getLogcatSince(long date)
Captura um fluxo de snapshot dos dados do logcat capturados a partir da data fornecida. |
String
|
getMacAddress()
Retorna o endereço MAC do dispositivo, retorna nulo se não é possível fazer consultas no dispositivo. |
Integer
|
getMainUserId()
Retorna o ID do usuário principal. |
|
getMainlineModuleInfo()
Consiga as informações sobre os módulos de linha principal instalados no dispositivo. |
int
|
getMaxNumberOfRunningUsersSupported()
Receba o número máximo permitido de usuários em execução simultânea. |
int
|
getMaxNumberOfUsersSupported()
Descubra o número máximo de usuários permitidos. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Retorna o |
String
|
getMountPoint(String mountName)
Retorna um ponto de montagem. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Retorna um |
|
getMountPointInfo()
Retorna uma versão analisada das informações em /proc/mounts no dispositivo |
TestDeviceOptions
|
getOptions()
Busque as opções de teste do dispositivo. |
long
|
getPartitionFreeSpace(String partition)
Método auxiliar para determinar a quantidade de espaço livre na partição do dispositivo. |
Integer
|
getPrimaryUserId()
Retorna o ID do usuário principal. |
ProcessInfo
|
getProcessByName(String processName)
O método auxiliar executa o elemento "pidof" e "stat" e retorna o objeto |
String
|
getProcessPid(String process)
Retorna o pid do serviço ou retorna nulo se algo der errado. |
String
|
getProductType()
Método de conveniência para obter o tipo de produto deste dispositivo. |
String
|
getProductVariant()
Método de conveniência para receber a variante do produto deste dispositivo. |
String
|
getProperty(String name)
Recupera o valor da propriedade fornecido do dispositivo. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Descubra o modo de recuperação atual usado para o dispositivo. |
InputStreamSource
|
getScreenshot(String format)
Faz uma captura de tela do dispositivo. |
InputStreamSource
|
getScreenshot(long displayId)
Faz uma captura de tela do ID de tela do dispositivo. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Faz uma captura de tela do dispositivo. |
InputStreamSource
|
getScreenshot()
Faz uma captura de tela do dispositivo. |
String
|
getSerialNumber()
Método de conveniência para obter o número de série deste dispositivo. |
String
|
getSetting(int userId, String namespace, String key)
Retorna o valor da configuração solicitada. |
String
|
getSetting(String namespace, String key)
Consulte |
String
|
getSimOperator()
Retorna o operador do chip ou nulo, se não estiver disponível ou se o dispositivo não estiver disponível. |
String
|
getSimState()
Retorna o estado do chip ou nulo, se não estiver disponível ou o dispositivo não estiver disponível. |
|
getTombstones()
Busque e retorne a lista de tombstones dos dispositivos. |
long
|
getTotalMemory()
Retorna o tamanho total da memória física em bytes ou -1 em caso de erro interno |
String
|
getTrackingSerial()
Para fins de gerenciamento de dispositivos, acesse o número de série usado para rastreá-lo. |
|
getUninstallablePackageNames()
Busque os nomes dos pacotes de aplicativos que podem ser desinstalados. |
boolean
|
getUseFastbootErase()
Escolha se você quer usar o formato "fastboot" ou "fastboot" para excluir permanentemente uma partição no dispositivo. |
int
|
getUserFlags(int userId)
Encontre e retorne as sinalizações de um determinado usuário. |
|
getUserInfos()
Recebe o mapa de useId para |
int
|
getUserSerialNumber(int userId)
Retorne o número de série associado ao userId, se encontrado. Em qualquer outro caso, retorne -10000. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Processa o DeviceEvent fornecido. Processar o DeviceEvent, que pode ou não fazer a transição deste dispositivo para uma nova alocação estado. |
boolean
|
hasFeature(String feature)
Verifique se um recurso está disponível em um dispositivo. |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Instale um pacote Android no dispositivo. |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Instale um pacote Android no dispositivo. |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Instala um pacote Android no dispositivo para um determinado usuário. |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instala um pacote Android no dispositivo para um determinado usuário. |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
Verificar se a plataforma do dispositivo oferece suporte à enumeração de apps |
boolean
|
isBypassLowTargetSdkBlockSupported()
Verificar se a plataforma no dispositivo oferece suporte à evasão de blocos do SDK de destino baixo em instalações de apps |
boolean
|
isDebugfsMounted()
Verifique se o debugfs está ativado. |
boolean
|
isDeviceEncrypted()
Retorna se o dispositivo estiver criptografado. |
boolean
|
isDirectory(String path)
Retorna "True" se o caminho no dispositivo é um diretório. Caso contrário, retorna "false". |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Retorna se a criptografia for compatível com o dispositivo. |
boolean
|
isExecutable(String fullPath)
Retorna "True" se o caminho do arquivo no dispositivo é um arquivo executável. Caso contrário, retorna "false". |
boolean
|
isFastbootEnabled()
Retorne se o fastboot estiver disponível para o dispositivo. |
boolean
|
isHeadless()
Retorna "true" se o dispositivo for headless (sem tela). Caso contrário, retorna "false". |
boolean
|
isHeadlessSystemUserMode()
Retorna indicando se o dispositivo usa o modo de usuário do sistema headless. |
boolean
|
isMainUserPermanentAdmin()
Informa se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para o status de não administrador. |
boolean
|
isMultiUserSupported()
Determina se há suporte para vários usuários. |
boolean
|
isPackageInstalled(String packageName, String userId)
Consulte o dispositivo em busca de um determinado nome de pacote e ID do usuário para verificar se ele está instalado ou não para esse usuário. |
boolean
|
isPackageInstalled(String packageName)
Consulte o dispositivo em busca de um nome de pacote específico para verificar se ele está instalado ou não. |
boolean
|
isRuntimePermissionSupported()
Verificar se a plataforma do dispositivo é compatível com a concessão de permissões de execução |
boolean
|
isStateBootloaderOrFastbootd()
Retorna "true" se o dispositivo está em |
boolean
|
isUserRunning(int userId)
Verifique se um determinado usuário está em execução. |
boolean
|
isUserSecondary(int userId)
Retorna se o usuário especificado é um usuário secundário, de acordo com as sinalizações dele. |
boolean
|
isUserVisible(int userId)
Verifica se um determinado usuário está visível. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Verifica se o usuário especificado está visível na tela especificada. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano no |
boolean
|
isVisibleBackgroundUsersSupported()
Informa se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano. |
boolean
|
isWifiEnabled()
Teste se o Wi-Fi está ativado. |
|
listDisplayIds()
Colete a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys" SurfaceFlinger". |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Recebe a lista de telas que podem ser usadas para |
|
listUsers()
Recebe a lista de usuários no dispositivo. |
boolean
|
logAnrs(ITestLogger logger)
Coleta e registra ANRs do dispositivo. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Método auxiliar para registrar um relatório de bug e registrá-lo. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Registre uma mensagem no logcat do dispositivo. |
void
|
mountDebugfs()
Montar debugfs. |
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. |
void
|
postAdbRootAction()
Modifique se o dispositivo precisar que algumas ações específicas sejam realizadas após o adb root e antes do dispositivo está on-line novamente. |
void
|
postAdbUnrootAction()
Substituir se o dispositivo precisar que algumas ações específicas sejam realizadas depois do adb unroot e antes o dispositivo ficará on-line novamente. |
void
|
postBootSetup()
Siga as instruções para configurar o dispositivo e fazer esses testes após cada inicialização. |
void
|
postInvocationTearDown(Throwable exception)
Etapas extras para a limpeza específica do dispositivo que serão executadas após a invocação é concluída. |
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. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Extraia recursivamente o conteúdo do diretório do dispositivo. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Extraia recursivamente o conteúdo do diretório do dispositivo. |
boolean
|
pullFile(String remoteFilePath, File localFile)
Recupera um arquivo do dispositivo. |
File
|
pullFile(String remoteFilePath, int userId)
Recupera um arquivo do dispositivo, o armazena em um |
File
|
pullFile(String remoteFilePath)
Recupera um arquivo do dispositivo, o armazena em um |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Recupera um arquivo do dispositivo. |
String
|
pullFileContents(String remoteFilePath)
Recupera um arquivo do dispositivo e retorna o conteúdo. |
File
|
pullFileFromExternal(String remoteFilePath)
Um método conveniente para recuperar um arquivo do armazenamento externo do dispositivo, armazená-lo em um
|
boolean
|
pushDir(File localFileDir, String deviceFilePath,
Envie recursivamente o conteúdo do diretório para o dispositivo, excluindo alguns diretórios filtrada. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
Enviar recursivamente o conteúdo do diretório para o dispositivo. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
Enviar recursivamente o conteúdo do diretório para o dispositivo. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variante de |
boolean
|
pushFile(File localFile, String remoteFilePath)
Envie um arquivo para o dispositivo. |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
Envie um arquivo para o dispositivo. |
boolean
|
pushString(String contents, String remoteFilePath)
Enviar por push o arquivo criado a partir de uma string para o dispositivo |
void
|
reboot(String reason)
Reinicializa o dispositivo no modo adb com o |
void
|
reboot()
Reinicializa o dispositivo no modo adb. |
void
|
rebootIntoBootloader()
Reinicializa o dispositivo no modo de carregador de inicialização. |
void
|
rebootIntoFastbootd()
Reinicializa o dispositivo no modo fastbootd. |
void
|
rebootIntoRecovery()
Reinicializa o dispositivo no modo de recuperação do adb. |
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 |
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 |
void
|
rebootUntilOnline()
Uma alternativa para |
void
|
rebootUntilOnline(String reason)
Uma alternativa para |
void
|
rebootUserspace()
Reinicializa apenas a parte do espaço do usuário do dispositivo. |
void
|
rebootUserspaceUntilOnline()
Uma alternativa para |
boolean
|
recoverDevice()
Tenta recuperar a comunicação do dispositivo. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Registra um |
void
|
remountSystemReadOnly()
Torne a partição do sistema no dispositivo somente leitura. |
void
|
remountSystemWritable()
Torne a partição do sistema no dispositivo gravável. |
void
|
remountVendorReadOnly()
Torne a partição do fornecedor no dispositivo somente leitura. |
void
|
remountVendorWritable()
Tornar a partição do fornecedor no dispositivo gravável. |
boolean
|
removeAdmin(String componentName, int userId)
Remove o administrador do dispositivo de um determinado usuário e retorna |
void
|
removeOwners()
Remova todos os proprietários de perfil de dispositivo existentes da melhor maneira possível. |
boolean
|
removeUser(int userId)
Remove determinado usuário do dispositivo. |
void
|
resetContentProviderSetup()
Redefina a flag de configuração do provedor de conteúdo para acioná-la novamente. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Método de conveniência para executar |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Executa testes de instrumentação e fornece recuperação de dispositivo. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Igual a |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Igual a |
void
|
setConfiguration(IConfiguration configuration)
Injeta o |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
Define a data no dispositivo Observação: para definir a data no dispositivo, é necessário ter acesso root |
boolean
|
setDeviceOwner(String componentName, int userId)
Define um componente de administrador do dispositivo como proprietário do dispositivo em um determinado usuário. |
void
|
setDeviceState(TestDeviceState deviceState)
Atualizar o estado do dispositivo. |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
Para o emulador, defina |
void
|
setEmulatorProcess(Process p)
Define o |
void
|
setFastbootEnabled(boolean fastbootEnabled)
Defina a opção fastboot para o dispositivo. |
void
|
setFastbootPath(String fastbootPath)
Define o caminho para o binário fastboot que será usado. |
void
|
setIDevice(IDevice newDevice)
Atualize o IDevice associado a esse ITestDevice. |
void
|
setLogStartDelay(int delay)
Define o tempo em ms de espera antes de iniciar a captura do logcat para um dispositivo on-line. |
void
|
setOptions(TestDeviceOptions options)
Definir o |
boolean
|
setProperty(String propKey, String propValue)
Define o valor da propriedade fornecido no dispositivo. |
void
|
setRecovery(IDeviceRecovery recovery)
Defina a |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Define o modo de recuperação atual a ser usado no dispositivo. |
void
|
setSetting(String namespace, String key, String value)
Consulte |
void
|
setSetting(int userId, String namespace, String key, String value)
Adiciona um valor de configuração ao namespace de um determinado usuário. |
void
|
setTestLogger(ITestLogger testLogger)
Injeta a instância |
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. |
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. |
void
|
startLogcat()
Começa a capturar a saída do logcat do dispositivo em segundo plano. |
boolean
|
startUser(int userId)
Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. |
boolean
|
startUser(int userId, boolean waitFlag)
Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Inicia um determinado usuário em segundo plano, visível na tela especificada (ou seja, permitindo que o usuário para iniciar atividades nessa tela). |
void
|
stopEmulatorOutput()
Feche e exclua a saída do emulador. |
void
|
stopLogcat()
Interrompe a captura da saída do logcat do dispositivo e descarta os dados salvos atualmente. |
boolean
|
stopUser(int userId)
Interrompe um determinado usuário. |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Interrompa um determinado usuário. |
String
|
switchToAdbTcp()
Alterna o dispositivo para o modo adb-over-tcp. |
boolean
|
switchToAdbUsb()
Alterna o dispositivo para adb no modo usb. |
boolean
|
switchUser(int userId)
Mude para outro userId com um tempo limite padrão. |
boolean
|
switchUser(int userId, long timeout)
Troque para outro userId com o tempo limite fornecido como prazo. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Sincroniza de forma incremental o conteúdo de um diretório de arquivos local com o dispositivo. |
Bugreport
|
takeBugreport()
Crie um relatório de bug e o retorne dentro de um objeto |
String
|
uninstallPackage(String packageName)
Desinstala um pacote Android do dispositivo. |
String
|
uninstallPackageForUser(String packageName, int userId)
Desinstala um pacote Android do dispositivo para um determinado usuário. |
boolean
|
unlockDevice()
Desbloqueia o dispositivo se ele estiver em um estado criptografado. |
void
|
unmountDebugfs()
Desmonte debugfs. |
boolean
|
waitForBootComplete(long timeOut)
Bloqueia até que a flag de inicialização do dispositivo seja definida. |
boolean
|
waitForDeviceAvailable()
Espera o dispositivo responder e ficar disponível para testes. |
boolean
|
waitForDeviceAvailable(long waitTime)
Espera o dispositivo responder e ficar disponível para testes. |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Espera o dispositivo responder e ficar disponível sem considerar o caminho de recuperação. |
void
|
waitForDeviceBootloader()
Bloqueia até que o dispositivo fique visível pelo fastboot. |
boolean
|
waitForDeviceInRecovery(long waitTime)
Bloqueia o dispositivo em "recuperação do adb" estado (diferente do
|
boolean
|
waitForDeviceInSideload(long waitTime)
Bloqueia o dispositivo para estar no "sideload do adb" estado |
boolean
|
waitForDeviceNotAvailable(long waitTime)
Bloqueios para que o dispositivo não esteja disponível, ou seja, ausentes no adb |
void
|
waitForDeviceOnline()
Bloqueia até que o dispositivo fique visível via adb. |
void
|
waitForDeviceOnline(long waitTime)
Bloqueia até que o dispositivo fique visível via adb. |
boolean
|
waitForDeviceShell(long waitTime)
Espera o dispositivo responder a um comando básico do shell do adb. |
Métodos protegidos | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
Cria o comando do SO para a sessão de comando do shell do adb e os args específicos |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
Crie um |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
Execute uma reinicialização do adb. |
void
|
ensureRuntimePermissionSupported()
método auxiliar para gerar uma exceção se a permissão de tempo de execução não for compatível |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
Consiga a instância |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
|
String
|
internalGetProperty(String propName, String fastbootVar, String description)
Busca uma propriedade do dispositivo no cache ddmlib por padrão e volta para o adb shell getprop` ou `fastboot getvar`, dependendo se o dispositivo está em fastboot ou não. |
boolean
|
isInRebootCallback()
Retorna se os callbacks de reinicialização estão sendo executados ou não. |
boolean
|
isNewer(File localFile, IFileEntry entry)
Retorne |
void
|
notifyRebootEnded()
Notifica todos os |
void
|
notifyRebootStarted()
Notifica todos os |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Executa uma ação neste dispositivo. |
void
|
postAdbReboot()
Outras ações que podem ser realizadas após a reinicialização. |
void
|
prePostBootSetup()
Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) modifique esse método para configuração específica pós-inicialização. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
Define a instância do Relógio a ser usada. |
void
|
setMicrodroidProcess(Process process)
Marca o TestDevice como microdroide e define o CID dele. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
Executa um comando fastboot simples com variáveis de ambiente e informa o status da kubectl. |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
Executa um comando fastboot simples e informa o status do comando. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
Aguarde até que o dispositivo fique indisponível (pare de gerar relatórios para o adb). |
Constantes
INVALID_USER_ID
public static final int INVALID_USER_ID
Valor retornado para qualquer ID de usuário inválido/não encontrado: UserHandle definiu o valor -10000
Valor constante: -10.000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Valor constante: 5.000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
o número padrão de tentativas de repetição do comando a serem executadas
Valor constante: 2 (0x00000002)
Campos
CAMINHO DE DEPURAÇÃO
public static final String DEBUGFS_PATH
Cartão SD
protected static final String SD_CARD
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
Construtores públicos
Dispositivo nativo
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Cria um TestDevice
.
Parâmetros | |
---|---|
device |
IDevice : o IDevice associado |
stateMonitor |
IDeviceStateMonitor : o mecanismo IDeviceStateMonitor a ser usado. |
allocationMonitor |
IDeviceMonitor : o IDeviceMonitor para informar sobre mudanças no estado de alocação.
Pode ser nulo |
Métodos públicos
batchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Microotimização (cerca de 400 milissegundos) por meio da pré-busca de todas as propriedades necessárias em vez de chamar "adb" getprop para cada um. Ou seja, a busca de todas as propriedades é tão rápida quanto a busca de uma. Chamadas de device.getApiLevel(), checkApiLevelAgainstNextRelease e getBuildAlias "adb getprop" em segundo plano. Nós os buscamos em uma chamada e chamamos NativeDevice.setProperty. Mesmo se não fizermos isso, o próprio NativeDevice vai chamar setProperty e armazenar em cache o resultado para futuras chamadas. Estamos fazendo isso um pouco antes. Se o dispositivo estiver em modo de recuperação outros erros ao buscar as propriedades, eles serão ignorados.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Retorna se é permitido alternar para o usuário headless SYSTEM.
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public 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 | |
---|---|
DeviceNotAvailableException |
verificarConectividade
public boolean checkConnectivity ()
Verifique se o dispositivo tem conectividade de rede.
Retorna | |
---|---|
boolean |
true se o dispositivo tiver uma conexão de rede ativa,
false em excesso. |
Gera | |
---|---|
DeviceNotAvailableException |
ClearErrorDialogs
public boolean clearErrorDialogs ()
Tentativa de dispensar todas as caixas de diálogo de erro exibidas no momento na interface do dispositivo.
Retorna | |
---|---|
boolean |
true se nenhuma caixa de diálogo estiver presente ou se elas tiverem sido apagadas.
Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
ClearLastConnectedWiFiNetwork
public void clearLastConnectedWifiNetwork ()
Limpa a última rede Wi-Fi conectada. Precisa ser chamado ao iniciar uma nova invocação. para evitar a conexão à rede Wi-Fi usada no teste anterior após a reinicialização do dispositivo.
limparLogcat
public 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.).
conectar à rede Wi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Conecta-se a uma rede Wi-Fi.
Ativa o Wi-Fi e bloqueia até que uma conexão seja estabelecida com um dos Wi-Fi
das redes fornecidas no mapa wifiSsidToPsk. Depois que a conexão é estabelecida, a instância tenta
restaurar a conexão após cada reinicialização até ITestDevice#disconnectFromWifi()
ou
ITestDevice#clearLastConnectedWifiNetwork()
seja chamado.
Parâmetros | |
---|---|
wifiSsidToPsk |
: um mapa de SSIDs de Wi-Fi para senhas. |
scanSsid |
boolean : se é necessário procurar SSIDs ocultos para essa rede. |
Retorna | |
---|---|
boolean |
true se conectado à rede Wi-Fi. false
caso contrário |
Gera | |
---|---|
DeviceNotAvailableException |
conectar à rede Wi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Conecta-se a uma rede Wi-Fi.
Ativa o Wi-Fi e bloqueia até que uma conexão seja estabelecida com a rede Wi-Fi especificada.
Depois que a conexão é estabelecida, a instância tenta restaurá-la após cada reinicialização
até ITestDevice#disconnectFromWifi()
ou
ITestDevice#clearLastConnectedWifiNetwork()
seja chamado.
Parâmetros | |
---|---|
wifiSsid |
String : o ssid do Wi-Fi a ser conectado. |
wifiPsk |
String : senha longa PSK ou nula se não estiver criptografada |
Retorna | |
---|---|
boolean |
true se conectado à rede Wi-Fi. false
caso contrário |
Gera | |
---|---|
DeviceNotAvailableException |
conectar à rede Wi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk)
Conecta-se a uma rede Wi-Fi.
Ativa o Wi-Fi e bloqueia até que uma conexão seja estabelecida com um dos Wi-Fi
das redes fornecidas no mapa wifiSsidToPsk. Depois que a conexão é estabelecida, a instância tenta
restaurar a conexão após cada reinicialização até ITestDevice#disconnectFromWifi()
ou
ITestDevice#clearLastConnectedWifiNetwork()
é chamado.f
Parâmetros | |
---|---|
wifiSsidToPsk |
: um mapa de SSIDs de Wi-Fi para senhas. |
Retorna | |
---|---|
boolean |
true se conectado à rede Wi-Fi. false
caso contrário |
Gera | |
---|---|
DeviceNotAvailableException |
conectar à rede Wi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Conecta-se a uma rede Wi-Fi.
Ativa o Wi-Fi e bloqueia até que uma conexão seja estabelecida com a rede Wi-Fi especificada.
Depois que a conexão é estabelecida, a instância tenta restaurá-la após cada reinicialização
até ITestDevice#disconnectFromWifi()
ou
ITestDevice#clearLastConnectedWifiNetwork()
seja chamado.
Parâmetros | |
---|---|
wifiSsid |
String : o ssid do Wi-Fi a ser conectado. |
wifiPsk |
String : senha longa PSK ou nula se não estiver criptografada |
scanSsid |
boolean : se é necessário procurar um SSID oculto para esta rede. |
Retorna | |
---|---|
boolean |
true se conectado à rede Wi-Fi. false
caso contrário |
Gera | |
---|---|
DeviceNotAvailableException |
conectar aRedeWiFiSeÉ necessário
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Uma variante de connectToWifiNetwork(String, String)
que só se conecta se o dispositivo
não tem conectividade de rede no momento.
Parâmetros | |
---|---|
scanSsid |
boolean : se é necessário procurar um SSID oculto para esta rede. |
Retorna | |
---|---|
boolean |
true se conectado à rede Wi-Fi. false
caso contrário |
Gera | |
---|---|
DeviceNotAvailableException |
conectar aRedeWiFiSeÉ necessário
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Uma variante de connectToWifiNetwork(String, String)
que só se conecta se o dispositivo
não tem conectividade de rede no momento.
Retorna | |
---|---|
boolean |
true se conectado à rede Wi-Fi. false
caso contrário |
Gera | |
---|---|
DeviceNotAvailableException |
criarUsuário
public int createUser (String name, boolean guest, boolean ephemeral)
Criar um usuário com um determinado nome e as flags fornecidas
Parâmetros | |
---|---|
name |
String : do usuário a ser criado no dispositivo. |
guest |
boolean : ativa a flag de usuário --guest durante a criação. |
ephemeral |
boolean : ativa a sinalização de usuário "-efêmero" durante a criação. |
Retorna | |
---|---|
int |
ID do usuário criado |
Gera | |
---|---|
DeviceNotAvailableException |
criarUsuário
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Criar um usuário com um determinado nome e as flags fornecidas
Parâmetros | |
---|---|
name |
String : do usuário a ser criado no dispositivo. |
guest |
boolean : ativa a flag de usuário --guest durante a criação. |
ephemeral |
boolean : ativa a sinalização de usuário "-efêmero" durante a criação. |
forTesting |
boolean : ativa a flag de teste --for-testing durante a criação. |
Retorna | |
---|---|
int |
ID do usuário criado |
Gera | |
---|---|
DeviceNotAvailableException |
criarUsuário
public int createUser (String name)
Cria um usuário com um nome determinado e flags padrão 0.
Parâmetros | |
---|---|
name |
String : do usuário a ser criado no dispositivo. |
Retorna | |
---|---|
int |
o número inteiro do ID do usuário criado |
Gera | |
---|---|
DeviceNotAvailableException |
createUserNoThrow
public int createUserNoThrow (String name)
Cria um usuário com um nome determinado e flags padrão 0.
Parâmetros | |
---|---|
name |
String : do usuário a ser criado no dispositivo. |
Retorna | |
---|---|
int |
o número inteiro do ID do usuário criado ou -1 para o erro. |
Gera | |
---|---|
DeviceNotAvailableException |
deleteFile
public 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 | |
---|---|
DeviceNotAvailableException |
deleteFile
public 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 | |
---|---|
DeviceNotAvailableException |
deregisterDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Remove o IDeviceActionReceiver
registrado.
Parâmetros | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : uma IDeviceActionReceiver que vai ser removida. |
deviceSoftReiniciado
public 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 | |
---|---|
DeviceNotAvailableException |
deviceSoftRestartedSince
public 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 | |
---|---|
DeviceNotAvailableException |
desativarAdbRoot
public 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 |
desativar Proteção de teclado
public void disableKeyguard ()
Tenta desativar o bloqueio de teclado.
Primeiro, aguarde até que o envio de entradas fique pronto. Isso acontece aproximadamente no mesmo momento em que o dispositivo informa BOOT_COMPLETE, de forma aparentemente assíncrona, porque o framework atual tem uma disputa ocasional. Em seguida, o comando é enviado para dispensar o bloqueio de teclado (funciona somente em aplicativos não seguros)
Gera | |
---|---|
DeviceNotAvailableException |
desativarNetworkMonitor
public boolean disableNetworkMonitor ()
Desativa o monitoramento de rede no dispositivo.
Retorna | |
---|---|
boolean |
true se o monitoramento for desativado. false
em caso de falha. |
Gera | |
---|---|
DeviceNotAvailableException |
desconectarDoWi-Fi
public boolean disconnectFromWifi ()
Desconecta de uma rede Wi-Fi.
Remove todas as redes da lista de redes conhecidas e desativa o Wi-Fi.
Retorna | |
---|---|
boolean |
true se desconectado da rede Wi-Fi. false
se a desconexão falhar. |
Gera | |
---|---|
DeviceNotAvailableException |
fazFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
Método auxiliar para determinar se um arquivo existente no dispositivo existe para um determinado usuário.
Parâmetros | |
---|---|
deviceFilePath |
String : o caminho absoluto do arquivo no dispositivo a ser verificado. |
userId |
int : o ID do usuário para verificar a existência do arquivo. |
Retorna | |
---|---|
boolean |
true se o arquivo existir. Caso contrário, retorna false . |
Gera | |
---|---|
DeviceNotAvailableException |
fazFileExist
public 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 |
dumpHeap
public File dumpHeap (String process, String devicePath)
Tenta despejar a heap do system_server. É responsabilidade do autor da chamada limpar o arquivo despejado.
Parâmetros | |
---|---|
process |
String : o nome do processo do dispositivo em que o despejo de heap será feito. |
devicePath |
String : o caminho no dispositivo em que o despejo será colocado. Precisa ser um local
se houver permissão para isso. |
Retorna | |
---|---|
File |
o ERROR(/File) que contém o relatório. Nulo se algo falhar. |
Gera | |
---|---|
DeviceNotAvailableException |
enableAdbRoot
public 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 |
enableNetworkMonitor
public boolean enableNetworkMonitor ()
Ativa o monitoramento de rede no dispositivo.
Retorna | |
---|---|
boolean |
true se o monitoramento foi ativado. false
em caso de falha. |
Gera | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
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 e o desempenho de falhas.
Parâmetros | |
---|---|
timeout |
long : tempo em milissegundos até o dispositivo deixar de responder. 0L para
sem tempo limite |
cmdArgs |
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 |
executeAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
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 e o desempenho de falhas.
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. |
cmdArgs |
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 |
executeAdbCommand
public String executeAdbCommand (String... cmdArgs)
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 e o desempenho de falhas.
Parâmetros | |
---|---|
cmdArgs |
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 |
executeFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
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 | |
---|---|
cmdArgs |
String : o comando fastboot e os argumentos a serem executados |
Retorna | |
---|---|
CommandResult |
CommandResult que contém a saída do comando |
Gera | |
---|---|
DeviceNotAvailableException |
executeFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
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. |
cmdArgs |
String : o comando fastboot e os argumentos a serem executados |
Retorna | |
---|---|
CommandResult |
CommandResult que contém a saída do comando |
Gera | |
---|---|
DeviceNotAvailableException |
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
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 | |
---|---|
cmdArgs |
String : o comando fastboot e os argumentos a serem executados |
Retorna | |
---|---|
CommandResult |
CommandResult que contém a saída do comando |
Gera | |
---|---|
DeviceNotAvailableException |
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
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 |
cmdArgs |
String : o comando fastboot e os argumentos a serem executados |
Retorna | |
---|---|
CommandResult |
CommandResult que contém a saída do comando |
Gera | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public 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 |
executeShellCommand
public 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 |
executeShellCommand
public 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 |
executeShellCommand
public 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 |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd)
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 | |
---|---|
cmd |
String : o comando que será executado. |
Retorna | |
---|---|
CommandResult |
O resultado em CommandResult . |
Gera | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, 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 | |
---|---|
cmd |
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 |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, 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 | |
---|---|
cmd |
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 |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, 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 | |
---|---|
cmd |
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 |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Executa um comando do shell do adb, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
cmd |
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 |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, 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 | |
---|---|
cmd |
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 |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, 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 | |
---|---|
cmd |
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 |
fastbootWipePartition
public 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 |
getActiveApexes
publicgetActiveApexes ()
Busque as informações sobre os APEXs ativados no dispositivo.
Retorna | |
---|---|
|
ERROR(/Set) de ApexInfo ativados no dispositivo no momento |
Gera | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (String namespace)
Retorna pares de chave-valor do namespace solicitado.
Parâmetros | |
---|---|
namespace |
String : precisa ser {"system", "secure", "global"} |
Retorna | |
---|---|
|
o mapa de pares de chave-valor. Nulo se o namespace não for compatível. |
Gera | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
Retorna o estado de alocação atual do dispositivo
Retorna | |
---|---|
DeviceAllocationState |
getAndroidId
public String getAndroidId (int userId)
Encontre e retorne o android-id associado a um userId. Ele será nulo se não for encontrado.
Parâmetros | |
---|---|
userId |
int |
Retorna | |
---|---|
String |
Gera | |
---|---|
DeviceNotAvailableException |
getAndroidIds
publicgetAndroidIds ()
Cria um mapa de IDs do Android encontrados que correspondem a IDs de usuário. Não há nenhum seguro de que cada usuário ID encontrou um ID do Android associado a essa função, de modo que alguns IDs de usuário podem ter correspondência de valores nulos.
Retorna | |
---|---|
|
Foi encontrado um mapa de IDs do Android com IDs de usuário correspondentes. |
Gera | |
---|---|
DeviceNotAvailableException |
getApiLevel
public 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 | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Busca informações sobre um pacote instalado no dispositivo.
Parâmetros | |
---|---|
packageName |
String |
Retorna | |
---|---|
PackageInfo |
PackageInfo ou null se as informações não puderem ser recuperadas |
Gera | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
Busca informações dos pacotes instalados no dispositivo.
Retorna | |
---|---|
|
ERROR(/List) de PackageInfo s instalados no dispositivo. |
Gera | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public 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 possui rádio, ou a string de versão não pode ser lida) |
Gera | |
---|---|
DeviceNotAvailableException |
getBateria
public 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 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
publicgetBootHistory ()
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
publicgetBootHistorySince (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 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 |
getBugreport
public InputStreamSource getBugreport ()
Recupera um relatório de bug do dispositivo.
A implementação vai continuar funcionando em dispositivos sem cartão SD (ou onde o cartão SD ainda não está montado).
Retorna | |
---|---|
InputStreamSource |
Um InputStreamSource que produzirá o conteúdo do relatório de bug sob demanda. Em
caso de falha, o InputStreamSource produzirá um ERROR(/InputStream) vazio. |
getBugreportz
public InputStreamSource getBugreportz ()
Recupera um relatório de bugs do dispositivo. O relatório de bug no formato ZIP contém o principal relatório de bug e e outros arquivos de registro úteis para depuração.
Compatível apenas com "adb version" > 1.0.36
Retorna | |
---|---|
InputStreamSource |
um InputStreamSource do arquivo zip que contém o bugreportz, retorna nulo no
em caso de falha. |
getBuildAlias
public 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 | |
---|---|
DeviceNotAvailableException |
getBuildFlavor
public 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 | |
---|---|
DeviceNotAvailableException |
getBuildId
public 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 | |
---|---|
DeviceNotAvailableException |
getBuildSigningKeys
public 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 | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Retorna um DeviceDescriptor
armazenado em cache se o dispositivo estiver alocado. Caso contrário, retorna o
DeviceDescriptor
atual.
Retorna | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public 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 String[] getChildren (String path)
Alternativa ao uso de IFileEntry
, que às vezes não funciona devido às permissões.
Parâmetros | |
---|---|
path |
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 | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
A conexão atual associada ao dispositivo.
Retorna | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
Retorna o ContentProviderHandler
ou nulo, se não estiver disponível.
O provedor de conteúdo pode ser reutilizado se tiver sido construído antes com o mesmo userId
.
Parâmetros | |
---|---|
userId |
int : o ID do usuário para inicializar o provedor de conteúdo. |
Retorna | |
---|---|
ContentProviderHandler |
Gera | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Retorna o estado atual do dobrável do dispositivo ou retorna nulo caso ocorram problemas.
Retorna | |
---|---|
DeviceFoldableState |
Gera | |
---|---|
DeviceNotAvailableException |
getCurrentUser
public int getCurrentUser ()
Retorna o ID do usuário em execução no momento. Em caso de erro, retorne -10000.
Retorna | |
---|---|
int |
Gera | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
Acessa a classe do dispositivo.
Retorna | |
---|---|
String |
a classe de dispositivo String . |
getDeviceDate
public long getDeviceDate ()
Retorna a data do dispositivo em milissegundos desde a época.
Retorna | |
---|---|
long |
a data do dispositivo em formato de época. |
Gera | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public 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 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 TestDeviceState getDeviceState ()
Recebe o estado do dispositivo.
Retorna | |
---|---|
TestDeviceState |
getDeviceTimeShift
public 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 InputStreamSource getEmulatorOutput ()
Acessar o stream do emulador stdout e stderr
Retorna | |
---|---|
InputStreamSource |
saída do emulador |
getEmulatorProcess
public Process getEmulatorProcess ()
Retorne o Process
correspondente a esse emulador.
Retorna | |
---|---|
Process |
Process ou null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
O registro que contém todos os registros executeShellCommand(String)
.
Retorna | |
---|---|
File |
getExternalStoreFreeSpace
public 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 |
getFastbootPath
public String getFastbootPath ()
Retorna o caminho do binário fastboot sendo usado.
Ainda é necessário que isFastbootEnabled()
seja verdadeiro para que as funções de fastboot estejam ativadas.
Retorna | |
---|---|
String |
getFastbootProductType
public 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 |
getFastbootProductVariant
public 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 |
getFastbootSerialNumber
public String getFastbootSerialNumber ()
Retorna o número de série do modo fastboot.
Retorna | |
---|---|
String |
getFastbootVariable
public 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 | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
Retorna a string da versão do binário fastboot sendo usado. Ou nulo, se algo der errada.
Retorna | |
---|---|
String |
getFileEntry
public 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 | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Assistente não oficial para receber um FileEntry
de um caminho não raiz. FIXME: refatore o
sistema FileEntry para disponibilizá-lo em qualquer caminho. (mesmo sem raiz).
Parâmetros | |
---|---|
entry |
FileListingService.FileEntry : um FileEntry não necessariamente raiz, conforme exigido pela Ddmlib. |
Retorna | |
---|---|
IFileEntry |
um FileEntryWrapper que representa a FileEntry. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getFoldableStates
publicgetFoldableStates ()
Retorna a lista de estados dobráveis no dispositivo. Pode ser obtido com "cmd device_state print-states".
Retorna | |
---|---|
|
Gera | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
Retorna uma referência ao IDevice
ddmlib 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 |
getInstallPackageNames
publicgetInstalledPackageNames ()
Busque os nomes dos pacotes de apps presentes no dispositivo.
Retorna | |
---|---|
|
ERROR(/Set) de String nomes de pacotes atualmente instalados no dispositivo. |
Gera | |
---|---|
DeviceNotAvailableException |
getIntProperty
public 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 |
getIpAddress
public String getIpAddress ()
Extrai o endereço IP do dispositivo.
Retorna | |
---|---|
String |
o endereço IP do dispositivo ou null se o dispositivo não tiver um endereço IP |
Gera | |
---|---|
DeviceNotAvailableException |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Retorne um objeto para obter o estado atual do bloqueio de teclado ou nulo, se não houver suporte.
Retorna | |
---|---|
KeyguardControllerState |
um KeyguardControllerState contendo um snapshot do estado do bloqueio de teclado
e retorna Nulo se a consulta do Keyguard não tiver suporte. |
Gera | |
---|---|
DeviceNotAvailableException |
getLastLastRestartTimeMillis
public 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 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 | |
---|---|
DeviceNotAvailableException |
getLogcat
public 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 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 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 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 |
getMacAddress
public String getMacAddress ()
Retorna o endereço MAC do dispositivo, retorna nulo se não é possível fazer consultas no dispositivo.
Retorna | |
---|---|
String |
getMainUserId
public Integer getMainUserId ()
Retorna o ID do usuário principal.
Retorna | |
---|---|
Integer |
o userId do usuário principal, se houver, e nulo, se não houver um usuário principal. |
Gera | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
Consiga as informações sobre os módulos de linha principal instalados no dispositivo.
Retorna | |
---|---|
|
ERROR(/Set) de String módulos de linha principal instalados atualmente no dispositivo. |
Gera | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersAllowed
public int getMaxNumberOfRunningUsersSupported ()
Receba o número máximo permitido de usuários em execução simultânea. O valor padrão é 0.
Retorna | |
---|---|
int |
Um número inteiro que indica o número de usuários em execução simultânea |
Gera | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersAllowed
public int getMaxNumberOfUsersSupported ()
Descubra o número máximo de usuários permitidos. O valor padrão é 0.
Retorna | |
---|---|
int |
Um número inteiro que indica o número de usuários compatíveis |
Gera | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
Retorna | |
---|---|
Process |
Retorna o processo da VM do Microdroid. Se TestDevice não for um Microdroid, retorna nulo. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Retorna o IDeviceStateMonitor
associado ao dispositivo.
Retorna | |
---|---|
IDeviceStateMonitor |
getMountPoint
public 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 |
getMountPointInfo
public 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 |
getMountPointInfo
publicgetMountPointInfo ()
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 |
getOptions
public TestDeviceOptions getOptions ()
Busque as opções de teste do dispositivo.
Retorna | |
---|---|
TestDeviceOptions |
TestDeviceOptions relacionado ao dispositivo em teste. |
getPartitionFreeSpace
public 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 |
getPrimaryUserId
public Integer getPrimaryUserId ()
Retorna o ID do usuário principal.
Retorna | |
---|---|
Integer |
o userId do usuário principal, se houver, e nulo, se não houver um usuário principal. |
Gera | |
---|---|
DeviceNotAvailableException |
getProcessByName
public 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 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 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 |
getProductVariant
public 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 |
getProperty
public 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 | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public 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. |
getCaptura de tela
public InputStreamSource getScreenshot (String format)
Faz uma captura de tela do dispositivo. É recomendável usar getCaptura de tela(format) em vez da codificação JPEG para tamanhos menores
Parâmetros | |
---|---|
format |
String : PNG e JPEG compatíveis |
Retorna | |
---|---|
InputStreamSource |
uma InputStreamSource da captura de tela no formato, ou null se
falha na captura de tela. |
Gera | |
---|---|
DeviceNotAvailableException |
getCaptura de tela
public InputStreamSource getScreenshot (long displayId)
Faz uma captura de tela do ID de tela do dispositivo. O formato é PNG.
TODO: estender as implementações acima para oferecer suporte a "format" e "redimensionar"
Parâmetros | |
---|---|
displayId |
long : o ID da tela de onde a captura de tela será feita. |
Retorna | |
---|---|
InputStreamSource |
um InputStreamSource da captura de tela no formato, ou null se o
não foi possível fazer a captura de tela. |
Gera | |
---|---|
DeviceNotAvailableException |
getCaptura de tela
public InputStreamSource getScreenshot (String format, boolean rescale)
Faz uma captura de tela do dispositivo. Recomendamos usar getScreenshot(String)
com codificação JPEG para tamanhos menores.
Parâmetros | |
---|---|
format |
String : PNG e JPEG compatíveis |
rescale |
boolean : se a captura de tela precisar ser redimensionada para reduzir o tamanho da imagem resultante |
Retorna | |
---|---|
InputStreamSource |
um InputStreamSource da captura de tela no formato, ou null se o
não foi possível fazer a captura de tela. |
Gera | |
---|---|
DeviceNotAvailableException |
getCaptura de tela
public InputStreamSource getScreenshot ()
Faz uma captura de tela do dispositivo.
Retorna | |
---|---|
InputStreamSource |
uma InputStreamSource da captura de tela em formato PNG ou null se
falha na captura de tela. |
Gera | |
---|---|
DeviceNotAvailableException |
getSerialNumber
public 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 |
getSetting
public String getSetting (int userId, String namespace, String key)
Retorna o valor da configuração solicitada. O namespace precisa ser um destes: {"system", "secure", "global"}
Parâmetros | |
---|---|
userId |
int |
namespace |
String |
key |
String |
Retorna | |
---|---|
String |
o valor associado ao namespace:key de um usuário. Nulo se não for encontrado. |
Gera | |
---|---|
DeviceNotAvailableException |
getSetting
public String getSetting (String namespace, String key)
Consulte getSetting(int, String, String)
e realizada em um usuário do sistema.
Parâmetros | |
---|---|
namespace |
String |
key |
String |
Retorna | |
---|---|
String |
Gera | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
Retorna o operador do chip ou nulo, se não estiver disponível ou se o dispositivo não estiver disponível.
Retorna | |
---|---|
String |
getSimState
public String getSimState ()
Retorna o estado do chip ou nulo, se não estiver disponível ou o dispositivo não estiver disponível.
Retorna | |
---|---|
String |
getTombstones
publicgetTombstones ()
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 |
getTotalMemory
public 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 |
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
Busque os nomes dos pacotes de aplicativos que podem ser desinstalados. Isso é definido atualmente como pacotes que não são do sistema e pacotes de sistema atualizados.
Retorna | |
---|---|
|
ERROR(/Set) de nomes de pacotes String desinstaláveis atualmente instalados no
dispositivo. |
Gera | |
---|---|
DeviceNotAvailableException |
getUseFastbootApagar
public 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. |
getUserFlags
public int getUserFlags (int userId)
Encontre e retorne as sinalizações de um determinado usuário. As flags são definidas em "android.content.pm.UserInfo" no Android Open Source Project.
Parâmetros | |
---|---|
userId |
int |
Retorna | |
---|---|
int |
as sinalizações associadas ao userId fornecido, se encontrados, -10000 em qualquer outro caso. |
Gera | |
---|---|
DeviceNotAvailableException |
getUserInfos
publicgetUserInfos ()
Recebe o mapa de useId para UserInfo
no dispositivo. Uma DeviceRuntimeException
vai ser gerada se a saída do dispositivo não for a esperada.
Retorna | |
---|---|
|
a lista de objetos UserInfo. |
Gera | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Retorne o número de série associado ao userId, se encontrado. Em qualquer outro caso, retorne -10000.
Parâmetros | |
---|---|
userId |
int |
Retorna | |
---|---|
int |
Gera | |
---|---|
DeviceNotAvailableException |
handleAllocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Processa o DeviceEvent fornecido. Pode fazer a transição do dispositivo
para o novo estado. Informa o IDeviceMonitor
sobre transições de estado.
Processar o DeviceEvent, que pode ou não fazer a transição deste dispositivo para uma nova alocação estado.
Parâmetros | |
---|---|
event |
DeviceEvent |
Retorna | |
---|---|
IManagedTestDevice.DeviceEventResponse |
hasFeature
public boolean hasFeature (String feature)
Verifique se um recurso está disponível em um dispositivo.
Parâmetros | |
---|---|
feature |
String : qual formato deve ser "feature: |
Retorna | |
---|---|
boolean |
Verdadeiro se o atributo for encontrado. Caso contrário, será falso. |
Gera | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Instale um pacote Android no dispositivo.
Parâmetros | |
---|---|
packageFile |
File : o arquivo apk a ser instalado. |
reinstall |
boolean : true se uma reinstalação precisar ser realizada. |
extraArgs |
String : argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis
. |
Retorna | |
---|---|
String |
um String com um código de erro ou null em caso de sucesso. |
Gera | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Instale um pacote Android no dispositivo.
Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em o horário de instalação precisa chamar essa função.
Parâmetros | |
---|---|
packageFile |
File : o arquivo apk a ser instalado. |
reinstall |
boolean : true se uma reinstalação precisar ser realizada. |
grantPermissions |
boolean : se todas as permissões de execução forem concedidas no momento da instalação |
extraArgs |
String : argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis
. |
Retorna | |
---|---|
String |
um String com um código de erro ou null em caso de sucesso. |
Gera | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Instala um pacote Android no dispositivo para um determinado usuário.
Parâmetros | |
---|---|
packageFile |
File : o arquivo apk a ser instalado. |
reinstall |
boolean : true se uma reinstalação precisar ser realizada. |
userId |
int : o ID do usuário inteiro para fazer a instalação. |
extraArgs |
String : argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis
. |
Retorna | |
---|---|
String |
um String com um código de erro ou null em caso de sucesso. |
Gera | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instala um pacote Android no dispositivo para um determinado usuário.
Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em o horário de instalação precisa chamar essa função.
Parâmetros | |
---|---|
packageFile |
File : o arquivo apk a ser instalado. |
reinstall |
boolean : true se uma reinstalação precisar ser realizada. |
grantPermissions |
boolean : se todas as permissões de execução forem concedidas no momento da instalação |
userId |
int : o ID do usuário inteiro para fazer a instalação. |
extraArgs |
String : argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis
. |
Retorna | |
---|---|
String |
um String com um código de erro ou null em caso de sucesso. |
Gera | |
---|---|
DeviceNotAvailableException |
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
Retorna | |
---|---|
boolean |
isAppEnumerationsupported
public 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 | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlockAllowed
public boolean isBypassLowTargetSdkBlockSupported ()
Verificar se a plataforma no dispositivo oferece suporte à evasão de blocos do SDK de destino baixo 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 | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public boolean isDebugfsMounted ()
Verifique se o debugfs está ativado.
Retorna | |
---|---|
boolean |
true se o debugfs estiver ativado |
Gera | |
---|---|
DeviceNotAvailableException |
IsDeviceEncrypted
public boolean isDeviceEncrypted ()
Retorna se o dispositivo estiver criptografado.
Retorna | |
---|---|
boolean |
true se o dispositivo estiver criptografado. |
Gera | |
---|---|
DeviceNotAvailableException |
Diretório isDirectory
public boolean isDirectory (String path)
Retorna "True" se o caminho no dispositivo é um diretório. Caso contrário, retorna "false".
Parâmetros | |
---|---|
path |
String |
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
isEnableAdbRoot
public boolean isEnableAdbRoot ()
Retorna | |
---|---|
boolean |
true se a raiz do adb precisar ser ativada no dispositivo. |
isEncryptionsupported
public boolean isEncryptionSupported ()
Retorna se a criptografia for compatível com o dispositivo.
Retorna | |
---|---|
boolean |
true se o dispositivo for compatível com criptografia. |
Gera | |
---|---|
DeviceNotAvailableException |
IsExecutável
public 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 | |
---|---|
DeviceNotAvailableException |
isFastbootEnabled
public boolean isFastbootEnabled ()
Retorne se o fastboot estiver disponível para o dispositivo.
Retorna | |
---|---|
boolean |
isHeadless
public boolean isHeadless ()
Retorna "true" se o dispositivo for headless (sem tela). Caso contrário, retorna "false".
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Retorna indicando se o dispositivo usa o modo de usuário do sistema headless.
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Informa se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para o status de não administrador.
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
isMultiUsersupported
public boolean isMultiUserSupported ()
Determina se há suporte para vários usuários.
Retorna | |
---|---|
boolean |
verdadeiro se houver suporte para vários usuários; caso contrário, falso |
Gera | |
---|---|
DeviceNotAvailableException |
isPackageInstall
public boolean isPackageInstalled (String packageName, String userId)
Consulte o dispositivo em busca de um determinado nome de pacote e ID do usuário para verificar se ele está instalado ou não para esse usuário.
Parâmetros | |
---|---|
packageName |
String : o pacote que estamos verificando se está instalado. |
userId |
String : o ID do usuário em que o pacote está instalado. Se nulo, o usuário principal
zero será usado. |
Retorna | |
---|---|
boolean |
Verdadeiro se o pacote for relatado como instalado. Falso, do contrário. |
Gera | |
---|---|
DeviceNotAvailableException |
isPackageInstall
public boolean isPackageInstalled (String packageName)
Consulte o dispositivo em busca de um nome de pacote específico para verificar se ele está instalado ou não.
Parâmetros | |
---|---|
packageName |
String |
Retorna | |
---|---|
boolean |
Verdadeiro se o pacote for relatado como instalado. Falso, do contrário. |
Gera | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionAllowed
public 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 | |
---|---|
DeviceNotAvailableException |
isStatebootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
Retorna "true" se o dispositivo está em TestDeviceState#FASTBOOT
ou TestDeviceState.FASTBOOTD
.
Retorna | |
---|---|
boolean |
isUserRunning
public boolean isUserRunning (int userId)
Verifique se um determinado usuário está em execução.
Parâmetros | |
---|---|
userId |
int |
Retorna | |
---|---|
boolean |
Verdadeiro se o usuário estiver correndo e falso em todos os outros casos. |
Gera | |
---|---|
DeviceNotAvailableException |
Secundário do usuário
public boolean isUserSecondary (int userId)
Retorna se o usuário especificado é um usuário secundário, de acordo com as sinalizações dele.
Parâmetros | |
---|---|
userId |
int |
Retorna | |
---|---|
boolean |
verdadeiro se o usuário for secundário. Caso contrário, falso. |
Gera | |
---|---|
DeviceNotAvailableException |
isUserVisible
public boolean isUserVisible (int userId)
Verifica se um determinado usuário está visível.
Um rótulo "visível" usuário é um usuário que está interagindo com o ser humano usuário e, portanto, é capaz de iniciar atividades de inicialização (normalmente na tela padrão).
Parâmetros | |
---|---|
userId |
int |
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Verifica se o usuário especificado está visível na tela especificada.
Um rótulo "visível" usuário é um usuário que está interagindo com o ser humano usuário e, portanto, é capaz de iniciar atividades de inicialização nessa tela.
Parâmetros | |
---|---|
userId |
int |
displayId |
int |
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano no ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
Se isso acontecer, você pode chamar startVisibleBackgroundUser(int, int, boolean)
, transmitindo
uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers()
(que
precisa incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersAllowed
public boolean isVisibleBackgroundUsersSupported ()
Informa se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano.
Se isso acontecer, você pode chamar startVisibleBackgroundUser(int, int, boolean)
, transmitindo
uma tela retornada por listDisplayIdsForStartingVisibleBackgroundUsers()
.
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
Compatível com Wi-Fi
public boolean isWifiEnabled ()
Teste se o Wi-Fi está ativado.
Verifica se o Wi-Fi está ativado no dispositivo. Útil para declarar o status do Wi-Fi antes de testes que não deve funcionar com Wi-Fi, por exemplo, testes de dados móveis.
Retorna | |
---|---|
boolean |
true se o Wi-Fi estiver ativado. false se desativado |
Gera | |
---|---|
DeviceNotAvailableException |
listDisplayIds
publiclistDisplayIds ()
Colete a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys" SurfaceFlinger".
Retorna | |
---|---|
|
A lista de exibições. O padrão sempre retorna a exibição padrão 0. |
Gera | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Recebe a lista de telas que podem ser usadas para start a user visible in the background
.
Retorna | |
---|---|
|
Gera | |
---|---|
DeviceNotAvailableException |
listUsers
publiclistUsers ()
Recebe a lista de usuários no dispositivo. Gera DeviceRuntimeException
se a saída
do dispositivo não é o esperado.
Retorna | |
---|---|
|
a lista de IDs de usuário. |
Gera | |
---|---|
DeviceNotAvailableException |
LogAnrs
public boolean logAnrs (ITestLogger logger)
Coleta e registra ANRs do dispositivo.
Parâmetros | |
---|---|
logger |
ITestLogger : um ITestLogger para registrar os ANRs. |
Retorna | |
---|---|
boolean |
True, se a geração de registros foi bem-sucedida. Caso contrário, false. |
Gera | |
---|---|
DeviceNotAvailableException |
relatório do bug
public boolean logBugreport (String dataName, ITestLogger listener)
Método auxiliar para registrar um relatório de bug e registrá-lo.
Parâmetros | |
---|---|
dataName |
String : nome em que o relatório do bug será informado. |
listener |
ITestLogger : um ITestLogger para registrar o relatório do bug. |
Retorna | |
---|---|
boolean |
Verdadeiro se a geração de registros for bem-sucedida. Caso contrário, é falso. |
LogOnDevice
public 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(). |
nonBlockingReiniciar
public 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 | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
Modifique se o dispositivo precisar que algumas ações específicas sejam realizadas após o adb root e antes do dispositivo está on-line novamente. A implementação padrão não inclui ações de adição. Não há garantia de que a raiz do adb esteja ativada nesta etapa.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
Substituir se o dispositivo precisar que algumas ações específicas sejam realizadas depois do adb unroot e antes o dispositivo ficará on-line novamente. A implementação padrão não inclui outras ações. Não há garantia de que a raiz do adb será desativada nesta etapa.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pós-inicialização
public 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 |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Etapas extras para a limpeza específica do dispositivo que serão executadas após a invocação é concluída.
Parâmetros | |
---|---|
exception |
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 | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
PullDir
public 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 |
PullDir
public 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 |
pullFile
public 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 |
pullFile
public 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 |
pullFile
public 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 |
pullFile
public 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 |
pullFileContents
public 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 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 para o 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 |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Envie recursivamente o conteúdo do diretório para o dispositivo, excluindo alguns diretórios filtrada.
Parâmetros | |
---|---|
localFileDir |
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 |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
Enviar recursivamente o conteúdo do diretório para o dispositivo.
Parâmetros | |
---|---|
localFileDir |
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 |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
Enviar recursivamente o conteúdo do diretório para o dispositivo.
Parâmetros | |
---|---|
localFileDir |
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 |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, 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. |
remoteFilePath |
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 |
pushFile
public boolean pushFile (File localFile, String remoteFilePath)
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. |
remoteFilePath |
String : o caminho absoluto do arquivo de destino remoto |
Retorna | |
---|---|
boolean |
true se o arquivo foi enviado. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, 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. |
remoteFilePath |
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 |
pushString
public boolean pushString (String contents, String remoteFilePath)
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 |
remoteFilePath |
String : o caminho absoluto do arquivo de destino remoto |
Retorna | |
---|---|
boolean |
true se a string foi enviada. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
reiniciar
public void reboot (String reason)
Reinicializa o dispositivo no modo adb com o reason
especificado a ser mantido durante a reinicialização.
Bloqueia até que o dispositivo fique disponível.
O último motivo da reinicialização pode ser encontrado consultando a propriedade sys.boot.reason
.
Parâmetros | |
---|---|
reason |
String : um motivo para essa reinicialização ou null se nenhum motivo for especificado. |
Gera | |
---|---|
DeviceNotAvailableException |
reiniciar
public void reboot ()
Reinicializa o dispositivo no modo adb.
Bloqueia até que o dispositivo fique disponível.
Gera | |
---|---|
DeviceNotAvailableException |
reinicializarIntobootloader
public 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 |
reinicializarIntoFastbootd
public void rebootIntoFastbootd ()
Reinicializa o dispositivo no modo fastbootd.
Bloqueia até que o dispositivo entre no modo fastbootd.
Gera | |
---|---|
DeviceNotAvailableException |
reinicializarIntoRecovery
public void rebootIntoRecovery ()
Reinicializa o dispositivo no modo de recuperação do adb.
Bloqueia até que o dispositivo inicie a recuperação
Gera | |
---|---|
DeviceNotAvailableException |
reinicializarIntoSideload
public 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 |
reinicializarIntoSideload
public 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 |
reinicializarUntilOnline
public 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 |
reinicializarUntilOnline
public 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 |
Reinicializar espaço do usuário
public 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 |
reinicializarUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
Uma alternativa para rebootUserspace()
()} que só será bloqueada até que o dispositivo esteja on-line, ou seja,
visível para o adb.
Gera | |
---|---|
DeviceNotAvailableException |
recupereDispositivo
public boolean recoverDevice ()
Tenta recuperar a comunicação do dispositivo.
Retorna | |
---|---|
boolean |
Verdadeiro em caso de tentativa e êxito de recuperação. Retorna "Falso" se a recuperação foi ignorada |
Gera | |
---|---|
DeviceNotAvailableException |
se o dispositivo não estiver mais disponível |
registrarDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registra um IDeviceActionReceiver
para este dispositivo.
Todos os IDeviceActionReceiver
registrados vão receber uma notificação antes de uma ação no dispositivo
começar e depois que a ação do dispositivo terminar.
Parâmetros | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : um IDeviceActionReceiver que será registrado. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Torne a partição do sistema no dispositivo somente leitura. Pode reinicializar o dispositivo.
Gera | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Torne a partição do sistema no dispositivo gravável. Pode reinicializar o dispositivo.
Gera | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
Torne a partição do fornecedor no dispositivo somente leitura. Pode reinicializar o dispositivo.
Gera | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
Tornar a partição do fornecedor no dispositivo gravável. Pode reinicializar o dispositivo.
Gera | |
---|---|
DeviceNotAvailableException |
removeAdmin
public boolean removeAdmin (String componentName, int userId)
Remove o administrador do dispositivo de um determinado usuário e retorna true
quando o processo é bem-sucedido. Caso contrário, retorna false
.
Parâmetros | |
---|---|
componentName |
String : do administrador do dispositivo a ser removido. |
userId |
int : do usuário em que o administrador do dispositivo está instalado. |
Retorna | |
---|---|
boolean |
Verdadeiro se for bem-sucedido, caso contrário, falso. |
Gera | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
Remova todos os proprietários de perfil de dispositivo existentes da melhor maneira possível.
Gera | |
---|---|
DeviceNotAvailableException |
removeUser
public boolean removeUser (int userId)
Remove determinado usuário do dispositivo.
Parâmetros | |
---|---|
userId |
int : do usuário a ser removido |
Retorna | |
---|---|
boolean |
verdadeiro se conseguirmos remover o usuário, caso contrário é falso. |
Gera | |
---|---|
DeviceNotAvailableException |
resetContentProviderConfigurar
public void resetContentProviderSetup ()
Redefina a flag de configuração do provedor de conteúdo para acioná-la novamente.
runInstrumentationTests
public 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 |
runInstrumentationTests
public 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 |
runInstrumentationTestsAsUser
public 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 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 |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Injeta o IConfiguration
em uso.
Parâmetros | |
---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Parâmetros | |
---|---|
avdInfo |
GceAvdInfo |
definirData
public 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 | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
Define um componente de administrador do dispositivo como proprietário do dispositivo em um determinado usuário.
Parâmetros | |
---|---|
componentName |
String : do administrador do dispositivo para ser o proprietário do dispositivo. |
userId |
int : do usuário em que o proprietário do dispositivo mora. |
Retorna | |
---|---|
boolean |
Verdadeiro se for bem-sucedido, caso contrário, falso. |
Gera | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Atualizar o estado do dispositivo.
Parâmetros | |
---|---|
deviceState |
TestDeviceState : o TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
Para o emulador, defina SizeLimitedOutputStream
para registrar a saída
Parâmetros | |
---|---|
output |
SizeLimitedOutputStream : para registrar a saída. |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Define o Process
quando o dispositivo é um emulador.
Parâmetros | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Defina a opção fastboot para o dispositivo. Deve ser definido quando o dispositivo é o primeiro alocada.
Parâmetros | |
---|---|
fastbootEnabled |
boolean : se o fastboot está disponível ou não para o dispositivo. |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Define o caminho para o binário fastboot que será usado.
Ainda é necessário que isFastbootEnabled()
seja verdadeiro para que as funções de fastboot estejam ativadas.
Parâmetros | |
---|---|
fastbootPath |
String |
setIDevice
public void setIDevice (IDevice newDevice)
Atualize o IDevice associado a esse ITestDevice.
O novo IDevice precisa se referir ao mesmo dispositivo físico que a referência atual. Esse método será chamado se o DDMS tiver alocado um novo IDevice
Parâmetros | |
---|---|
newDevice |
IDevice : o IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Define o tempo em ms de espera antes de iniciar a captura do logcat para um dispositivo on-line.
Parâmetros | |
---|---|
delay |
int : o atraso em ms |
setOptions
public void setOptions (TestDeviceOptions options)
Definir o TestDeviceOptions
para o dispositivo
Parâmetros | |
---|---|
options |
TestDeviceOptions |
setProperty
public 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 | |
---|---|
DeviceNotAvailableException |
setRecovery
public 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 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. |
setSetting
public void setSetting (String namespace, String key, String value)
Consulte setSetting(int, String, String, String)
e realizada em um usuário do sistema.
Parâmetros | |
---|---|
namespace |
String |
key |
String |
value |
String |
Gera | |
---|---|
DeviceNotAvailableException |
setSetting
public void setSetting (int userId, String namespace, String key, String value)
Adiciona um valor de configuração ao namespace de um determinado usuário. Algumas configurações só estarão disponíveis após a reinicialização. O namespace precisa ser um destes: {"system", "secure", "global"}
Parâmetros | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
Gera | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Injeta a instância ITestLogger
Parâmetros | |
---|---|
testLogger |
ITestLogger |
setTrackSerial
public 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 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. |
startLogcat
public 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.
usuáriode inicialização
public boolean startUser (int userId)
Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. Se o usuário já estiver executado em segundo plano, esse método é um NOOP.
Parâmetros | |
---|---|
userId |
int : do usuário que começa em segundo plano |
Retorna | |
---|---|
boolean |
verdadeiro se o usuário tiver sido iniciado com sucesso em segundo plano. |
Gera | |
---|---|
DeviceNotAvailableException |
usuáriode inicialização
public boolean startUser (int userId, boolean waitFlag)
Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. Se o usuário já estiver executado em segundo plano, esse método é um NOOP. É possível fornecer uma flag extra para aguardar que a operação tenha efeito.
Parâmetros | |
---|---|
userId |
int : do usuário que começa em segundo plano |
waitFlag |
boolean : fará o comando aguardar até que o usuário seja iniciado e desbloqueado. |
Retorna | |
---|---|
boolean |
verdadeiro se o usuário tiver sido iniciado com sucesso em segundo plano. |
Gera | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Inicia um determinado usuário em segundo plano, visível na tela especificada (ou seja, permitindo que o usuário para iniciar atividades nessa tela).
OBSERVAÇÃO: esse comando não verifica se o usuário existe, se a exibição está disponível, se device supports such feature
etc.
Parâmetros | |
---|---|
userId |
int : do usuário que começa em segundo plano |
displayId |
int : tela para iniciar visíveis ao usuário |
waitFlag |
boolean : fará o comando aguardar até que o usuário seja iniciado e desbloqueado. |
Retorna | |
---|---|
boolean |
true se o usuário tiver sido iniciado visível em segundo plano. |
Gera | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Feche e exclua a saída do emulador.
stopLogcat
public 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.
stopUser
public boolean stopUser (int userId)
Interrompe um determinado usuário. Se o usuário já tiver sido interrompido, esse método será NOOP. Não é possível interromper o usuário atual e o do sistema.
Parâmetros | |
---|---|
userId |
int : do usuário a ser interrompido. |
Retorna | |
---|---|
boolean |
verdadeiro se o usuário tiver sido interrompido. |
Gera | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Interrompa um determinado usuário. É possível fornecer sinalizações extras para aguardar até que a operação tenha efeito. e forçar o encerramento do usuário. Não é possível interromper o usuário atual e o do sistema.
Parâmetros | |
---|---|
userId |
int : do usuário a ser interrompido. |
waitFlag |
boolean : fará o comando esperar até que o usuário seja interrompido. |
forceFlag |
boolean : força o fechamento do usuário. |
Retorna | |
---|---|
boolean |
verdadeiro se o usuário tiver sido interrompido. |
Gera | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public 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 | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Alterna o dispositivo para adb no modo usb.
Retorna | |
---|---|
boolean |
true se a troca for bem-sucedida. Caso contrário, false . |
Gera | |
---|---|
DeviceNotAvailableException |
switchUser
public boolean switchUser (int userId)
Mude para outro userId com um tempo limite padrão. switchUser(int, long)
.
Parâmetros | |
---|---|
userId |
int |
Retorna | |
---|---|
boolean |
Verdadeiro se o novo userId corresponder ao provedor userId. Falso, do contrário. |
Gera | |
---|---|
DeviceNotAvailableException |
switchUser
public boolean switchUser (int userId, long timeout)
Troque para outro userId com o tempo limite fornecido como prazo. Tentativa de desativar o bloqueio de teclado após a alteração do usuário.
Parâmetros | |
---|---|
userId |
int |
timeout |
long : aguardar antes de retornar "false" para a falha da troca de usuário. |
Retorna | |
---|---|
boolean |
Verdadeiro se o novo userId corresponder ao provedor userId. Falso, do contrário. |
Gera | |
---|---|
DeviceNotAvailableException |
syncFiles
public 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 |
Relatório TakeBug
public Bugreport takeBugreport ()
Crie um relatório de bug e o retorne dentro de um objeto Bugreport
para processá-lo. Retornar nulo
em caso de problema. O arquivo referenciado no objeto Bugreport precisa ser limpo com Bugreport.close()
.
Retorna | |
---|---|
Bugreport |
desinstalarPackage
public String uninstallPackage (String packageName)
Desinstala um pacote Android do dispositivo.
Parâmetros | |
---|---|
packageName |
String : o pacote do Android a ser desinstalado. |
Retorna | |
---|---|
String |
um String com um código de erro ou null em caso de sucesso. |
Gera | |
---|---|
DeviceNotAvailableException |
desinstalarPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
Desinstala um pacote Android do dispositivo para um determinado usuário.
Parâmetros | |
---|---|
packageName |
String : o pacote do Android a ser desinstalado. |
userId |
int : o ID do usuário inteiro para desinstalar. |
Retorna | |
---|---|
String |
um String com um código de erro ou null em caso de sucesso. |
Gera | |
---|---|
DeviceNotAvailableException |
desbloquearDispositivo
public 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 |
"waitForBootComplete"
public 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 | |
---|---|
DeviceNotAvailableException |
"waitForDeviceAvailable"
public 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 |
"waitForDeviceAvailable"
public 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 |
"waitForDeviceAvailableInRecoverPath"
public 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 |
"waitForDeviceBootloader"
public void waitForDeviceBootloader ()
Bloqueia até que o dispositivo fique visível pelo fastboot. Usar tempo limite padrão.
Gera | |
---|---|
DeviceNotAvailableException |
"waitForDeviceInRecovery"
public boolean waitForDeviceInRecovery (long waitTime)
Bloqueia o dispositivo em "recuperação do adb" estado (diferente do
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 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 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 void waitForDeviceOnline ()
Bloqueia até que o dispositivo fique visível via adb. Usa o tempo limite padrão
O dispositivo pode não ser necessariamente responsivo a comandos após a conclusão. Usar
waitForDeviceAvailable()
.
Gera | |
---|---|
DeviceNotAvailableException |
"waitForDeviceOnline"
public void waitForDeviceOnline (long waitTime)
Bloqueia até que o dispositivo fique visível via adb.
O dispositivo pode não ser necessariamente responsivo a comandos após a conclusão. Usar
waitForDeviceAvailable()
.
Parâmetros | |
---|---|
waitTime |
long : o tempo de espera em ms |
Gera | |
---|---|
DeviceNotAvailableException |
"waitForDeviceShell"
public 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. |
Métodos protegidos
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Parâmetros | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Cria o comando do SO para a sessão de comando do shell do adb e os args específicos
Parâmetros | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
Retorna | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Parâmetros | |
---|---|
feature |
String |
strictMinLevel |
int |
createReiniciarDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Crie um RebootDeviceAction
para ser usado ao executar uma ação de reinicialização.
Parâmetros | |
---|---|
rebootMode |
NativeDevice.RebootMode : um modo da reinicialização. |
reason |
String : para esta reinicialização. |
Retorna | |
---|---|
NativeDevice.RebootDeviceAction |
o RebootDeviceAction criado. |
doAdbReiniciar
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Execute uma reinicialização do adb.
Parâmetros | |
---|---|
rebootMode |
NativeDevice.RebootMode : um modo da reinicialização. |
reason |
String : para esta reinicialização. |
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
certifiqueRuntimePermissionAllowed
protected void ensureRuntimePermissionSupported ()
método auxiliar para gerar uma exceção se a permissão de tempo de execução não for compatível
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Retorna | |
---|---|
int |
getRunUtil
protected IRunUtil getRunUtil ()
Consiga a instância RunUtil
a ser usada.
Retorna | |
---|---|
IRunUtil |
inicializeConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parâmetros | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
Gera | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
internalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Busca uma propriedade do dispositivo no cache ddmlib por padrão e volta para o adb shell getprop` ou `fastboot getvar`, dependendo se o dispositivo está em fastboot ou não.
Parâmetros | |
---|---|
propName |
String : o nome da propriedade do dispositivo conforme retornado por "adb shell getprop". |
fastbootVar |
String : o nome da variável fastboot equivalente a ser consultada. se for null ,
a consulta fastboot não será tentada |
description |
String : uma descrição simples da variável. A primeira letra deve estar em maiúscula. |
Retorna | |
---|---|
String |
Uma string, possivelmente null ou vazia, contendo o valor da propriedade especificada |
Gera | |
---|---|
DeviceNotAvailableException |
isInReiniciarCallback
protected boolean isInRebootCallback ()
Retorna se os callbacks de reinicialização estão sendo executados ou não. Todas as APIs públicas de Se for "true", a reinicialização vai ser desativada.
Retorna | |
---|---|
boolean |
IsNewer
protected boolean isNewer (File localFile, IFileEntry entry)
Retorne true
se o arquivo local for mais recente que o arquivo remoto. IFileEntry
sendo
o minuto, no caso de horários iguais, o arquivo será considerado mais recente.
Parâmetros | |
---|---|
localFile |
File |
entry |
IFileEntry |
Retorna | |
---|---|
boolean |
notificarReiniciarEnded
protected void notifyRebootEnded ()
Notifica todos os IDeviceActionReceiver
sobre o evento de término de reinicialização.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notificarReiniciarIniciado
protected void notifyRebootStarted ()
Notifica todos os IDeviceActionReceiver
sobre o evento de início de reinicialização.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
performDeviceAction
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Executa uma ação neste dispositivo. Tenta recuperar o dispositivo e, opcionalmente, repetir o comando se a ação vai falhar.
Parâmetros | |
---|---|
actionDescription |
String : uma breve descrição da ação a ser realizada. Usado para geração de registros
para fins específicos. |
action |
NativeDevice.DeviceAction : a ação a ser realizada. |
retryAttempts |
int : a repetição tenta realizar a ação se falhar, mas a recuperação é bem-sucedida. |
Retorna | |
---|---|
boolean |
true se a ação tiver sido realizada |
Gera | |
---|---|
DeviceNotAvailableException |
se a tentativa de recuperação falhar ou se o número máximo de tentativas for atingido sem sucesso |
pós-reinicialização do Adb
protected void postAdbReboot ()
Outras ações que podem ser realizadas após a reinicialização.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Configuração PrePostBoot
protected void prePostBootSetup ()
Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) modifique esse método para configuração específica pós-inicialização.
Gera | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Parâmetros | |
---|---|
remoteFilePath |
String |
localFile |
File |
Retorna | |
---|---|
boolean |
Gera | |
---|---|
DeviceNotAvailableException |
definir relógio
protected void setClock (Clock clock)
Define a instância do Relógio a ser usada.
Parâmetros | |
---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Marca o TestDevice como microdroide e define o CID dele.
Parâmetros | |
---|---|
process |
Process : processo da VM do Microdroid. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Parâmetros | |
---|---|
deviceOptions |
|
SimpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Executa um comando fastboot simples com variáveis de ambiente e informa o status da kubectl.
Parâmetros | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
Retorna | |
---|---|
CommandResult |
SimpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Executa um comando fastboot simples e informa o status do comando.
Parâmetros | |
---|---|
timeout |
long |
fullCmd |
String |
Retorna | |
---|---|
CommandResult |
"waitForDeviceNotAvailable"
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Aguarde até que o dispositivo fique indisponível (pare de gerar relatórios para o adb).
Parâmetros | |
---|---|
operationDesc |
String : o nome da operação que está aguardando indisponível. |
time |
long : o tempo de espera pela indisponibilidade. |
Retorna | |
---|---|
boolean |
Verdadeiro se o dispositivo ficou indisponível. |