DispositivoITest

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


Fornece uma API confiável e de nível um pouco mais alto para um IDevice ddmlib.

Repete comandos do dispositivo por uma quantidade configurável e fornece uma recuperação do dispositivo para dispositivos que não respondem.

Resumo

Classes aninhadas

class ITestDevice.ApexInfo

Uma classe struct simples para armazenar informações sobre um único APEX

class ITestDevice.MountPointInfo

Classe de struct simples para armazenar informações sobre um único ponto de montagem

Métodos públicos

abstract boolean canSwitchToHeadlessSystemUser()

Retorna se é permitido alternar para o usuário headless SYSTEM.

abstract boolean checkConnectivity()

Verifique se o dispositivo tem conectividade de rede.

abstract boolean clearErrorDialogs()

Tentativa de dispensar todas as caixas de diálogo de erro exibidas no momento na interface do dispositivo.

abstract void clearLastConnectedWifiNetwork()

Limpa a última rede Wi-Fi conectada.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

Conecta-se a uma rede Wi-Fi.

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Conecta-se a uma rede Wi-Fi.

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Conecta-se a uma rede Wi-Fi.

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)

Conecta-se a uma rede Wi-Fi.

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)

Uma variante de connectToWifiNetwork(String, String) que só se conecta se o dispositivo não tem conectividade de rede no momento.

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

Uma variante de connectToWifiNetwork(String, String) que só se conecta se o dispositivo não tem conectividade de rede no momento.

abstract int createUser(String name)

Cria um usuário com um nome determinado e flags padrão 0.

abstract int createUser(String name, boolean guest, boolean ephemeral)

Criar um usuário com um determinado nome e as flags fornecidas

abstract int createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)

Criar um usuário com um determinado nome e as flags fornecidas

abstract int createUserNoThrow(String name)

Cria um usuário com um nome determinado e flags padrão 0.

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Remove o IDeviceActionReceiver registrado.

abstract void disableKeyguard()

Tenta desativar o bloqueio de teclado.

abstract boolean disableNetworkMonitor()

Desativa o monitoramento de rede no dispositivo.

abstract boolean disconnectFromWifi()

Desconecta de uma rede Wi-Fi.

abstract boolean doesFileExist(String deviceFilePath, int userId)

Método auxiliar para determinar se um arquivo existente no dispositivo existe para um determinado usuário.

abstract File dumpHeap(String process, String devicePath)

Tenta despejar a heap do system_server.

abstract boolean enableNetworkMonitor()

Ativa o monitoramento de rede no dispositivo.

abstract getActiveApexes()

Busque as informações sobre os APEXs ativados no dispositivo.

abstract getAllSettings(String namespace)

Retorna pares de chave-valor do namespace solicitado.

abstract String getAndroidId(int userId)

Encontre e retorne o android-id associado a um userId. Ele será nulo se não for encontrado.

abstract getAndroidIds()

Cria um mapa de IDs do Android encontrados que correspondem a IDs de usuário.

abstract PackageInfo getAppPackageInfo(String packageName)

Busca informações sobre um pacote instalado no dispositivo.

abstract getAppPackageInfos()

Busca informações dos pacotes instalados no dispositivo.

abstract InputStreamSource getBugreport()

Recupera um relatório de bug do dispositivo.

abstract InputStreamSource getBugreportz()

Recupera um relatório de bugs do dispositivo.

abstract DeviceFoldableState getCurrentFoldableState()

Retorna o estado dobrável atual do dispositivo ou retorna nulo caso ocorram problemas.

abstract int getCurrentUser()

Retorna o ID do usuário em execução no momento.

abstract getFoldableStates()

Retorna a lista de estados dobráveis no dispositivo.

abstract getInstalledPackageNames()

Busque os nomes dos pacotes de apps presentes no dispositivo.

abstract String getIpAddress()

Extrai o endereço IP do dispositivo.

abstract KeyguardControllerState getKeyguardState()

Retorne um objeto para obter o estado atual do bloqueio de teclado ou nulo, se não houver suporte.

abstract Integer getMainUserId()

Retorna o ID do usuário principal.

abstract getMainlineModuleInfo()

Acessa as informações sobre os módulos de linha principal instalados no dispositivo.

abstract int getMaxNumberOfRunningUsersSupported()

Receba o número máximo permitido de usuários em execução simultânea.

abstract int getMaxNumberOfUsersSupported()

Descubra o número máximo de usuários permitidos.

abstract TestDeviceOptions getOptions()

Busque as opções de teste do dispositivo.

abstract Integer getPrimaryUserId()

Retorna o ID do usuário principal.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

Faz uma captura de tela do dispositivo.

abstract InputStreamSource getScreenshot(String format)

Faz uma captura de tela do dispositivo.

abstract InputStreamSource getScreenshot(long displayId)

Faz uma captura de tela do ID de tela do dispositivo.

abstract InputStreamSource getScreenshot()

Faz uma captura de tela do dispositivo.

abstract String getSetting(int userId, String namespace, String key)

Retorna o valor da configuração solicitada.

abstract String getSetting(String namespace, String key)

Consulte getSetting(int, String, String) e realizada em um usuário do sistema.

abstract getUninstallablePackageNames()

Busque os nomes dos pacotes de aplicativos que podem ser desinstalados.

abstract int getUserFlags(int userId)

Encontre e retorne as sinalizações de um determinado usuário.

abstract getUserInfos()

Recebe o mapa de useId para UserInfo no dispositivo.

abstract int getUserSerialNumber(int userId)

Retorna o número de série associado ao userId, se encontrado. Em qualquer outro caso, retorna -10000.

abstract boolean hasFeature(String feature)

Verifique se um recurso está disponível em um dispositivo.

abstract String installPackage(File packageFile, boolean reinstall, String... extraArgs)

Instale um pacote Android no dispositivo.

abstract String installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

Instale um pacote Android no dispositivo.

abstract String installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)

Instala um pacote Android no dispositivo para um determinado usuário.

abstract String installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Instala um pacote Android no dispositivo para um determinado usuário.

default String installPackages( packageFiles, boolean reinstall, String... extraArgs)

Instale um app Android composto de vários arquivos APK (um pacote dividido principal e um extras).

default String installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

Instalar um app Android composto de vários arquivos APK (um pacote dividido principal e um extras). que ficam no dispositivo Android.

default String installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)

Instalar um app Android composto de vários arquivos APK (um pacote dividido principal e um extras). para um determinado usuário.

default String installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Instalar um app Android composto de vários arquivos APK (um pacote dividido principal e um extras). para um determinado usuário.

default String installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)

Instalar um app Android composto de vários arquivos APK (um pacote dividido principal e um extras). que ficam no dispositivo Android.

default String installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

Instalar um app Android composto de vários arquivos APK (um pacote dividido principal e um extras). que ficam no dispositivo Android.

abstract boolean isHeadlessSystemUserMode()

Retorna indicando se o dispositivo usa o modo de usuário do sistema headless.

abstract boolean isMainUserPermanentAdmin()

Informa se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para o status de não administrador.

abstract boolean isMultiUserSupported()

Determina se há suporte para vários usuários.

abstract boolean isPackageInstalled(String packageName, String userId)

Consulte o dispositivo em busca de um determinado nome de pacote e ID do usuário para verificar se ele está instalado ou não para esse usuário.

abstract boolean isPackageInstalled(String packageName)

Consulte o dispositivo em busca de um nome de pacote específico para verificar se ele está instalado ou não.

abstract boolean isUserRunning(int userId)

Verifique se um determinado usuário está em execução.

abstract boolean isUserSecondary(int userId)

Retorna se o usuário especificado é um usuário secundário, de acordo com as sinalizações dele.

abstract boolean isUserVisible(int userId)

Verifica se um determinado usuário está visível.

abstract boolean isUserVisibleOnDisplay(int userId, int displayId)

Verifica se o usuário especificado está visível na tela especificada.

abstract 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).

abstract boolean isVisibleBackgroundUsersSupported()

Informa se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano.

abstract boolean isWifiEnabled()

Teste se o Wi-Fi está ativado.

abstract listDisplayIds()

Colete a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys" SurfaceFlinger".

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

Recebe a lista de telas que podem ser usadas para start a user visible in the background.

abstract listUsers()

Recebe a lista de usuários no dispositivo.

abstract boolean logBugreport(String dataName, ITestLogger listener)

Método auxiliar para registrar um relatório de bug e registrá-lo.

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

Notifica o dispositivo para aguardar a conclusão do Snapuserd.

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Registra um IDeviceActionReceiver para este dispositivo.

abstract boolean removeAdmin(String componentName, int userId)

Remove o administrador do dispositivo de um determinado usuário e retorna true quando o processo é bem-sucedido. Caso contrário, retorna false.

abstract void removeOwners()

Remova todos os proprietários de perfil de dispositivo existentes da melhor maneira possível.

abstract boolean removeUser(int userId)

Remove determinado usuário do dispositivo.

abstract boolean setDeviceOwner(String componentName, int userId)

Define um componente de administrador do dispositivo como proprietário do dispositivo em um determinado usuário.

abstract void setSetting(String namespace, String key, String value)

Consulte setSetting(int, String, String, String) e realizada em um usuário do sistema.

abstract void setSetting(int userId, String namespace, String key, String value)

Adiciona um valor de configuração ao namespace de um determinado usuário.

abstract boolean startUser(int userId)

Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento.

abstract boolean startUser(int userId, boolean waitFlag)

Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento.

abstract boolean startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)

Inicia um determinado usuário em segundo plano, visível na tela especificada (ou seja, permitindo que o usuário para iniciar atividades nessa tela).

abstract boolean stopUser(int userId)

Interrompe um determinado usuário.

abstract boolean stopUser(int userId, boolean waitFlag, boolean forceFlag)

Interrompa um determinado usuário.

abstract boolean switchUser(int userId)

Mude para outro userId com um tempo limite padrão.

abstract boolean switchUser(int userId, long timeout)

Mude para outro userId com o tempo limite fornecido como prazo.

abstract Bugreport takeBugreport()

Crie um relatório de bug e o retorne dentro de um objeto Bugreport para processá-lo.

abstract String uninstallPackage(String packageName)

Desinstala um pacote Android do dispositivo.

abstract String uninstallPackageForUser(String packageName, int userId)

Desinstala um pacote Android do dispositivo para um determinado usuário.

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Se esperado, aguarde a conclusão do Snapuserd.

Métodos públicos

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Retorna se é permitido alternar para o usuário headless SYSTEM.

Retorna
boolean

Gera
DeviceNotAvailableException

verificarConectividade

public abstract boolean checkConnectivity ()

Verifique se o dispositivo tem conectividade de rede.

Retorna
boolean true se o dispositivo tiver uma conexão de rede ativa, false em excesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

ClearErrorDialogs

public abstract boolean clearErrorDialogs ()

Tentativa de dispensar todas as caixas de diálogo de erro exibidas no momento na interface do dispositivo.

Retorna
boolean true se nenhuma caixa de diálogo estiver presente ou se elas tiverem sido apagadas. Caso contrário, false.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

ClearLastConnectedWiFiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Limpa a última rede Wi-Fi conectada. Precisa ser chamado ao iniciar uma nova invocação. para evitar a conexão à rede Wi-Fi usada no teste anterior após a reinicialização do dispositivo.

conectar à rede Wi-Fi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Conecta-se a uma rede Wi-Fi.

Ativa o Wi-Fi e bloqueia até que uma conexão seja estabelecida com um dos Wi-Fi das redes fornecidas no mapa wifiSsidToPsk. Depois que a conexão é estabelecida, a instância tenta restaurar a conexão após cada reinicialização até ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsidToPsk : um mapa de SSIDs de Wi-Fi para senhas.

Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

conectar à rede Wi-Fi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Conecta-se a uma rede Wi-Fi.

Ativa o Wi-Fi e bloqueia até que uma conexão seja estabelecida com um dos Wi-Fi das redes fornecidas no mapa wifiSsidToPsk. Depois que a conexão é estabelecida, a instância tenta restaurar a conexão após cada reinicialização até ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsidToPsk : um mapa de SSIDs de Wi-Fi para senhas.

scanSsid boolean: verifica se há SSIDs ocultos para esta rede.

Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

conectar à rede Wi-Fi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Conecta-se a uma rede Wi-Fi.

Ativa o Wi-Fi e bloqueia até que uma conexão seja estabelecida com a rede Wi-Fi especificada. Depois que a conexão é estabelecida, a instância tenta restaurá-la após cada reinicialização até ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsid String: o ssid do Wi-Fi a ser conectado.

wifiPsk String: senha longa PSK ou nula se não estiver criptografada

Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

conectar à rede Wi-Fi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Conecta-se a uma rede Wi-Fi.

Ativa o Wi-Fi e bloqueia até que uma conexão seja estabelecida com a rede Wi-Fi especificada. Depois que a conexão é estabelecida, a instância tenta restaurá-la após cada reinicialização até ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsid String: o ssid do Wi-Fi a ser conectado.

wifiPsk String: senha longa PSK ou nula se não estiver criptografada

scanSsid boolean: se é necessário procurar um SSID oculto para esta rede.

Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

conectar aRedeWiFiSeÉ necessário

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Uma variante de connectToWifiNetwork(String, String) que só se conecta se o dispositivo não tem conectividade de rede no momento.

Parâmetros
scanSsid boolean: se é necessário procurar um SSID oculto para esta rede.

Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

conectar aRedeWiFiSeÉ necessário

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Uma variante de connectToWifiNetwork(String, String) que só se conecta se o dispositivo não tem conectividade de rede no momento.

Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

usuário

public abstract int createUser (String name)

Cria um usuário com um nome determinado e flags padrão 0.

Parâmetros
name String: do usuário a ser criado no dispositivo.

Retorna
int o número inteiro do ID do usuário criado

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

usuário

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Criar um usuário com um determinado nome e as flags fornecidas

Parâmetros
name String: do usuário a ser criado no dispositivo.

guest boolean: ativa a flag de usuário --guest durante a criação.

ephemeral boolean: ativa a sinalização do usuário "-efêmero" durante a criação.

Retorna
int ID do usuário criado

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

usuário

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Criar um usuário com um determinado nome e as flags fornecidas

Parâmetros
name String: do usuário a ser criado no dispositivo.

guest boolean: ativa a flag de usuário --guest durante a criação.

ephemeral boolean: ativa a sinalização de usuário "-efêmero" durante a criação.

forTesting boolean: ativa a flag de teste --for-testing durante a criação.

Retorna
int ID do usuário criado

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

Cria um usuário com um nome determinado e flags padrão 0.

Parâmetros
name String: do usuário a ser criado no dispositivo.

Retorna
int o número inteiro do ID do usuário criado ou -1 para o erro.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Remove o IDeviceActionReceiver registrado.

Parâmetros
deviceActionReceiver IDeviceActionReceiver: uma IDeviceActionReceiver que vai ser removida.

desativarKeyguard

public abstract void disableKeyguard ()

Tenta desativar o bloqueio de teclado.

Primeiro, aguarde até que o envio de entradas fique pronto. Isso acontece aproximadamente no mesmo momento em que o dispositivo informa BOOT_COMPLETE, de forma aparentemente assíncrona, porque o framework atual tem uma disputa ocasional. Em seguida, o comando é enviado para dispensar o bloqueio de teclado (funciona somente em aplicativos não seguros)

Gera
DeviceNotAvailableException

desativarNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Desativa o monitoramento de rede no dispositivo.

Retorna
boolean true se o monitoramento for desativado. false em caso de falha.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

desconectarDoWi-Fi

public abstract boolean disconnectFromWifi ()

Desconecta de uma rede Wi-Fi.

Remove todas as redes da lista de redes conhecidas e desativa o Wi-Fi.

Retorna
boolean true se desconectado da rede Wi-Fi. false se a desconexão falhar.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

fazFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

Método auxiliar para determinar se um arquivo existente no dispositivo existe para um determinado usuário.

Parâmetros
deviceFilePath String: o caminho absoluto do arquivo no dispositivo a ser verificado.

userId int: o ID do usuário para verificar a existência do arquivo.

Retorna
boolean true se o arquivo existir. Caso contrário, retorna false.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Tenta despejar a heap do system_server. É responsabilidade do autor da chamada limpar o arquivo despejado.

Parâmetros
process String: o nome do processo do dispositivo em que o despejo de heap será feito.

devicePath String: o caminho no dispositivo em que o despejo será colocado. Precisa ser um local se houver permissão para isso.

Retorna
File o ERROR(/File) que contém o relatório. Nulo se algo falhar.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Ativa o monitoramento de rede no dispositivo.

Retorna
boolean true se o monitoramento foi ativado. false em caso de falha.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

getActiveApexes

public abstract  getActiveApexes ()

Busque as informações sobre os APEXs ativados no dispositivo.

Retorna
ERROR(/Set) de ApexInfo ativados no dispositivo no momento

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

Retorna pares de chave-valor do namespace solicitado.

Parâmetros
namespace String: precisa ser {"system", "secure", "global"}

Retorna
o mapa de pares de chave-valor. Nulo se o namespace não for compatível.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Encontre e retorne o android-id associado a um userId. Ele será nulo se não for encontrado.

Parâmetros
userId int

Retorna
String

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Cria um mapa de IDs do Android encontrados que correspondem a IDs de usuário. Não há nenhum seguro de que cada usuário ID encontrou um ID do Android associado a essa função, de modo que alguns IDs de usuário podem ter correspondência de valores nulos.

Retorna
Foi encontrado um mapa de IDs do Android com IDs de usuário correspondentes.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Busca informações sobre um pacote instalado no dispositivo.

Parâmetros
packageName String

Retorna
PackageInfo PackageInfo ou null se as informações não puderem ser recuperadas

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Busca informações dos pacotes instalados no dispositivo.

Retorna
ERROR(/List) de PackageInfos instalados no dispositivo.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Recupera um relatório de bug do dispositivo.

A implementação vai continuar funcionando em dispositivos sem cartão SD (ou onde o cartão SD ainda não está montado).

Retorna
InputStreamSource Um InputStreamSource que produzirá o conteúdo do relatório de bug sob demanda. Em caso de falha, o InputStreamSource produzirá um ERROR(/InputStream) vazio.

getBugreportz

public abstract InputStreamSource getBugreportz ()

Recupera um relatório de bugs do dispositivo. O relatório de bug no formato ZIP contém o principal relatório de bug e e outros arquivos de registro úteis para depuração.

Compatível apenas com "adb version" > 1.0.36

Retorna
InputStreamSource um InputStreamSource do arquivo zip que contém o bugreportz, retorna nulo no em caso de falha.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

Retorna o estado dobrável atual do dispositivo ou retorna nulo caso ocorram problemas.

Retorna
DeviceFoldableState

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Retorna o ID do usuário em execução no momento. Em caso de erro, retorne -10000.

Retorna
int

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

Retorna a lista de estados dobráveis no dispositivo. Pode ser obtido com "cmd device_state print-states".

Retorna

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstallPackageNames

public abstract  getInstalledPackageNames ()

Busque os nomes dos pacotes de apps presentes no dispositivo.

Retorna
ERROR(/Set) de String nomes de pacotes atualmente instalados no dispositivo.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Extrai o endereço IP do dispositivo.

Retorna
String o endereço IP do dispositivo ou null se o dispositivo não tiver um endereço IP

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Retorne um objeto para obter o estado atual do bloqueio de teclado ou nulo, se não houver suporte.

Retorna
KeyguardControllerState um KeyguardControllerState contendo um snapshot do estado do bloqueio de teclado e retorna Nulo se a consulta do Keyguard não tiver suporte.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

getMainUserId

public abstract Integer getMainUserId ()

Retorna o ID do usuário principal.

Retorna
Integer o userId do usuário principal, se houver, e nulo, se não houver um usuário principal.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se a saída do dispositivo não for a esperada.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Acessa as informações sobre os módulos de linha principal instalados no dispositivo.

Retorna
ERROR(/Set) de String módulos de linha principal instalados atualmente no dispositivo.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersAllowed

public abstract int getMaxNumberOfRunningUsersSupported ()

Receba o número máximo permitido de usuários em execução simultânea. O valor padrão é 0.

Retorna
int Um número inteiro que indica o número de usuários em execução simultânea

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersAllowed

public abstract int getMaxNumberOfUsersSupported ()

Descubra o número máximo de usuários permitidos. O valor padrão é 0.

Retorna
int um número inteiro que indica o número de usuários compatíveis

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Busque as opções de teste do dispositivo.

Retorna
TestDeviceOptions TestDeviceOptions relacionado ao dispositivo em teste.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Retorna o ID do usuário principal.

Retorna
Integer o userId do usuário principal, se houver, e nulo, se não houver um usuário principal.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se a saída do dispositivo não for a esperada.
DeviceNotAvailableException

getCaptura de tela

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Faz uma captura de tela do dispositivo. Recomendamos usar getScreenshot(String) com codificação JPEG para tamanhos menores.

Parâmetros
format String: PNG e JPEG compatíveis

rescale boolean: se a captura de tela precisar ser redimensionada para reduzir o tamanho da imagem resultante

Retorna
InputStreamSource um InputStreamSource da captura de tela no formato, ou null se o não foi possível fazer a captura de tela.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCaptura de tela

public abstract InputStreamSource getScreenshot (String format)

Faz uma captura de tela do dispositivo. É recomendável usar getCaptura de tela(format) em vez da codificação JPEG para tamanhos menores

Parâmetros
format String: PNG e JPEG compatíveis

Retorna
InputStreamSource uma InputStreamSource da captura de tela no formato, ou null se falha na captura de tela.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCaptura de tela

public abstract InputStreamSource getScreenshot (long displayId)

Faz uma captura de tela do ID de tela do dispositivo. O formato é PNG.

TODO: estender as implementações acima para oferecer suporte a "format" e "redimensionar"

Parâmetros
displayId long: o ID da tela de onde a captura de tela será feita.

Retorna
InputStreamSource um InputStreamSource da captura de tela no formato, ou null se o não foi possível fazer a captura de tela.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCaptura de tela

public abstract InputStreamSource getScreenshot ()

Faz uma captura de tela do dispositivo.

Retorna
InputStreamSource uma InputStreamSource da captura de tela em formato PNG ou null se falha na captura de tela.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (int userId, 
                String namespace, 
                String key)

Retorna o valor da configuração solicitada. O namespace precisa ser um destes: {"system", "secure", "global"}

Parâmetros
userId int

namespace String

key String

Retorna
String o valor associado ao namespace:key de um usuário. Nulo se não for encontrado.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

Consulte getSetting(int, String, String) e realizada em um usuário do sistema.

Parâmetros
namespace String

key String

Retorna
String

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Busque os nomes dos pacotes de aplicativos que podem ser desinstalados. Isso é definido atualmente como pacotes que não são do sistema e pacotes de sistema atualizados.

Retorna
ERROR(/Set) de nomes de pacotes String desinstaláveis atualmente instalados no dispositivo.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Encontre e retorne as sinalizações de um determinado usuário. As flags são definidas em "android.content.pm.UserInfo" no Android Open Source Project.

Parâmetros
userId int

Retorna
int as sinalizações associadas ao userId fornecido, se encontrados, -10000 em qualquer outro caso.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Recebe o mapa de useId para UserInfo no dispositivo. Uma DeviceRuntimeException vai ser gerada se a saída do dispositivo não for a esperada.

Retorna
a lista de objetos UserInfo.

Gera
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Retorna o número de série associado ao userId, se encontrado. Em qualquer outro caso, retorna -10000.

Parâmetros
userId int

Retorna
int

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

Verifique se um recurso está disponível em um dispositivo.

Parâmetros
feature String: qual formato deve ser "feature:" ou "" diretamente.

Retorna
boolean Verdadeiro se o atributo for encontrado. Caso contrário, será falso.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Instale um pacote Android no dispositivo.

Parâmetros
packageFile File: o arquivo apk a ser instalado.

reinstall boolean: true se uma reinstalação precisar ser realizada.

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para disponível .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

installPackage

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Instale um pacote Android no dispositivo.

Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em o horário de instalação precisa chamar essa função.

Parâmetros
packageFile File: o arquivo apk a ser instalado.

reinstall boolean: true se uma reinstalação precisar ser realizada.

grantPermissions boolean: se todas as permissões de execução forem concedidas no momento da instalação

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou
UnsupportedOperationException se a permissão de execução não for compatível com a plataforma no dispositivo.

installPackageForUser

public abstract 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 a ser instalado.

reinstall boolean: true se uma reinstalação precisar ser realizada.

userId int: o ID do usuário inteiro para fazer a instalação.

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

installPackageForUser

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Instala um pacote Android no dispositivo para um determinado usuário.

Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em o horário de instalação precisa chamar essa função.

Parâmetros
packageFile File: o arquivo apk a ser instalado.

reinstall boolean: true se uma reinstalação precisar ser realizada.

grantPermissions boolean: se todas as permissões de execução forem concedidas no momento da instalação

userId int: o ID do usuário inteiro para fazer a instalação.

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou
UnsupportedOperationException se a permissão de execução não for compatível com a plataforma no dispositivo.

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

Instale um app Android composto de vários arquivos APK (um pacote dividido principal e um extras). Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o APK para vários arquivos.

Parâmetros
packageFiles : os arquivos apk locais.

reinstall boolean: true se uma reinstalação precisar ser realizada.

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para disponível .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou
UnsupportedOperationException se a permissão de execução não for compatível com a plataforma no dispositivo.

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Instalar um app Android composto de vários arquivos APK (um pacote dividido principal e um extras). que ficam no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o APK para vários arquivos.

Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em o momento da instalação deve chamar essa função.

Parâmetros
packageFiles : os caminhos de arquivos apk remotos a serem instalados

reinstall boolean: true se uma reinstalação precisar ser realizada.

grantPermissions boolean: se todas as permissões de execução forem concedidas no momento da instalação

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou
UnsupportedOperationException se a permissão de execução não for compatível com a plataforma no dispositivo.

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Instalar um app Android composto de vários arquivos APK (um pacote dividido principal e um extras). para um determinado usuário. Consulte "https://developer.android.com/studio/build/configure-apk-splits" ativado como dividir o apk em vários arquivos.

Parâmetros
packageFiles : os arquivos apk locais.

reinstall boolean: true se uma reinstalação precisar ser realizada.

userId int: o ID do usuário inteiro para fazer a instalação.

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou
UnsupportedOperationException se a permissão de execução não for compatível com a plataforma no dispositivo.

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Instalar um app Android composto de vários arquivos APK (um pacote dividido principal e um extras). para um determinado usuário. Consulte "https://developer.android.com/studio/build/configure-apk-splits" ativado como dividir o apk em vários arquivos.

Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em o horário de instalação precisa chamar essa função.

Parâmetros
packageFiles : os arquivos apk locais.

reinstall boolean: true se uma reinstalação precisar ser realizada.

grantPermissions boolean: se todas as permissões de execução forem concedidas no momento da instalação

userId int: o ID do usuário inteiro para fazer a instalação.

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou
UnsupportedOperationException se a permissão de execução não for compatível com a plataforma no dispositivo.

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Instalar um app Android composto de vários arquivos APK (um pacote dividido principal e um extras). que ficam no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o APK para vários arquivos.

Parâmetros
remoteApkPaths : os caminhos de arquivos apk remotos.

reinstall boolean: true se uma reinstalação precisar ser realizada.

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para disponível .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou
UnsupportedOperationException se a permissão de execução não for compatível com a plataforma no dispositivo.

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Instalar um app Android composto de vários arquivos APK (um pacote dividido principal e um extras). que ficam no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o APK para vários arquivos.

Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em o momento da instalação deve chamar essa função.

Parâmetros
remoteApkPaths : os caminhos de arquivos apk remotos.

reinstall boolean: true se uma reinstalação precisar ser realizada.

grantPermissions boolean: se todas as permissões de execução forem concedidas no momento da instalação

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou
UnsupportedOperationException se a permissão de execução não for compatível com a plataforma no dispositivo.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Retorna indicando se o dispositivo usa o modo de usuário do sistema headless.

Retorna
boolean

Gera
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

Informa se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para o status de não administrador.

Retorna
boolean

Gera
DeviceNotAvailableException

isMultiUsersupported

public abstract boolean isMultiUserSupported ()

Determina se há suporte para vários usuários.

Retorna
boolean verdadeiro se for compatível com vários usuários, caso contrário será falso

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstall

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Consulte o dispositivo em busca de um determinado nome de pacote e ID do usuário para verificar se ele está instalado ou não para esse usuário.

Parâmetros
packageName String: o pacote que estamos verificando se está instalado.

userId String: o ID do usuário em que o pacote está instalado. Se nulo, o usuário principal zero será usado.

Retorna
boolean Verdadeiro se o pacote for relatado como instalado. Falso, do contrário.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstall

public abstract boolean isPackageInstalled (String packageName)

Consulte o dispositivo em busca de um nome de pacote específico para verificar se ele está instalado ou não.

Parâmetros
packageName String

Retorna
boolean Verdadeiro se o pacote for relatado como instalado. Falso, do contrário.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Verifique se um determinado usuário está em execução.

Parâmetros
userId int

Retorna
boolean Verdadeiro se o usuário estiver correndo e falso em todos os outros casos.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Secundário do usuário

public abstract boolean isUserSecondary (int userId)

Retorna se o usuário especificado é um usuário secundário, de acordo com as sinalizações dele.

Parâmetros
userId int

Retorna
boolean verdadeiro se o usuário for secundário. Caso contrário, falso.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Verifica se um determinado usuário está visível.

Um rótulo "visível" usuário é um usuário que está interagindo com o ser humano usuário e, portanto, é capaz de iniciar atividades de inicialização (normalmente na tela padrão).

Parâmetros
userId int

Retorna
boolean

Gera
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Verifica se o usuário especificado está visível na tela especificada.

Um rótulo "visível" usuário é um usuário que está interagindo com o ser humano usuário e, portanto, é capaz de iniciar atividades de inicialização nessa tela.

Parâmetros
userId int

displayId int

Retorna
boolean

Gera
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano no ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

Se isso acontecer, você pode chamar startVisibleBackgroundUser(int, int, boolean), transmitindo uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers() (que precisa incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Retorna
boolean

Gera
DeviceNotAvailableException

isVisibleBackgroundUsersAllowed

public abstract boolean isVisibleBackgroundUsersSupported ()

Informa se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano.

Se isso acontecer, você pode chamar startVisibleBackgroundUser(int, int, boolean), transmitindo uma tela retornada por listDisplayIdsForStartingVisibleBackgroundUsers().

Retorna
boolean

Gera
DeviceNotAvailableException

Compatível com Wi-Fi

public abstract boolean isWifiEnabled ()

Teste se o Wi-Fi está ativado.

Verifica se o Wi-Fi está ativado no dispositivo. Útil para declarar o status do Wi-Fi antes de testes que não deve funcionar com Wi-Fi, por exemplo, testes de dados móveis.

Retorna
boolean true se o Wi-Fi estiver ativado. false se desativado

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

listDisplayIds

public abstract  listDisplayIds ()

Colete a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys" SurfaceFlinger".

Retorna
A lista de exibições. O padrão sempre retorna a exibição padrão 0.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Recebe a lista de telas que podem ser usadas para start a user visible in the background.

Retorna

Gera
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Recebe a lista de usuários no dispositivo. Gera DeviceRuntimeException se a saída do dispositivo não é o esperado.

Retorna
a lista de IDs de usuário.

Gera
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

relatório do bug

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Método auxiliar para registrar um relatório de bug e registrá-lo.

Parâmetros
dataName String: nome em que o relatório do bug será informado.

listener ITestLogger: um ITestLogger para registrar o relatório do bug.

Retorna
boolean Verdadeiro se a geração de registros for bem-sucedida. Caso contrário, é falso.

notificarSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Notifica o dispositivo para aguardar a conclusão do Snapuserd.

Parâmetros
waitPhase SnapuserdWaitPhase

registrarDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra um IDeviceActionReceiver para este dispositivo.

Todos os IDeviceActionReceiver registrados vão receber uma notificação antes de uma ação no dispositivo começar e depois que a ação do dispositivo terminar.

Parâmetros
deviceActionReceiver IDeviceActionReceiver: um IDeviceActionReceiver que será registrado.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Remove o administrador do dispositivo de um determinado usuário e retorna true quando o processo é bem-sucedido. Caso contrário, retorna false.

Parâmetros
componentName String: do administrador do dispositivo a ser removido.

userId int: do usuário em que o administrador do dispositivo está instalado.

Retorna
boolean Verdadeiro se for bem-sucedido, caso contrário, falso.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Remova todos os proprietários de perfil de dispositivo existentes da melhor maneira possível.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Remove determinado usuário do dispositivo.

Parâmetros
userId int: do usuário a ser removido

Retorna
boolean verdadeiro se conseguirmos remover o usuário, caso contrário é falso.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Define um componente de administrador do dispositivo como proprietário do dispositivo em um determinado usuário.

Parâmetros
componentName String: do administrador do dispositivo para ser o proprietário do dispositivo.

userId int: do usuário em que o proprietário do dispositivo mora.

Retorna
boolean Verdadeiro se for bem-sucedido, caso contrário, falso.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

public abstract void setSetting (String namespace, 
                String key, 
                String value)

Consulte setSetting(int, String, String, String) e realizada em um usuário do sistema.

Parâmetros
namespace String

key String

value String

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

public abstract void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Adiciona um valor de configuração ao namespace de um determinado usuário. Algumas configurações só estarão disponíveis após a reinicialização. O namespace precisa ser um destes: {"system", "secure", "global"}

Parâmetros
userId int

namespace String

key String

value String

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

usuáriode inicialização

public abstract boolean startUser (int userId)

Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. Se o usuário já estiver executado em segundo plano, esse método é um NOOP.

Parâmetros
userId int: do usuário que começa em segundo plano

Retorna
boolean verdadeiro se o usuário tiver sido iniciado com sucesso em segundo plano.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

usuáriode inicialização

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. Se o usuário já estiver executado em segundo plano, esse método é um NOOP. É possível fornecer uma flag extra para aguardar que a operação tenha efeito.

Parâmetros
userId int: do usuário que começa em segundo plano

waitFlag boolean: fará o comando aguardar até que o usuário seja iniciado e desbloqueado.

Retorna
boolean verdadeiro se o usuário tiver sido iniciado com sucesso em segundo plano.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

public abstract boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Inicia um determinado usuário em segundo plano, visível na tela especificada (por exemplo, permitindo que o usuário para iniciar atividades nessa tela).

OBSERVAÇÃO: esse comando não verifica se o usuário existe, se a exibição está disponível, se device supports such feature etc.

Parâmetros
userId int: do usuário que começa em segundo plano

displayId int: tela para iniciar visíveis ao usuário

waitFlag boolean: fará o comando aguardar até que o usuário seja iniciado e desbloqueado.

Retorna
boolean true se o usuário tiver sido iniciado visível em segundo plano.

Gera
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Interrompe um determinado usuário. Se o usuário já tiver sido interrompido, esse método será NOOP. Não é possível interromper o usuário atual e o do sistema.

Parâmetros
userId int: do usuário a ser interrompido.

Retorna
boolean verdadeiro se o usuário tiver sido interrompido.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Interrompa um determinado usuário. É possível fornecer sinalizações extras para aguardar até que a operação tenha efeito. e forçar o encerramento do usuário. Não é possível interromper o usuário atual e o do sistema.

Parâmetros
userId int: do usuário a ser interrompido.

waitFlag boolean: fará o comando esperar até que o usuário seja interrompido.

forceFlag boolean: força o fechamento do usuário.

Retorna
boolean verdadeiro se o usuário tiver sido interrompido.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

Mude para outro userId com um tempo limite padrão. switchUser(int, long).

Parâmetros
userId int

Retorna
boolean Verdadeiro se o novo userId corresponder ao provedor userId. Falso, do contrário.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Mude para outro userId com o tempo limite fornecido como prazo. Tentativa de desativar o bloqueio de teclado após a alteração do usuário.

Parâmetros
userId int

timeout long: aguardar antes de retornar "false" para a falha da troca de usuário.

Retorna
boolean Verdadeiro se o novo userId corresponder ao provedor userId. Falso, do contrário.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Relatório TakeBug

public abstract Bugreport takeBugreport ()

Crie um relatório de bug e o retorne dentro de um objeto Bugreport para processá-lo. Retornar nulo em caso de problema. O arquivo referenciado no objeto Bugreport precisa ser limpo com Bugreport.close().

Retorna
Bugreport

desinstalarPackage

public abstract String uninstallPackage (String packageName)

Desinstala um pacote Android do dispositivo.

Parâmetros
packageName String: o pacote do Android a ser desinstalado.

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

desinstalarPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Desinstala um pacote Android do dispositivo para um determinado usuário.

Parâmetros
packageName String: o pacote do Android a ser desinstalado.

userId int: o ID do usuário inteiro para desinstalar.

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser se recuperou

"waitForSnapuserd"

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Se esperado, aguarde a conclusão do Snapuserd.

Parâmetros
currentPhase SnapuserdWaitPhase

Gera
DeviceNotAvailableException