ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Subclasses indiretas conhecidas IManagedTestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice IManagedTestDevice Um ITestDevice cujo ciclo de vida é gerenciado.  LocalAndroidVirtualDevice A classe para dispositivos virtuais locais executados no host do TradeFed.  ManagedRemoteDevice Um dispositivo em execução em uma máquina virtual que gerenciamos remotamente por uma instância do Tradefed na VM.  NativeDevice Implementação padrão de um ITestDevice Dispositivos Android com pilha não completa.  NestedRemoteDevice Representação do dispositivo em execução em uma VM Cuttlefish remota.  RemoteAndroidDevice Implementação de um ITestDevice para um dispositivo Android de stack completa conectado por adb connect.  RemoteAndroidVirtualDevice Estenda o comportamento de RemoteAndroidDevice para um dispositivo Android de pilha completa em execução no Google Compute Engine (GCE).  TestDevice Implementação de um ITestDevice para um dispositivo Android de pilha completa

---

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

Tenta novamente comandos do dispositivo por um valor configurável e fornece uma interface de recuperação para dispositivos que não respondem.

Resumo

Classes aninhadas
class	ITestDevice.ApexInfo Uma classe de estrutura simples para armazenar informações sobre um único APEX
class	ITestDevice.MountPointInfo Uma classe de estrutura 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 do sistema sem cabeça.
abstract boolean	checkConnectivity() Verifique se o dispositivo tem conectividade de rede.
abstract boolean	clearErrorDialogs() Tente dispensar as caixas de diálogo de erro exibidas 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 tiver 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 tiver conectividade de rede no momento.
abstract int	createUser(String name) Crie um usuário com um nome e flags padrão 0.
abstract int	createUser(String name, boolean guest, boolean ephemeral) Criar um usuário com um nome e as flags fornecidas
abstract int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) Criar um usuário com um nome e as flags fornecidas
abstract int	createUserNoThrow(String name) Crie um usuário com um nome 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 o arquivo no dispositivo existe para um determinado usuário.
abstract File	dumpHeap(String process, String devicePath) Tenta despejar a pilha do system_server.
abstract boolean	enableNetworkMonitor() Ativa o monitoramento de rede no dispositivo.
abstract	getActiveApexes() Busca as informações sobre os APEXes ativados no dispositivo.
abstract	getAllSettings(String namespace) Retorna pares de chave-valor do namespace solicitado.
abstract String	getAndroidId(int userId) Encontra e retorna o Android-ID associado a um userId, nulo se não encontrado.
abstract	getAndroidIds() Crie um mapa de IDs do Android encontrados que correspondem aos IDs dos usuários.
abstract PackageInfo	getAppPackageInfo(String packageName) Buscar informações sobre um pacote instalado no dispositivo.
abstract	getAppPackageInfos() Buscar informações de pacotes instalados no dispositivo.
abstract InputStreamSource	getBugreport() Recupera um relatório de bug do dispositivo.
abstract InputStreamSource	getBugreportz() Recupera um bugreportz do dispositivo.
abstract DeviceFoldableState	getCurrentFoldableState() Retorna o estado dobrável atual do dispositivo ou nulo se alguns problemas ocorreram.
abstract int	getCurrentUser() Retorna o ID do usuário em execução atual.
abstract	getFoldableStates() Retorna a lista de estados dobráveis no dispositivo.
abstract	getInstalledPackageNames() Busca os nomes dos pacotes de aplicativos presentes no dispositivo.
abstract String	getIpAddress() Recebe o endereço IP do dispositivo.
abstract KeyguardControllerState	getKeyguardState() Retorna um objeto para conferir 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() Receber as informações sobre os módulos principais instalados no dispositivo.
abstract int	getMaxNumberOfRunningUsersSupported() Receba o número máximo de usuários em execução simultaneamente com suporte.
abstract int	getMaxNumberOfUsersSupported() Receba o número máximo de usuários com suporte.
abstract TestDeviceOptions	getOptions() Buscar 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(long displayId) Faz uma captura de tela do ID de exibição fornecido do dispositivo.
abstract InputStreamSource	getScreenshot(String format) Faz uma captura 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 executado no usuário do sistema.
abstract	getUninstallablePackageNames() Busca os nomes dos pacotes de aplicativos que podem ser desinstalados.
abstract int	getUserFlags(int userId) Encontre e retorne as flags 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, ou -10000 em outros casos.
abstract boolean	hasFeature(String feature) Conferir se um recurso está disponível em um dispositivo.
abstract String	installPackage(File packageFile, boolean reinstall, String... extraArgs) Instale um pacote do Android no dispositivo.
abstract String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Instale um pacote do Android no dispositivo.
abstract String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) Instale um pacote Android no dispositivo para um determinado usuário.
abstract String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instale um pacote Android no dispositivo para um determinado usuário.
default String	installPackages( packageFiles, boolean reinstall, String... extraArgs) Instale um app Android feito de vários arquivos APK (um principal e pacotes divididos extras).
default String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android.
default String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs) Instale um aplicativo Android feito de vários arquivos APK (um principal e pacotes divididos extras) para um determinado usuário.
default String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instale um aplicativo Android feito de vários arquivos APK (um principal e pacotes divididos extras) para um determinado usuário.
default String	installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs) Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android.
default String	installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android.
abstract boolean	isHeadlessSystemUserMode() Retorna se o dispositivo usa o modo de usuário do sistema sem cabeça.
abstract 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.
abstract boolean	isMultiUserSupported() Determina se há suporte para vários usuários.
abstract boolean	isPackageInstalled(String packageName, String userId) Consultar o dispositivo para 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) Consultar o dispositivo para um determinado nome de pacote e verificar se ele está instalado ou não.
abstract boolean	isUserRunning(int userId) Verificar se um determinado usuário está em execução.
abstract boolean	isUserSecondary(int userId) Retorna se o usuário especificado é secundário de acordo com as flags.
abstract boolean	isUserVisible(int userId) Verifica se o usuário especificado está visível.
abstract boolean	isUserVisibleOnDisplay(int userId, int displayId) Verifica se o usuário está visível na tela.
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() Retorna se o dispositivo permite que os usuários sejam iniciados e visíveis em segundo plano.
abstract boolean	isWifiEnabled() Teste se o Wi-Fi está ativado.
abstract	listDisplayIds() Coletar a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys SurfaceFlinger".
abstract	listDisplayIdsForStartingVisibleBackgroundUsers() Consegue 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 para os repórteres.
default void	notifySnapuserd(SnapuserdWaitPhase waitPhase) Notifica o dispositivo para que ele aguarde 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 especificado no usuário especificado e retorna true se for bem-sucedido, false caso contrário.
abstract void	removeOwners() Remova todos os proprietários de perfil de dispositivo com o melhor esforço.
abstract boolean	removeUser(int userId) Remover um determinado usuário do dispositivo.
abstract boolean	setDeviceOwner(String componentName, int userId) Define um componente de administrador do dispositivo como proprietário do dispositivo no usuário especificado.
abstract void	setSetting(String namespace, String key, String value) Consulte setSetting(int, String, String, String) e executado no usuário do sistema.
abstract void	setSetting(int userId, String namespace, String key, String value) Adicione 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 se ele estiver parado.
abstract boolean	startUser(int userId, boolean waitFlag) Inicia um determinado usuário em segundo plano se ele estiver parado.
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 inicie atividades nessa tela).
abstract boolean	stopUser(int userId) Interrompe um determinado usuário.
abstract boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) Parar 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) Mudar para outro userId com o tempo limite fornecido como prazo.
abstract Bugreport	takeBugreport() Retorna um bugreport dentro de um objeto Bugreport para processá-lo.
abstract String	uninstallPackage(String packageName) Desinstalar um pacote do Android do dispositivo.
abstract String	uninstallPackageForUser(String packageName, int userId) Desinstalar um pacote do Android do dispositivo para um determinado usuário.
default void	waitForSnapuserd(SnapuserdWaitPhase currentPhase) Se esperado, aguarde o snapuserd ser concluído.

Métodos públicos

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Retorna se é permitido alternar para o usuário do sistema sem cabeça.

Retorna
boolean

Gera
DeviceNotAvailableException

checkConnectivity

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 caso contrário.

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Tente dispensar as caixas de diálogo de erro exibidas na interface do dispositivo.

Retorna
boolean	true se nenhuma caixa de diálogo estiver presente ou se ela tiver sido limpa. false se não forem.

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

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 uma das redes Wi-Fi fornecidas no mapa wifiSsidToPsk. Depois que uma conexão é estabelecida, a instância tenta restaurar a conexão após cada reinicialização até que 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 recuperada.

connectToWifiNetwork

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 uma das redes Wi-Fi fornecidas no mapa wifiSsidToPsk. Depois que uma conexão é estabelecida, a instância tenta restaurar a conexão após cada reinicialização até que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsidToPsk	: um mapa de SSIDs de Wi-Fi para senhas.
scanSsid	boolean: se a verificação de SSIDs ocultos para essa rede será feita.

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 recuperada.

connectToWifiNetwork

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 uma conexão é estabelecida, a instância tenta restaurar a conexão após cada reinicialização até que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsid	String: o SSID do Wi-Fi a que você quer se conectar
wifiPsk	String: frase de acesso PSK ou nulo se não for 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 recuperada.

connectToWifiNetwork

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 uma conexão é estabelecida, a instância tenta restaurar a conexão após cada reinicialização até que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsid	String: o SSID do Wi-Fi a que você quer se conectar
wifiPsk	String: frase de acesso PSK ou nulo se não for criptografada
scanSsid	boolean: se a verificação de SSID ocultos para essa rede será feita.

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 recuperada.

connectToWifiNetworkIfNeeded

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 tiver conectividade de rede no momento.

Parâmetros
scanSsid	boolean: se a verificação de SSID ocultos para essa rede será feita

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

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

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

Parâmetros
name	String: o nome 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

createUser

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

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

Parâmetros
name	String: o nome do usuário a ser criado no dispositivo
guest	boolean: ativar a flag de usuário --guest durante a criação
ephemeral	boolean: ativar a flag do usuário --ephemeral durante a criação

Retorna
int	ID do usuário criado

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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

Parâmetros
name	String: o nome do usuário a ser criado no dispositivo
guest	boolean: ativar a flag de usuário --guest durante a criação
ephemeral	boolean: ativar a flag do usuário --ephemeral durante a criação
forTesting	boolean: ativar 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)

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

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

Retorna
int	O número inteiro do ID do usuário criado ou -1 para 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 será removida.

disableKeyguard

public abstract void disableKeyguard ()

Tenta desativar o bloqueio de teclado.

Primeiro, aguarde o envio de entrada ficar pronto. Isso acontece na mesma hora em que o dispositivo informa BOOT_COMPLETE, aparentemente de forma assíncrona, porque a implementação atual do framework tem uma condição de corrida ocasional. O comando é enviado para dispensar a proteção de teclas (funciona apenas em proteções não seguras).

Gera
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Desativa o monitoramento de rede no dispositivo.

Retorna
boolean	true se o monitoramento for desativado. false se ela falhar.

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

disconnectFromWifi

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 recuperada.

doesFileExist

public abstract 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

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

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

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Tenta despejar a pilha do system_server. É responsabilidade do autor da chamada limpar o arquivo descartado.

Parâmetros
process	String: o nome do processo do dispositivo em que o dumpheap será usado.
devicePath	String: o caminho no dispositivo em que o despejo será colocado. Ele precisa ser um local em que as permissões sejam permitidas.

Retorna
File	o ERROR(/File) que contém o relatório. Valor 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 for ativado. false se ela falhar.

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

getActiveApexes

public abstract  getActiveApexes ()

Busca as informações sobre os APEXes ativados no dispositivo.

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

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 um dos valores {"system", "secure", "global"}

Retorna
	o mapa de pares de chave-valor. Valor nulo se o namespace não tiver suporte.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Encontra e retorna o Android-ID associado a um userId, nulo se não encontrado.

Parâmetros
userId	int

Retorna
String

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Crie um mapa de IDs do Android encontrados que correspondem aos IDs dos usuários. Não há garantia de que cada ID do usuário vai encontrar um ID do Android associado a essa função. Portanto, alguns IDs de usuário podem corresponder a "null".

Retorna
	Mapa de IDs do Android encontrados que correspondem aos IDs de usuário.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Parâmetros
packageName	String

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

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Buscar informações de 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 garante que o app continue funcionando em um dispositivo sem um cartão SD (ou em que o cartão SD ainda não foi montado).

Retorna
InputStreamSource	Um InputStreamSource que vai produzir o conteúdo do bugreport sob demanda. Em caso de falha, o InputStreamSource vai produzir um ERROR(/InputStream) vazio.

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

Compatível apenas com a versão do adb > 1.0.36.

Retorna
InputStreamSource	Um InputStreamSource do arquivo ZIP que contém os bugreportz, retorna null em caso de falha.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

Retorna o estado dobrável atual do dispositivo ou nulo se alguns problemas ocorreram.

Retorna
DeviceFoldableState

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Retorna o ID do usuário em execução atual. 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 recebido com "cmd device_state print-states".

Retorna

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Busca os nomes dos pacotes de aplicativos presentes no dispositivo.

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

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Recebe o endereço IP do dispositivo.

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

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

Retorna
KeyguardControllerState	um KeyguardControllerState que contém um snapshot do estado do bloqueio de tela e retorna "Null" se a consulta de bloqueio de tela não tiver suporte.

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

getMainUserId

public abstract Integer getMainUserId ()

Retorna o ID do usuário principal.

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

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Receber as informações sobre os módulos principais instalados no dispositivo.

Retorna
	ERROR(/Set) dos módulos principais String instalados no dispositivo.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Receba o número máximo de usuários em execução simultaneamente com suporte. O valor padrão é 0.

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

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Receba o número máximo de usuários com suporte. O valor padrão é 0.

Retorna
int	um número inteiro que indica o número de usuários com suporte

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Buscar 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 um, e nulo, se não houver.

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

Parâmetros
format	String: PNG, JPEG com suporte
rescale	boolean: se a captura de tela precisa ser redimensionada para reduzir o tamanho da imagem resultante

Retorna
InputStreamSource	uma InputStreamSource da captura de tela no formato ou null se a captura de tela não foi bem-sucedida.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Faz uma captura de tela do ID de exibição fornecido do dispositivo. O formato é PNG.

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

Parâmetros
displayId	long: o ID de exibição da tela para fazer capturas de tela.

Retorna
InputStreamSource	uma InputStreamSource da captura de tela no formato ou null se a captura de tela não foi bem-sucedida.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

Parâmetros
format	String: PNG, JPEG com suporte

Retorna
InputStreamSource	uma InputStreamSource da captura de tela no formato ou null se a captura de tela não foi concluída.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Faz uma captura de tela do dispositivo.

Retorna
InputStreamSource	uma InputStreamSource da captura de tela no formato PNG ou null se a captura de tela não foi concluída.

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. namespace precisa ser um destes: {"system", "secure", "global"}

Parâmetros
userId	int
namespace	String
key	String

Retorna
String	o valor associado à chave namespace:key de um usuário. Valor nulo se não encontrado.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

Consulte getSetting(int, String, String) e executado no usuário do sistema.

Parâmetros
namespace	String
key	String

Retorna
String

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Busca os nomes dos pacotes de aplicativos que podem ser desinstalados. Atualmente, isso é definido como pacotes não do sistema e pacotes do sistema atualizados.

Retorna
	ERROR(/Set) dos nomes de pacote String não desinstaláveis instalados no dispositivo.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Encontre e retorne as flags de um determinado usuário. As flags são definidas na classe "android.content.pm.UserInfo" no Android Open Source Project.

Parâmetros
userId	int

Retorna
int	As flags associadas ao userId fornecido, se encontrado, ou -10000 em outros casos.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Recebe o mapa de useId para UserInfo no dispositivo. Ocorrerá DeviceRuntimeException se a saída do dispositivo não for como esperado.

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, ou -10000 em outros casos.

Parâmetros
userId	int

Retorna
int

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

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

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

Retorna
boolean	Verdadeiro se o recurso 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 do Android no dispositivo.

Parâmetros
packageFile	File: o arquivo apk a ser instalado
reinstall	boolean: true se uma reinstalação precisar ser feita
extraArgs	String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções 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 recuperada.

installPackage

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

Instale um pacote do Android no dispositivo.

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

Parâmetros
packageFile	File: o arquivo apk a ser instalado
reinstall	boolean: true se uma reinstalação precisar ser feita
grantPermissions	boolean: se todas as permissões de execução precisam ser concedidas no momento da instalação
extraArgs	String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções 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 recuperada.
UnsupportedOperationException	Se a permissão de execução não tiver suporte da 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 feita
userId	int: o ID de usuário inteiro a ser instalado.
extraArgs	String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções 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 recuperada.

installPackageForUser

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

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

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

Parâmetros
packageFile	File: o arquivo apk a ser instalado
reinstall	boolean: true se uma reinstalação precisar ser feita
grantPermissions	boolean: se todas as permissões de execução precisam ser concedidas no momento da instalação
userId	int: o ID de usuário inteiro a ser instalado.
extraArgs	String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções 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 recuperada.
UnsupportedOperationException	Se a permissão de execução não tiver suporte da plataforma no dispositivo.

installPackages

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

Instale um app Android feito de vários arquivos APK (um principal e pacotes divididos extras). Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

Parâmetros
packageFiles	: os arquivos APK locais
reinstall	boolean: true se uma reinstalação precisar ser feita
extraArgs	String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções 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 recuperada.
UnsupportedOperationException	Se a permissão de execução não tiver suporte da plataforma no dispositivo.

installPackages

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

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

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

Parâmetros
packageFiles	: os caminhos de arquivo APK remotos a serem instalados
reinstall	boolean: true se uma reinstalação precisar ser feita
grantPermissions	boolean: se todas as permissões de execução precisam ser concedidas no momento da instalação
extraArgs	String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções 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 recuperada.
UnsupportedOperationException	Se a permissão de execução não tiver suporte da plataforma no dispositivo.

installPackagesForUser

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

Instale um aplicativo Android feito de vários arquivos APK (um principal e pacotes divididos extras) para um determinado usuário. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

Parâmetros
packageFiles	: os arquivos APK locais
reinstall	boolean: true se uma reinstalação precisar ser feita
userId	int: o ID de usuário inteiro a ser instalado.
extraArgs	String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções 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 recuperada.
UnsupportedOperationException	Se a permissão de execução não tiver suporte da plataforma no dispositivo.

installPackagesForUser

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

Instale um aplicativo Android feito de vários arquivos APK (um principal e pacotes divididos extras) para um determinado usuário. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

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

Parâmetros
packageFiles	: os arquivos APK locais
reinstall	boolean: true se uma reinstalação precisar ser feita
grantPermissions	boolean: se todas as permissões de execução precisam ser concedidas no momento da instalação
userId	int: o ID de usuário inteiro a ser instalado.
extraArgs	String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções 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 recuperada.
UnsupportedOperationException	Se a permissão de execução não tiver suporte da plataforma no dispositivo.

installRemotePackages

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

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

Parâmetros
remoteApkPaths	: os caminhos de arquivo de APK remotos
reinstall	boolean: true se uma reinstalação precisar ser feita
extraArgs	String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções 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 recuperada.
UnsupportedOperationException	Se a permissão de execução não tiver suporte da plataforma no dispositivo.

installRemotePackages

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

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

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

Parâmetros
remoteApkPaths	: os caminhos de arquivo de APK remotos
reinstall	boolean: true se uma reinstalação precisar ser feita
grantPermissions	boolean: se todas as permissões de execução precisam ser concedidas no momento da instalação
extraArgs	String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções 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 recuperada.
UnsupportedOperationException	Se a permissão de execução não tiver suporte da plataforma no dispositivo.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Retorna se o dispositivo usa o modo de usuário do sistema sem cabeça.

Retorna
boolean

Gera
DeviceNotAvailableException

isMainUserPermanentAdmin

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

Retorna
boolean

Gera
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

Retorna
boolean	"true" se houver suporte para vários usuários. Caso contrário, será "false".

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Consultar o dispositivo para 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 para o qual o pacote está instalado. Se for nulo, o usuário principal zero será usado.

Retorna
boolean	Verdadeiro se o pacote for informado como instalado. Falso em outros casos.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

Consultar o dispositivo para um determinado nome de pacote e verificar se ele está instalado ou não.

Parâmetros
packageName	String

Retorna
boolean	Verdadeiro se o pacote for informado como instalado. Falso em outros casos.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

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

Parâmetros
userId	int

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

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

Retorna se o usuário especificado é secundário de acordo com as flags.

Parâmetros
userId	int

Retorna
boolean	"true" se o usuário for secundário, ou "false", caso contrário.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

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

Um usuário "visível" é um usuário que interage com o usuário "humano" e, portanto, pode iniciar atividades de lançamento (geralmente 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 está visível na tela.

Um usuário "visível" é aquele que interage com o usuário "humano" e, portanto, pode iniciar atividades de lançamento 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 sim, chame 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

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

Se isso acontecer, chame startVisibleBackgroundUser(int, int, boolean), transmitindo uma tela retornada por listDisplayIdsForStartingVisibleBackgroundUsers().

Retorna
boolean

Gera
DeviceNotAvailableException

isWifiEnabled

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 são executados 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 recuperada.

listDisplayIds

public abstract  listDisplayIds ()

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

Retorna
	A lista de telas. O padrão sempre retorna a tela padrão 0.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Consegue 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. Será gerado DeviceRuntimeException se a saída do dispositivo não for como esperado.

Retorna
	a lista de IDs de usuários.

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

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Método auxiliar para registrar um relatório de bug para os repórteres.

Parâmetros
dataName	String: nome em que o bugreport será informado.
listener	ITestLogger: um ITestLogger para registrar o bugreport.

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

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Notifica o dispositivo para que ele aguarde a conclusão do snapuserd.

Parâmetros
waitPhase	SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra um IDeviceActionReceiver para este dispositivo.

Todos os IDeviceActionReceivers registrados vão receber uma notificação antes do início de uma ação do dispositivo e depois que ela terminar.

Parâmetros
deviceActionReceiver	IDeviceActionReceiver: uma IDeviceActionReceiver que será registrada.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Remove o administrador do dispositivo especificado no usuário especificado e retorna true se for bem-sucedido, false caso contrário.

Parâmetros
componentName	String: o administrador do dispositivo a ser removido.
userId	int: o usuário em que o administrador do dispositivo está.

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

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Remova todos os proprietários de perfil de dispositivo com o melhor esforço.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Remover um determinado usuário do dispositivo.

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

Retorna
boolean	"true" se a remoção do usuário foi bem-sucedida. Caso contrário, será "false".

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 no usuário especificado.

Parâmetros
componentName	String: de administrador do dispositivo para ser 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, será 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 executado no 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)

Adicione um valor de configuração ao namespace de um determinado usuário. Algumas configurações só ficam disponíveis depois de uma reinicializaçã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

startUser

public abstract boolean startUser (int userId)

Inicia um determinado usuário em segundo plano se ele estiver parado. Se o usuário já estiver em execução em segundo plano, esse método será uma operação nula.

Parâmetros
userId	int: do usuário para iniciar em segundo plano

Retorna
boolean	Verdadeiro se o usuário foi iniciado em segundo plano.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Inicia um determinado usuário em segundo plano se ele estiver parado. Se o usuário já estiver em execução em segundo plano, esse método será uma operação nula. É possível fornecer uma sinalização extra para aguardar a operação.

Parâmetros
userId	int: do usuário para iniciar em segundo plano
waitFlag	boolean: faz com que o comando aguarde até que o usuário seja iniciado e desbloqueado.

Retorna
boolean	Verdadeiro se o usuário foi iniciado 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 (ou seja, permitindo que o usuário inicie atividades nessa tela).

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

Parâmetros
userId	int: do usuário para iniciar em segundo plano
displayId	int: tela para iniciar o usuário visível em
waitFlag	boolean: faz com que o comando aguarde até que o usuário seja iniciado e desbloqueado.

Retorna
boolean	true se o usuário foi iniciado com sucesso e está visível em segundo plano.

Gera
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Interrompe um determinado usuário. Se o usuário já estiver parado, esse método será uma operação sem efeito. Não é possível interromper o usuário atual e do sistema.

Parâmetros
userId	int: do usuário para interromper.

Retorna
boolean	Verdadeiro se o usuário foi interrompido.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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

Parar um determinado usuário. É possível fornecer flags extras para aguardar a operação ter efeito e encerrar forçosamente o usuário. Não é possível interromper o usuário atual e do sistema.

Parâmetros
userId	int: do usuário para parar.
waitFlag	boolean: faz com que o comando aguarde até que o usuário seja interrompido.
forceFlag	boolean: força a interrupção do usuário.

Retorna
boolean	Verdadeiro se o usuário foi 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 corresponde ao provedor de userId. Falso em outros casos.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

Parâmetros
userId	int
timeout	long: para aguardar antes de retornar falso para o switch-user falhou.

Retorna
boolean	Verdadeiro se o novo userId corresponde ao provedor de userId. Falso em outros casos.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Retorna um bugreport dentro de um objeto Bugreport para processá-lo. Retorna null em caso de problemas. O arquivo referenciado no objeto Bugreport precisa ser limpo usando Bugreport.close().

Retorna
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Desinstalar um pacote do Android do dispositivo.

Parâmetros
packageName	String: o pacote 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 recuperada.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Parâmetros
packageName	String: o pacote Android a ser desinstalado
userId	int: o ID de usuário inteiro 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 recuperada.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Se esperado, aguarde o snapuserd ser concluído.

Parâmetros
currentPhase	SnapuserdWaitPhase

Gera
DeviceNotAvailableException