TestDevice
public
class
TestDevice
extends NativeDevice
Subclasses diretas conhecidas
| 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 stack completa conectado por
adb connect.
|
|
Subclasses indiretas conhecidas
|
Implementação de um ITestDevice para um dispositivo Android de pilha completa
Resumo
Campos |
|---|
public
static
final
String |
DISMISS_KEYGUARD_CMD
Comandos que podem ser usados para dispensar a tela de bloqueio.
|
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 dos usuários.
|
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 as 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 visíveis em 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 do Android do dispositivo para um determinado usuário.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
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
Métodos públicos
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Retorna se é permitido alternar para o usuário do sistema sem cabeça.
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. |
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 |
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 |
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 |
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. |
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 a proteção de teclas (funciona
apenas em proteções não seguras).
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. |
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. |
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. |
getActiveApexes
public getActiveApexes ()
Busca as informações sobre os APEXes ativados no dispositivo.
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. |
getAndroidId
public String getAndroidId (int userId)
Encontra e retorna o Android-ID associado a um userId, nulo se não encontrado.
getAndroidIds
public 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. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Buscar informações sobre um pacote instalado no dispositivo.
| Parâmetros |
|---|
packageName |
String |
getAppPackageInfos
public getAppPackageInfos ()
Buscar informações de pacotes instalados no dispositivo.
getBugreport
public 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).
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.
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Retorna o estado dobrável atual do dispositivo ou nulo se alguns problemas ocorreram.
getCurrentUser
public int getCurrentUser ()
Retorna o ID do usuário em execução atual. Em caso de erro, retorne -10000.
getFoldableStates
public getFoldableStates ()
Retorna a lista de estados dobráveis no dispositivo. Pode ser recebido com "cmd device_state
print-states".
getInstalledPackageNames
public getInstalledPackageNames ()
Busca os nomes dos pacotes de aplicativos presentes no dispositivo.
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Retorna um objeto para conferir o estado atual do bloqueio de teclado ou nulo, se não houver suporte.
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. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Receber as informações sobre os módulos principais instalados no dispositivo.
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 |
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 |
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. |
getScreenshot
public InputStreamSource getScreenshot ()
Faz uma captura de tela do dispositivo.
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 |
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. |
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 |
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 |
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. |
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. |
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.
| Retorna |
|---|
int |
As flags associadas ao userId fornecido, se encontrado, ou -10000 em outros casos. |
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. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Retorna o número de série associado ao userId, se encontrado, ou -10000 em outros casos.
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. |
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. |
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. |
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. |
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. |
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. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
| Parâmetros |
|---|
packageFiles |
|
reinstall |
boolean |
extraArgs |
String |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
| Parâmetros |
|---|
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
| Parâmetros |
|---|
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
userId |
int |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
| Parâmetros |
|---|
packageFiles |
|
reinstall |
boolean |
userId |
int |
extraArgs |
String |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
| Parâmetros |
|---|
remoteApkPaths |
|
reinstall |
boolean |
extraArgs |
String |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
| Parâmetros |
|---|
remoteApkPaths |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
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. Caso contrário, será falso. |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Retorna se o dispositivo usa o modo de usuário do sistema sem cabeça.
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.
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". |
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. |
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. |
isUserRunning
public boolean isUserRunning (int userId)
Verificar se um determinado usuário está em execução.
| Retorna |
|---|
boolean |
Verdadeiro se o usuário estiver executando, falso em todos os outros casos. |
isUserSecondary
public boolean isUserSecondary (int userId)
Retorna se o usuário especificado é secundário de acordo com as flags.
| Retorna |
|---|
boolean |
"true" se o usuário for secundário, ou "false", caso contrário. |
isUserVisible
public 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).
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 |
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. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Consegue a lista de telas que podem ser usadas para start a user visible in the background.
listUsers
public 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. |
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. |
removeOwners
public void removeOwners ()
Remova todos os proprietários de perfil de dispositivo com o melhor esforço.
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". |
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. |
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 |
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
depois de uma reinicialização.
namespace precisa ser um destes: {"system", "secure", "global"}
| Parâmetros |
|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
shutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Desliga o dispositivo microdroid, se houver um.
| Parâmetros |
|---|
microdroidDevice |
ITestDevice |
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á 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. |
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á 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. |
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. |
stopUser
public 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. |
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 parar. |
| Retorna |
|---|
boolean |
Verdadeiro se o usuário foi interrompido. |
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).
| Retorna |
|---|
boolean |
Verdadeiro se o novo userId corresponde ao provedor de userId. Falso em outros casos. |
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. |
takeBugreport
public 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().
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. |
uninstallPackageForUser
public 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. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
| Parâmetros |
|---|
currentPhase |
SnapuserdWaitPhase |
Métodos protegidos
createParser
protected AaptParser createParser (File appFile)
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. |
getBugreportzInternal
protected File getBugreportzInternal ()
Método auxiliar interno para receber o arquivo ZIP do bugreportz como um ERROR(/File).
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Exposto para testes.
getHostCurrentTime
protected long getHostCurrentTime ()
Exposto para testes
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.
