TestDevice

public class TestDevice
extends NativeDevice

java.lang.Object
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice

Subclasses diretas conhecidas ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice ManagedRemoteDevice Um dispositivo em execução em uma máquina virtual que gerenciamos remotamente por uma instância do Tradefed na VM.  NestedRemoteDevice Representação do dispositivo em execução em uma VM Cuttlefish remota.  RemoteAndroidDevice Implementação de um ITestDevice para um dispositivo Android de pilha completa conectado por adb connect.

Subclasses indiretas conhecidas LocalAndroidVirtualDevice, RemoteAndroidVirtualDevice LocalAndroidVirtualDevice A classe para dispositivos virtuais locais executados no host do TradeFed.  RemoteAndroidVirtualDevice Estenda o comportamento de RemoteAndroidDevice para um dispositivo Android de pilha completa em execução no Google Compute Engine (GCE).

---

Implementação de um ITestDevice para um dispositivo Android de pilha completa

Resumo

Classes aninhadas
class	TestDevice.MicrodroidBuilder Um builder usado para criar um Microdroid TestDevice.

Campos
public static final String	DISMISS_KEYGUARD_CMD Comandos que podem ser usados para dispensar a tela de bloqueio.

Construtores públicos
TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Métodos públicos
boolean	canSwitchToHeadlessSystemUser() Retorna se é permitido alternar para o usuário do sistema sem cabeça.
boolean	clearErrorDialogs() Tente dispensar as caixas de diálogo de erro exibidas na interface do dispositivo.
int	createUser(String name) Crie um usuário com um nome e flags padrão 0.
int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) Criar um usuário com um nome e as flags fornecidas
int	createUser(String name, boolean guest, boolean ephemeral) Criar um usuário com um nome e as flags fornecidas
int	createUserNoThrow(String name) Crie um usuário com um nome e flags padrão 0.
void	disableKeyguard() Tenta desativar o bloqueio de teclado.
boolean	doesFileExist(String deviceFilePath) Método auxiliar para determinar se o arquivo no dispositivo existe.
boolean	doesFileExist(String deviceFilePath, int userId) Método auxiliar para determinar se o arquivo no dispositivo existe para um determinado usuário.
File	dumpHeap(String process, String devicePath) Tenta despejar a pilha do system_server.
	getActiveApexes() Busca as informações sobre os APEXes ativados no dispositivo.
	getAllSettings(String namespace) Retorna pares de chave-valor do namespace solicitado.
String	getAndroidId(int userId) Encontra e retorna o Android-ID associado a um userId, nulo se não encontrado.
	getAndroidIds() Crie um mapa de IDs do Android encontrados que correspondem aos IDs do usuário.
PackageInfo	getAppPackageInfo(String packageName) Buscar informações sobre um pacote instalado no dispositivo.
	getAppPackageInfos() Buscar informações de pacotes instalados no dispositivo.
InputStreamSource	getBugreport() Recupera um relatório de bug do dispositivo.
InputStreamSource	getBugreportz() Recupera um bugreportz do dispositivo.
DeviceFoldableState	getCurrentFoldableState() Retorna o estado dobrável atual do dispositivo ou nulo se alguns problemas ocorreram.
int	getCurrentUser() Retorna o ID do usuário em execução atual.
	getFoldableStates() Retorna a lista de estados dobráveis no dispositivo.
	getInstalledPackageNames() Busca os nomes dos pacotes de aplicativos presentes no dispositivo.
KeyguardControllerState	getKeyguardState() Retorna um objeto para conferir o estado atual do bloqueio de teclado ou nulo, se não houver suporte.
Integer	getMainUserId() Retorna o ID do usuário principal.
	getMainlineModuleInfo() Receber informações sobre os módulos principais instalados no dispositivo.
int	getMaxNumberOfRunningUsersSupported() Receba o número máximo de usuários em execução simultaneamente com suporte.
int	getMaxNumberOfUsersSupported() Receba o número máximo de usuários com suporte.
Integer	getPrimaryUserId() Retorna o ID do usuário principal.
InputStreamSource	getScreenshot() Faz uma captura de tela do dispositivo.
InputStreamSource	getScreenshot(String format, boolean rescale) Faz uma captura de tela do dispositivo.
InputStreamSource	getScreenshot(long displayId) Faz uma captura de tela do ID de exibição fornecido do dispositivo.
InputStreamSource	getScreenshot(String format) Faz uma captura de tela do dispositivo.
String	getSetting(String namespace, String key) Consulte getSetting(int, String, String) e executado no usuário do sistema.
String	getSetting(int userId, String namespace, String key) Retorna o valor da configuração solicitada.
	getUninstallablePackageNames() Busca os nomes dos pacotes de aplicativos que podem ser desinstalados.
int	getUserFlags(int userId) Encontre e retorne as flags de um determinado usuário.
	getUserInfos() Recebe o mapa de useId para UserInfo no dispositivo.
int	getUserSerialNumber(int userId) Retorna o número de série associado ao userId, se encontrado, ou -10000 em outros casos.
boolean	hasFeature(String feature) Conferir se um recurso está disponível em um dispositivo.
String	installPackage(File packageFile, boolean reinstall, String... extraArgs) Instale um pacote do Android no dispositivo.
String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Instale um pacote do Android no dispositivo.
String	installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs) Instale um pacote do Android no dispositivo.
String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instale um pacote Android no dispositivo para um determinado usuário.
String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) Instale um pacote Android no dispositivo para um determinado usuário.
String	installPackages( packageFiles, boolean reinstall, String... extraArgs)
String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
String	installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)
String	installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
boolean	isAppEnumerationSupported() Verificar se a plataforma no dispositivo oferece suporte à enumeração de apps
boolean	isHeadlessSystemUserMode() Retorna se o dispositivo usa o modo de usuário do sistema sem cabeça.
boolean	isMainUserPermanentAdmin() Retorna se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para o status de não administrador.
boolean	isMultiUserSupported() Determina se há suporte para vários usuários.
boolean	isPackageInstalled(String packageName) Consultar o dispositivo para um determinado nome de pacote e verificar se ele está instalado ou não.
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.
boolean	isUserRunning(int userId) Verificar se um determinado usuário está em execução.
boolean	isUserSecondary(int userId) Retorna se o usuário especificado é secundário de acordo com as flags.
boolean	isUserVisible(int userId) Verifica se o usuário especificado está visível.
boolean	isUserVisibleOnDisplay(int userId, int displayId) Verifica se o usuário está visível na tela.
boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported() Retorna se o dispositivo permite que os usuários sejam iniciados e apareçam no segundo plano no ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
boolean	isVisibleBackgroundUsersSupported() Retorna se o dispositivo permite que os usuários sejam iniciados e visíveis em segundo plano.
	listDisplayIds() Coletar a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys SurfaceFlinger".
	listDisplayIdsForStartingVisibleBackgroundUsers() Consegue a lista de telas que podem ser usadas para start a user visible in the background.
	listUsers() Recebe a lista de usuários no dispositivo.
boolean	logBugreport(String dataName, ITestLogger listener) Método auxiliar para registrar um relatório de bug para os repórteres.
void	notifySnapuserd(SnapuserdWaitPhase waitPhase)
void	postInvocationTearDown(Throwable exception) Etapas extras para a limpeza necessária específica do dispositivo que será executada após a invocação ser concluída.
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.
void	removeOwners() Remova todos os proprietários de perfil de dispositivo com o melhor esforço.
boolean	removeUser(int userId) Remover um determinado usuário do dispositivo.
boolean	setDeviceOwner(String componentName, int userId) Define um componente de administrador do dispositivo como proprietário do dispositivo no usuário especificado.
void	setFirstBootloaderReboot()
void	setSetting(String namespace, String key, String value) Consulte setSetting(int, String, String, String) e executado no usuário do sistema.
void	setSetting(int userId, String namespace, String key, String value) Adicione um valor de configuração ao namespace de um determinado usuário.
void	shutdownMicrodroid(ITestDevice microdroidDevice) Desliga o dispositivo microdroid, se houver um.
boolean	startUser(int userId) Inicia um determinado usuário em segundo plano se ele estiver parado.
boolean	startUser(int userId, boolean waitFlag) Inicia um determinado usuário em segundo plano se ele estiver parado.
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).
boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) Parar um determinado usuário.
boolean	stopUser(int userId) Interrompe um determinado usuário.
boolean	supportsMicrodroid() Verifica as condições prévias para executar um microdroid.
boolean	supportsMicrodroid(boolean protectedVm) Verifica as condições prévias para executar um microdroid.
boolean	switchUser(int userId) Mude para outro userId com um tempo limite padrão.
boolean	switchUser(int userId, long timeout) Mudar para outro userId com o tempo limite fornecido como prazo.
Bugreport	takeBugreport() Retorna um bugreport dentro de um objeto Bugreport para processá-lo.
String	uninstallPackage(String packageName) Desinstalar um pacote do Android do dispositivo.
String	uninstallPackageForUser(String packageName, int userId) Desinstalar um pacote Android do dispositivo para um determinado usuário.
void	waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Métodos protegidos
AaptParser	createParser(File appFile)
void	doAdbReboot(NativeDevice.RebootMode rebootMode, String reason) Faça uma reinicialização do adb.
InputStreamSource	getBugreportInternal()
File	getBugreportzInternal() Método auxiliar interno para receber o arquivo ZIP do bugreportz como um ERROR(/File).
long	getCheckNewUserSleep() Exposto para testes.
long	getHostCurrentTime() Exposto para testes
void	prePostBootSetup() Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) substitua esse método para uma configuração específica após a inicialização.

Campos

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Comandos que podem ser usados para dispensar a tela de bloqueio.

Construtores públicos

TestDevice

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Métodos públicos

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Retorna
boolean

Gera
DeviceNotAvailableException

clearErrorDialogs

public 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

createUser

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

createUser

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

createUser

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

createUserNoThrow

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

disableKeyguard

public 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 o bloqueio de tela (funciona apenas em telas não seguras).

Gera
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Método auxiliar para determinar se o arquivo no dispositivo existe.

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

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

Gera
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Parâmetros
deviceFilePath	String: o caminho absoluto do arquivo no dispositivo a ser verificado
userId	int: o ID do usuário para verificar a existência do arquivo

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

Gera
DeviceNotAvailableException

dumpHeap

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

getActiveApexes

public  getActiveApexes ()

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

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

Gera
DeviceNotAvailableException

getAllSettings

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

getAndroidId

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

getAndroidIds

public  getAndroidIds ()

Crie um mapa de IDs do Android encontrados que correspondem aos IDs do usuário. 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 do usuário podem corresponder a "null".

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

Gera
DeviceNotAvailableException

getAppPackageInfo

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

getAppPackageInfos

public  getAppPackageInfos ()

Buscar informações de pacotes instalados no dispositivo.

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

Gera
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

Recupera um relatório de bug do dispositivo.

A implementação desse recurso garante que ele 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 relatório de bug sob demanda. Em caso de falha, o InputStreamSource vai produzir um ERROR(/InputStream) vazio.

getBugreportz

public 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 o bugreportz, retorna null em caso de falha.

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Retorna
DeviceFoldableState

Gera
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

Retorna
int

Gera
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

Retorna

Gera
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

Busca os nomes dos pacotes de aplicativos presentes no dispositivo.

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

Gera
DeviceNotAvailableException

getKeyguardState

public 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 da proteção de tela e retorna "Null" se a consulta de proteção de tela não tiver suporte.

Gera
DeviceNotAvailableException

getMainUserId

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

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

Gera
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

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

getMaxNumberOfUsersSupported

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

getPrimaryUserId

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

getScreenshot

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

getScreenshot

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

getScreenshot

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

getScreenshot

public 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 bem-sucedida.

Gera
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

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

Parâmetros
namespace	String
key	String

Retorna
String

Gera
DeviceNotAvailableException

getSetting

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

getUninstallablePackageNames

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

getUserFlags

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

Gera
DeviceNotAvailableException

getUserInfos

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

getUserSerialNumber

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

hasFeature

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

installPackage

public 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

installPackage

public 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

installPackage

public String installPackage (File packageFile, 
                File certFile, 
                boolean reinstall, 
                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
certFile	File: true se uma reinstalação precisar ser feita
reinstall	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

installPackageForUser

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

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

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

installPackageForUser

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

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

Parâmetros
packageFile	File: o arquivo apk 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

installPackages

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

Parâmetros
packageFiles
reinstall	boolean
extraArgs	String

Retorna
String

Gera
DeviceNotAvailableException

installPackages

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

Parâmetros
packageFiles
reinstall	boolean
grantPermissions	boolean
extraArgs	String

Retorna
String

Gera
DeviceNotAvailableException

installPackagesForUser

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

Parâmetros
packageFiles
reinstall	boolean
grantPermissions	boolean
userId	int
extraArgs	String

Retorna
String

Gera
DeviceNotAvailableException

installPackagesForUser

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

Parâmetros
packageFiles
reinstall	boolean
userId	int
extraArgs	String

Retorna
String

Gera
DeviceNotAvailableException

installRemotePackages

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

Parâmetros
remoteApkPaths
reinstall	boolean
extraArgs	String

Retorna
String

Gera
DeviceNotAvailableException

installRemotePackages

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

Parâmetros
remoteApkPaths
reinstall	boolean
grantPermissions	boolean
extraArgs	String

Retorna
String

Gera
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Verificar se a plataforma no dispositivo oferece suporte à enumeração de apps

Retorna
boolean	Verdadeiro se a enumeração de apps tiver suporte. Falso, caso contrário.

Gera
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

Retorna
boolean

Gera
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

Retorna
boolean

Gera
DeviceNotAvailableException

isMultiUserSupported

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

isPackageInstalled

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

isPackageInstalled

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

isUserRunning

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

isUserSecondary

public boolean isUserSecondary (int userId)

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

Parâmetros
userId	int

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

Gera
DeviceNotAvailableException

isUserVisible

public boolean isUserVisible (int userId)

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

Um usuário "visível" é aquele que interage com o usuário "humano" e, portanto, pode iniciar atividades de lançamento (normalmente na tela padrão).

Parâmetros
userId	int

Retorna
boolean

Gera
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Verifica se o usuário 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 boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Retorna se o dispositivo permite que os usuários sejam iniciados e apareçam no 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 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

listDisplayIds

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

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Retorna

Gera
DeviceNotAvailableException

listUsers

public  listUsers ()

Recebe a lista de usuários no dispositivo. DeviceRuntimeException será gerado se a saída do dispositivo não for como esperado.

Retorna
	a lista de IDs de usuários.

Gera
DeviceNotAvailableException

logBugreport

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

Parâmetros
waitPhase	SnapuserdWaitPhase

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Etapas extras para a limpeza necessária específica do dispositivo que será executada após a invocação ser concluída.

Parâmetros
exception	Throwable: se houver, a exceção final gerada pela falha de invocação.

removeAdmin

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

removeOwners

public void removeOwners ()

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

Gera
DeviceNotAvailableException

removeUser

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

setDeviceOwner

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

setFirstBootloaderReboot

public void setFirstBootloaderReboot ()

setSetting

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

setSetting

public 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 após uma reinicialização. namespace precisa ser um destes: {"system", "secure", "global"}

Parâmetros
userId	int
namespace	String
key	String
value	String

Gera
DeviceNotAvailableException

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Desliga o dispositivo microdroid, se houver um.

Parâmetros
microdroidDevice	ITestDevice

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public 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á um NOOP.

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
DeviceNotAvailableException

startUser

public 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á um NOOP. É 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
DeviceNotAvailableException

startVisibleBackgroundUser

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

Inicia um determinado usuário em segundo plano, visível na tela especificada (ou seja, permitindo que o usuário 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 boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Parar um determinado usuário. É possível fornecer sinalizações 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 interromper.
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	"true" se o usuário foi interrompido.

Gera
DeviceNotAvailableException

stopUser

public 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	"true" se o usuário foi interrompido.

Gera
DeviceNotAvailableException

supportsMicrodroid

public boolean supportsMicrodroid ()

Verifica as condições prévias para executar um microdroid.

Retorna
boolean	retorna "true" se as pré-condições forem atendidas. Caso contrário, retorna "false".

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Verifica as condições prévias para executar um microdroid.

Parâmetros
protectedVm	boolean: verdadeiro se o microdroid for destinado a ser executado em uma VM protegida.

Retorna
boolean	retorna "true" se as pré-condições forem atendidas. Caso contrário, retorna "false".

switchUser

public boolean switchUser (int userId)

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

Parâmetros
userId	int

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

Gera
DeviceNotAvailableException

switchUser

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

takeBugreport

public Bugreport takeBugreport ()

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

Retorna
Bugreport

uninstallPackage

public 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

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Desinstalar um pacote 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

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Parâmetros
currentPhase	SnapuserdWaitPhase

Gera
DeviceNotAvailableException

Métodos protegidos

createParser

protected AaptParser createParser (File appFile)

Parâmetros
appFile	File

Retorna
AaptParser

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Faça uma reinicialização do adb.

Parâmetros
rebootMode	NativeDevice.RebootMode: um modo dessa reinicialização.
reason	String: para esta reinicialização.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

Retorna
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

Método auxiliar interno para receber o arquivo ZIP do bugreportz como um ERROR(/File).

Retorna
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Exposto para testes.

Retorna
long

getHostCurrentTime

protected long getHostCurrentTime ()

Exposto para testes

Retorna
long

prePostBootSetup

protected void prePostBootSetup ()

Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) substitua esse método para uma configuração específica após a inicialização.

Gera
DeviceNotAvailableException