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 o keyguard. |
Métodos públicos |
---|
boolean | canSwitchToHeadlessSystemUser () Retorna se é permitido alternar para o usuário headless SYSTEM. |
boolean | clearErrorDialogs () Tente descartar todas as caixas de diálogo de erro atualmente exibidas na interface do usuário 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 () Tenta 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 os 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 correspondentes a IDs de usuário. |
PackageInfo | getAppPackageInfo (String packageName) Busca informações sobre um pacote instalado no dispositivo. |
| getAppPackageInfos () Busca 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 () 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 suportado. |
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 em execução simultânea com suporte. |
int | getMaxNumberOfUsersSupported () Obtenha o número máximo de usuários suportados. |
Integer | getPrimaryUserId () Retorna o ID do usuário primário. |
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 fornecido. |
String | getSetting (String namespace, String key) Consulte getSetting(int, String, String) e execute no 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 os sinalizadores de um determinado usuário. |
| getUserInfos () Obtém o mapa de useId para UserInfo no dispositivo. |
int | getUserSerialNumber (int userId) Retorna o número de série associado ao userId se encontrado, -10000 nos demais casos. |
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 oferece suporte à 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 multiusuário é compatível. |
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 fornecido está visível. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Verifica se o usuário fornecido está visível na exibição fornecida. |
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 para os repórteres. |
void | postInvocationTearDown (Throwable exception) Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a conclusão da chamada. |
boolean | removeAdmin (String componentName, int userId) Remova o administrador do dispositivo fornecido em determinado usuário e retorne true se for bem-sucedido, false caso contrário. |
void | removeOwners () Remova todos os proprietários de perfil de dispositivo 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) 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. |
boolean | startUser (int userId) Inicia um determinado usuário em segundo plano se estiver parado no momento. |
boolean | startUser (int userId, boolean waitFlag) Inicia um determinado usuário em segundo plano se estiver parado no momento. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Inicia um determinado usuário em segundo plano, visível na exibição fornecida (ou seja, permitindo que o usuário inicie atividades nessa exibição). |
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) Alterne para outro userId com o tempo limite fornecido como prazo. |
Bugreport | takeBugreport () Pegue um relatório de bug e o retorne 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. |
Campos
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Comandos que podem ser usados para dispensar o keyguard.
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 ()
Tente descartar todas as caixas de diálogo de erro atualmente exibidas na interface do usuário do dispositivo.
devoluções |
---|
boolean | true se nenhuma caixa de diálogo estiver presente ou se as caixas de diálogo forem 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 : habilite o sinalizador de usuário --guest durante a criação |
ephemeral | boolean : habilite o sinalizador de usuário --ephemeral durante a criação |
forTesting | boolean : habilite 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 : habilite o sinalizador de usuário --guest durante a criação |
ephemeral | boolean : habilite o sinalizador de 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. |
desativarKeyguard
public void disableKeyguard ()
Tenta desativar a proteção do teclado.
Primeiro, espere que o envio de entrada fique pronto, isso acontece ao mesmo tempo em que o dispositivo relata BOOT_COMPLETE, aparentemente de forma assíncrona, porque a implementação atual da estrutura tem uma condição de corrida ocasional. Em seguida, o comando é enviado para descartar o keyguard (funciona apenas em não-seguros)
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 |
devoluções |
---|
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 contra o qual 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 para despejar. |
devicePath | String : o caminho no dispositivo onde colocar o dump. Este deve ser um local onde as permissões permitem. |
devoluções |
---|
File | o ERROR(/File) contendo o relatório. Nulo se algo falhou. |
getActiveApexes
public getActiveApexes ()
Busque as informações sobre os APEXes ativados no dispositivo.
getAllSettings
public getAllSettings (String namespace)
Retorna pares de valores-chave do namespace solicitado.
Parâmetros |
---|
namespace | String : deve ser um dos {"system", "secure", "global"} |
devoluções |
---|
| o mapa de pares 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, nulo se não for encontrado.
getAndroidIds
public getAndroidIds ()
Crie um mapa de IDs de Android encontrados correspondentes a 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 null.
devoluções |
---|
| Mapa de IDs de Android encontrados com IDs de usuários 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 de pacotes instalados no dispositivo.
getbugreport
public InputStreamSource getBugreport ()
Recupera um relatório de bug do dispositivo.
A implementação disso é garantida para continuar a funcionar em um dispositivo sem um 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 bug em formato zip contém o relatório de bug 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 alguns problemas ocorreram.
getCurrentUser
public int getCurrentUser ()
Retorna o id do usuário em execução atual. Em caso de erro, retorna -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 nulo se não houver 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 em execução simultânea com suporte. O padrão é 0.
devoluções |
---|
int | um inteiro indicando o número de usuários em execução simultaneamente |
public int getMaxNumberOfUsersSupported ()
Obtenha o número máximo de usuários suportados. 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 null se não houver 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 de codificação JPEG para tamanho menor.
Parâmetros |
---|
format | String : PNG suportado, JPEG |
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 de codificação JPEG para tamanho menor
Parâmetros |
---|
format | String : PNG suportado, JPEG |
obter captura de tela
public InputStreamSource getScreenshot (long displayId)
Captura uma captura de tela do dispositivo com o ID de exibição fornecido. O formato é PNG.
TODO: estender as implementações acima para suportar 'format' e 'rescale'
Parâmetros |
---|
displayId | long : o ID de exibição da tela para obter a captura de tela. |
getSetting
public String getSetting (String namespace,
String key)
Consulte getSetting(int, String, String)
e execute 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 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 ()
Busque os nomes dos pacotes de aplicativos que podem ser desinstalados. Atualmente, isso é definido como pacotes que não são do sistema e pacotes do sistema atualizados.
devoluções |
---|
| ERROR(/Set) de nomes de pacotes String instalá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 encontrados, -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)
Retorna o número de série associado ao userId se encontrado, -10000 nos demais casos.
tem recurso
public boolean hasFeature (String feature)
Verifique se um recurso está disponível em um dispositivo.
Parâmetros |
---|
feature | String : qual formato deve ser "recurso: " ou " " diretamente. |
devoluções |
---|
boolean | Verdadeiro se o recurso for encontrado, falso caso contrário. |
pacote de instalação
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 deve ser realizada |
extraArgs | String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis. |
devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedida. |
pacote de instalação
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Instale um pacote Android no dispositivo.
Nota: Somente os casos de uso que requerem 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 deve 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 para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis. |
devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedida. |
pacote de instalação
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Instale um pacote Android no dispositivo.
Nota: Somente os casos de uso que requerem 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 deve 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 para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis. |
devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedida. |
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.
Nota: Somente os casos de uso que requerem 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 deve ser executada |
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 o qual instalar. |
extraArgs | String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis. |
devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedida. |
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 para instalar |
reinstall | boolean : true se uma reinstalação deve ser executada |
userId | int : o id de usuário inteiro para o qual instalar. |
extraArgs | String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis. |
devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedida. |
instalarPacotes
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Parâmetros |
---|
packageFiles | |
reinstall | boolean |
extraArgs | String |
instalarPacotes
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 |
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 oferece suporte à enumeração de aplicativos
devoluções |
---|
boolean | Verdadeiro se a enumeração do aplicativo for suportada, falso caso contrário |
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.
isMultiUserSupported
public boolean isMultiUserSupported ()
Determina se multiusuário é compatível.
devoluções |
---|
boolean | verdadeiro se multiusuário for suportado, falso caso contrário |
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. Falso caso contrário. |
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 nulo, o usuário primário zero será usado. |
devoluções |
---|
boolean | Verdadeiro se o pacote for relatado como instalado. Falso caso contrário. |
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 executando, 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 | true se o usuário for secundário, false caso contrário. |
isUserVisible
public boolean isUserVisible (int userId)
Verifica se o usuário fornecido está visível.
Um usuário "visível" é um usuário 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 fornecido está visível na exibição fornecida.
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 nesse monitor.
Parâmetros |
---|
userId | int |
displayId | int |
listDisplayIds
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
.
listarUsuá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ários. |
log Bugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Método auxiliar para obter um relatório de bug e registrá-lo para os repórteres.
Parâmetros |
---|
dataName | String : nome sob o qual o relatório de bug será reportado. |
listener | ITestLogger : um ITestLogger para registrar o relatório de bug. |
devoluções |
---|
boolean | True se o registro foi bem-sucedido, false caso contrário. |
postInvocation TearDown
public void postInvocationTearDown (Throwable exception)
Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a conclusão da chamada.
Parâmetros |
---|
exception | Throwable : se houver, a exceção final levantada pela falha de invocação. |
removeAdmin
public boolean removeAdmin (String componentName,
int userId)
Remova o administrador do dispositivo fornecido em determinado usuário e retorne true
se for bem-sucedido, false
caso contrário.
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. |
removeOwners
public void removeOwners ()
Remova todos os proprietários de perfil de dispositivo existentes com o melhor esforço.
removeUser
public boolean removeUser (int userId)
Remova um determinado usuário do dispositivo.
Parâmetros |
---|
userId | int : do usuário para remover |
devoluções |
---|
boolean | true se obtivermos sucesso na remoção do usuário, false caso contrário. |
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 o proprietário do dispositivo reside. |
devoluções |
---|
boolean | Verdadeiro se for bem-sucedido, falso caso contrário. |
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ó estarão disponíveis após uma 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 houver.
Parâmetros |
---|
microdroidDevice | ITestDevice |
startUser
public boolean startUser (int userId)
Inicia um determinado usuário em segundo plano se estiver parado no momento. Se o usuário já estiver executando em segundo plano, esse 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. |
startUser
public boolean startUser (int userId,
boolean waitFlag)
Inicia um determinado usuário em segundo plano se estiver parado no momento. Se o usuário já estiver executando em segundo plano, esse método é um NOOP. Possível fornecer sinalizador extra para aguardar a operação ter efeito.
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 na exibição fornecida (ou seja, permitindo que o usuário inicie atividades nessa exibição).
NOTA: este comando não verifica se o usuário existe, o display está disponível, device supports such feature
, etc.
Parâmetros |
---|
userId | int : do usuário para iniciar em segundo plano |
displayId | int : exibir 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 êxito visível em segundo plano. |
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Pare um determinado usuário. Possível fornecer sinalizadores extras para aguardar a operação ter efeito 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 parado. |
forceFlag | boolean : forçará a parada do usuário. |
devoluções |
---|
boolean | true se o usuário foi interrompido com êxito. |
stopUser
public boolean stopUser (int userId)
Interrompe um determinado usuário. Se o usuário já estiver parado, esse 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 êxito. |
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 : true se o microdroid for executado na 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. Falso caso contrário. |
mudar de utilizador
public boolean switchUser (int userId,
long timeout)
Alterne para outro userId com o tempo limite fornecido como prazo. Tentativa de desabilitar a proteção do teclado após a alteração do usuário ser bem-sucedida.
Parâmetros |
---|
userId | int |
timeout | long : para esperar antes de retornar false para switch-user falhou. |
devoluções |
---|
boolean | Verdadeiro se o novo userId corresponder ao provedor userId. Falso caso contrário. |
takebugreport
public Bugreport takeBugreport ()
Pegue um relatório de bug e o retorne dentro de um objeto Bugreport
para tratá-lo. Retorna nulo em caso de emissão. O arquivo referenciado no objeto Bugreport precisa ser limpo por meio de Bugreport.close()
.
pacote de desinstalação
public String uninstallPackage (String packageName)
Desinstale um pacote Android do dispositivo.
Parâmetros |
---|
packageName | String : o pacote do Android a ser desinstalado |
devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedida. |
desinstalarPacoteForUser
public String uninstallPackageForUser (String packageName,
int userId)
Desinstale 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 de usuário inteiro para desinstalar. |
devoluções |
---|
String | uma String com um código de erro ou null se for bem-sucedida. |
Métodos protegidos
criarParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Execute uma reinicialização 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 teste
prePostBootSetup
protected void prePostBootSetup ()
Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) substitua esse método para configuração específica de 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 2023-07-19 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 2023-07-19 UTC.",
"state": ""
}