Dispositivo nativo
public class NativeDevice
extends Object
implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.device.NativeDevice |
Implementação padrão de dispositivos Android ITestDevice
não full stack.
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 de comando para executar |
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 () Micro otimização (cerca de 400 milissegundos) pré-buscando todos os adereços que precisamos, em vez de chamar 'adb getprop' para cada um. |
boolean | canSwitchToHeadlessSystemUser () Retorna se é permitido mudar para o usuário SYSTEM sem cabeça. |
boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) Verifique se um recurso é atualmente suportado ou não, dado um nível minimamente suportado. |
boolean | checkConnectivity () Verifique se o dispositivo tem conectividade de rede. |
boolean | clearErrorDialogs () Tente descartar quaisquer caixas de diálogo de erro exibidas atualmente na IU do dispositivo. |
void | clearLastConnectedWifiNetwork () Limpa a última rede wifi conectada. |
void | clearLogcat () Exclui quaisquer dados acumulados do logcat. |
boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) Conecta-se a uma rede wi-fi. |
boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) Conecta-se a uma rede wi-fi. |
boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) Conecta-se a uma rede wifi.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) Crie um usuário com um determinado nome e os sinalizadores fornecidos |
int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) Crie um usuário com um determinado nome e os sinalizadores fornecidos |
int | createUser (String name) Crie um usuário com um determinado nome e sinalizadores padrão 0. |
int | createUserNoThrow (String name) Crie um usuário com um determinado nome e sinalizadores padrão 0. |
void | deleteFile (String deviceFilePath) Método auxiliar para excluir um arquivo ou diretório no dispositivo. |
void | deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Remove o |
boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) Método auxiliar para verificar se o dispositivo foi reiniciado suavemente, comparando o system_server atual com o system_server |
boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) Método auxiliar para verificar se o dispositivo foi reiniciado suavemente desde o horário UTC desde a época do dispositivo e seu |
boolean | disableAdbRoot () Desativa a raiz do adb. |
void | disableKeyguard () Tentativas de desativar a proteção do teclado. |
boolean | disableNetworkMonitor () Desativa o monitoramento de rede no dispositivo. |
boolean | disconnectFromWifi () Desconecta de uma rede wifi. |
boolean | doesFileExist (String deviceFilePath, int userId) Método auxiliar para determinar se o arquivo no dispositivo existe para um determinado usuário. |
boolean | doesFileExist (String deviceFilePath) Método auxiliar para determinar se o arquivo no dispositivo existe. |
File | dumpHeap (String process, String devicePath) Tente despejar o 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, envMap, String... cmdArgs) executeAdbCommand (long timeout, envMap, String... cmdArgs) 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 ( envVarMap, String... cmdArgs) executeLongFastbootCommand ( envVarMap, String... cmdArgs) Método auxiliar que executa um comando fastboot de longa duração como um comando do sistema com variáveis de ambiente do sistema. |
String | executeShellCommand (String command) Método auxiliar que executa um comando shell adb e retorna a saída como |
void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando. |
void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando. |
void | executeShellCommand (String command, IShellOutputReceiver receiver) Executa o comando adb shell fornecido, tentando novamente várias vezes se o comando falhar. |
CommandResult | executeShellV2Command (String cmd) Método auxiliar que executa um comando shell adb e retorna os resultados como um |
CommandResult | executeShellV2Command (String cmd, OutputStream pipeToOutput) Método auxiliar que executa um comando shell adb e retorna os resultados como um |
CommandResult | executeShellV2Command (String cmd, File pipeAsInput) Método auxiliar que executa um comando shell adb e retorna os resultados como um |
CommandResult | executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) Executa um comando shell adb, com mais parâmetros para controlar o comportamento do comando. |
CommandResult | executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit) Executa um comando shell 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 shell 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 shell adb, com mais parâmetros para controlar o comportamento do comando. |
CommandResult | fastbootWipePartition (String partition) Método auxiliar que limpa uma partição do dispositivo. |
getActiveApexes () Busque as informações sobre APEXes ativados no dispositivo. | |
getAllSettings (String namespace) Retorna pares de valores-chave do namespace solicitado. | |
DeviceAllocationState | getAllocationState () Retornar o estado atual de alocação do dispositivo |
String | getAndroidId (int userId) Encontre e retorne o android-id associado a um userId, nulo se não for encontrado. |
getAndroidIds () Crie um mapa de IDs de Android encontrados que correspondam aos IDs de usuário. | |
int | getApiLevel () Obtenha o nível de API do dispositivo. |
PackageInfo | getAppPackageInfo (String packageName) Busque informações sobre um pacote instalado no dispositivo. |
getAppPackageInfos () Busque informações de pacotes instalados no dispositivo. | |
String | getBasebandVersion () Método de conveniência para obter a versão de banda base (rádio) deste dispositivo. |
Integer | getBattery () Retorna o nível atual da bateria de um dispositivo ou Nulo se o nível da bateria não estiver disponível. |
boolean | getBooleanProperty (String name, boolean defaultValue) Retorna o valor booleano da propriedade fornecida. |
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 de inicialização e o motivo da inicialização desde o tempo determinado desde a época do dispositivo e a unidade de tempo especificada. | |
String | getBootloaderVersion () Método conveniente para obter a versão do bootloader deste dispositivo. |
InputStreamSource | getBugreport () Recupera um relatório de bug do dispositivo. |
InputStreamSource | getBugreportz () Recupera um bugreportz do dispositivo. |
String | getBuildAlias () Recupere o alias do build que o dispositivo está executando atualmente. |
String | getBuildFlavor () Recupere o tipo de compilação para o dispositivo. |
String | getBuildId () Recupere a compilação que o dispositivo está executando atualmente. |
String | getBuildSigningKeys () Retorna o tipo de chave usado para assinar a imagem do dispositivo Normalmente, os dispositivos Android podem ser assinados com chaves de teste (como no AOSP) ou chaves de liberação (controladas por fabricantes de dispositivos individuais) |
DeviceDescriptor | getCachedDeviceDescriptor () Retorna um |
DeviceDescriptor | getCachedDeviceDescriptor (boolean shortDescriptor) Retorna um |
String[] | getChildren (String path) Alternativa ao uso |
AbstractConnection | getConnection () A conexão atual associada ao dispositivo. |
DeviceFoldableState | getCurrentFoldableState () Retorna o estado dobrável atual do dispositivo ou nulo se ocorrerem alguns problemas. |
int | getCurrentUser () Retorne o ID do usuário em execução atual. |
String | getDeviceClass () Obtenha a classe do dispositivo. |
long | getDeviceDate () Retorne a data do dispositivo em milissegundos desde a época. |
DeviceDescriptor | getDeviceDescriptor () Retorne um |
DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) Retorne um |
TestDeviceState | getDeviceState () Obtenha o estado do dispositivo. |
long | getDeviceTimeOffset (Date date) Auxiliar para obter a diferença de horário entre o dispositivo e um determinado |
InputStreamSource | getEmulatorOutput () Obtenha o fluxo do emulador stdout e stderr |
Process | getEmulatorProcess () Retorne o |
final File | getExecuteShellCommandLog () O log que contém todos os logs |
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 que está sendo usado. |
String | getFastbootProductType () Método conveniente para obter o tipo de produto deste dispositivo quando estiver no modo fastboot. |
String | getFastbootProductVariant () Método conveniente para obter o tipo de produto deste dispositivo quando estiver no modo fastboot. |
String | getFastbootSerialNumber () Retorna o número de série do modo fastboot. |
String | getFastbootVariable (String variableName) Recupere o valor da variável fastboot fornecido do dispositivo. |
String | getFastbootVersion () Retorna a string da versão do binário fastboot que está sendo usado. |
IFileEntry | getFileEntry (String path) Recuperar uma referência a um arquivo remoto no dispositivo. |
IFileEntry | getFileEntry (FileListingService.FileEntry entry) Ajudante não oficial para obter um |
getFoldableStates () Retorna a lista de estados dobráveis no dispositivo. | |
IDevice | getIDevice () Retorna uma referência ao ddmlib |
getInstalledPackageNames () Busque os nomes dos pacotes de aplicativos presentes no dispositivo. | |
long | getIntProperty (String name, long defaultValue) Retorna o valor inteiro da propriedade fornecida do dispositivo. |
String | getIpAddress () Obtém o endereço IP do dispositivo. |
KeyguardControllerState | getKeyguardState () Retorne um objeto para obter o estado atual do keyguard ou nulo se não for compatível. |
long | getLastExpectedRebootTimeMillis () Retorna a última vez que as APIs Tradefed acionaram uma reinicialização em milissegundos desde EPOCH, conforme retornado por |
int | getLaunchApiLevel () Obtenha o primeiro nível de API lançado no dispositivo. |
InputStreamSource | getLogcat () Captura um fluxo de instantâneo dos dados do logcat. |
InputStreamSource | getLogcat (int maxBytes) Captura um fluxo de instantâneo dos últimos |
InputStreamSource | getLogcatDump () Obtenha um dump do logcat atual do dispositivo. |
InputStreamSource | getLogcatSince (long date) Captura um fluxo instantâneo de dados do logcat capturados a partir da data fornecida. |
String | getMacAddress () Retorna o endereço MAC do dispositivo, nulo se não for possível consultar o dispositivo. |
Integer | getMainUserId () Retorna o ID do usuário principal. |
getMainlineModuleInfo () Obtenha as informações sobre os módulos principais instalados no dispositivo. | |
int | getMaxNumberOfRunningUsersSupported () Obtenha o número máximo de usuários com suporte em execução simultânea. |
int | getMaxNumberOfUsersSupported () Obtenha o número máximo de usuários com suporte. |
Process | getMicrodroidProcess () |
IDeviceStateMonitor | getMonitor () Retorne 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 para o 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 os comandos "pidof" e "stat" e retorna o objeto |
String | getProcessPid (String process) Retorna o pid do serviço ou null se algo deu errado. |
String | getProductType () Método de conveniência para obter o tipo de produto deste dispositivo. |
String | getProductVariant () Método de conveniência para obter a variante do produto deste dispositivo. |
String | getProperty (String name) Recuperar o valor da propriedade fornecido do dispositivo. |
ITestDevice.RecoveryMode | getRecoveryMode () Obtenha o modo de recuperação atual usado para o dispositivo. |
InputStreamSource | getScreenshot (String format) Captura uma captura de tela do dispositivo. |
InputStreamSource | getScreenshot (long displayId) Captura uma captura de tela do dispositivo com o ID de exibição. |
InputStreamSource | getScreenshot (String format, boolean rescale) Captura uma captura de tela do dispositivo. |
InputStreamSource | getScreenshot () Captura 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) Retorne o valor da configuração solicitada. |
String | getSetting (String namespace, String key) Veja |
String | getSimOperator () Retorne a operadora do cartão SIM ou nulo se não estiver disponível ou se o dispositivo não estiver disponível. |
String | getSimState () Retorne o estado do cartão SIM ou nulo se não estiver disponível ou se o dispositivo não estiver disponível. |
getTombstones () Busque e retorne a lista de lápides dos dispositivos. | |
long | getTotalMemory () Retorna o tamanho total da memória física em bytes ou -1 em caso de erro interno |
getUninstallablePackageNames () Obtenha os nomes dos pacotes de aplicativos que podem ser desinstalados. | |
boolean | getUseFastbootErase () Defina se deseja usar o apagamento fastboot ou o formato fastboot para limpar uma partição no dispositivo. |
int | getUserFlags (int userId) Encontre e retorne os sinalizadores de um determinado usuário. |
getUserInfos () Obtém o mapa de useId para | |
int | getUserSerialNumber (int userId) Retorne o número de série associado ao userId se encontrado, -10000 em qualquer outro caso. |
IManagedTestDevice.DeviceEventResponse | handleAllocationEvent (DeviceEvent event) Processe o DeviceEvent fornecido. Processe o DeviceEvent, que pode ou não fazer a transição deste dispositivo para um novo estado de alocação. |
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) Instale um pacote Android no dispositivo para um determinado usuário. |
String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instale um pacote Android no dispositivo para um determinado usuário. |
void | invalidatePropertyCache () |
boolean | isAdbRoot () |
boolean | isAdbTcp () |
boolean | isAppEnumerationSupported () Verifique se a plataforma no dispositivo suporta enumeração de aplicativos |
boolean | isBypassLowTargetSdkBlockSupported () Verifique se a plataforma no dispositivo suporta ignorar o bloqueio SDK de destino baixo em instalações de aplicativos |
boolean | isDebugfsMounted () Verifique se o debugfs está montado. |
boolean | isDeviceEncrypted () Retorna se o dispositivo estiver criptografado. |
boolean | isDirectory (String path) Retorna True se o caminho no dispositivo for um diretório; caso contrário, 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 for um arquivo executável; caso contrário, retorna false. |
boolean | isFastbootEnabled () Retorne se o fastboot estiver disponível para o dispositivo. |
boolean | isHeadless () Retorne verdadeiro se o dispositivo estiver sem cabeça (sem tela), caso contrário, retorne falso. |
boolean | isHeadlessSystemUserMode () Retorna se o dispositivo usa o modo de usuário do sistema headless. |
boolean | isMainUserPermanentAdmin () Retorna 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 para obter um determinado nome de pacote e um determinado ID de usuário para verificar se ele está instalado ou não para esse usuário. |
boolean | isPackageInstalled (String packageName) Consulte o dispositivo para obter um determinado nome de pacote para verificar se ele está instalado ou não. |
boolean | isRuntimePermissionSupported () Verifique se a plataforma no dispositivo suporta a concessão de permissão de tempo de execução |
boolean | isStateBootloaderOrFastbootd () Retorna verdadeiro se o dispositivo estiver 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 seus sinalizadores. |
boolean | isUserVisible (int userId) Verifica se o usuário determinado está visível. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Verifica se o usuário determinado está visível na exibição especificada. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano no |
boolean | isVisibleBackgroundUsersSupported () Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano. |
boolean | isWifiEnabled () Teste se o wifi está ativado. |
listDisplayIds () Colete a lista de IDs de exibição disponíveis no dispositivo, conforme relatado por "dumpsys SurfaceFlinger". | |
listDisplayIdsForStartingVisibleBackgroundUsers () Obtém a lista de exibições que podem ser usadas para | |
listUsers () Obtém 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 obter um relatório de bug e registrá-lo aos repórteres. |
void | logOnDevice (String tag, Log.LogLevel level, String format, Object... args) Registre uma mensagem no logcat do dispositivo. |
void | mountDebugfs () Monte debugfs. |
void | nonBlockingReboot () Emite um comando para reinicializar o dispositivo e retorna quando o comando é concluído e quando o dispositivo não está mais visível para o adb. |
void | postAdbRootAction () Substitua se o dispositivo precisar que algumas ações específicas sejam executadas após o adb root e antes de o dispositivo ficar on-line novamente. |
void | postAdbUnrootAction () Substitua se o dispositivo precisar que algumas ações específicas sejam executadas após o adb desenraizar e antes que o dispositivo esteja online novamente. |
void | postBootSetup () Siga as instruções para configurar o dispositivo para teste após cada inicialização. |
void | postInvocationTearDown (Throwable exception) Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a invocação. |
void | preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes) Etapas extras para configuração necessária específica do dispositivo que serão executadas no dispositivo antes do fluxo de invocação. |
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, armazena-o em um local temporário |
File | pullFile (String remoteFilePath) Recupera um arquivo do dispositivo, armazena-o em um local temporário |
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 local temporário |
boolean | pushDir (File localFileDir, String deviceFilePath, excludedDirectories) pushDir (File localFileDir, String deviceFilePath, excludedDirectories) Envie recursivamente o conteúdo do diretório para o dispositivo, excluindo alguns diretórios que são filtrados. |
boolean | pushDir (File localFileDir, String deviceFilePath) Envie 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 | pushString (String contents, String remoteFilePath) Enviar arquivo criado a partir de uma string para o dispositivo |
void | reboot (String reason) Reinicia o dispositivo no modo adb com um determinado |
void | reboot () Reinicia o dispositivo no modo adb. |
void | rebootIntoBootloader () Reinicia o dispositivo no modo bootloader. |
void | rebootIntoFastbootd () Reinicia o dispositivo no modo fastbootd. |
void | rebootIntoRecovery () Reinicia o dispositivo no modo de recuperação adb. |
void | rebootIntoSideload () Reinicia o dispositivo no modo adb sideload (observe que este é um modo especial de recuperação) Bloqueia até que o dispositivo entre no modo sideload |
void | rebootIntoSideload (boolean autoReboot) Reinicia o dispositivo no modo adb sideload (observe que este é um modo especial de recuperação) Bloqueia até que o dispositivo entre no modo sideload |
void | rebootUntilOnline () Uma alternativa para |
void | rebootUntilOnline (String reason) Uma alternativa para |
void | rebootUserspace () Reinicia apenas parte do espaço do usuário do dispositivo. |
void | rebootUserspaceUntilOnline () Uma alternativa para |
boolean | recoverDevice () Tentativas de 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 () Torne a partição do fornecedor no dispositivo gravável. |
boolean | removeAdmin (String componentName, int userId) Remova o administrador do dispositivo em determinado usuário e retorne |
void | removeOwners () Remova todos os proprietários de perfis de dispositivos existentes com o melhor esforço. |
boolean | removeUser (int userId) Remova um determinado usuário do dispositivo. |
void | resetContentProviderSetup () Redefina o sinalizador de configuração do provedor de conteúdo para acioná-lo novamente. |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) Método de conveniência para executar |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) Executa testes de instrumentação e fornece recuperação de dispositivos. |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) O mesmo que |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) O mesmo que |
void | setConfiguration ( IConfiguration configuration) Injeta o |
final void | setConnectionAvdInfo ( GceAvdInfo avdInfo) |
void | setDate (Date date) Define a data no dispositivo Nota: definir a data no dispositivo requer root |
boolean | setDeviceOwner (String componentName, int userId) Defina um componente de administração do dispositivo como proprietário do dispositivo em determinado usuário. |
void | setDeviceState ( TestDeviceState deviceState) Atualize 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 deve ser usado. |
void | setIDevice (IDevice newDevice) Atualize o IDevice associado a este ITestDevice. |
void | setLogStartDelay (int delay) Define o tempo em ms de espera antes de iniciar a captura do logcat para um dispositivo online. |
void | setOptions ( TestDeviceOptions options) Defina |
boolean | setProperty (String propKey, String propValue) Define o valor da propriedade fornecido no dispositivo. |
void | setRecovery ( IDeviceRecovery recovery) Defina o |
void | setRecoveryMode ( ITestDevice.RecoveryMode mode) Defina o modo de recuperação atual a ser usado pelo dispositivo. |
void | setSetting (String namespace, String key, String value) Veja |
void | setSetting (int userId, String namespace, String key, String value) Adicione um valor de configuração ao namespace de um determinado usuário. |
void | setTestLogger ( ITestLogger testLogger) Injeta a instância |
void | setUseFastbootErase (boolean useFastbootErase) Defina se deseja usar o apagamento fastboot ou o formato fastboot para limpar uma partição no dispositivo. |
void | startLogcat () Comece a capturar a saída do logcat do dispositivo em segundo plano. |
boolean | startUser (int userId) Inicia um determinado usuário em segundo plano se ele estiver parado no momento. |
boolean | startUser (int userId, boolean waitFlag) Inicia um determinado usuário em segundo plano se ele estiver parado no momento. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Inicia um determinado usuário em segundo plano, visível em uma determinada tela (ou seja, permitindo que o usuário inicie atividades naquela tela). |
void | stopEmulatorOutput () Feche e exclua a saída do emulador. |
void | stopLogcat () Pare de capturar a saída do logcat do dispositivo e descarte os dados do logcat salvos atualmente. |
boolean | stopUser (int userId) Interrompe um determinado usuário. |
boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Pare um determinado usuário. |
String | switchToAdbTcp () Mude o dispositivo para o modo adb-over-tcp. |
boolean | switchToAdbUsb () Mude o dispositivo para o modo adb sobre usb. |
boolean | switchUser (int userId) Mude para outro userId com um tempo limite padrão. |
boolean | switchUser (int userId, long timeout) Mude para outro userId com o tempo limite fornecido como prazo. |
boolean | syncFiles (File localFileDir, String deviceFilePath) Sincroniza incrementalmente o conteúdo de um diretório de arquivos local com o dispositivo. |
Bugreport | takeBugreport () Pegue um relatório de bug e retorne-o dentro de um objeto |
String | uninstallPackage (String packageName) Desinstale um pacote Android do dispositivo. |
String | uninstallPackageForUser (String packageName, int userId) Desinstale um pacote Android do dispositivo para um determinado usuário. |
boolean | unlockDevice () Desbloqueia o dispositivo se ele estiver em estado criptografado. |
void | unmountDebugfs () Desmonte debugfs. |
boolean | waitForBootComplete (long timeOut) Bloqueia até que o sinalizador de inicialização completa do dispositivo seja definido. |
boolean | waitForDeviceAvailable () Aguarda que o dispositivo responda e esteja disponível para teste. |
boolean | waitForDeviceAvailable (long waitTime) Aguarda que o dispositivo responda e esteja disponível para teste. |
boolean | waitForDeviceAvailableInRecoverPath (long waitTime) Aguarda que o dispositivo responda e esteja disponível sem considerar o caminho de recuperação. |
void | waitForDeviceBootloader () Bloqueia até que o dispositivo fique visível via fastboot. |
boolean | waitForDeviceInRecovery (long waitTime) Blocos para o dispositivo estar no estado 'adb recovery' (observe que isso é diferente de |
boolean | waitForDeviceInSideload (long waitTime) Blocos para o dispositivo estar no estado 'adb sideload' |
boolean | waitForDeviceNotAvailable (long waitTime) Blocos para o dispositivo não estarem disponíveis, 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) Aguarda que o dispositivo responda a um comando básico do shell adb. |
Métodos protegidos | |
---|---|
void | addExtraConnectionBuilderArgs ( DefaultConnection.ConnectionBuilder builder) |
String[] | buildAdbShellCommand (String command, boolean forceExitStatusDetection) Constrói o comando do sistema operacional para a sessão de comando e argumentos do shell adb fornecido |
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 lançar exceção se a permissão de tempo de execução não for suportada |
int | getApiLevelSafe () |
ITestLogger | getLogger () |
IRunUtil | getRunUtil () Obtenha a instância |
void | initializeConnection ( IBuildInfo info, MultiMap <String, String> attributes) |
String | internalGetProperty (String propName, String fastbootVar, String description) Busque uma propriedade de dispositivo, do cache ddmlib por padrão, e volte para `adb shell getprop` ou `fastboot getvar` dependendo se o dispositivo está em Fastboot ou não. |
boolean | isInRebootCallback () Retorna se os retornos de chamada de reinicialização estão sendo executados ou não. |
boolean | isNewer (File localFile, IFileEntry entry) Retorne |
void | notifyRebootEnded () Notifica todos |
void | notifyRebootStarted () Notifica todos |
boolean | performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts) Executa uma ação neste dispositivo. |
void | postAdbReboot () Possíveis ações extras que podem ser executadas após uma reinicialização. |
void | prePostBootSetup () Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) substitua esse método para configuração específica pós-inicialização. |
boolean | pullFileInternal (String remoteFilePath, File localFile) |
void | setClock (Clock clock) Defina a instância de Clock a ser usada. |
void | setMicrodroidProcess (Process process) Marca o TestDevice como microdroid e define seu CID. |
void | setTestDeviceOptions ( deviceOptions) setTestDeviceOptions ( deviceOptions) |
CommandResult | simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) Executa um comando fastboot simples com variáveis de ambiente e relata o status do comando. |
CommandResult | simpleFastbootCommand (long timeout, String[] fullCmd) Executa um comando fastboot simples e relata o status do comando. |
boolean | waitForDeviceNotAvailable (String operationDesc, long time) Espere para ver o dispositivo ficar indisponível (pare de reportar ao 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: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Valor Constante: 5000 (0x000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
o número padrão de tentativas de repetição de comando para executar
Valor Constante: 2 (0x00000002)
Campos
DEBUGFS_PATH
public static final String DEBUGFS_PATH
CARTÃO SD
protected static final String SD_CARD
ARMAZENAMENTO_EMULADO
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 alterações de estado de alocação. Pode ser nulo |
Métodos públicos
batchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Micro otimização (cerca de 400 milissegundos) pré-buscando todos os adereços que precisamos, em vez de chamar 'adb getprop' para cada um. ou seja, é tão rápido buscar todas as propriedades quanto buscar uma. Coisas como device.getApiLevel(), checkApiLevelAgainstNextRelease e getBuildAlias chamam `adb getprop` nos bastidores. Nós os buscamos em uma chamada e chamamos NativeDevice.setProperty. Mesmo se não fizermos isso, o próprio NativeDevice chamará setProperty e armazenará em cache o resultado para chamadas futuras. Estamos apenas fazendo isso um pouco mais cedo. Se o dispositivo estiver em recuperação ou houver outros erros ao buscar os adereços, nós simplesmente os ignoramos.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Retorna se é permitido mudar para o usuário SYSTEM sem cabeça.
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Verifique se um recurso é atualmente suportado ou não, dado um nível minimamente suportado. Este método leva em consideração recursos ainda não lançados, antes do nível da API ser aumentado.
Parâmetros | |
---|---|
strictMinLevel | int : O nível mínimo possível estrito que suporta o recurso. |
Devoluções | |
---|---|
boolean | Verdadeiro se o nível for compatível. Caso contrário, falso. |
Lança | |
---|---|
DeviceNotAvailableException |
verificar conectividade
public boolean checkConnectivity ()
Verifique se o dispositivo tem conectividade de rede.
Devoluções | |
---|---|
boolean | true se o dispositivo tiver uma conexão de rede funcionando, false caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException |
clearErrorDialogs
public boolean clearErrorDialogs ()
Tente descartar quaisquer caixas de diálogo de erro exibidas atualmente na IU do dispositivo.
Devoluções | |
---|---|
boolean | true se nenhuma caixa de diálogo estiver presente ou se as caixas de diálogo tiverem sido limpas com êxito. false caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException |
limparLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
Limpa a última rede wifi conectada. Deve ser chamado ao iniciar uma nova invocação para evitar a conexão à rede wifi usada no teste anterior após a reinicialização do dispositivo.
limparLogcat
public void clearLogcat ()
Exclui quaisquer dados acumulados do logcat.
Isso é útil para casos em que você deseja garantirITestDevice#getLogcat()
retorne apenas dados de log produzidos após um determinado ponto (como após atualizar uma nova construção de dispositivo, etc.). conectarToWifiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Conecta-se a uma rede wi-fi.
Liga o wifi e bloqueia até que uma conexão bem-sucedida seja feita com uma das redes wifi fornecidas no mapa wifiSsidToPsk. Assim que a conexão for estabelecida, a instância tentará restaurá-la após cada reinicialização até que ITestDevice#disconnectFromWifi()
ou ITestDevice#clearLastConnectedWifiNetwork()
seja chamado.
Parâmetros | |
---|---|
wifiSsidToPsk | |
scanSsid | boolean : se deve procurar SSIDs ocultos para esta rede. |
Devoluções | |
---|---|
boolean | true se conectado à rede wifi com sucesso. false caso contrário |
Lança | |
---|---|
DeviceNotAvailableException |
conectarToWifiNetwork
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 bem-sucedida seja feita à rede Wi-Fi especificada. Assim que a conexão for estabelecida, a instância tentará restaurá-la após cada reinicialização até queITestDevice#disconnectFromWifi()
ou ITestDevice#clearLastConnectedWifiNetwork()
seja chamado.Parâmetros | |
---|---|
wifiSsid | String : o ssid do wifi ao qual se conectar |
wifiPsk | String : senha PSK ou nula se não criptografada |
Devoluções | |
---|---|
boolean | true se conectado à rede wifi com sucesso. false caso contrário |
Lança | |
---|---|
DeviceNotAvailableException |
conectarToWifiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk)
Conecta-se a uma rede wi-fi.
Liga o wifi e bloqueia até que uma conexão bem-sucedida seja feita com uma das redes wifi fornecidas no mapa wifiSsidToPsk. Assim que a conexão for estabelecida, a instância tentará restaurar a conexão após cada reinicialização até que ITestDevice#disconnectFromWifi()
ou ITestDevice#clearLastConnectedWifiNetwork()
seja chamado.f
Parâmetros | |
---|---|
wifiSsidToPsk |
Devoluções | |
---|---|
boolean | true se conectado à rede wifi com sucesso. false caso contrário |
Lança | |
---|---|
DeviceNotAvailableException |
conectarToWifiNetwork
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 bem-sucedida seja feita à rede Wi-Fi especificada. Assim que a conexão for estabelecida, a instância tentará restaurá-la após cada reinicialização até queITestDevice#disconnectFromWifi()
ou ITestDevice#clearLastConnectedWifiNetwork()
seja chamado.Parâmetros | |
---|---|
wifiSsid | String : o ssid do wifi ao qual se conectar |
wifiPsk | String : senha PSK ou nula se não criptografada |
scanSsid | boolean : se deve procurar SSID oculto para esta rede. |
Devoluções | |
---|---|
boolean | true se conectado à rede wifi com sucesso. false caso contrário |
Lança | |
---|---|
DeviceNotAvailableException |
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Uma variante de connectToWifiNetwork(String, String)
que só se conecta se o dispositivo atualmente não tiver conectividade de rede.
Parâmetros | |
---|---|
scanSsid | boolean : se deve procurar SSID oculto para esta rede |
Devoluções | |
---|---|
boolean | true se conectado à rede wifi com sucesso. false caso contrário |
Lança | |
---|---|
DeviceNotAvailableException |
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Uma variante de connectToWifiNetwork(String, String)
que só se conecta se o dispositivo atualmente não tiver conectividade de rede.
Devoluções | |
---|---|
boolean | true se conectado à rede wifi com sucesso. false caso contrário |
Lança | |
---|---|
DeviceNotAvailableException |
criarUsuário
public int createUser (String name, boolean guest, boolean ephemeral)
Crie um usuário com um determinado nome e os sinalizadores fornecidos
Parâmetros | |
---|---|
name | String : do usuário a ser criado no dispositivo |
guest | boolean : habilita o sinalizador do usuário --guest durante a criação |
ephemeral | boolean : habilita o sinalizador do usuário --ephemeral durante a criação |
Devoluções | |
---|---|
int | id do usuário criado |
Lança | |
---|---|
DeviceNotAvailableException |
criarUsuário
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Crie um usuário com um determinado nome e os sinalizadores fornecidos
Parâmetros | |
---|---|
name | String : do usuário a ser criado no dispositivo |
guest | boolean : habilita o sinalizador do usuário --guest durante a criação |
ephemeral | boolean : habilita o sinalizador do usuário --ephemeral durante a criação |
forTesting | boolean : habilita o sinalizador de teste --for-testing durante a criação |
Devoluções | |
---|---|
int | id do usuário criado |
Lança | |
---|---|
DeviceNotAvailableException |
criarUsuário
public int createUser (String name)
Crie um usuário com um determinado nome e sinalizadores padrão 0.
Parâmetros | |
---|---|
name | String : do usuário a ser criado no dispositivo |
Devoluções | |
---|---|
int | o número inteiro para o ID do usuário criado |
Lança | |
---|---|
DeviceNotAvailableException |
createUserNoThrow
public int createUserNoThrow (String name)
Crie um usuário com um determinado nome e sinalizadores padrão 0.
Parâmetros | |
---|---|
name | String : do usuário a ser criado no dispositivo |
Devoluções | |
---|---|
int | o número inteiro para o ID do usuário criado ou -1 para erro. |
Lança | |
---|---|
DeviceNotAvailableException |
excluir arquivo
public void deleteFile (String deviceFilePath)
Método auxiliar para excluir um arquivo ou diretório no dispositivo.
Parâmetros | |
---|---|
deviceFilePath | String : O caminho absoluto do arquivo no dispositivo. |
Lança | |
---|---|
DeviceNotAvailableException |
cancelar registroDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Remove o IDeviceActionReceiver
registrado.
Parâmetros | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : Um IDeviceActionReceiver que será removido. |
dispositivoSoftRestarted
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Método auxiliar para verificar se o dispositivo foi reiniciado suavemente, comparando o system_server atual com o system_server ProcessInfo
anterior. Use getProcessByName(String)
para obter ProcessInfo
.
Parâmetros | |
---|---|
prevSystemServerProcess | ProcessInfo : o processo system_server anterior ProcessInfo . |
Devoluções | |
---|---|
boolean | true se o dispositivo for reiniciado suavemente |
Lança | |
---|---|
DeviceNotAvailableException |
dispositivoSoftRestartedSince
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Método auxiliar para verificar se o dispositivo foi reiniciado suavemente desde o horário UTC desde a época do dispositivo e seu ERROR(/TimeUnit)
. Soft-Restart refere-se a system_server reiniciado fora de uma reinicialização forçada do dispositivo (por exemplo: reinicialização solicitada). O dispositivo atual utcEpochTime em Milliseccond pode ser obtido pelo método getDeviceDate()
.
Parâmetros | |
---|---|
utcEpochTime | long : o tempo do dispositivo em segundos desde a época. |
timeUnit | TimeUnit : a unidade de tempo TimeUnit para o utcEpochTime fornecido. |
Devoluções | |
---|---|
boolean | true se o dispositivo for reiniciado suavemente |
Lança | |
---|---|
DeviceNotAvailableException |
desativarAdbRoot
public boolean disableAdbRoot ()
Desativa a raiz do adb.
Desativar o adb root pode fazer com que o dispositivo se desconecte do adb. Este método será bloqueado até que o dispositivo esteja disponível.Devoluções | |
---|---|
boolean | true se for bem-sucedido. |
Lança | |
---|---|
DeviceNotAvailableException |
desabilitarKeyguard
public void disableKeyguard ()
Tentativas de desativar a proteção do teclado.
Primeiro espere que o despacho de entrada fique pronto, isso acontece quase ao mesmo tempo em que o dispositivo reporta BOOT_COMPLETE, aparentemente de forma assíncrona, porque a implementação da estrutura atual tem condições de corrida ocasionais. Em seguida, o comando é enviado para descartar a proteção do teclado (funciona apenas em dispositivos não seguros)
Lança | |
---|---|
DeviceNotAvailableException |
desativarNetworkMonitor
public boolean disableNetworkMonitor ()
Desativa o monitoramento de rede no dispositivo.
Devoluções | |
---|---|
boolean | true se o monitoramento for desabilitado com sucesso. false se falhou. |
Lança | |
---|---|
DeviceNotAvailableException |
desconectarFromWifi
public boolean disconnectFromWifi ()
Desconecta de uma rede wifi.
Remove todas as redes da lista de redes conhecidas e desativa o wifi.Devoluções | |
---|---|
boolean | true se desconectado da rede wifi com sucesso. false se a desconexão falhou. |
Lança | |
---|---|
DeviceNotAvailableException |
fazFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
Método auxiliar para determinar se o arquivo 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 |
Devoluções | |
---|---|
boolean | true se o arquivo existir, false caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException |
fazFileExist
public boolean doesFileExist (String deviceFilePath)
Método auxiliar para determinar se o arquivo no dispositivo existe.
Parâmetros | |
---|---|
deviceFilePath | String : o caminho absoluto do arquivo no dispositivo a ser verificado |
Devoluções | |
---|---|
boolean | true se o arquivo existir, false caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException |
dumpHeap
public File dumpHeap (String process, String devicePath)
Tente despejar o heap do system_server. É responsabilidade do chamador limpar o arquivo despejado.
Parâmetros | |
---|---|
process | String : o nome do processo do dispositivo no qual dumpheap. |
devicePath | String : o caminho no dispositivo onde colocar o dump. Este deve ser um local onde as permissões permitam. |
Devoluções | |
---|---|
File | o ERROR(/File) que contém o relatório. Nulo se algo falhou. |
Lança | |
---|---|
DeviceNotAvailableException |
ativarAdbRoot
public boolean enableAdbRoot ()
Ativa a raiz do adb. Se a configuração "enable-root" for "false", registrará uma mensagem e retornará sem habilitar o root.
Ativar o adb root pode fazer com que o dispositivo se desconecte do adb. Este método será bloqueado até que o dispositivo esteja disponível.Devoluções | |
---|---|
boolean | true se for bem-sucedido. |
Lança | |
---|---|
DeviceNotAvailableException |
habilitarNetworkMonitor
public boolean enableNetworkMonitor ()
Ativa o monitoramento de rede no dispositivo.
Devoluções | |
---|---|
boolean | true se o monitoramento for habilitado com sucesso. false se falhou. |
Lança | |
---|---|
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.
executeShellCommand(String)
deve ser usado sempre que possível, pois esse método fornece melhor detecção de falhas e desempenho.
Parâmetros | |
---|---|
timeout | long : o tempo em milissegundos antes que o dispositivo seja considerado sem resposta, 0L sem tempo limite |
cmdArgs | String : o comando adb e os argumentos a serem executados |
Devoluções | |
---|---|
String | o stdout do comando. null se o comando falhou na execução. |
Lança | |
---|---|
DeviceNotAvailableException |
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.
executeShellCommand(String)
deve ser usado sempre que possível, pois esse método fornece melhor detecção de falhas e desempenho.
Parâmetros | |
---|---|
timeout | long : o tempo em milissegundos antes que o dispositivo seja considerado sem resposta, 0L sem tempo limite |
envMap | |
cmdArgs | String : o comando adb e os argumentos a serem executados |
Devoluções | |
---|---|
String | o stdout do comando. null se o comando falhou na execução. |
Lança | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (String... cmdArgs)
Método auxiliar que executa um comando adb como um comando do sistema.
executeShellCommand(String)
deve ser usado sempre que possível, pois esse método fornece melhor detecção de falhas e desempenho.Parâmetros | |
---|---|
cmdArgs | String : o comando adb e os argumentos a serem executados |
Devoluções | |
---|---|
String | o stdout do comando. null se o comando falhou na execução. |
Lança | |
---|---|
DeviceNotAvailableException |
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.
Espera-se que seja usado quando o dispositivo já estiver no modo fastboot.
Parâmetros | |
---|---|
cmdArgs | String : o comando fastboot e argumentos para executar |
Devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
Lança | |
---|---|
DeviceNotAvailableException |
executeFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Método auxiliar que executa um comando fastboot como um comando do sistema.
Espera-se que seja usado quando o dispositivo já estiver no modo fastboot.Parâmetros | |
---|---|
timeout | long : o tempo em milissegundos antes do comando expirar |
cmdArgs | String : o comando fastboot e argumentos para executar |
Devoluções | |
---|---|
CommandResult | o CommandResult contendo a saída do comando |
Lança | |
---|---|
DeviceNotAvailableException |
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Método Helper, que executa um comando Fastboot de longa execução como um comando do sistema.
Idêntico paraexecuteFastbootCommand(String)
exceto que usa um tempo limite mais longo.Parâmetros | |
---|---|
cmdArgs | String : O comando e argumentos Fastboot para executar |
Devoluções | |
---|---|
CommandResult | o comandoResult contendo saída do comando |
Lança | |
---|---|
DeviceNotAvailableException |
ExecutElongfastBootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
Método Helper, que executa um comando Fastboot de longa execução como um comando do sistema com variáveis de ambiente do sistema.
Idêntico para executeFastbootCommand(String)
exceto que usa um tempo limite mais longo.
Parâmetros | |
---|---|
envVarMap | |
cmdArgs | String : O comando e argumentos Fastboot para executar |
Devoluções | |
---|---|
CommandResult | o comandoResult contendo saída do comando |
Lança | |
---|---|
DeviceNotAvailableException |
ExecuteshellCommand
public String executeShellCommand (String command)
Método Helper, que executa um comando adb shell e retorna a saída como uma String
.
Parâmetros | |
---|---|
command | String : o comando adb shell para executar |
Devoluções | |
---|---|
String | a saída do shell |
Lança | |
---|---|
DeviceNotAvailableException |
ExecuteshellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command | String : o comando adb shell para executar |
receiver | IShellOutputReceiver : o IShellOutputReceiver para direcionar a saída do shell. |
maxTimeToOutputShellResponse | long : a quantidade máxima de tempo durante a qual o comando não pode gerar nenhuma resposta; unidade conforme especificado na timeUnit |
timeUnit | TimeUnit : Unidade para maxTimeToOutputShellResponse |
retryAttempts | int : O número máximo de vezes para repetir o comando se falhar devido a uma exceção. DeviceNotResponsiveException será lançado se retryAttempts forem realizadas sem sucesso. |
Lança | |
---|---|
DeviceNotAvailableException |
ExecuteshellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
command | String : o comando adb shell para executar |
receiver | IShellOutputReceiver : o IShellOutputReceiver para direcionar a saída do shell. |
maxTimeoutForCommand | long : o tempo limite máximo para o comando ser concluído; unidade conforme especificado na timeUnit |
maxTimeToOutputShellResponse | long : a quantidade máxima de tempo durante a qual o comando não pode gerar nenhuma resposta; unidade conforme especificado na timeUnit |
timeUnit | TimeUnit : Unidade para maxTimeToOutputShellResponse |
retryAttempts | int : O número máximo de vezes para repetir o comando se falhar devido a uma exceção. DeviceNotResponsiveException será lançado se retryAttempts forem realizadas sem sucesso. |
Lança | |
---|---|
DeviceNotAvailableException |
ExecuteshellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver)
Executa o comando adb shell fornecido, voltando várias vezes se o comando falhar.
Uma forma mais simples deexecuteShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
com valores padrão.Parâmetros | |
---|---|
command | String : o comando adb shell para executar |
receiver | IShellOutputReceiver : o IShellOutputReceiver para direcionar a saída do shell. |
Lança | |
---|---|
DeviceNotAvailableException |
Executeshellv2Command
public CommandResult executeShellV2Command (String cmd)
Método Helper, que executa um comando adb shell e retorna os resultados como um CommandResult
preenchido corretamente com a saída de status de comando, stdout e stderr.
Parâmetros | |
---|---|
cmd | String : o comando que deve ser executado. |
Devoluções | |
---|---|
CommandResult | O resultado em CommandResult . |
Lança | |
---|---|
DeviceNotAvailableException |
Executeshellv2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Método Helper, que executa um comando de shell adb e retorna os resultados como um CommandResult
preenchido corretamente com a saída de status do comando e stderr. O STDOUT é direcionado para o fluxo especificado.
Parâmetros | |
---|---|
cmd | String : o comando que deve ser executado. |
pipeToOutput | OutputStream : ERROR(/OutputStream) onde a saída STD será redirecionada ou nula. |
Devoluções | |
---|---|
CommandResult | O resultado em CommandResult . |
Lança | |
---|---|
DeviceNotAvailableException |
Executeshellv2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Método Helper, que executa um comando de shell adb e retorna os resultados como um CommandResult
preenchido corretamente com a saída de status de comando, stdout e stderr.
Parâmetros | |
---|---|
cmd | String : o comando que deve ser executado. |
pipeAsInput | File : um ERROR(/File) que será canalizado como entrada para o comando ou nulo. |
Devoluções | |
---|---|
CommandResult | O resultado em CommandResult . |
Lança | |
---|---|
DeviceNotAvailableException |
Executeshellv2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
cmd | String : o comando adb shell para executar |
maxTimeoutForCommand | long : o tempo limite máximo para o comando ser concluído; unidade conforme especificado na timeUnit |
timeUnit | TimeUnit : Unidade para maxTimeToOutputShellResponse |
retryAttempts | int : O número máximo de vezes para repetir o comando se falhar devido a uma exceção. DeviceNotResponsiveException será lançado se retryAttempts forem realizadas sem sucesso. |
Devoluções | |
---|---|
CommandResult |
Lança | |
---|---|
DeviceNotAvailableException |
Executeshellv2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
cmd | String : o comando adb shell para executar |
maxTimeoutForCommand | long : o tempo limite máximo para o comando ser concluído; unidade conforme especificado na timeUnit |
timeUnit | TimeUnit : Unidade para maxTimeToOutputShellResponse |
Devoluções | |
---|---|
CommandResult |
Lança | |
---|---|
DeviceNotAvailableException |
Executeshellv2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
cmd | String : o comando adb shell para executar |
pipeAsInput | File : um ERROR(/File) que será canalizado como entrada para o comando ou nulo. |
pipeToOutput | OutputStream : ERROR(/OutputStream) onde a saída STD será redirecionada ou nula. |
maxTimeoutForCommand | long : o tempo limite máximo para o comando ser concluído; unidade conforme especificado na timeUnit |
timeUnit | TimeUnit : Unidade para maxTimeToOutputShellResponse |
retryAttempts | int : O número máximo de vezes para repetir o comando se falhar devido a uma exceção. DeviceNotResponsiveException será lançado se retryAttempts forem realizadas sem sucesso. |
Devoluções | |
---|---|
CommandResult |
Lança | |
---|---|
DeviceNotAvailableException |
Executeshellv2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Executa um comando adb shell, com mais parâmetros para controlar o comportamento do comando.
Parâmetros | |
---|---|
cmd | String : o comando adb shell para executar |
pipeAsInput | File : um ERROR(/File) que será canalizado como entrada para o comando ou nulo. |
pipeToOutput | OutputStream : ERROR(/OutputStream) onde a saída STD será redirecionada ou nula. |
pipeToError | OutputStream : ERROR(/OutputStream) onde o erro DST será redirecionado ou nulo. |
maxTimeoutForCommand | long : o tempo limite máximo para o comando ser concluído; unidade conforme especificado na timeUnit |
timeUnit | TimeUnit : Unidade para maxTimeToOutputShellResponse |
retryAttempts | int : O número máximo de vezes para repetir o comando se falhar devido a uma exceção. DeviceNotResponsiveException será lançado se retryAttempts forem realizadas sem sucesso. |
Devoluções | |
---|---|
CommandResult |
Lança | |
---|---|
DeviceNotAvailableException |
FastBootwipepartição
public CommandResult fastbootWipePartition (String partition)
Método Helper que limpa uma partição para o dispositivo.
SegetUseFastbootErase()
for true
, a apagamento fastboot será usada para limpar a partição. O dispositivo deve então criar um sistema de arquivos na próxima vez que as botas do dispositivo. Caso contrário, o formato Fastboot é usado que criará um novo sistema de arquivos no dispositivo. Espera -se ser usado quando o dispositivo já estiver no modo Fastboot.Parâmetros | |
---|---|
partition | String : a partição para limpar |
Devoluções | |
---|---|
CommandResult | o comandoResult contendo saída do comando |
Lança | |
---|---|
DeviceNotAvailableException |
getActiveapexes
publicgetActiveApexes ()
Busque as informações sobre os ápice ativados no dispositivo.
Devoluções | |
---|---|
ERROR(/Set) de ApexInfo atualmente ativado no dispositivo |
Lança | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (String namespace)
Retorne pares de valor da chave do espaço de nome solicitado.
Parâmetros | |
---|---|
namespace | String : deve ser um dos {"System", "Secure", "Global"} |
Devoluções | |
---|---|
o mapa dos pares do valor da chave. Nulo se o namespace não for suportado. |
Lança | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
Retorne o estado de alocação atual do dispositivo
Devoluções | |
---|---|
DeviceAllocationState |
Getandroidid
public String getAndroidId (int userId)
Encontre e retorne o Android-ID associado a um usuário do usuário, nulo se não for encontrado.
Parâmetros | |
---|---|
userId | int |
Devoluções | |
---|---|
String |
Lança | |
---|---|
DeviceNotAvailableException |
Getandroidids
publicgetAndroidIds ()
Crie um mapa dos IDs do Android encontrado IDs de usuário correspondentes. Não há seguro de que cada ID do usuário tenha encontrado um ID do Android associado a essa função para que alguns IDs de usuário possam corresponder ao NULL.
Devoluções | |
---|---|
O mapa dos IDs do Android encontrou IDs de usuário correspondentes. |
Lança | |
---|---|
DeviceNotAvailableException |
getapilevel
public int getApiLevel ()
Obtenha o nível da API do dispositivo. Padrão para UNKNOWN_API_LEVEL
.
Devoluções | |
---|---|
int | um número inteiro indicando o nível da API do dispositivo |
Lança | |
---|---|
DeviceNotAvailableException |
getApppackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Pegue informações sobre um pacote instalado no dispositivo.
Parâmetros | |
---|---|
packageName | String |
Devoluções | |
---|---|
PackageInfo | o PackageInfo ou null se a informação não puder ser recuperada |
Lança | |
---|---|
DeviceNotAvailableException |
getApppackageInfos
publicgetAppPackageInfos ()
Buscar informações dos pacotes instalados no dispositivo.
Devoluções | |
---|---|
ERROR(/List) de PackageInfo S instalado no dispositivo. |
Lança | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public String getBasebandVersion ()
Método de conveniência para obter a versão BaseBand (Radio) deste dispositivo. Obter a versão de rádio é específica do dispositivo, portanto, pode não retornar as informações corretas para todos os dispositivos. Este método depende da propriedade GSM.Version.BaseBand para retornar as informações corretas da versão. Isso não é preciso para alguns dispositivos CDMA e a versão retornada aqui pode não corresponder à versão relatada do Fastboot e pode não retornar a versão para o rádio CDMA. Tl; dr Este método relata apenas uma versão precisa se a propriedade GSM.Version.BaseBand for a mesma que a versão retornada pelo fastboot getvar version-baseband
.
Devoluções | |
---|---|
String | A versão String BaseBand ou null se não puder ser determinada (o dispositivo não possui string de rádio ou versão não pode ser lido) |
Lança | |
---|---|
DeviceNotAvailableException |
getbattery
public Integer getBattery ()
Retorna o nível atual da bateria de um dispositivo ou nulo se o nível da bateria indisponível.
Devoluções | |
---|---|
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 para retornar se a propriedade estiver vazia ou não existir. |
Devoluções | |
---|---|
boolean | true se a propriedade tiver valor "1" , "y" , "yes" , "on" ou "true" , false se a propriedade tiver valor de "0" , "n" , "no" , "off" , "false" ou defaultValue de outra forma. |
Lança | |
---|---|
DeviceNotAvailableException |
Getboothistory
publicgetBootHistory ()
O método Helper coleta o mapa do histórico de inicialização com o tempo de inicialização e o motivo da inicialização.
Devoluções | |
---|---|
Mapa do tempo de inicialização (tempo da UTC em segundo desde a época) e motivo de inicialização |
Lança | |
---|---|
DeviceNotAvailableException |
Getboothistorysince
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
O Método Helper coleta o mapa do histórico de inicialização com o tempo de inicialização e a razão de inicialização desde o tempo fornecido desde a época do dispositivo e a unidade de tempo especificada. O dispositivo atual Utcepochtime em milissegundos pode ser obtido pelo método getDeviceDate()
.
Parâmetros | |
---|---|
utcEpochTime | long : o tempo do dispositivo desde a época. |
timeUnit | TimeUnit : o horário da unidade TimeUnit tempo. |
Devoluções | |
---|---|
Mapa do tempo de inicialização (tempo da UTC em segundo desde a época) e motivo de inicialização |
Lança | |
---|---|
DeviceNotAvailableException |
getbootloadVerSion
public String getBootloaderVersion ()
Método de conveniência para obter a versão do carregador de inicialização deste dispositivo.
Tentará recuperar a versão do carregador de inicialização do estado atual do dispositivo. (ou seja, se o dispositivo estiver no modo Fastboot, ele tentará recuperar a versão do Fastboot)Devoluções | |
---|---|
String | a versão String BootLoader ou null se não puder ser encontrada |
Lança | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
Recupera um relatório de bug do dispositivo.
É garantido que a implementação disso continue trabalhando em um dispositivo sem um SDCARD (ou onde o SDCARD ainda não está montado).
Devoluções | |
---|---|
InputStreamSource | Um InputStreamSource que produzirá o conteúdo do relatório de bugs sob demanda. Em caso de falha, o InputStreamSource produzirá um ERROR(/InputStream) . |
getBugreportz
public InputStreamSource getBugreportz ()
Recupera um BugReportz do dispositivo. O BugReport de formato ZIP contém o principal relatório de bugs e outros arquivos de log que são úteis para depuração.
Somente suportado para 'ADB Version'> 1.0.36
Devoluções | |
---|---|
InputStreamSource | Um InputStreamSource do arquivo zip que contém o bugreportz, retorna nulo em caso de falha. |
getBuildalias
public String getBuildAlias ()
Recupere o alias da construção em que o dispositivo está em execução no momento.
O alias de construção é geralmente uma string mais legível do que o ID de construção (normalmente um número para construções de nexus). Por exemplo, o lançamento final do Android 4.2 tem alias de construção JDQ39 e Build ID 573038
Devoluções | |
---|---|
String | o pseudônimo de construção ou recuar para construir o ID se não puder ser recuperado |
Lança | |
---|---|
DeviceNotAvailableException |
getBuildFLAVE
public String getBuildFlavor ()
Recupere o sabor da construção para o dispositivo.
Devoluções | |
---|---|
String | o sabor da construção ou nulo se não pudesse ser recuperado |
Lança | |
---|---|
DeviceNotAvailableException |
getBuildid
public String getBuildId ()
Recuperar a construção O dispositivo está em execução no momento.
Devoluções | |
---|---|
String | O ID da construção ou IBuildInfo#UNKNOWN_BUILD_ID se não pudesse ser recuperado |
Lança | |
---|---|
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 teclas de teste (como no AOSP) ou teclas de liberação (controladas por fabricantes de dispositivos individuais)
Devoluções | |
---|---|
String | A tecla de assinatura, se for encontrada, nula. |
Lança | |
---|---|
DeviceNotAvailableException |
getCachedDeviceScriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Retorna um DeviceDescriptor
em cache se o dispositivo for alocado, caso contrário, retornará o DeviceDescriptor
atual.
Devoluções | |
---|---|
DeviceDescriptor |
getCachedDeviceScriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Retorna um DeviceDescriptor
em cache se o dispositivo for alocado, caso contrário, retornará o DeviceDescriptor
atual.
Parâmetros | |
---|---|
shortDescriptor | boolean : se deve ou não limitar o descritor a informações mínimas nuas |
Devoluções | |
---|---|
DeviceDescriptor |
Getchildren
public String[] getChildren (String path)
Alternativa ao uso IFileEntry
que às vezes não funciona devido a permissões.
Parâmetros | |
---|---|
path | String : é o caminho no dispositivo onde fazer a pesquisa |
Devoluções | |
---|---|
String[] | Matriz de string contendo todo o arquivo em um caminho no dispositivo. |
Lança | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
A conexão atual associada ao dispositivo.
Devoluções | |
---|---|
AbstractConnection |
getCurrentFoldablestate
public DeviceFoldableState getCurrentFoldableState ()
Retorna o estado dobrável atual do dispositivo ou nulo se ocorreram alguns problemas.
Devoluções | |
---|---|
DeviceFoldableState |
Lança | |
---|---|
DeviceNotAvailableException |
GetCurrentUser
public int getCurrentUser ()
Retorne o ID do usuário em execução atual. Em caso de erro, retorne -10000.
Devoluções | |
---|---|
int |
Lança | |
---|---|
DeviceNotAvailableException |
getDeviceclass
public String getDeviceClass ()
Obtenha a classe de dispositivo.
Devoluções | |
---|---|
String | a classe de dispositivo String . |
getDevicedate
public long getDeviceDate ()
Retorne a data do dispositivo em milissegundos desde a época.
Devoluções | |
---|---|
long | A data do dispositivo em formato de época. |
Lança | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
Retorne um DeviceDescriptor
das informações do dispositivo para obter informações sobre ele sem passar o objeto de dispositivo real.
Devoluções | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Retorne um DeviceDescriptor
das informações do dispositivo para obter informações sobre ele sem passar o objeto de dispositivo real.
Parâmetros | |
---|---|
shortDescriptor | boolean : se deve ou não limitar o descritor a informações mínimas nuas |
Devoluções | |
---|---|
DeviceDescriptor |
getDevicestate
public TestDeviceState getDeviceState ()
Obtenha o estado do dispositivo.
Devoluções | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Helper para obter a diferença de horário entre o dispositivo e um determinado ERROR(/Date)
. Use o tempo da época internamente.
Parâmetros | |
---|---|
date | Date |
Devoluções | |
---|---|
long | a diferença em milissegundos |
Lança | |
---|---|
DeviceNotAvailableException |
getemulatorOutput
public InputStreamSource getEmulatorOutput ()
Obtenha o fluxo do emulador stdout e stderr
Devoluções | |
---|---|
InputStreamSource | saída do emulador |
getemulatorProcess
public Process getEmulatorProcess ()
Retorne o Process
correspondente a este emulador.
Devoluções | |
---|---|
Process | o Process ou null |
getExecuteshellCommandlog
public final File getExecuteShellCommandLog ()
O log que contém todos os logs executeShellCommand(String)
.
Devoluções | |
---|---|
File |
getExternalStoreFreespace
public long getExternalStoreFreeSpace ()
Método auxiliar para determinar a quantidade de espaço livre no armazenamento externo do dispositivo.
Devoluções | |
---|---|
long | a quantidade de espaço livre em KB |
Lança | |
---|---|
DeviceNotAvailableException |
getfastbootpath
public String getFastbootPath ()
Retorna o caminho do binário Fastboot que está sendo usado. Ainda exige que isFastbootEnabled()
seja verdadeiro, para ter as funções Fastboots ativadas.
Devoluções | |
---|---|
String |
getfastBootProductType
public String getFastbootProductType ()
Método de conveniência para obter o tipo de produto deste dispositivo quando estiver no modo Fastboot.
Este método deve ser usado apenas se o dispositivo estiver no fastboot. É uma variante um pouco mais segura que o método genéricogetProductType()
neste caso, porque o itestDevice saberá recuperar o dispositivo no fastboot se o dispositivo estiver em estado incorreto ou não responder.Devoluções | |
---|---|
String | o nome do tipo de produto String ou null se não puder ser determinado |
Lança | |
---|---|
DeviceNotAvailableException |
getfastbootproductvariant
public String getFastbootProductVariant ()
Método de conveniência para obter o tipo de produto deste dispositivo quando estiver no modo Fastboot.
Este método deve ser usado apenas se o dispositivo estiver no fastboot. É uma variante um pouco mais segura que o método genéricogetProductType()
neste caso, porque o itestDevice saberá recuperar o dispositivo no fastboot se o dispositivo estiver em estado incorreto ou não responder.Devoluções | |
---|---|
String | o nome do tipo de produto String ou null se não puder ser determinado |
Lança | |
---|---|
DeviceNotAvailableException |
GetFastBootSerialNumber
public String getFastbootSerialNumber ()
Retorna o número de série do modo Fastboot.
Devoluções | |
---|---|
String |
GetfastBootVariable
public String getFastbootVariable (String variableName)
Recupere o valor variável do fastboot fornecido do dispositivo.
Parâmetros | |
---|---|
variableName | String : o nome da variável |
Devoluções | |
---|---|
String | o valor da propriedade ou null se não existir |
Lança | |
---|---|
DeviceNotAvailableException |
GetFastBootVersion
public String getFastbootVersion ()
Retorna a string de versão do binário Fastboot que está sendo usado. Ou nulo se algo der errado.
Devoluções | |
---|---|
String |
getfileEntry
public IFileEntry getFileEntry (String path)
Recuperar uma referência a um arquivo remoto no dispositivo.
Parâmetros | |
---|---|
path | String : o caminho do arquivo para recuperar. Pode ser um caminho ou caminho absoluto em relação a '/'. (ou seja, a sintaxe "/sistema" e "sistema" é suportada) |
Devoluções | |
---|---|
IFileEntry | o IFileEntry ou null se o arquivo em determinado path não pode ser encontrado |
Lança | |
---|---|
DeviceNotAvailableException |
getfileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Ajudante não oficial para obter um FileEntry
de um caminho que não seja da raiz. FIXME: Refactor o sistema FileEntry para tê -lo disponível em qualquer caminho. (até não raiz).
Parâmetros | |
---|---|
entry | FileListingService.FileEntry : Uma FileEntry não necessariamente root como o ddmlib exige. |
Devoluções | |
---|---|
IFileEntry | um FileEntryWrapper representando o FileEntry. |
Lança | |
---|---|
| 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".
Devoluções | |
---|---|
Lança | |
---|---|
DeviceNotAvailableException |
getidevice
public IDevice getIDevice ()
Retorna uma referência ao IDevice
DDMLIB associado.
IDevice
pode ser alocado pelo DDMS cada vez que o dispositivo se desconecta e se reconecta do ADB. Assim, os chamadores não devem manter uma referência ao IDevice
, porque essa referência pode ficar obsoleta.Devoluções | |
---|---|
IDevice | o IDevice |
GetInstalledPackagenames
publicgetInstalledPackageNames ()
Pegue os nomes de pacote de aplicativos presentes no dispositivo.
Devoluções | |
---|---|
ERROR(/Set) dos nomes de pacote String atualmente instalados no dispositivo. |
Lança | |
---|---|
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 para retornar se a propriedade estiver vazia ou não existe. |
Devoluções | |
---|---|
long | O valor da propriedade ou defaultValue se a propriedade estiver vazia, não existe ou não possui um valor inteiro. |
Lança | |
---|---|
DeviceNotAvailableException |
getipaddress
public String getIpAddress ()
Obtém o endereço IP do dispositivo.
Devoluções | |
---|---|
String | o endereço IP do dispositivo, ou null se o dispositivo não tiver endereço IP |
Lança | |
---|---|
DeviceNotAvailableException |
GetKeyGuardState
public KeyguardControllerState getKeyguardState ()
Retorne um objeto para obter o estado atual do guarda -chave ou nulo se não for suportado.
Devoluções | |
---|---|
KeyguardControllerState | Um KeyguardControllerState contendo um instantâneo do estado do guard de chave e retorna nulo se a consulta do chaveiro não for suportada. |
Lança | |
---|---|
DeviceNotAvailableException |
getLastexpeedReboottimemillis
public long getLastExpectedRebootTimeMillis ()
Retorna a última vez que as APIs comerciais desencadearam uma reinicialização em milissegundos desde que a época retornada pelo System.currentTimeMillis()
.
Devoluções | |
---|---|
long |
GetLaunchApilevel
public int getLaunchApiLevel ()
Obtenha o primeiro nível de API lançado do dispositivo. Padrão para UNKNOWN_API_LEVEL
.
Devoluções | |
---|---|
int | um número inteiro indicando o primeiro nível de dispositivo da API lançado |
Lança | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
Pega um fluxo de instantâneos dos dados logcat.
Funciona em dois modos:
TestDeviceOptions.getMaxLogcatDataSize()
bytes do conteúdo atual da captura de logcat em segundo planoDevoluções | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Pega um fluxo de instantâneos dos últimos maxBytes
dos dados do logcat capturados.
Útil para casos quando você deseja capturar instantâneos frequentes dos dados do logcat capturados sem incorrer na penalidade de espaço em disco potencialmente grande de obter o instantâneo getLogcat()
inteiro.
Parâmetros | |
---|---|
maxBytes | int : A quantidade máxima de dados a ser retornada. Deve ser uma quantidade que possa se encaixar confortavelmente na memória |
Devoluções | |
---|---|
InputStreamSource |
getLogcatdump
public InputStreamSource getLogcatDump ()
Obtenha um despejo do logcat atual para o dispositivo. Ao contrário do getLogcat()
, esse método sempre retornará um despejo estático do logcat.
Tem a desvantagem de que nada será devolvido se o dispositivo não estiver acessível.
Devoluções | |
---|---|
InputStreamSource | Um InputStreamSource dos dados logcat. Um fluxo vazio é retornado se falhar ao capturar dados logcat. |
getLogcats ,nce
public InputStreamSource getLogcatSince (long date)
Pega um fluxo de instantâneos de dados de logcat capturados iniciando a data fornecida. O tempo no dispositivo deve ser usado getDeviceDate()
.
Parâmetros | |
---|---|
date | long : em milissegundo desde o formato de época de quando iniciar o instantâneo até o presente. (pode ser obtido usando 'data +%s') |
Devoluções | |
---|---|
InputStreamSource |
getMacAddress
public String getMacAddress ()
Retorna o endereço MAC do dispositivo, nulo se ele não conseguir consultar o dispositivo.
Devoluções | |
---|---|
String |
getMainUserID
public Integer getMainUserId ()
Retorna o ID do usuário principal.
Devoluções | |
---|---|
Integer | O UserID do usuário principal, se houver um e nulo se não houver usuário principal. |
Lança | |
---|---|
DeviceNotAvailableException |
getMainLineModuleInfo
publicgetMainlineModuleInfo ()
Obtenha as informações sobre os módulos principais instalados no dispositivo.
Devoluções | |
---|---|
ERROR(/Set) dos módulos da linha principal String atualmente instalados no dispositivo. |
Lança | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
Obtenha o número máximo de usuários em execução simultaneamente suportados. O padrão é 0.
Devoluções | |
---|---|
int | um número inteiro indicando o número de usuários em execução simultaneamente |
Lança | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUserSSupport
public int getMaxNumberOfUsersSupported ()
Obtenha o número máximo de usuários suportados. O padrão é 0.
Devoluções | |
---|---|
int | um número inteiro indicando o número de usuários suportados |
Lança | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
Devoluções | |
---|---|
Process | Retorna o processo da VM Microdroid. Se o testDevice não for um microdroid, retornará nulo. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Retorne o IDeviceStateMonitor
associado ao dispositivo.
Devoluções | |
---|---|
IDeviceStateMonitor |
getMountpoint
public String getMountPoint (String mountName)
Retorna um ponto de montagem.
Consulta o dispositivo diretamente se as informações em cache noIDevice
não estiverem disponíveis. TODO: mova esse comportamento para IDevice#getMountPoint(String)
Parâmetros | |
---|---|
mountName | String : o nome do ponto de montagem |
Devoluções | |
---|---|
String | o ponto de montagem ou null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Retorna um MountPointInfo
correspondente ao caminho MountPoint especificado, ou null
se esse caminho não tiver nada montado ou não aparecer em /proc /montar como um MountPoint.
Parâmetros | |
---|---|
mountpoint | String |
Devoluções | |
---|---|
ITestDevice.MountPointInfo | Um ERROR(/List) de MountPointInfo contendo as informações em "/proc/montars" |
Lança | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
Retorna uma versão analisada das informações em /proc /montar no dispositivo
Devoluções | |
---|---|
Um ERROR(/List) de MountPointInfo contendo as informações em "/proc/montars" |
Lança | |
---|---|
DeviceNotAvailableException |
getOptions
public TestDeviceOptions getOptions ()
Pegue as opções de teste para o dispositivo.
Devoluções | |
---|---|
TestDeviceOptions | TestDeviceOptions relacionados ao dispositivo em teste. |
getPartitionFreespace
public long getPartitionFreeSpace (String partition)
Método Helper para determinar a quantidade de espaço livre na partição do dispositivo.
Parâmetros | |
---|---|
partition | String |
Devoluções | |
---|---|
long | a quantidade de espaço livre em KB |
Lança | |
---|---|
DeviceNotAvailableException |
getPrimaryUserID
public Integer getPrimaryUserId ()
Retorna o ID do usuário principal.
Devoluções | |
---|---|
Integer | O UserID do usuário principal, se houver um e nulo se não houver usuário primário. |
Lança | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
O método Helper executa o comando "PIDOF" e "Stat" e retorna o objeto ProcessInfo
com PID e Horário de início do processo do processo fornecido.
Parâmetros | |
---|---|
processName | String : A sequência de nome do Proces. |
Devoluções | |
---|---|
ProcessInfo | ProcessInfo de determinado nome do processo |
Lança | |
---|---|
DeviceNotAvailableException |
getProcesspid
public String getProcessPid (String process)
Retorna o PID do serviço ou nulo se algo der errado.
Parâmetros | |
---|---|
process | String : A sequência de nome do Proces. |
Devoluções | |
---|---|
String |
Lança | |
---|---|
DeviceNotAvailableException |
getProductType
public String getProductType ()
Método de conveniência para obter o tipo de produto deste dispositivo.
Este método funcionará se o dispositivo estiver no modo Adb ou Fastboot.Devoluções | |
---|---|
String | o nome do tipo de produto String . Não será nulo |
Lança | |
---|---|
DeviceNotAvailableException |
getProductVariant
public String getProductVariant ()
Método de conveniência para obter a variante do produto deste dispositivo.
Este método funcionará se o dispositivo estiver no modo Adb ou Fastboot.Devoluções | |
---|---|
String | o nome da variante do produto String ou null se não puder ser determinado |
Lança | |
---|---|
DeviceNotAvailableException |
getProperty
public String getProperty (String name)
Recuperar o valor da propriedade fornecida do dispositivo.
Parâmetros | |
---|---|
name | String : o nome da propriedade |
Devoluções | |
---|---|
String | o valor da propriedade ou null se não existir |
Lança | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
Obtenha o modo de recuperação atual usado para o dispositivo.
Devoluções | |
---|---|
ITestDevice.RecoveryMode | o modo de recuperação atual usado para o dispositivo. |
obter captura de tela
public InputStreamSource getScreenshot (String format)
Pega uma captura de tela do dispositivo. Recomendado para usar getScreenshot (formato) em vez de codificar JPEG para tamanho menor
Parâmetros | |
---|---|
format | String : PNG suportado, JPEG |
Devoluções | |
---|---|
InputStreamSource | Um InputStreamSource da captura de tela no formato, ou null se a captura de tela não tiver sido bem -sucedida. |
Lança | |
---|---|
DeviceNotAvailableException |
obter captura de tela
public InputStreamSource getScreenshot (long displayId)
Pega uma captura de tela do dispositivo com o ID de exibição. O formato é png.
TODO: estender as implementações acima para apoiar o 'formato' e o 'rescalamento'
Parâmetros | |
---|---|
displayId | long : o ID da tela da tela para obter a captura de tela. |
Devoluções | |
---|---|
InputStreamSource | Um InputStreamSource da captura de tela no formato, ou null se a captura de tela não tiver sido bem -sucedida. |
Lança | |
---|---|
DeviceNotAvailableException |
obter captura de tela
public InputStreamSource getScreenshot (String format, boolean rescale)
Pega uma captura de tela do dispositivo. Recomendado para usar getScreenshot(String)
em vez de codificar JPEG para um tamanho menor.
Parâmetros | |
---|---|
format | String : PNG suportado, JPEG |
rescale | boolean : se a captura de tela deve ser redimensionada para reduzir o tamanho da imagem resultante |
Devoluções | |
---|---|
InputStreamSource | Um InputStreamSource da captura de tela no formato, ou null se a captura de tela não tiver sido bem -sucedida. |
Lança | |
---|---|
DeviceNotAvailableException |
obter captura de tela
public InputStreamSource getScreenshot ()
Pega uma captura de tela do dispositivo.
Devoluções | |
---|---|
InputStreamSource | Um InputStreamSource da captura de tela no formato PNG, ou null se a captura de tela não tiver sido bem -sucedida. |
Lança | |
---|---|
DeviceNotAvailableException |
GetSerialNumber
public String getSerialNumber ()
Método de conveniência para obter o número de série deste dispositivo.
Devoluções | |
---|---|
String | o número de série String |
getSetting
public String getSetting (int userId, String namespace, String key)
Retorne o valor da configuração solicitada. o espaço para nome deve ser um dos: {"System", "Secure", "Global"}
Parâmetros | |
---|---|
userId | int |
namespace | String |
key | String |
Devoluções | |
---|---|
String | O valor associado ao espaço para nome: chave de um usuário. Nulo se não for encontrado. |
Lança | |
---|---|
DeviceNotAvailableException |
getSetting
public String getSetting (String namespace, String key)
Consulte getSetting(int, String, String)
e executado no usuário do sistema.
Parâmetros | |
---|---|
namespace | String |
key | String |
Devoluções | |
---|---|
String |
Lança | |
---|---|
DeviceNotAvailableException |
getMimoperator
public String getSimOperator ()
Retorne o operador do cartão SIM ou nulo se não estiver disponível ou se o dispositivo não estiver disponível.
Devoluções | |
---|---|
String |
getsimstate
public String getSimState ()
Retorne o estado do cartão SIM ou nulo se não estiver disponível ou o dispositivo não estiver disponível.
Devoluções | |
---|---|
String |
GetTombstones
publicgetTombstones ()
Pegue e retorne a lista de lápides dos dispositivos. Requer root.
O método é o melhor esforço, portanto, se uma lápide não for puxada por qualquer motivo, ele estará faltando na lista. Somente um DeviceNotAvailableException
encerrará o método mais cedo.
Devoluções | |
---|---|
Uma lista de arquivos da Tombstone, vazia se não houver lápide. |
Lança | |
---|---|
DeviceNotAvailableException |
getTotalmemory
public long getTotalMemory ()
Retorna o tamanho total da memória física em bytes ou -1 em caso de erro interno
Devoluções | |
---|---|
long |
GetUnInstallablePackagenames
publicgetUninstallablePackageNames ()
Pegue os nomes de pacotes de aplicativos que podem ser desinstalados. Atualmente, isso é definido como pacotes não-sistemas e pacotes de sistemas atualizados.
Devoluções | |
---|---|
ERROR(/Set) dos nomes de pacotes String desinstaláveis atualmente instalados no dispositivo. |
Lança | |
---|---|
DeviceNotAvailableException |
getUseFastBooterase
public boolean getUseFastbootErase ()
Obtenha se o formato de apagar ou fastboot de fastboot ou fastboot para limpar uma partição no dispositivo.
Devoluções | |
---|---|
boolean | true se a apagamento fastboot será usada ou false se o formato Fastboot for usado. |
getUserflags
public int getUserFlags (int userId)
Encontre e retorne os sinalizadores de um determinado usuário. Os sinalizadores são definidos na classe "Android.content.pm.userinfo" no projeto de código aberto do Android.
Parâmetros | |
---|---|
userId | int |
Devoluções | |
---|---|
int | Os sinalizadores associados ao UserID fornecido se for encontrado, -10000 em qualquer outro caso. |
Lança | |
---|---|
DeviceNotAvailableException |
getUserinfos
publicgetUserInfos ()
Obtém o mapa do USEID no UserInfo
no dispositivo. Lançará DeviceRuntimeException
se a saída do dispositivo não for o esperado.
Devoluções | |
---|---|
a lista de objetos userInfo. |
Lança | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Retorne o número de série associado ao UserID, se encontrado, -10000 em qualquer outro caso.
Parâmetros | |
---|---|
userId | int |
Devoluções | |
---|---|
int |
Lança | |
---|---|
DeviceNotAvailableException |
HandLealLocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Processe o dispositivo fornecido. Pode fazer transição de dispositivo para novo estado. Informará o IDeviceMonitor
de qualquer transição de estado.
Processe o DeviceEvent, que pode ou não fazer a transição deste dispositivo para um novo estado de alocação.
Parâmetros | |
---|---|
event | DeviceEvent |
Devoluções | |
---|---|
IManagedTestDevice.DeviceEventResponse |
has -feature
public boolean hasFeature (String feature)
Verifique se um recurso está disponível em um dispositivo.
Parâmetros | |
---|---|
feature | String : Qual formato deve ser "Recurso: |
Devoluções | |
---|---|
boolean | Verdadeiro se o recurso for encontrado, falso caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException |
InstallPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Instale um pacote Android no dispositivo.
Parâmetros | |
---|---|
packageFile | File : o arquivo APK para instalar |
reinstall | boolean : true se um reinstalar deve ser realizado |
extraArgs | String : Argumentos extras opcionais para passar. Consulte 'ADB Shell PM -H' para obter opções disponíveis. |
Devoluções | |
---|---|
String | uma String com um código de erro ou null se o sucesso. |
Lança | |
---|---|
DeviceNotAvailableException |
InstallPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Instale um pacote Android no dispositivo.
NOTA: Somente os casos de uso que requerem controle explícito da concessão de permissão de tempo de execução no horário de instalação deve chamar essa função.
Parâmetros | |
---|---|
packageFile | File : o arquivo APK para instalar |
reinstall | boolean : true se um reinstalar deve ser realizado |
grantPermissions | boolean : se todas as permissões de tempo de execução devem ser concedidas no horário de instalação |
extraArgs | String : Argumentos extras opcionais para passar. Consulte 'ADB Shell PM -H' para obter opções disponíveis. |
Devoluções | |
---|---|
String | uma String com um código de erro ou null se o sucesso. |
Lança | |
---|---|
DeviceNotAvailableException |
InstallPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Instale um pacote Android no dispositivo para um determinado usuário.
Parâmetros | |
---|---|
packageFile | File : o arquivo APK para instalar |
reinstall | boolean : true se um reinstalar deve ser realizado |
userId | int : o ID de usuário inteiro para instalar. |
extraArgs | String : Argumentos extras opcionais para passar. Consulte 'ADB Shell PM -H' para obter opções disponíveis. |
Devoluções | |
---|---|
String | uma String com um código de erro ou null se o sucesso. |
Lança | |
---|---|
DeviceNotAvailableException |
InstallPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instale um pacote Android no dispositivo para um determinado usuário.
NOTA: Somente os casos de uso que requerem controle explícito da concessão de permissão de tempo de execução no horário de instalação deve chamar essa função.
Parâmetros | |
---|---|
packageFile | File : o arquivo APK para instalar |
reinstall | boolean : true se um reinstalar deve ser realizado |
grantPermissions | boolean : se todas as permissões de tempo de execução devem ser concedidas no horário de instalação |
userId | int : o ID de usuário inteiro para instalar. |
extraArgs | String : Argumentos extras opcionais para passar. Consulte 'ADB Shell PM -H' para obter opções disponíveis. |
Devoluções | |
---|---|
String | uma String com um código de erro ou null se o sucesso. |
Lança | |
---|---|
DeviceNotAvailableException |
invalidatePropertyCache
public void invalidatePropertyCache ()
ISADBTCP
public boolean isAdbTcp ()
Devoluções | |
---|---|
boolean |
isappenumerations suportado
public boolean isAppEnumerationSupported ()
Verifique se a plataforma no dispositivo suporta a enumeração do aplicativo
Devoluções | |
---|---|
boolean | Verdadeiro se a enumeração do aplicativo for suportada, false caso contrário |
Lança | |
---|---|
DeviceNotAvailableException |
isbypasslowtargetsdkblocksupported
public boolean isBypassLowTargetSdkBlockSupported ()
Verifique se a plataforma no dispositivo suporta ignorando o bloco SDK de baixo destino nas instalações de aplicativos
Devoluções | |
---|---|
boolean | Verdadeiro se o Bloco SDK de Alvo Baixo de Alvo é suportado, FALSE, caso contrário, caso contrário |
Lança | |
---|---|
DeviceNotAvailableException |
IsdebugfsMorted
public boolean isDebugfsMounted ()
Verifique se o Debugfs está montado.
Devoluções | |
---|---|
boolean | true se Debugfs estiver montado |
Lança | |
---|---|
DeviceNotAvailableException |
IsdeviceCrypted
public boolean isDeviceEncrypted ()
Retorna se o dispositivo for criptografado.
Devoluções | |
---|---|
boolean | true se o dispositivo for criptografado. |
Lança | |
---|---|
DeviceNotAvailableException |
IsDirectory
public boolean isDirectory (String path)
Retorne true se o caminho no dispositivo for um diretório, false caso contrário.
Parâmetros | |
---|---|
path | String |
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
isenableadbroot
public boolean isEnableAdbRoot ()
Devoluções | |
---|---|
boolean | true se o ADB Root deve ser ativado no dispositivo |
ISENCRYPTIONSUPORTADO
public boolean isEncryptionSupported ()
Retorna se a criptografia for suportada no dispositivo.
Devoluções | |
---|---|
boolean | true se o dispositivo suportar criptografia. |
Lança | |
---|---|
DeviceNotAvailableException |
isExecutable
public boolean isExecutable (String fullPath)
Retorna true se o caminho do arquivo no dispositivo for um arquivo executável, false caso contrário.
Parâmetros | |
---|---|
fullPath | String |
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
isfastbootenabled
public boolean isFastbootEnabled ()
Retorne se o Fastboot estiver disponível para o dispositivo.
Devoluções | |
---|---|
boolean |
Isheadless
public boolean isHeadless ()
Retorne true se o dispositivo estiver sem cabeça (sem tela), false caso contrário.
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
ISHEADLESSYSTEMUSERMODE
public boolean isHeadlessSystemUserMode ()
Retorna se o dispositivo usa o modo de usuário do sistema sem cabeça.
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
ismainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Retorna se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para o status não administrado.
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
Ismultiusersuportado
public boolean isMultiUserSupported ()
Determina se o usuário multi é suportado.
Devoluções | |
---|---|
boolean | Verdadeiro se o usuário multi for suportado, false caso contrário |
Lança | |
---|---|
DeviceNotAvailableException |
ispackageInstala
public boolean isPackageInstalled (String packageName, String userId)
Consulte o dispositivo para obter um determinado nome do pacote e um identificador de usuário para verificar se está atualmente instalado ou não para esse usuário.
Parâmetros | |
---|---|
packageName | String : O pacote que estamos verificando se estiver instalado. |
userId | String : o ID do usuário para o qual estamos verificando o pacote está instalado. Se NULL, o usuário primário zero será usado. |
Devoluções | |
---|---|
boolean | Verdadeiro se o pacote for relatado conforme instalado. Falso caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException |
ispackageInstala
public boolean isPackageInstalled (String packageName)
Consulte o dispositivo para um determinado nome do pacote para verificar se está instalado atualmente ou não.
Parâmetros | |
---|---|
packageName | String |
Devoluções | |
---|---|
boolean | Verdadeiro se o pacote for relatado conforme instalado. Falso caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException |
IsruntimePermissionsUpported
public boolean isRuntimePermissionSupported ()
Verifique se a plataforma no dispositivo suporta a concessão de permissão de tempo de execução
Devoluções | |
---|---|
boolean | Verdadeiro se a permissão de tempo de execução for suportada, falsa caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException |
isStateBootLoaderorFastBootd
public boolean isStateBootloaderOrFastbootd ()
Retorna true se o dispositivo estiver no TestDeviceState#FASTBOOT
ou TestDeviceState.FASTBOOTD
.
Devoluções | |
---|---|
boolean |
isuserrunning
public boolean isUserRunning (int userId)
Verifique se um determinado usuário está em execução.
Parâmetros | |
---|---|
userId | int |
Devoluções | |
---|---|
boolean | Verdadeiro se o usuário estiver em execução, false em todos os outros casos. |
Lança | |
---|---|
DeviceNotAvailableException |
isuserSecondary
public boolean isUserSecondary (int userId)
Retorne se o usuário especificado é um usuário secundário de acordo com seus sinalizadores.
Parâmetros | |
---|---|
userId | int |
Devoluções | |
---|---|
boolean | Verdadeiro se o usuário for secundário, false caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException |
isserservável
public boolean isUserVisible (int userId)
Verifica se o usuário fornecido está visível.
Um usuário "visível" é um usuário que está interagindo com o usuário "humano" e, portanto, é capaz de iniciar atividades de lançamento (normalmente na tela padrão).
Parâmetros | |
---|---|
userId | int |
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
ISUSERVISIBLEDISPLAY
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Verifica se o usuário fornecido está visível na exibição fornecida.
Um usuário "visível" é um usuário que está interagindo com o usuário "humano" e, portanto, é capaz de iniciar atividades de lançamento nessa exibição.
Parâmetros | |
---|---|
userId | int |
displayId | int |
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
Isvisible BackgroundUsersOndefaultDisplaySupported
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)
, passando uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers()
(que deve incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
Isvisible BackgroundUsersSupportado
public boolean isVisibleBackgroundUsersSupported ()
Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano.
Se isso acontecer, você pode ligar para startVisibleBackgroundUser(int, int, boolean)
, passando uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers()
.
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
iswifienabled
public boolean isWifiEnabled ()
Teste se o WiFi estiver ativado.
Verifica se o WiFi está ativado no dispositivo. Útil para afirmar o status WiFi antes dos testes que não devem ser executados com o WiFi, por exemplo, testes de dados móveis.Devoluções | |
---|---|
boolean | true se o WiFi estiver ativado. false se desativado |
Lança | |
---|---|
DeviceNotAvailableException |
ListDisplayIds
publiclistDisplayIds ()
Colete a lista de exibições disponíveis no dispositivo, conforme relatado por "Dumpsys Surfaceflinger".
Devoluções | |
---|---|
A lista de displays. O padrão sempre retorna o visor padrão 0. |
Lança | |
---|---|
DeviceNotAvailableException |
ListDisplayIdsforstartingVisible Backgroundusers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Obtém a lista de exibições que podem ser usadas para start a user visible in the background
.
Devoluções | |
---|---|
Lança | |
---|---|
DeviceNotAvailableException |
Listusers
publiclistUsers ()
Obtém a lista de usuários no dispositivo. Lançará DeviceRuntimeException
se a saída do dispositivo não for o esperado.
Devoluções | |
---|---|
a lista de IDs de usuário. |
Lança | |
---|---|
DeviceNotAvailableException |
Loganrs
public boolean logAnrs (ITestLogger logger)
Coleta e registra ANRs do dispositivo.
Parâmetros | |
---|---|
logger | ITestLogger : um ITestLogger para registrar os ANRs. |
Devoluções | |
---|---|
boolean | É verdade que se o registro fosse bem -sucedido, false caso contrário. |
Lança | |
---|---|
DeviceNotAvailableException |
logbugreport
public boolean logBugreport (String dataName, ITestLogger listener)
Método Helper para pegar um relatório de bug e registrá -lo aos repórteres.
Parâmetros | |
---|---|
dataName | String : Nome sob o qual o BugReport será relatado. |
listener | ITestLogger : um ITestLogger para registrar o relatório de bugs. |
Devoluções | |
---|---|
boolean | É verdade que se o registro fosse bem -sucedido, false caso contrário. |
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á lançada, mesmo que o registro falhe.
Parâmetros | |
---|---|
tag | String : a tag sob a qual registramos nossa mensagem no logcat. |
level | Log.LogLevel : o nível de depuração da mensagem no logcat. |
format | String : o formato da mensagem. |
args | Object : os args a serem substituídos via string.format (). |
Não -BlockingReboot
public void nonBlockingReboot ()
Emite um comando para reiniciar o dispositivo e retornar no comando completo e quando o dispositivo não estiver mais visível para o ADB.
Lança | |
---|---|
DeviceNotAvailableException |
PostAdbrootaction
public void postAdbRootAction ()
Substitua se o dispositivo precisar de algumas ações específicas a serem realizadas após a raiz do ADB e antes que o dispositivo esteja novamente online. A implementação padrão não inclui nenhuma ação de adição. A raiz do ADB não é garantida para ser ativada nesta fase.
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Postadbunrootaction
public void postAdbUnrootAction ()
Substitua se o dispositivo precisar de algumas ações específicas a serem realizadas após a root do ADB e antes que o dispositivo esteja novamente online. A implementação padrão não inclui ações adicionais. O ADB Root não é garantido para ser desativado nesta fase.
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PostBootsetup
public void postBootSetup ()
Execute instruções para configurar o dispositivo para testar isso após cada inicialização.
Deve ser chamado depois que o dispositivo estiver totalmente inicializado/disponível Em circunstâncias normais, esse método não precisa ser chamado explicitamente, pois as implementações devem executar essas etapas automaticamente ao executar uma reinicialização. Onde pode ser necessário ser chamado é quando o dispositivo é reiniciado devido a outros eventos (por exemplo, quando um comando de atualização Fastboot é concluído)Lança | |
---|---|
DeviceNotAvailableException |
PostInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Etapas extras para limpeza necessária necessária específica do dispositivo que serão executadas após a conclusão da invocação.
Parâmetros | |
---|---|
exception | Throwable : se houver, a exceção final levantada pela falha de invocação. |
Preinvocationsetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Etapas extras para configuração necessária específica do dispositivo que será executada no dispositivo antes do fluxo de invocação.
Parâmetros | |
---|---|
info | IBuildInfo : o IBuildInfo do dispositivo. |
attributes | MultiMap : os atributos armazenados no contexto de invocação |
Joga | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
Pulldir
public boolean pullDir (String deviceFilePath, File localDir)
Recursivamente puxe o conteúdo do diretório do dispositivo.
Parâmetros | |
---|---|
deviceFilePath | String : the absolute file path of the remote source |
localDir | File : the local directory to pull files into |
Devoluções | |
---|---|
boolean | true if file was pulled successfully. false otherwise. |
Lança | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile)
Retrieves a file off device.
Parâmetros | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
Devoluções | |
---|---|
boolean | true if file was retrieved successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath, int userId)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
Parâmetros | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
userId | int : The user id to pull from |
Devoluções | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Throws | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
Parâmetros | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
Devoluções | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Lança | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Retrieves a file off device.
Parâmetros | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
userId | int : The user id to pull from |
Devoluções | |
---|---|
boolean | true if file was retrieved successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
pullFileContents
public String pullFileContents (String remoteFilePath)
Retrieves a file off device, and returns the contents.
Parâmetros | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
Devoluções | |
---|---|
String | A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Throws | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File)
, and return a reference to that File
.
Parâmetros | |
---|---|
remoteFilePath | String : the path to file on device, relative to the device's external storage mountpoint |
Devoluções | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Throws | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Recursively push directory contents to device while excluding some directories that are filtered.
Parâmetros | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
excludedDirectories |
Devoluções | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
Recursively push directory contents to device.
Parâmetros | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
Devoluções | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variant of pushFile(File, String)
which can optionally consider evaluating the need for the content provider.
Parâmetros | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
evaluateContentProviderNeeded | boolean : whether to check if we need the content provider |
Devoluções | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath)
Push a file to device. By default using a content provider.
Parâmetros | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
Devoluções | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
pushString
public boolean pushString (String contents, String remoteFilePath)
Push file created from a string to device
Parâmetros | |
---|---|
contents | String : the contents of the file to push |
remoteFilePath | String : the remote destination absolute file path |
Devoluções | |
---|---|
boolean | true if string was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
reinício
public void reboot (String reason)
Reboots the device into adb mode with given reason
to be persisted across reboot.
Blocks until device becomes available.
Last reboot reason can be obtained by querying sys.boot.reason
propety.
Parâmetros | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
Throws | |
---|---|
DeviceNotAvailableException |
reinício
public void reboot ()
Reboots the device into adb mode.
Blocks until device becomes available.Lança | |
---|---|
DeviceNotAvailableException |
rebootIntoBootloader
public void rebootIntoBootloader ()
Reboots the device into bootloader mode.
Blocks until device is in bootloader mode.Throws | |
---|---|
DeviceNotAvailableException |
rebootIntoFastbootd
public void rebootIntoFastbootd ()
Reboots the device into fastbootd mode.
Blocks until device is in fastbootd mode.
Throws | |
---|---|
DeviceNotAvailableException |
rebootIntoRecovery
public void rebootIntoRecovery ()
Reboots the device into adb recovery mode.
Blocks until device enters recoveryThrows | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload ()
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
Throws | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
Parâmetros | |
---|---|
autoReboot | boolean : whether to automatically reboot the device after sideload |
Throws | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline ()
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Throws | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline (String reason)
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Parâmetros | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
Throws | |
---|---|
DeviceNotAvailableException |
rebootUserspace
public void rebootUserspace ()
Reboots only userspace part of device.
Blocks until device becomes available.
AVISO. Userspace reboot is currently under active development, use it on your own risk.
Throws | |
---|---|
DeviceNotAvailableException |
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
An alternate to rebootUserspace()
()} that only blocks until device is online ie visible to adb.
Throws | |
---|---|
DeviceNotAvailableException |
recoverDevice
public boolean recoverDevice ()
Attempts to recover device communication.
Devoluções | |
---|---|
boolean | True if recovery attempted and successful, returns False if recovery was skipped |
Throws | |
---|---|
DeviceNotAvailableException | if device is no longer available |
registerDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registers a IDeviceActionReceiver
for this device.
All registered IDeviceActionReceiver
s will be notified before a device action starts and after the device action ends.
Parâmetros | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : A IDeviceActionReceiver which will be registered. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Make the system partition on the device read-only. May reboot the device.
Throws | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Make the system partition on the device writable. May reboot the device.
Throws | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
Make the vendor partition on the device read-only. May reboot the device.
Throws | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
Make the vendor partition on the device writable. May reboot the device.
Lança | |
---|---|
DeviceNotAvailableException |
removeAdmin
public boolean removeAdmin (String componentName, int userId)
Remove given device admin in given user and return true
if it is successful, false
otherwise.
Parâmetros | |
---|---|
componentName | String : of device admin to be removed. |
userId | int : of user that the device admin lives in. |
Devoluções | |
---|---|
boolean | True if it is successful, false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
Remove all existing device profile owners with the best effort.
Throws | |
---|---|
DeviceNotAvailableException |
removeUser
public boolean removeUser (int userId)
Remove a given user from the device.
Parâmetros | |
---|---|
userId | int : of the user to remove |
Devoluções | |
---|---|
boolean | true if we were successful in removing the user, false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
resetContentProviderSetup
public void resetContentProviderSetup ()
Reset the flag for content provider setup in order to trigger it again.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
with one or more listeners passed as parameters.
Parâmetros | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners | ITestLifeCycleReceiver : the test result listener(s) |
Devoluções | |
---|---|
boolean | true if test command completed. false if it failed to complete, but recovery succeeded |
Throws | |
---|---|
DeviceNotAvailableException |
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Runs instrumentation tests, and provides device recovery.
If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.
If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.
Parâmetros | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners |
Devoluções | |
---|---|
boolean | true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded |
Throws | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
but runs the test for the given user.
Parâmetros | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
Devoluções | |
---|---|
boolean |
Throws | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
but runs the test for a given user.
Parâmetros | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
Devoluções | |
---|---|
boolean |
Lança | |
---|---|
DeviceNotAvailableException |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Injects the IConfiguration
in use.
Parâmetros | |
---|---|
configuration | IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Parâmetros | |
---|---|
avdInfo | GceAvdInfo |
setDate
public void setDate (Date date)
Sets the date on device
Note: setting date on device requires root
Parâmetros | |
---|---|
date | Date : specify a particular date; will use host date if null |
Throws | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
Set a device admin component as device owner in given user.
Parâmetros | |
---|---|
componentName | String : of device admin to be device owner. |
userId | int : of the user that the device owner lives in. |
Devoluções | |
---|---|
boolean | True if it is successful, false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Update the device's state.
Parâmetros | |
---|---|
deviceState | TestDeviceState : the TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
For emulator set SizeLimitedOutputStream
to log output
Parâmetros | |
---|---|
output | SizeLimitedOutputStream : to log the output |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Sets the Process
, when this device is an emulator.
Parâmetros | |
---|---|
p | Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Set the fastboot option for the device. Should be set when device is first allocated.
Parâmetros | |
---|---|
fastbootEnabled | boolean : whether fastboot is available for the device or not |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled()
to be true, to have fastboot functions enabled.
Parâmetros | |
---|---|
fastbootPath | String |
setIDevice
public void setIDevice (IDevice newDevice)
Update the IDevice associated with this ITestDevice.
The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDeviceParâmetros | |
---|---|
newDevice | IDevice : the IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Sets the time in ms to wait before starting logcat capture for a online device.
Parâmetros | |
---|---|
delay | int : the delay in ms |
setOptions
public void setOptions (TestDeviceOptions options)
Set the TestDeviceOptions
for the device
Parâmetros | |
---|---|
options | TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
Sets the given property value on the device. Requires adb root is true.
Parâmetros | |
---|---|
propKey | String : The key targeted to be set. |
propValue | String : The property value to be set. |
Devoluções | |
---|---|
boolean | returns True if the setprop command was successful, False otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Set the IDeviceRecovery
to use for this device. Should be set when device is first allocated.
Parâmetros | |
---|---|
recovery | IDeviceRecovery : the IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Set the current recovery mode to use for the device.
Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etcParâmetros | |
---|---|
mode | ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not. |
setSetting
public void setSetting (String namespace, String key, String value)
See setSetting(int, String, String, String)
and performed on system user.
Parâmetros | |
---|---|
namespace | String |
key | String |
value | String |
Throws | |
---|---|
DeviceNotAvailableException |
setSetting
public void setSetting (int userId, String namespace, String key, String value)
Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}
Parâmetros | |
---|---|
userId | int |
namespace | String |
key | String |
value | String |
Throws | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Injects the ITestLogger
instance
Parâmetros | |
---|---|
testLogger | ITestLogger |
setUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
Set whether to use fastboot erase or fastboot format to wipe a partition on the device.
Parâmetros | |
---|---|
useFastbootErase | boolean : true if fastboot erase should be used or false if fastboot format should be used. |
startLogcat
public void startLogcat ()
Start capturing logcat output from device in the background.
Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat. When the device is no longer in use,stopLogcat()
must be called. startLogcat()
and stopLogcat()
do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat. startUser
public boolean startUser (int userId)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.
Parâmetros | |
---|---|
userId | int : of the user to start in the background |
Devoluções | |
---|---|
boolean | true if the user was successfully started in the background. |
Throws | |
---|---|
DeviceNotAvailableException |
startUser
public boolean startUser (int userId, boolean waitFlag)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.
Parâmetros | |
---|---|
userId | int : of the user to start in the background |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Devoluções | |
---|---|
boolean | true if the user was successfully started in the background. |
Throws | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).
NOTE: this command doesn't check if the user exists, display is available, device supports such feature
, etc.
Parâmetros | |
---|---|
userId | int : of the user to start in the background |
displayId | int : display to start user visible on |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Devoluções | |
---|---|
boolean | true if the user was successfully started visible in the background. |
Throws | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Close and delete the emulator output.
stopLogcat
public void stopLogcat ()
Stop capturing logcat output from device, and discard currently saved logcat data.
Will have no effect if logcat output is not being captured.stopUser
public boolean stopUser (int userId)
Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.
Parâmetros | |
---|---|
userId | int : of the user to stop. |
Devoluções | |
---|---|
boolean | true if the user was successfully stopped. |
Throws | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.
Parâmetros | |
---|---|
userId | int : of the user to stop. |
waitFlag | boolean : will make the command wait until user is stopped. |
forceFlag | boolean : will force stop the user. |
Devoluções | |
---|---|
boolean | true if the user was successfully stopped. |
Throws | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public String switchToAdbTcp ()
Switch device to adb-over-tcp mode.
Devoluções | |
---|---|
String | the tcp serial number or null if device could not be switched |
Throws | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Switch device to adb over usb mode.
Devoluções | |
---|---|
boolean | true if switch was successful, false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
mudar de utilizador
public boolean switchUser (int userId)
Switch to another userId with a default timeout. switchUser(int, long)
.
Parâmetros | |
---|---|
userId | int |
Devoluções | |
---|---|
boolean | True if the new userId matches the userId provider. False otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
mudar de utilizador
public boolean switchUser (int userId, long timeout)
Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.
Parâmetros | |
---|---|
userId | int |
timeout | long : to wait before returning false for switch-user failed. |
Devoluções | |
---|---|
boolean | True if the new userId matches the userId provider. False otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
syncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
Incrementally syncs the contents of a local file directory to device.
Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date. Hidden files (with names starting with ".") will be ignored. Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.Parâmetros | |
---|---|
localFileDir | File : the local file directory containing files to recursively push. |
deviceFilePath | String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail |
Devoluções | |
---|---|
boolean | true if files were synced successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
takeBugreport
public Bugreport takeBugreport ()
Take a bugreport and returns it inside a Bugreport
object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close()
.
Devoluções | |
---|---|
Bugreport |
uninstallPackage
public String uninstallPackage (String packageName)
Uninstall an Android package from device.
Parâmetros | |
---|---|
packageName | String : the Android package to uninstall |
Devoluções | |
---|---|
String | a String with an error code, or null if success. |
Throws | |
---|---|
DeviceNotAvailableException |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
Uninstall an Android package from device for a given user.
Parâmetros | |
---|---|
packageName | String : the Android package to uninstall |
userId | int : the integer user id to uninstall for. |
Devoluções | |
---|---|
String | a String with an error code, or null if success. |
Throws | |
---|---|
DeviceNotAvailableException |
unlockDevice
public boolean unlockDevice ()
Unlocks the device if the device is in an encrypted state.
This method may restart the framework but will not callpostBootSetup()
. Therefore, the device might not be fully ready to be tested when this method returns.Devoluções | |
---|---|
boolean | true if successful or if the device is unencrypted. |
Throws | |
---|---|
DeviceNotAvailableException |
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Blocks until the device's boot complete flag is set.
Parâmetros | |
---|---|
timeOut | long : time in msecs to wait for the flag to be set |
Devoluções | |
---|---|
boolean | true if device's boot complete flag is set within the timeout |
Throws | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
Waits for the device to be responsive and available for testing. Uses default timeout.
Devoluções | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Throws | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
Waits for the device to be responsive and available for testing.
Parâmetros | |
---|---|
waitTime | long : the time in ms to wait |
Devoluções | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Throws | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Waits for the device to be responsive and available without considering recovery path.
Parâmetros | |
---|---|
waitTime | long |
Devoluções | |
---|---|
boolean | True if device is available, False if unavailable. |
Throws | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Blocks until device is visible via fastboot. Use default timeout.
Throws | |
---|---|
DeviceNotAvailableException |
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery
).
Parâmetros | |
---|---|
waitTime | long : the time in ms to wait |
Devoluções | |
---|---|
boolean | true if device boots into recovery before time expires. false otherwise |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
Blocks for the device to be in the 'adb sideload' state
Parâmetros | |
---|---|
waitTime | long : the time in ms to wait |
Devoluções | |
---|---|
boolean | true if device boots into sideload before time expires. false otherwise |
waitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Blocks for the device to be not available ie missing from adb
Parâmetros | |
---|---|
waitTime | long : the time in ms to wait |
Devoluções | |
---|---|
boolean | true if device becomes not available before time expires. false otherwise |
waitForDeviceOnline
public void waitForDeviceOnline ()
Blocks until device is visible via adb. Uses default timeout
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Throws | |
---|---|
DeviceNotAvailableException |
waitForDeviceOnline
public void waitForDeviceOnline (long waitTime)
Blocks until device is visible via adb.
Note the device may not necessarily be responsive to commands on completion. UsewaitForDeviceAvailable()
instead.Parâmetros | |
---|---|
waitTime | long : the time in ms to wait |
Throws | |
---|---|
DeviceNotAvailableException |
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Waits for device to be responsive to a basic adb shell command.
Parâmetros | |
---|---|
waitTime | long : the time in ms to wait |
Devoluções | |
---|---|
boolean | true if device becomes responsive before waitTime elapses. |
Protected methods
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Parâmetros | |
---|---|
builder | DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Builds the OS command for the given adb shell command session and args
Parâmetros | |
---|---|
command | String |
forceExitStatusDetection | boolean |
Devoluções | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Parâmetros | |
---|---|
feature | String |
strictMinLevel | int |
createRebootDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Create a RebootDeviceAction
to be used when performing a reboot action.
Parâmetros | |
---|---|
rebootMode | NativeDevice.RebootMode : a mode of this reboot. |
reason | String : for this reboot. |
Devoluções | |
---|---|
NativeDevice.RebootDeviceAction | the created RebootDeviceAction . |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Perform a adb reboot.
Parâmetros | |
---|---|
rebootMode | NativeDevice.RebootMode : a mode of this reboot. |
reason | String : for this reboot. |
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
helper method to throw exception if runtime permission isn't supported
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Devoluções | |
---|---|
int |
initializeConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parâmetros | |
---|---|
info | IBuildInfo |
attributes | MultiMap |
Throws | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
internalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.
Parâmetros | |
---|---|
propName | String : The name of the device property as returned by `adb shell getprop` |
fastbootVar | String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted |
description | String : A simple description of the variable. First letter should be capitalized. |
Devoluções | |
---|---|
String | A string, possibly null or empty, containing the value of the given property |
Throws | |
---|---|
DeviceNotAvailableException |
isInRebootCallback
protected boolean isInRebootCallback ()
Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.
Devoluções | |
---|---|
boolean |
isNewer
protected boolean isNewer (File localFile, IFileEntry entry)
Return true
if local file is newer than remote file. IFileEntry
being accurate to the minute, in case of equal times, the file will be considered newer.
Parâmetros | |
---|---|
localFile | File |
entry | IFileEntry |
Devoluções | |
---|---|
boolean |
notifyRebootEnded
protected void notifyRebootEnded ()
Notifies all IDeviceActionReceiver
about reboot end event.
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notifyRebootStarted
protected void notifyRebootStarted ()
Notifies all IDeviceActionReceiver
about reboot start event.
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
performDeviceAction
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Performs an action on this device. Attempts to recover device and optionally retry command if action fails.
Parâmetros | |
---|---|
actionDescription | String : a short description of action to be performed. Used for logging purposes only. |
action | NativeDevice.DeviceAction : the action to be performed |
retryAttempts | int : the retry attempts to make for action if it fails but recovery succeeds |
Devoluções | |
---|---|
boolean | true if action was performed successfully |
Throws | |
---|---|
DeviceNotAvailableException | if recovery attempt fails or max attempts done without success |
postAdbReboot
protected void postAdbReboot ()
Possible extra actions that can be taken after a reboot.
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
prePostBootSetup
protected void prePostBootSetup ()
Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.
Lança | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Parâmetros | |
---|---|
remoteFilePath | String |
localFile | File |
Devoluções | |
---|---|
boolean |
Throws | |
---|---|
DeviceNotAvailableException |
setClock
protected void setClock (Clock clock)
Set the Clock instance to use.
Parâmetros | |
---|---|
clock | Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Marks the TestDevice as microdroid and sets its CID.
Parâmetros | |
---|---|
process | Process : Process of the Microdroid VM. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Parâmetros | |
---|---|
deviceOptions |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Executes a simple fastboot command with environment variables and report the status of the command.
Parâmetros | |
---|---|
timeout | long |
envVarMap | |
fullCmd | String |
Devoluções | |
---|---|
CommandResult |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Executes a simple fastboot command and report the status of the command.
Parâmetros | |
---|---|
timeout | long |
fullCmd | String |
Devoluções | |
---|---|
CommandResult |
waitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Wait to see the device going unavailable (stop reporting to adb).
Parâmetros | |
---|---|
operationDesc | String : The name of the operation that is waiting for unavailable. |
time | long : The time to wait for unavailable to occur. |
Devoluções | |
---|---|
boolean | True if device did become unavailable. |
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2023-12-04 UTC.