Classes aninhadas |
---|
class | TestDevice.MicrodroidBuilder Um construtor usado para criar um Microdroid TestDevice. |
Campos |
---|
public static final String | DISMISS_KEYGUARD_CMD Comandos que podem ser usados para dispensar a proteção do teclado. |
Métodos públicos |
---|
boolean | canSwitchToHeadlessSystemUser () Retorna se é permitido mudar para o usuário SYSTEM sem cabeça. |
boolean | clearErrorDialogs () Tente descartar quaisquer caixas de diálogo de erro exibidas atualmente na IU do dispositivo. |
int | createUser (String name) Crie um usuário com um determinado nome e sinalizadores padrão 0. |
int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) Crie um usuário com um determinado nome e os sinalizadores fornecidos |
int | createUser (String name, boolean guest, boolean ephemeral) Crie um usuário com um determinado nome e os sinalizadores fornecidos |
int | createUserNoThrow (String name) Crie um usuário com um determinado nome e sinalizadores padrão 0. |
void | disableKeyguard () Tentativas de desativar a proteção do 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) Tente despejar o heap do system_server. |
| getActiveApexes () Busque as informações sobre APEXes ativados no dispositivo. |
| getAllSettings (String namespace) Retorna pares de valores-chave do namespace solicitado. |
String | getAndroidId (int userId) Encontre e retorne o android-id associado a um userId, nulo se não for encontrado. |
| getAndroidIds () Crie um mapa de IDs de Android encontrados que correspondam aos IDs de usuário. |
PackageInfo | getAppPackageInfo (String packageName) Busque informações sobre um pacote instalado no dispositivo. |
| getAppPackageInfos () Busque 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 ocorrerem alguns problemas. |
int | getCurrentUser () Retorne o ID do usuário em execução atual. |
| getFoldableStates () Retorna a lista de estados dobráveis no dispositivo. |
| getInstalledPackageNames () Busque os nomes dos pacotes de aplicativos presentes no dispositivo. |
KeyguardControllerState | getKeyguardState () Retorne um objeto para obter o estado atual do keyguard ou nulo se não for compatível. |
Integer | getMainUserId () Retorna o ID do usuário principal. |
| getMainlineModuleInfo () Obtenha as informações sobre os módulos principais instalados no dispositivo. |
int | getMaxNumberOfRunningUsersSupported () Obtenha o número máximo de usuários com suporte em execução simultânea. |
int | getMaxNumberOfUsersSupported () Obtenha o número máximo de usuários com suporte. |
Integer | getPrimaryUserId () Retorna o ID do usuário principal. |
InputStreamSource | getScreenshot () Captura uma captura de tela do dispositivo. |
InputStreamSource | getScreenshot (String format, boolean rescale) Captura uma captura de tela do dispositivo. |
InputStreamSource | getScreenshot (String format) Captura uma captura de tela do dispositivo. |
InputStreamSource | getScreenshot (long displayId) Captura uma captura de tela do dispositivo com o ID de exibição. |
String | getSetting (String namespace, String key) Veja getSetting(int, String, String) e executado no usuário do sistema. |
String | getSetting (int userId, String namespace, String key) Retorne o valor da configuração solicitada. |
| getUninstallablePackageNames () Obtenha os nomes dos pacotes de aplicativos que podem ser desinstalados. |
int | getUserFlags (int userId) Encontre e retorne os sinalizadores de um determinado usuário. |
| getUserInfos () Obtém o mapa de useId para UserInfo no dispositivo. |
int | getUserSerialNumber (int userId) Retorne o número de série associado ao userId se encontrado, -10000 em qualquer outro caso. |
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) 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) installPackages ( packageFiles, boolean reinstall, String... extraArgs) |
String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) |
boolean | isAppEnumerationSupported () Verifique se a plataforma no dispositivo suporta enumeração de aplicativos |
boolean | isHeadlessSystemUserMode () Retorna se o dispositivo usa o modo de usuário do sistema headless. |
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) Consulte o dispositivo para obter um determinado nome de pacote para verificar se ele está instalado ou não. |
boolean | isPackageInstalled (String packageName, String userId) Consulte o dispositivo para obter um determinado nome de pacote e um determinado ID de 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 seus sinalizadores. |
boolean | isUserVisible (int userId) Verifica se o usuário determinado está visível. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Verifica se o usuário determinado está visível na exibição 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 () Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano. |
| listDisplayIds () Colete a lista de IDs de exibição disponíveis no dispositivo, conforme relatado por "dumpsys SurfaceFlinger". |
| listDisplayIdsForStartingVisibleBackgroundUsers () Obtém a lista de exibições que podem ser usadas para start a user visible in the background . |
| listUsers () Obtém a lista de usuários no dispositivo. |
boolean | logBugreport (String dataName, ITestLogger listener) Método auxiliar para obter um relatório de bug e registrá-lo aos repórteres. |
void | notifySnapuserd ( SnapuserdWaitPhase waitPhase) |
void | postInvocationTearDown (Throwable exception) Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a invocação. |
boolean | removeAdmin (String componentName, int userId) Remova o administrador do dispositivo em determinado usuário e retorne true se for bem-sucedido, caso contrário, false . |
void | removeOwners () Remova todos os proprietários de perfis de dispositivos existentes com o melhor esforço. |
boolean | removeUser (int userId) Remova um determinado usuário do dispositivo. |
boolean | setDeviceOwner (String componentName, int userId) Defina um componente de administração do dispositivo como proprietário do dispositivo em determinado usuário. |
void | setSetting (String namespace, String key, String value) Veja 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 existir. |
boolean | startUser (int userId) Inicia um determinado usuário em segundo plano se ele estiver parado no momento. |
boolean | startUser (int userId, boolean waitFlag) Inicia um determinado usuário em segundo plano se ele estiver parado no momento. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Inicia um determinado usuário em segundo plano, visível em uma determinada tela (ou seja, permitindo que o usuário inicie atividades naquela tela). |
boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Pare um determinado usuário. |
boolean | stopUser (int userId) Interrompe um determinado usuário. |
boolean | supportsMicrodroid () Verifica as pré-condições para executar um microdroid. |
boolean | supportsMicrodroid (boolean protectedVm) Verifica as pré-condições para executar um microdroid. |
boolean | switchUser (int userId) Mude para outro userId com um tempo limite padrão. |
boolean | switchUser (int userId, long timeout) Mude para outro userId com o tempo limite fornecido como prazo. |
Bugreport | takeBugreport () Pegue um relatório de bug e retorne-o dentro de um objeto Bugreport para tratá-lo. |
String | uninstallPackage (String packageName) Desinstale um pacote Android do dispositivo. |
String | uninstallPackageForUser (String packageName, int userId) Desinstale 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 a proteção do teclado.
Construtores públicos
Métodos públicos
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Retorna se é permitido mudar para o usuário SYSTEM sem cabeça.
clearErrorDialogs
public boolean clearErrorDialogs ()
Tente descartar quaisquer caixas de diálogo de erro exibidas atualmente na IU do dispositivo.
Devoluções |
---|
boolean | true se nenhuma caixa de diálogo estiver presente ou se as caixas de diálogo tiverem sido limpas com êxito. false caso contrário. |
criarUsuário
public int createUser (String name)
Crie um usuário com um determinado nome e sinalizadores padrão 0.
Parâmetros |
---|
name | String : do usuário a ser criado no dispositivo |
Devoluções |
---|
int | o número inteiro para o ID do usuário criado |
criarUsuário
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Crie um usuário com um determinado nome e os sinalizadores fornecidos
Parâmetros |
---|
name | String : do usuário a ser criado no dispositivo |
guest | boolean : habilita o sinalizador do usuário --guest durante a criação |
ephemeral | boolean : habilita o sinalizador do usuário --ephemeral durante a criação |
forTesting | boolean : habilita o sinalizador de teste --for-testing durante a criação |
Devoluções |
---|
int | id do usuário criado |
criarUsuário
public int createUser (String name,
boolean guest,
boolean ephemeral)
Crie um usuário com um determinado nome e os sinalizadores fornecidos
Parâmetros |
---|
name | String : do usuário a ser criado no dispositivo |
guest | boolean : habilita o sinalizador do usuário --guest durante a criação |
ephemeral | boolean : habilita o sinalizador do usuário --ephemeral durante a criação |
Devoluções |
---|
int | id do usuário criado |
createUserNoThrow
public int createUserNoThrow (String name)
Crie um usuário com um determinado nome e sinalizadores padrão 0.
Parâmetros |
---|
name | String : do usuário a ser criado no dispositivo |
Devoluções |
---|
int | o número inteiro para o ID do usuário criado ou -1 para erro. |
desabilitarKeyguard
public void disableKeyguard ()
Tentativas de desativar a proteção do teclado.
Primeiro espere que o despacho de entrada fique pronto, isso acontece quase ao mesmo tempo em que o dispositivo reporta BOOT_COMPLETE, aparentemente de forma assíncrona, porque a implementação da estrutura atual tem condições de corrida ocasionais. Em seguida, o comando é enviado para descartar a proteção do teclado (funciona apenas em dispositivos não seguros)
fazFileExist
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 |
Devoluções |
---|
boolean | true se o arquivo existir, false caso contrário. |
fazFileExist
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 |
Devoluções |
---|
boolean | true se o arquivo existir, false caso contrário. |
dumpHeap
public File dumpHeap (String process,
String devicePath)
Tente despejar o heap do system_server. É responsabilidade do chamador limpar o arquivo despejado.
Parâmetros |
---|
process | String : o nome do processo do dispositivo no qual dumpheap. |
devicePath | String : o caminho no dispositivo onde colocar o dump. Este deve ser um local onde as permissões permitam. |
Devoluções |
---|
File | o ERROR(/File) que contém o relatório. Nulo se algo falhou. |
getActiveApexes
public getActiveApexes ()
Busque as informações sobre APEXes ativados no dispositivo.
getAllSettings
public getAllSettings (String namespace)
Retorna pares de valores-chave do namespace solicitado.
Parâmetros |
---|
namespace | String : deve ser um de {"system", "secure", "global"} |
Devoluções |
---|
| o mapa de pares de valores-chave. Nulo se o namespace não for compatível. |
obterAndroidId
public String getAndroidId (int userId)
Encontre e retorne o android-id associado a um userId, nulo se não for encontrado.
obterAndroidIds
public getAndroidIds ()
Crie um mapa de IDs de Android encontrados que correspondam aos IDs de usuário. Não há garantia de que cada ID de usuário encontrará um ID de Android associado a esta função, portanto, alguns IDs de usuário podem corresponder a nulo.
Devoluções |
---|
| Mapa de IDs de Android encontrados com IDs de usuário correspondentes. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Busque informações sobre um pacote instalado no dispositivo.
Parâmetros |
---|
packageName | String |
getAppPackageInfos
public getAppPackageInfos ()
Busque informações de pacotes instalados no dispositivo.
getBugreport
public InputStreamSource getBugreport ()
Recupera um relatório de bug do dispositivo.
É garantido que a implementação disso continuará funcionando em um dispositivo sem cartão sd (ou onde o cartão sd ainda não está montado).
getBugreportz
public InputStreamSource getBugreportz ()
Recupera um bugreportz do dispositivo. O relatório de erros em formato Zip contém o relatório de erros principal e outros arquivos de log que são úteis para depuração.
Compatível apenas com 'versão adb' > 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Retorna o estado dobrável atual do dispositivo ou nulo se ocorrerem alguns problemas.
getCurrentUser
public int getCurrentUser ()
Retorne 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 obtido com "cmd device_state print-states".
getInstalledPackageNames
public getInstalledPackageNames ()
Busque os nomes dos pacotes de aplicativos presentes no dispositivo.
Devoluções |
---|
| ERROR(/Set) de nomes de pacotes String atualmente instalados no dispositivo. |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Retorne um objeto para obter o estado atual do keyguard ou nulo se não for compatível.
getMainUserId
public Integer getMainUserId ()
Retorna o ID do usuário principal.
Devoluções |
---|
Integer | o userId do usuário principal, se houver, e null se não houver nenhum usuário principal. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Obtenha as informações sobre os módulos principais instalados no dispositivo.
Devoluções |
---|
| ERROR(/Set) dos módulos da linha principal String atualmente instalados no dispositivo. |
public int getMaxNumberOfRunningUsersSupported ()
Obtenha o número máximo de usuários com suporte em execução simultânea. O padrão é 0.
Devoluções |
---|
int | um número inteiro indicando o número de usuários em execução simultânea |
public int getMaxNumberOfUsersSupported ()
Obtenha o número máximo de usuários com suporte. O padrão é 0.
Devoluções |
---|
int | um número inteiro indicando o número de usuários suportados |
getPrimaryUserId
public Integer getPrimaryUserId ()
Retorna o ID do usuário principal.
Devoluções |
---|
Integer | o userId do usuário principal, se houver, e nulo, se não houver nenhum usuário principal. |
obter captura de tela
public InputStreamSource getScreenshot ()
Captura uma captura de tela do dispositivo.
obter captura de tela
public InputStreamSource getScreenshot (String format,
boolean rescale)
Captura uma captura de tela do dispositivo. Recomendado usar getScreenshot(String)
em vez da codificação JPEG para tamanhos menores.
Parâmetros |
---|
format | String : PNG e JPEG suportados |
rescale | boolean : se a captura de tela deve ser redimensionada para reduzir o tamanho da imagem resultante |
obter captura de tela
public InputStreamSource getScreenshot (String format)
Captura uma captura de tela do dispositivo. Recomendado usar getScreenshot(format) em vez da codificação JPEG para tamanhos menores
Parâmetros |
---|
format | String : PNG e JPEG suportados |
obter captura de tela
public InputStreamSource getScreenshot (long displayId)
Captura uma captura de tela do dispositivo com o ID de exibição. O formato é PNG.
TODO: estender as implementações acima para suportar 'formatar' e 'redimensionar'
Parâmetros |
---|
displayId | long : o ID de exibição da tela da qual obter a captura de tela. |
getSetting
public String getSetting (String namespace,
String key)
Veja 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)
Retorne o valor da configuração solicitada. namespace deve ser um dos seguintes: {"system", "secure", "global"}
Parâmetros |
---|
userId | int |
namespace | String |
key | String |
Devoluções |
---|
String | o valor associado ao namespace:key de um usuário. Nulo se não for encontrado. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
Obtenha os nomes dos pacotes de aplicativos que podem ser desinstalados. Atualmente, isso é definido como pacotes que não são do sistema e pacotes de sistema atualizados.
Devoluções |
---|
| ERROR(/Set) de nomes de pacotes String desinstaláveis atualmente instalados no dispositivo. |
getUserFlags
public int getUserFlags (int userId)
Encontre e retorne os sinalizadores de um determinado usuário. Os sinalizadores são definidos na classe "android.content.pm.UserInfo" no Android Open Source Project.
Devoluções |
---|
int | os sinalizadores associados ao userId fornecido, se encontrado, -10000 em qualquer outro caso. |
getUserInfos
public getUserInfos ()
Obtém o mapa de useId para UserInfo
no dispositivo. Lançará DeviceRuntimeException
se a saída do dispositivo não for a esperada.
Devoluções |
---|
| a lista de objetos UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Retorne o número de série associado ao userId se encontrado, -10000 em qualquer outro caso.
temRecurso
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. |
Devoluções |
---|
boolean | Verdadeiro se o recurso for encontrado; caso contrário, falso. |
instalarPacote
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Instale um pacote Android no dispositivo.
Parâmetros |
---|
packageFile | File : o arquivo apk para instalar |
reinstall | boolean : true se uma reinstalação precisar ser realizada |
extraArgs | String : argumentos extras opcionais a serem passados. Consulte 'adb shell pm -h' para opções disponíveis. |
Devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedido. |
instalarPacote
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Instale um pacote Android no dispositivo.
Nota: Somente casos de uso que exigem controle explícito de concessão de permissão de tempo de execução no momento da instalação devem chamar esta função.
Parâmetros |
---|
packageFile | File : o arquivo apk para instalar |
reinstall | boolean : true se uma reinstalação precisar ser realizada |
grantPermissions | boolean : se todas as permissões de tempo de execução devem ser concedidas no momento da instalação |
extraArgs | String : argumentos extras opcionais a serem passados. Consulte 'adb shell pm -h' para opções disponíveis. |
Devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedido. |
instalarPacote
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Instale um pacote Android no dispositivo.
Nota: Somente casos de uso que exigem controle explícito de concessão de permissão de tempo de execução no momento da instalação devem chamar esta função.
Parâmetros |
---|
packageFile | File : o arquivo apk para instalar |
certFile | File : true se uma reinstalação precisar ser realizada |
reinstall | boolean : se todas as permissões de tempo de execução devem ser concedidas no momento da instalação |
extraArgs | String : argumentos extras opcionais a serem passados. Consulte 'adb shell pm -h' para opções disponíveis. |
Devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedido. |
instalarPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Instale um pacote Android no dispositivo para um determinado usuário.
Nota: Somente casos de uso que exigem controle explícito de concessão de permissão de tempo de execução no momento da instalação devem chamar esta função.
Parâmetros |
---|
packageFile | File : o arquivo apk para instalar |
reinstall | boolean : true se uma reinstalação precisar ser realizada |
grantPermissions | boolean : se todas as permissões de tempo de execução devem ser concedidas no momento da instalação |
userId | int : o ID de usuário inteiro para instalar. |
extraArgs | String : argumentos extras opcionais a serem passados. Consulte 'adb shell pm -h' para opções disponíveis. |
Devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedido. |
instalarPackageForUser
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 para instalar |
reinstall | boolean : true se uma reinstalação precisar ser realizada |
userId | int : o ID de usuário inteiro para instalar. |
extraArgs | String : argumentos extras opcionais a serem passados. Consulte 'adb shell pm -h' para opções disponíveis. |
Devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedido. |
instalar pacotes
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Parâmetros |
---|
packageFiles | |
reinstall | boolean |
extraArgs | String |
instalar pacotes
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parâmetros |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
instalarPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Parâmetros |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
userId | int |
extraArgs | String |
instalarPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Parâmetros |
---|
packageFiles | |
reinstall | boolean |
userId | int |
extraArgs | String |
instalarRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Parâmetros |
---|
remoteApkPaths | |
reinstall | boolean |
extraArgs | String |
instalarRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parâmetros |
---|
remoteApkPaths | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Verifique se a plataforma no dispositivo suporta enumeração de aplicativos
Devoluções |
---|
boolean | Verdadeiro se a enumeração de aplicativos for compatível; caso contrário, falso |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Retorna se o dispositivo usa o modo de usuário do sistema headless.
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.
isMultiUserSupportado
public boolean isMultiUserSupported ()
Determina se há suporte para vários usuários.
Devoluções |
---|
boolean | verdadeiro se houver suporte para vários usuários; caso contrário, falso |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Consulte o dispositivo para obter um determinado nome de pacote para verificar se ele está instalado ou não.
Parâmetros |
---|
packageName | String |
Devoluções |
---|
boolean | Verdadeiro se o pacote for relatado como instalado. Caso contrário, falso. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
Consulte o dispositivo para obter um determinado nome de pacote e um determinado ID de 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 estamos verificando se o pacote está instalado. Se for nulo, o usuário primário zero será usado. |
Devoluções |
---|
boolean | Verdadeiro se o pacote for relatado como instalado. Caso contrário, falso. |
isUserRunning
public boolean isUserRunning (int userId)
Verifique se um determinado usuário está em execução.
Devoluções |
---|
boolean | Verdadeiro se o usuário estiver em execução, falso em todos os outros casos. |
isUserSecondary
public boolean isUserSecondary (int userId)
Retorna se o usuário especificado é um usuário secundário de acordo com seus sinalizadores.
Devoluções |
---|
boolean | verdadeiro se o usuário for secundário; caso contrário, falso. |
isUserVisible
public boolean isUserVisible (int userId)
Verifica se o usuário determinado está visível.
Um usuário "visível" é aquele que está interagindo com o usuário "humano" e, portanto, é capaz de iniciar atividades de inicialização (normalmente na exibição padrão).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Verifica se o usuário determinado está visível na exibição especificada.
Um usuário "visível" é um usuário que está interagindo com o usuário "humano" e, portanto, é capaz de iniciar atividades de lançamento nessa exibição.
Parâmetros |
---|
userId | int |
displayId | int |
listaDisplayIds
public listDisplayIds ()
Colete a lista de IDs de exibição disponíveis no dispositivo, conforme relatado por "dumpsys SurfaceFlinger".
Devoluções |
---|
| A lista de exibições. Padrão sempre retorna a exibição padrão 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Obtém a lista de exibições que podem ser usadas para start a user visible in the background
.
listaUsuários
public listUsers ()
Obtém a lista de usuários no dispositivo. Lançará DeviceRuntimeException
se a saída do dispositivo não for a esperada.
Devoluções |
---|
| a lista de IDs de usuário. |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Método auxiliar para obter um relatório de bug e registrá-lo aos repórteres.
Parâmetros |
---|
dataName | String : nome sob o qual o bugreport será reportado. |
listener | ITestLogger : um ITestLogger para registrar o relatório de bug. |
Devoluções |
---|
boolean | Verdadeiro se o registro foi bem-sucedido; caso contrário, falso. |
notificarSnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Parâmetros |
---|
waitPhase | SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a invocação.
Parâmetros |
---|
exception | Throwable : se houver, a exceção final levantada pela falha de invocação. |
removerAdmin
public boolean removeAdmin (String componentName,
int userId)
Remova o administrador do dispositivo em determinado usuário e retorne true
se for bem-sucedido, caso contrário, false
.
Parâmetros |
---|
componentName | String : do administrador do dispositivo a ser removido. |
userId | int : do usuário em que o administrador do dispositivo reside. |
Devoluções |
---|
boolean | Verdadeiro se for bem-sucedido, falso caso contrário. |
removerProprietários
public void removeOwners ()
Remova todos os proprietários de perfis de dispositivos existentes com o melhor esforço.
removerUsuário
public boolean removeUser (int userId)
Remova um determinado usuário do dispositivo.
Parâmetros |
---|
userId | int : do usuário a ser removido |
Devoluções |
---|
boolean | verdadeiro se obtivermos sucesso na remoção do usuário; caso contrário, falso. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Defina um componente de administração do dispositivo como proprietário do dispositivo em 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 reside o proprietário do dispositivo. |
Devoluções |
---|
boolean | Verdadeiro se for bem-sucedido, falso caso contrário. |
definirConfiguração
public void setSetting (String namespace,
String key,
String value)
Veja setSetting(int, String, String, String)
e executado no usuário do sistema.
Parâmetros |
---|
namespace | String |
key | String |
value | String |
definirConfiguração
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ó estarão disponíveis após a reinicialização. namespace deve ser um dos seguintes: {"system", "secure", "global"}
Parâmetros |
---|
userId | int |
namespace | String |
key | String |
value | String |
desligamentoMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Desliga o dispositivo microdroid, se existir.
Parâmetros |
---|
microdroidDevice | ITestDevice |
usuário inicial
public boolean startUser (int userId)
Inicia um determinado usuário em segundo plano se ele estiver parado no momento. Se o usuário já estiver executando em segundo plano, este método é um NOOP.
Parâmetros |
---|
userId | int : do usuário para iniciar em segundo plano |
Devoluções |
---|
boolean | true se o usuário foi iniciado com êxito em segundo plano. |
usuário inicial
public boolean startUser (int userId,
boolean waitFlag)
Inicia um determinado usuário em segundo plano se ele estiver parado no momento. Se o usuário já estiver executando em segundo plano, este método é um NOOP. Possível fornecer sinalizador extra para aguardar o efeito da operação.
Parâmetros |
---|
userId | int : do usuário para iniciar em segundo plano |
waitFlag | boolean : fará o comando esperar até que o usuário seja iniciado e desbloqueado. |
Devoluções |
---|
boolean | true se o usuário foi iniciado com êxito em segundo plano. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Inicia um determinado usuário em segundo plano, visível em uma determinada tela (ou seja, permitindo que o usuário inicie atividades naquela tela).
NOTA: este comando não verifica se o usuário existe, a exibição está disponível, device supports such feature
, etc.
Parâmetros |
---|
userId | int : do usuário para iniciar em segundo plano |
displayId | int : display para iniciar o usuário visível em |
waitFlag | boolean : fará o comando esperar até que o usuário seja iniciado e desbloqueado. |
Devoluções |
---|
boolean | true se o usuário foi iniciado com sucesso e visível em segundo plano. |
pararUsuário
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Pare um determinado usuário. É possível fornecer sinalizadores extras para aguardar o efeito da operação e forçar o encerramento do usuário. Não é possível parar o usuário atual e do sistema.
Parâmetros |
---|
userId | int : do usuário para parar. |
waitFlag | boolean : fará o comando esperar até que o usuário seja interrompido. |
forceFlag | boolean : forçará a parada do usuário. |
Devoluções |
---|
boolean | true se o usuário foi interrompido com êxito. |
pararUsuário
public boolean stopUser (int userId)
Interrompe um determinado usuário. Se o usuário já estiver parado, este método é um NOOP. Não é possível parar o usuário atual e do sistema.
Parâmetros |
---|
userId | int : do usuário para parar. |
Devoluções |
---|
boolean | true se o usuário foi interrompido com sucesso. |
suportaMicrodroid
public boolean supportsMicrodroid ()
Verifica as pré-condições para executar um microdroid.
Devoluções |
---|
boolean | retorna verdadeiro se as pré-condições forem satisfeitas, falso caso contrário. |
suportaMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Verifica as pré-condições para executar um microdroid.
Parâmetros |
---|
protectedVm | boolean : verdadeiro se o microdroid for executado em VM protegida. |
Devoluções |
---|
boolean | retorna verdadeiro se as pré-condições forem satisfeitas, falso caso contrário. |
mudar de utilizador
public boolean switchUser (int userId)
Mude para outro userId com um tempo limite padrão. switchUser(int, long)
.
Devoluções |
---|
boolean | Verdadeiro se o novo userId corresponder ao provedor userId. Caso contrário, falso. |
mudar de utilizador
public boolean switchUser (int userId,
long timeout)
Mude para outro userId com o tempo limite fornecido como prazo. Tentativa de desativar a proteção do teclado após a alteração do usuário ser bem-sucedida.
Parâmetros |
---|
userId | int |
timeout | long : esperar antes de retornar false para switch-user falhou. |
Devoluções |
---|
boolean | Verdadeiro se o novo userId corresponder ao provedor userId. Caso contrário, falso. |
pegueBugreport
public Bugreport takeBugreport ()
Pegue um relatório de bug e retorne-o dentro de um objeto Bugreport
para tratá-lo. Retorne nulo em caso de problema. O arquivo referenciado no objeto Bugreport precisa ser limpo via Bugreport.close()
.
desinstalarPackage
public String uninstallPackage (String packageName)
Desinstale um pacote Android do dispositivo.
Parâmetros |
---|
packageName | String : o pacote Android a ser desinstalado |
Devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedido. |
desinstalarPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
Desinstale 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 para desinstalar. |
Devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedido. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Parâmetros |
---|
currentPhase | SnapuserdWaitPhase |
Métodos protegidos
criarParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Execute uma reinicialização do adb.
Parâmetros |
---|
rebootMode | NativeDevice.RebootMode : um modo desta reinicialização. |
reason | String : para esta reinicialização. |
getBugreportzInternal
protected File getBugreportzInternal ()
Método auxiliar interno para obter o arquivo zip 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 configuração específica pós-inicialização.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2024-04-02 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Não contém as informações de que eu preciso"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Muito complicado / etapas demais"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Desatualizado"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problema na tradução"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problema com as amostras / o código"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Outro"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Fácil de entender"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Meu problema foi resolvido"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Outro"
}]
{
"last_modified": "Última atualização 2024-04-02 UTC.",
"state": ""
}