Dispositivo de teste
public
class
TestDevice
extends NativeDevice
Subclasses diretas conhecidas
ManagedRemoteDevice (link em inglês) |
Um dispositivo executado em uma máquina virtual gerenciada remotamente por uma instância do Tradefed
a VM.
|
NestedRemoteDevice (link em inglês) |
Representação do dispositivo em execução dentro de uma VM do Cuttlefish remota.
|
RemoteAndroidDevice (link em inglês) |
Implementação de um ITestDevice para um dispositivo Android de pilha completa conectado via
Conexão adb.
|
|
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 o bloqueio de teclado.
|
Métodos públicos |
boolean
|
canSwitchToHeadlessSystemUser()
Retorna se é permitido alternar para o usuário headless SYSTEM.
|
boolean
|
clearErrorDialogs()
Tentativa de dispensar todas as caixas de diálogo de erro exibidas no momento na interface do dispositivo.
|
int
|
createUser(String name)
Cria um usuário com um nome determinado e flags padrão 0.
|
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Criar um usuário com um determinado nome e as flags fornecidas
|
int
|
createUser(String name, boolean guest, boolean ephemeral)
Criar um usuário com um determinado nome e as flags fornecidas
|
int
|
createUserNoThrow(String name)
Cria um usuário com um nome determinado 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 existe no dispositivo.
|
boolean
|
doesFileExist(String deviceFilePath, int userId)
Método auxiliar para determinar se um arquivo existente no dispositivo existe para um determinado usuário.
|
File
|
dumpHeap(String process, String devicePath)
Tenta despejar a heap do system_server.
|
|
getActiveApexes()
Busque as informações sobre os APEXs ativados no dispositivo.
|
|
getAllSettings(String namespace)
Retorna pares de chave-valor do namespace solicitado.
|
String
|
getAndroidId(int userId)
Encontre e retorne o android-id associado a um userId. Ele será nulo se não for encontrado.
|
|
getAndroidIds()
Cria um mapa de IDs do Android encontrados que correspondem a IDs de usuário.
|
PackageInfo
|
getAppPackageInfo(String packageName)
Busca informações sobre um pacote instalado no dispositivo.
|
|
getAppPackageInfos()
Busca informações dos pacotes instalados no dispositivo.
|
InputStreamSource
|
getBugreport()
Recupera um relatório de bug do dispositivo.
|
InputStreamSource
|
getBugreportz()
Recupera um relatório de bugs do dispositivo.
|
DeviceFoldableState
|
getCurrentFoldableState()
Retorna o estado dobrável atual do dispositivo ou retorna nulo caso ocorram problemas.
|
int
|
getCurrentUser()
Retorna o ID do usuário em execução no momento.
|
|
getFoldableStates()
Retorna a lista de estados dobráveis no dispositivo.
|
|
getInstalledPackageNames()
Busque os nomes dos pacotes de apps presentes no dispositivo.
|
KeyguardControllerState
|
getKeyguardState()
Retorne um objeto para obter o estado atual do bloqueio de teclado ou nulo, se não houver suporte.
|
Integer
|
getMainUserId()
Retorna o ID do usuário principal.
|
|
getMainlineModuleInfo()
Consiga as informações sobre os módulos de linha principal instalados no dispositivo.
|
int
|
getMaxNumberOfRunningUsersSupported()
Receba o número máximo permitido de usuários em execução simultânea.
|
int
|
getMaxNumberOfUsersSupported()
Descubra o número máximo de usuários permitidos.
|
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(String format)
Faz uma captura de tela do dispositivo.
|
InputStreamSource
|
getScreenshot(long displayId)
Faz uma captura de tela do ID de tela do dispositivo.
|
String
|
getSetting(String namespace, String key)
Consulte getSetting(int, String, String) e realizada em um usuário do sistema.
|
String
|
getSetting(int userId, String namespace, String key)
Retorna o valor da configuração solicitada.
|
|
getUninstallablePackageNames()
Busque os nomes dos pacotes de aplicativos que podem ser desinstalados.
|
int
|
getUserFlags(int userId)
Encontre e retorne as sinalizações 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. Em qualquer outro caso, retorna -10000.
|
boolean
|
hasFeature(String feature)
Verifique se um recurso está disponível em um dispositivo.
|
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Instale um pacote Android no dispositivo.
|
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Instale um pacote Android no dispositivo.
|
String
|
installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs)
Instale um pacote Android no dispositivo.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Instala um pacote Android no dispositivo para um determinado usuário.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Instala 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 do dispositivo oferece suporte à enumeração de apps
|
boolean
|
isHeadlessSystemUserMode()
Retorna indicando se o dispositivo usa o modo de usuário do sistema headless.
|
boolean
|
isMainUserPermanentAdmin()
Informa se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para
o status de não administrador.
|
boolean
|
isMultiUserSupported()
Determina se há suporte para vários usuários.
|
boolean
|
isPackageInstalled(String packageName)
Consulte o dispositivo em busca de um nome de pacote específico para verificar se ele está instalado ou não.
|
boolean
|
isPackageInstalled(String packageName, String userId)
Consulte o dispositivo em busca de um determinado nome de pacote e ID do usuário para verificar se ele está
instalado ou não para esse usuário.
|
boolean
|
isUserRunning(int userId)
Verifique se um determinado usuário está em execução.
|
boolean
|
isUserSecondary(int userId)
Retorna se o usuário especificado é um usuário secundário, de acordo com as sinalizações dele.
|
boolean
|
isUserVisible(int userId)
Verifica se um determinado usuário está visível.
|
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Verifica se o usuário especificado está visível na tela especificada.
|
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()
Informa se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano.
|
|
listDisplayIds()
Colete a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys"
SurfaceFlinger".
|
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Recebe 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 e registrá-lo.
|
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
|
void
|
postInvocationTearDown(Throwable exception)
Etapas extras para a limpeza específica do dispositivo que serão executadas após a invocação
é concluída.
|
boolean
|
removeAdmin(String componentName, int userId)
Remove o administrador do dispositivo de um determinado usuário e retorna true quando o processo é bem-sucedido. Caso contrário, retorna false .
|
void
|
removeOwners()
Remova todos os proprietários de perfil de dispositivo existentes da melhor maneira possível.
|
boolean
|
removeUser(int userId)
Remove determinado usuário do dispositivo.
|
boolean
|
setDeviceOwner(String componentName, int userId)
Define um componente de administrador do dispositivo como proprietário do dispositivo em um determinado usuário.
|
void
|
setSetting(String namespace, String key, String value)
Consulte setSetting(int, String, String, String) e realizada em um usuário do sistema.
|
void
|
setSetting(int userId, String namespace, String key, String value)
Adiciona um valor de configuração ao namespace de um determinado usuário.
|
void
|
shutdownMicrodroid(ITestDevice microdroidDevice)
Desliga o dispositivo microdroide, se houver um.
|
boolean
|
startUser(int userId)
Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento.
|
boolean
|
startUser(int userId, boolean waitFlag)
Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento.
|
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Inicia um determinado usuário em segundo plano, visível na tela especificada (ou seja, permitindo que o usuário
para iniciar atividades nessa tela).
|
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Interrompa um determinado usuário.
|
boolean
|
stopUser(int userId)
Interrompe um determinado usuário.
|
boolean
|
supportsMicrodroid()
Verifica as condições prévias para executar um microdroide.
|
boolean
|
supportsMicrodroid(boolean protectedVm)
Verifica as condições prévias para executar um microdroide.
|
boolean
|
switchUser(int userId)
Mude para outro userId com um tempo limite padrão.
|
boolean
|
switchUser(int userId, long timeout)
Troque para outro userId com o tempo limite fornecido como prazo.
|
Bugreport
|
takeBugreport()
Crie um relatório de bug e o retorne dentro de um objeto Bugreport para processá-lo.
|
String
|
uninstallPackage(String packageName)
Desinstala um pacote Android do dispositivo.
|
String
|
uninstallPackageForUser(String packageName, int userId)
Desinstala um pacote 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 o bloqueio de teclado.
Construtores públicos
Métodos públicos
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Retorna se é permitido alternar para o usuário headless SYSTEM.
ClearErrorDialogs
public boolean clearErrorDialogs ()
Tentativa de dispensar todas as caixas de diálogo de erro exibidas no momento na interface do dispositivo.
Retorna |
boolean |
true se nenhuma caixa de diálogo estiver presente ou se elas tiverem sido apagadas.
Caso contrário, false . |
usuário
public int createUser (String name)
Cria um usuário com um nome determinado e flags padrão 0.
Parâmetros |
name |
String : do usuário a ser criado no dispositivo. |
Retorna |
int |
o número inteiro do ID do usuário criado |
usuário
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Criar um usuário com um determinado nome e as flags fornecidas
Parâmetros |
name |
String : do usuário a ser criado no dispositivo. |
guest |
boolean : ativa a flag de usuário --guest durante a criação. |
ephemeral |
boolean : ativa a sinalização de usuário "-efêmero" durante a criação. |
forTesting |
boolean : ativa a flag de teste --for-testing durante a criação. |
Retorna |
int |
ID do usuário criado |
usuário
public int createUser (String name,
boolean guest,
boolean ephemeral)
Criar um usuário com um determinado nome e as flags fornecidas
Parâmetros |
name |
String : do usuário a ser criado no dispositivo. |
guest |
boolean : ativa a flag de usuário --guest durante a criação. |
ephemeral |
boolean : ativa a sinalização de usuário "-efêmero" durante a criação. |
Retorna |
int |
ID do usuário criado |
createUserNoThrow
public int createUserNoThrow (String name)
Cria um usuário com um nome determinado e flags padrão 0.
Parâmetros |
name |
String : do usuário a ser criado no dispositivo. |
Retorna |
int |
o número inteiro do ID do usuário criado ou -1 para o erro. |
desativarKeyguard
public void disableKeyguard ()
Tenta desativar o bloqueio de teclado.
Primeiro, aguarde até que o envio de entradas fique pronto. Isso acontece aproximadamente no mesmo momento em que o
dispositivo informa BOOT_COMPLETE, de forma aparentemente assíncrona, porque o framework atual
tem uma disputa ocasional. Em seguida, o comando é enviado para dispensar o bloqueio de teclado (funciona
somente em aplicativos não seguros)
fazFileExist
public boolean doesFileExist (String deviceFilePath)
Método auxiliar para determinar se o arquivo existe no dispositivo.
Parâmetros |
deviceFilePath |
String : o caminho absoluto do arquivo no dispositivo a ser verificado. |
Retorna |
boolean |
true se o arquivo existir. Caso contrário, retorna false . |
fazFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Método auxiliar para determinar se um arquivo existente no dispositivo existe para um determinado usuário.
Parâmetros |
deviceFilePath |
String : o caminho absoluto do arquivo no dispositivo a ser verificado. |
userId |
int : o ID do usuário para verificar a existência do arquivo. |
Retorna |
boolean |
true se o arquivo existir. Caso contrário, retorna false . |
dumpHeap
public File dumpHeap (String process,
String devicePath)
Tenta despejar a heap do system_server. É responsabilidade do autor da chamada limpar
o arquivo despejado.
Parâmetros |
process |
String : o nome do processo do dispositivo em que o despejo de heap será feito. |
devicePath |
String : o caminho no dispositivo em que o despejo será colocado. Precisa ser um local
se houver permissão para isso. |
Retorna |
File |
o ERROR(/File) que contém o relatório. Nulo se algo falhar. |
getActiveApexes
public getActiveApexes ()
Busque as informações sobre os APEXs ativados no dispositivo.
getAllSettings
public getAllSettings (String namespace)
Retorna pares de chave-valor do namespace solicitado.
Parâmetros |
namespace |
String : precisa ser {"system", "secure", "global"} |
Retorna |
|
o mapa de pares de chave-valor. Nulo se o namespace não for compatível. |
getAndroidId
public String getAndroidId (int userId)
Encontre e retorne o android-id associado a um userId. Ele será nulo se não for encontrado.
getAndroidIds
public getAndroidIds ()
Cria um mapa de IDs do Android encontrados que correspondem a IDs de usuário. Não há nenhum seguro de que cada usuário
ID encontrou um ID do Android associado a essa função, de modo que alguns IDs de usuário podem ter correspondência de valores nulos.
Retorna |
|
Foi encontrado um mapa de IDs do Android com IDs de usuário correspondentes. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Busca informações sobre um pacote instalado no dispositivo.
Parâmetros |
packageName |
String |
getAppPackageInfos
public getAppPackageInfos ()
Busca informações dos pacotes instalados no dispositivo.
getBugreport
public InputStreamSource getBugreport ()
Recupera um relatório de bug do dispositivo.
A implementação vai continuar funcionando em dispositivos sem cartão SD
(ou onde o cartão SD ainda não está montado).
getBugreportz
public InputStreamSource getBugreportz ()
Recupera um relatório de bugs do dispositivo. O relatório de bug no formato ZIP contém o principal relatório de bug e
e outros arquivos de registro úteis para depuração.
Compatível apenas com "adb version" > 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Retorna o estado dobrável atual do dispositivo ou retorna nulo caso ocorram problemas.
getCurrentUser
public int getCurrentUser ()
Retorna o ID do usuário em execução no momento. Em caso de erro, retorne -10000.
getFoldableStates
public getFoldableStates ()
Retorna a lista de estados dobráveis no dispositivo. Pode ser obtido com "cmd device_state
print-states".
getInstallPackageNames
public getInstalledPackageNames ()
Busque os nomes dos pacotes de apps presentes no dispositivo.
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Retorne um objeto para obter 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, e nulo, se não houver um usuário principal. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Consiga as informações sobre os módulos de linha principal instalados no dispositivo.
Retorna |
|
ERROR(/Set) de String módulos de linha principal instalados atualmente no dispositivo. |
public int getMaxNumberOfRunningUsersSupported ()
Receba o número máximo permitido de usuários em execução simultânea. O valor padrão é 0.
Retorna |
int |
Um número inteiro que indica o número de usuários em execução simultânea |
public int getMaxNumberOfUsersSupported ()
Descubra o número máximo de usuários permitidos. O valor padrão é 0.
Retorna |
int |
Um número inteiro que indica o número de usuários compatíveis |
getPrimaryUserId
public Integer getPrimaryUserId ()
Retorna o ID do usuário principal.
Retorna |
Integer |
o userId do usuário principal, se houver, e nulo, se não houver um usuário principal. |
getCaptura de tela
public InputStreamSource getScreenshot ()
Faz uma captura de tela do dispositivo.
getCaptura de tela
public InputStreamSource getScreenshot (String format,
boolean rescale)
Faz uma captura de tela do dispositivo. Recomendamos usar getScreenshot(String)
com codificação JPEG para tamanhos menores.
Parâmetros |
format |
String : PNG e JPEG compatíveis |
rescale |
boolean : se a captura de tela precisar ser redimensionada para reduzir o tamanho da imagem resultante |
getCaptura de tela
public InputStreamSource getScreenshot (String format)
Faz uma captura de tela do dispositivo.
É recomendável usar getCaptura de tela(format) em vez da codificação JPEG para tamanhos menores
Parâmetros |
format |
String : PNG e JPEG compatíveis |
getCaptura de tela
public InputStreamSource getScreenshot (long displayId)
Faz uma captura de tela do ID de tela do dispositivo. O formato é PNG.
TODO: estender as implementações acima para oferecer suporte a "format" e "redimensionar"
Parâmetros |
displayId |
long : o ID da tela de onde a captura de tela será feita. |
getSetting
public String getSetting (String namespace,
String key)
Consulte getSetting(int, String, String)
e realizada em um usuário do sistema.
Parâmetros |
namespace |
String |
key |
String |
getSetting
public String getSetting (int userId,
String namespace,
String key)
Retorna o valor da configuração solicitada.
O namespace precisa ser um destes: {"system", "secure", "global"}
Parâmetros |
userId |
int |
namespace |
String |
key |
String |
Retorna |
String |
o valor associado ao namespace:key de um usuário. Nulo se não for encontrado. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
Busque os nomes dos pacotes de aplicativos que podem ser desinstalados. Isso é definido atualmente como
pacotes que não são do sistema
e pacotes de sistema atualizados.
Retorna |
|
ERROR(/Set) de nomes de pacotes String desinstaláveis atualmente instalados no
dispositivo. |
getUserFlags
public int getUserFlags (int userId)
Encontre e retorne as sinalizações de um determinado usuário.
As flags são definidas em "android.content.pm.UserInfo" no Android Open Source Project.
Retorna |
int |
as sinalizações associadas ao userId fornecido, se encontrados, -10000 em qualquer outro caso. |
getUserInfos
public getUserInfos ()
Recebe o mapa de useId para UserInfo
no dispositivo. Uma DeviceRuntimeException
vai ser gerada se a saída do dispositivo não for a esperada.
Retorna |
|
a lista de objetos UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Retorna o número de série associado ao userId, se encontrado. Em qualquer outro caso, retorna -10000.
hasFeature
public boolean hasFeature (String feature)
Verifique se um recurso está disponível em um dispositivo.
Parâmetros |
feature |
String : qual formato deve ser "feature:" ou "" diretamente. |
Retorna |
boolean |
Verdadeiro se o atributo for encontrado. Caso contrário, será falso. |
installPackage
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Instale um pacote Android no dispositivo.
Parâmetros |
packageFile |
File : o arquivo apk a ser instalado. |
reinstall |
boolean : true se uma reinstalação precisar ser realizada. |
extraArgs |
String : argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" 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 Android no dispositivo.
Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em
o horário de instalação precisa chamar essa função.
Parâmetros |
packageFile |
File : o arquivo apk a ser instalado. |
reinstall |
boolean : true se uma reinstalação precisar ser realizada. |
grantPermissions |
boolean : se todas as permissões de execução forem concedidas no momento da instalação |
extraArgs |
String : argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis
. |
Retorna |
String |
um String com um código de erro ou null em caso de sucesso. |
installPackage
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Instale um pacote Android no dispositivo.
Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em
o horário de instalação precisa chamar essa função.
Parâmetros |
packageFile |
File : o arquivo apk a ser instalado. |
certFile |
File : true se uma reinstalação precisar ser realizada. |
reinstall |
boolean : se todas as permissões de execução forem concedidas no momento da instalação |
extraArgs |
String : argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis
. |
Retorna |
String |
um String com um código de erro ou null em caso de sucesso. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Instala um pacote Android no dispositivo para um determinado usuário.
Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em
o horário de instalação precisa chamar essa função.
Parâmetros |
packageFile |
File : o arquivo apk a ser instalado. |
reinstall |
boolean : true se uma reinstalação precisar ser realizada. |
grantPermissions |
boolean : se todas as permissões de execução forem concedidas no momento da instalação |
userId |
int : o ID do usuário inteiro para fazer a instalação. |
extraArgs |
String : argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis
. |
Retorna |
String |
um String com um código de erro ou null em caso de sucesso. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Instala um pacote Android no dispositivo para um determinado usuário.
Parâmetros |
packageFile |
File : o arquivo apk a ser instalado. |
reinstall |
boolean : true se uma reinstalação precisar ser realizada. |
userId |
int : o ID do usuário inteiro para fazer a instalação. |
extraArgs |
String : argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis
. |
Retorna |
String |
um String com um código de erro ou null em caso de sucesso. |
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 do dispositivo oferece suporte à enumeração de apps
Retorna |
boolean |
Verdadeiro se a enumeração do app for compatível. Caso contrário, é falso. |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Retorna indicando se o dispositivo usa o modo de usuário do sistema headless.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Informa se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para
o status de não administrador.
isMultiUsersupported
public boolean isMultiUserSupported ()
Determina se há suporte para vários usuários.
Retorna |
boolean |
verdadeiro se for compatível com vários usuários, caso contrário será falso |
isPackageInstall
public boolean isPackageInstalled (String packageName)
Consulte o dispositivo em busca de um nome de pacote específico para verificar se ele está instalado ou não.
Parâmetros |
packageName |
String |
Retorna |
boolean |
Verdadeiro se o pacote for relatado como instalado. Falso, do contrário. |
isPackageInstall
public boolean isPackageInstalled (String packageName,
String userId)
Consulte o dispositivo em busca de um determinado nome de pacote e ID do usuário para verificar se ele está
instalado ou não para esse usuário.
Parâmetros |
packageName |
String : o pacote que estamos verificando se está instalado. |
userId |
String : o ID do usuário em que o pacote está instalado. Se nulo, o usuário principal
zero será usado. |
Retorna |
boolean |
Verdadeiro se o pacote for relatado como instalado. Falso, do contrário. |
isUserRunning
public boolean isUserRunning (int userId)
Verifique se um determinado usuário está em execução.
Retorna |
boolean |
Verdadeiro se o usuário estiver correndo e falso em todos os outros casos. |
Secundário do usuário
public boolean isUserSecondary (int userId)
Retorna se o usuário especificado é um usuário secundário, de acordo com as sinalizações dele.
Retorna |
boolean |
verdadeiro se o usuário for secundário. Caso contrário, falso. |
isUserVisible
public boolean isUserVisible (int userId)
Verifica se um determinado usuário está visível.
Um rótulo "visível" usuário é um usuário que está interagindo com o ser humano usuário e, portanto, é capaz de
iniciar atividades de inicialização (normalmente na tela padrão).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Verifica se o usuário especificado está visível na tela especificada.
Um rótulo "visível" usuário é um usuário que está interagindo com o ser humano usuário e, portanto, é capaz de
iniciar atividades de inicialização nessa tela.
Parâmetros |
userId |
int |
displayId |
int |
listDisplayIds
public listDisplayIds ()
Colete a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys"
SurfaceFlinger".
Retorna |
|
A lista de exibições. O padrão sempre retorna a exibição padrão 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Recebe 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. Gera DeviceRuntimeException
se a saída
do dispositivo não é o esperado.
Retorna |
|
a lista de IDs de usuário. |
relatório do bug
public boolean logBugreport (String dataName,
ITestLogger listener)
Método auxiliar para registrar um relatório de bug e registrá-lo.
Parâmetros |
dataName |
String : nome em que o relatório do bug será informado. |
listener |
ITestLogger : um ITestLogger para registrar o relatório do bug. |
Retorna |
boolean |
Verdadeiro se a geração de registros for bem-sucedida. Caso contrário, é falso. |
notificarSnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Parâmetros |
waitPhase |
SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Etapas extras para a limpeza específica do dispositivo que serão executadas após a invocação
é 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 de um determinado usuário e retorna true
quando o processo é bem-sucedido. Caso contrário, retorna false
.
Parâmetros |
componentName |
String : do administrador do dispositivo a ser removido. |
userId |
int : do usuário em que o administrador do dispositivo está instalado. |
Retorna |
boolean |
Verdadeiro se for bem-sucedido, caso contrário, falso. |
removeOwners
public void removeOwners ()
Remova todos os proprietários de perfil de dispositivo existentes da melhor maneira possível.
removeUser
public boolean removeUser (int userId)
Remove determinado usuário do dispositivo.
Parâmetros |
userId |
int : do usuário a ser removido |
Retorna |
boolean |
verdadeiro se conseguirmos remover o usuário, caso contrário é falso. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Define um componente de administrador do dispositivo como proprietário do dispositivo em um determinado usuário.
Parâmetros |
componentName |
String : do administrador do dispositivo para ser o proprietário do dispositivo. |
userId |
int : do usuário em que o proprietário do dispositivo mora. |
Retorna |
boolean |
Verdadeiro se for bem-sucedido, caso contrário, falso. |
setSetting
public void setSetting (String namespace,
String key,
String value)
Consulte setSetting(int, String, String, String)
e realizada em um usuário do sistema.
Parâmetros |
namespace |
String |
key |
String |
value |
String |
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)
Adiciona um valor de configuração ao namespace de um determinado usuário. Algumas configurações só estarão disponíveis
após a reinicialização.
O namespace precisa ser um destes: {"system", "secure", "global"}
Parâmetros |
userId |
int |
namespace |
String |
key |
String |
value |
String |
stopdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Desliga o dispositivo microdroide, se houver um.
Parâmetros |
microdroidDevice |
ITestDevice |
usuáriode inicialização
public boolean startUser (int userId)
Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. Se o usuário já estiver
executado em segundo plano, esse método é um NOOP.
Parâmetros |
userId |
int : do usuário que começa em segundo plano |
Retorna |
boolean |
verdadeiro se o usuário tiver sido iniciado com sucesso em segundo plano. |
usuáriode inicialização
public boolean startUser (int userId,
boolean waitFlag)
Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. Se o usuário já estiver
executado em segundo plano, esse método é um NOOP. É possível fornecer uma flag extra para aguardar
que a operação tenha efeito.
Parâmetros |
userId |
int : do usuário que começa em segundo plano |
waitFlag |
boolean : fará o comando aguardar até que o usuário seja iniciado e desbloqueado. |
Retorna |
boolean |
verdadeiro se o usuário tiver sido iniciado com sucesso em segundo plano. |
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
para iniciar atividades nessa tela).
OBSERVAÇÃO: esse comando não verifica se o usuário existe, se a exibição está disponível, se device supports such feature
etc.
Parâmetros |
userId |
int : do usuário que começa em segundo plano |
displayId |
int : tela para iniciar visíveis ao usuário |
waitFlag |
boolean : fará o comando aguardar até que o usuário seja iniciado e desbloqueado. |
Retorna |
boolean |
true se o usuário tiver sido iniciado visível em segundo plano. |
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Interrompa um determinado usuário. É possível fornecer sinalizações extras para aguardar até que a operação tenha efeito.
e forçar o encerramento do usuário. Não é possível interromper o usuário atual e o do sistema.
Parâmetros |
userId |
int : do usuário a ser interrompido. |
waitFlag |
boolean : fará o comando esperar até que o usuário seja interrompido. |
forceFlag |
boolean : força o fechamento do usuário. |
Retorna |
boolean |
verdadeiro se o usuário tiver sido interrompido. |
stopUser
public boolean stopUser (int userId)
Interrompe um determinado usuário. Se o usuário já tiver sido interrompido, esse método será NOOP.
Não é possível interromper o usuário atual e o do sistema.
Parâmetros |
userId |
int : do usuário a ser interrompido. |
Retorna |
boolean |
verdadeiro se o usuário tiver sido interrompido. |
suportaMicrodroid
public boolean supportsMicrodroid ()
Verifica as condições prévias para executar um microdroide.
Retorna |
boolean |
retorna verdadeiro se as condições prévias forem satisfeitas; caso contrário, retorna falso. |
suportaMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Verifica as condições prévias para executar um microdroide.
Parâmetros |
protectedVm |
boolean : verdadeiro se o microdroide for projetado para ser executado em uma VM protegida. |
Retorna |
boolean |
retorna verdadeiro se as condições prévias forem satisfeitas; caso contrário, retorna falso. |
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 corresponder ao provedor userId. Falso, do contrário. |
switchUser
public boolean switchUser (int userId,
long timeout)
Troque para outro userId com o tempo limite fornecido como prazo.
Tentativa de desativar o bloqueio de teclado após a alteração do usuário.
Parâmetros |
userId |
int |
timeout |
long : aguardar antes de retornar "false" para a falha da troca de usuário. |
Retorna |
boolean |
Verdadeiro se o novo userId corresponder ao provedor userId. Falso, do contrário. |
Relatório TakeBug
public Bugreport takeBugreport ()
Crie um relatório de bug e o retorne dentro de um objeto Bugreport
para processá-lo. Retornar nulo
em caso de problema. O arquivo referenciado no objeto Bugreport precisa ser limpo com Bugreport.close()
.
desinstalarPackage
public String uninstallPackage (String packageName)
Desinstala um pacote Android do dispositivo.
Parâmetros |
packageName |
String : o pacote do Android a ser desinstalado. |
Retorna |
String |
um String com um código de erro ou null em caso de sucesso. |
desinstalarPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
Desinstala um pacote Android do dispositivo para um determinado usuário.
Parâmetros |
packageName |
String : o pacote do Android a ser desinstalado. |
userId |
int : o ID do usuário inteiro para desinstalar. |
Retorna |
String |
um String com um código de erro ou null em caso de sucesso. |
"waitForSnapuserd"
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Parâmetros |
currentPhase |
SnapuserdWaitPhase |
Métodos protegidos
createParser
protected AaptParser createParser (File appFile)
doAdbReiniciar
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Execute uma reinicialização do adb.
Parâmetros |
rebootMode |
NativeDevice.RebootMode : um modo da 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 teste.
getHostCurrentTime
protected long getHostCurrentTime ()
Exposto para teste
Configuração PrePostBoot
protected void prePostBootSetup ()
Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) modifique esse método para
configuração específica pós-inicialização.