Tenta novamente comandos de dispositivo por um valor configurável e fornece uma interface de recuperação de dispositivo para dispositivos que não respondem.
Classes aninhadas |
---|
class | ITestDevice.ApexInfo Uma classe struct simples para armazenar informações sobre um único APEX |
class | ITestDevice.MountPointInfo Uma classe struct simples para armazenar informações sobre um único ponto de montagem |
Métodos públicos |
---|
abstract boolean | canSwitchToHeadlessSystemUser () Retorna se é permitido alternar para o usuário headless SYSTEM. |
abstract boolean | checkConnectivity () Verifique se o dispositivo tem conectividade de rede. |
abstract boolean | clearErrorDialogs () Tente descartar todas as caixas de diálogo de erro atualmente exibidas na interface do usuário do dispositivo. |
abstract void | clearLastConnectedWifiNetwork () Limpa a última rede wi-fi conectada. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) Conecta-se a uma rede wi-fi. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) Conecta-se a uma rede wi-fi. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) Conecta-se a uma rede wi-fi. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) Conecta-se a uma rede wi-fi. |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) Uma variante de connectToWifiNetwork(String, String) que só conecta se o dispositivo não tiver conectividade de rede no momento. |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) Uma variante de connectToWifiNetwork(String, String) que só conecta se o dispositivo não tiver conectividade de rede no momento. |
abstract int | createUser (String name) Crie um usuário com um determinado nome e sinalizadores padrão 0. |
abstract int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) Crie um usuário com um determinado nome e os sinalizadores fornecidos |
abstract int | createUser (String name, boolean guest, boolean ephemeral) Crie um usuário com um determinado nome e os sinalizadores fornecidos |
abstract int | createUserNoThrow (String name) Crie um usuário com um determinado nome e sinalizadores padrão 0. |
abstract void | deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Remove o IDeviceActionReceiver registrado. |
abstract void | disableKeyguard () Tenta desativar a proteção do teclado. |
abstract boolean | disableNetworkMonitor () Desativa o monitoramento de rede no dispositivo. |
abstract boolean | disconnectFromWifi () Desconecta de uma rede wi-fi. |
abstract boolean | doesFileExist (String deviceFilePath, int userId) Método auxiliar para determinar se o arquivo no dispositivo existe para um determinado usuário. |
abstract File | dumpHeap (String process, String devicePath) Tente despejar o heap do system_server. |
abstract boolean | enableNetworkMonitor () Ativa o monitoramento de rede no dispositivo. |
abstract | getActiveApexes () Busque as informações sobre os APEXes ativados no dispositivo. |
abstract | getAllSettings (String namespace) Retorna pares de valores-chave do namespace solicitado. |
abstract String | getAndroidId (int userId) Encontre e retorne o android-id associado a um userId, nulo se não for encontrado. |
abstract | getAndroidIds () Crie um mapa de IDs de Android encontrados correspondentes a IDs de usuário. |
abstract PackageInfo | getAppPackageInfo (String packageName) Busca informações sobre um pacote instalado no dispositivo. |
abstract | getAppPackageInfos () Busca informações de pacotes instalados no dispositivo. |
abstract InputStreamSource | getBugreport () Recupera um relatório de bug do dispositivo. |
abstract InputStreamSource | getBugreportz () Recupera um bugreportz do dispositivo. |
abstract DeviceFoldableState | getCurrentFoldableState () Retorna o estado dobrável atual do dispositivo ou nulo se alguns problemas ocorreram. |
abstract int | getCurrentUser () Retorna o id do usuário em execução atual. |
abstract | getFoldableStates () Retorna a lista de estados dobráveis no dispositivo. |
abstract | getInstalledPackageNames () Busque os nomes dos pacotes de aplicativos presentes no dispositivo. |
abstract String | getIpAddress () Obtém o endereço IP do dispositivo. |
abstract KeyguardControllerState | getKeyguardState () Retorne um objeto para obter o estado atual do keyguard ou nulo se não for compatível. |
abstract Integer | getMainUserId () Retorna o id do usuário principal. |
abstract | getMainlineModuleInfo () Obtenha as informações sobre os módulos principais instalados no dispositivo. |
abstract int | getMaxNumberOfRunningUsersSupported () Obtenha o número máximo de usuários em execução simultânea com suporte. |
abstract int | getMaxNumberOfUsersSupported () Obtenha o número máximo de usuários suportados. |
abstract TestDeviceOptions | getOptions () Busque as opções de teste para o dispositivo. |
abstract Integer | getPrimaryUserId () Retorna o ID do usuário primário. |
abstract InputStreamSource | getScreenshot () Captura uma captura de tela do dispositivo. |
abstract InputStreamSource | getScreenshot (String format, boolean rescale) Captura uma captura de tela do dispositivo. |
abstract InputStreamSource | getScreenshot (String format) Captura uma captura de tela do dispositivo. |
abstract InputStreamSource | getScreenshot (long displayId) Captura uma captura de tela do dispositivo com o ID de exibição fornecido. |
abstract String | getSetting (String namespace, String key) Consulte getSetting(int, String, String) e execute no usuário do sistema. |
abstract String | getSetting (int userId, String namespace, String key) Retorna o valor da configuração solicitada. |
abstract | getUninstallablePackageNames () Busque os nomes dos pacotes de aplicativos que podem ser desinstalados. |
abstract int | getUserFlags (int userId) Encontre e retorne os sinalizadores de um determinado usuário. |
abstract | getUserInfos () Obtém o mapa de useId para UserInfo no dispositivo. |
abstract int | getUserSerialNumber (int userId) Retorna o número de série associado ao userId se encontrado, -10000 nos demais casos. |
abstract boolean | hasFeature (String feature) Verifique se um recurso está disponível em um dispositivo. |
abstract String | installPackage (File packageFile, boolean reinstall, String... extraArgs) Instale um pacote Android no dispositivo. |
abstract String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Instale um pacote Android no dispositivo. |
abstract String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instale um pacote Android no dispositivo para um determinado usuário. |
abstract String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Instale um pacote Android no dispositivo para um determinado usuário. |
default String | installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um extra). |
default String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Instale um aplicativo Android feito de vários arquivos APK (um pacote dividido principal e extra) que estão no dispositivo Android. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um extra) para um determinado usuário. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um extra) para um determinado usuário. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) Instale um aplicativo Android feito de vários arquivos APK (um pacote dividido principal e extra) que estão no dispositivo Android. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Instale um aplicativo Android feito de vários arquivos APK (um pacote dividido principal e extra) que estão no dispositivo Android. |
abstract boolean | isHeadlessSystemUserMode () Retorna se o dispositivo usa o modo de usuário do sistema headless. |
abstract 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. |
abstract boolean | isMultiUserSupported () Determina se multiusuário é compatível. |
abstract boolean | isPackageInstalled (String packageName) Consulte o dispositivo para obter um determinado nome de pacote para verificar se ele está instalado ou não. |
abstract 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. |
abstract boolean | isUserRunning (int userId) Verifique se um determinado usuário está em execução. |
abstract boolean | isUserSecondary (int userId) Retorna se o usuário especificado é um usuário secundário de acordo com seus sinalizadores. |
abstract boolean | isUserVisible (int userId) Verifica se o usuário fornecido está visível. |
abstract boolean | isUserVisibleOnDisplay (int userId, int displayId) Verifica se o usuário fornecido está visível na exibição fornecida. |
abstract 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) . |
abstract boolean | isVisibleBackgroundUsersSupported () Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano. |
abstract boolean | isWifiEnabled () Teste se o wi-fi está ativado. |
abstract | listDisplayIds () Colete a lista de IDs de exibição disponíveis no dispositivo, conforme relatado por "Dumpsys SurfaceFlinger". |
abstract | listDisplayIdsForStartingVisibleBackgroundUsers () Obtém a lista de exibições que podem ser usadas para start a user visible in the background . |
abstract | listUsers () Obtém a lista de usuários no dispositivo. |
abstract boolean | logBugreport (String dataName, ITestLogger listener) Método auxiliar para obter um relatório de bug e registrá-lo para os repórteres. |
abstract void | registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Registra um IDeviceActionReceiver para este dispositivo. |
abstract 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. |
abstract void | removeOwners () Remova todos os proprietários de perfil de dispositivo existentes com o melhor esforço. |
abstract boolean | removeUser (int userId) Remova um determinado usuário do dispositivo. |
abstract boolean | setDeviceOwner (String componentName, int userId) Defina um componente de administração do dispositivo como proprietário do dispositivo em determinado usuário. |
abstract void | setSetting (String namespace, String key, String value) Consulte setSetting(int, String, String, String) e executado no usuário do sistema. |
abstract void | setSetting (int userId, String namespace, String key, String value) Adicione um valor de configuração ao namespace de um determinado usuário. |
abstract boolean | startUser (int userId) Inicia um determinado usuário em segundo plano se estiver parado no momento. |
abstract boolean | startUser (int userId, boolean waitFlag) Inicia um determinado usuário em segundo plano se estiver parado no momento. |
abstract 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). |
abstract boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Pare um determinado usuário. |
abstract boolean | stopUser (int userId) Interrompe um determinado usuário. |
abstract boolean | switchUser (int userId) Mude para outro userId com um tempo limite padrão. |
abstract boolean | switchUser (int userId, long timeout) Alterne para outro userId com o tempo limite fornecido como prazo. |
abstract Bugreport | takeBugreport () Pegue um relatório de bug e o retorne dentro de um objeto Bugreport para tratá-lo. |
abstract String | uninstallPackage (String packageName) Desinstale um pacote Android do dispositivo. |
abstract String | uninstallPackageForUser (String packageName, int userId) Desinstale um pacote Android do dispositivo para um determinado usuário. |
Métodos públicos
canSwitchToHeadlessSystemUser
public abstract boolean canSwitchToHeadlessSystemUser ()
Retorna se é permitido alternar para o usuário headless SYSTEM.
verificarConectividade
public abstract boolean checkConnectivity ()
Verifique se o dispositivo tem conectividade de rede.
devoluções |
---|
boolean | true se o dispositivo tiver uma conexão de rede funcionando, false overwise. |
clearErrorDialogs
public abstract 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. |
clearLastConnectedWifiNetwork
public abstract void clearLastConnectedWifiNetwork ()
Limpa a última rede wi-fi conectada. Isso deve ser chamado ao iniciar uma nova chamada para evitar a conexão com a rede wi-fi usada no teste anterior após a reinicialização do dispositivo.
connectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
Conecta-se a uma rede wi-fi.
Ativa o wifi e bloqueia até que uma conexão bem-sucedida seja feita com uma das redes wifi fornecidas no mapa wifiSsidToPsk. Depois que uma conexão é estabelecida, a instância tentará restaurá-la após cada reinicialização até que ITestDevice#disconnectFromWifi()
ou ITestDevice#clearLastConnectedWifiNetwork()
seja chamado.
Parâmetros |
---|
wifiSsidToPsk | : Um mapa de SSIDs wi-fi para senhas. |
scanSsid | boolean : se deve procurar por SSIDs ocultos para esta rede. |
devoluções |
---|
boolean | true se conectado à rede wi-fi com sucesso. false caso contrário |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
Conecta-se a uma rede wi-fi.
Ativa o wifi e bloqueia até que uma conexão bem-sucedida seja feita com uma das redes wifi fornecidas no mapa wifiSsidToPsk. Depois que uma conexão é estabelecida, a instância tentará restaurá-la após cada reinicialização até que ITestDevice#disconnectFromWifi()
ou ITestDevice#clearLastConnectedWifiNetwork()
seja chamado.
Parâmetros |
---|
wifiSsidToPsk | : Um mapa de SSIDs wi-fi para senhas. |
devoluções |
---|
boolean | true se conectado à rede wi-fi com sucesso. false caso contrário |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)
Conecta-se a uma rede wi-fi.
Liga o wi-fi e bloqueia até que uma conexão bem-sucedida seja feita com a rede wi-fi especificada. Depois que uma conexão é estabelecida, a instância tentará restaurá-la após cada reinicialização até que
ITestDevice#disconnectFromWifi()
ou
ITestDevice#clearLastConnectedWifiNetwork()
seja chamado.
Parâmetros |
---|
wifiSsid | String : o ssid wi-fi para se conectar |
wifiPsk | String : Senha PSK ou nula se não criptografada |
devoluções |
---|
boolean | true se conectado à rede wi-fi com sucesso. false caso contrário |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Conecta-se a uma rede wi-fi.
Liga o wi-fi e bloqueia até que uma conexão bem-sucedida seja feita com a rede wi-fi especificada. Depois que uma conexão é estabelecida, a instância tentará restaurá-la após cada reinicialização até que
ITestDevice#disconnectFromWifi()
ou
ITestDevice#clearLastConnectedWifiNetwork()
seja chamado.
Parâmetros |
---|
wifiSsid | String : o ssid wi-fi para se conectar |
wifiPsk | String : Senha PSK ou nula se não criptografada |
scanSsid | boolean : se deve procurar SSID oculto para esta rede. |
devoluções |
---|
boolean | true se conectado à rede wi-fi com sucesso. false caso contrário |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Uma variante de connectToWifiNetwork(String, String)
que só conecta se o dispositivo não tiver conectividade de rede no momento.
Parâmetros |
---|
scanSsid | boolean : se deve procurar SSID oculto para esta rede |
devoluções |
---|
boolean | true se conectado à rede wi-fi com sucesso. false caso contrário |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
Uma variante de connectToWifiNetwork(String, String)
que só conecta se o dispositivo não tiver conectividade de rede no momento.
devoluções |
---|
boolean | true se conectado à rede wi-fi com sucesso. false caso contrário |
criarusuário
public abstract 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 abstract 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 abstract 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 abstract 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 abstract 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)
desativarNetworkMonitor
public abstract boolean disableNetworkMonitor ()
Desativa o monitoramento de rede no dispositivo.
devoluções |
---|
boolean | true se o monitoramento for desabilitado com sucesso. false se falhou. |
desconectarDeWifi
public abstract boolean disconnectFromWifi ()
Desconecta de uma rede wi-fi.
Remove todas as redes da lista de redes conhecidas e desativa o wifi.
devoluções |
---|
boolean | true se desconectado da rede wi-fi com sucesso. false se a desconexão falhou. |
doesFileExist
public abstract 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 abstract 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. |
enableNetworkMonitor
public abstract boolean enableNetworkMonitor ()
Ativa o monitoramento de rede no dispositivo.
devoluções |
---|
boolean | true se o monitoramento for ativado com êxito. false se falhou. |
getActiveApexes
public abstract getActiveApexes ()
Busque as informações sobre os APEXes ativados no dispositivo.
getAllSettings
public abstract 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 suportado. |
getAndroidId
public abstract String getAndroidId (int userId)
Encontre e retorne o android-id associado a um userId, nulo se não for encontrado.
getAndroidIds
public abstract 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 abstract PackageInfo getAppPackageInfo (String packageName)
Busca informações sobre um pacote instalado no dispositivo.
Parâmetros |
---|
packageName | String |
getAppPackageInfos
public abstract getAppPackageInfos ()
Busca informações de pacotes instalados no dispositivo.
getbugreport
public abstract 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 abstract 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 abstract DeviceFoldableState getCurrentFoldableState ()
Retorna o estado dobrável atual do dispositivo ou nulo se alguns problemas ocorreram.
getCurrentUser
public abstract int getCurrentUser ()
Retorna o id do usuário em execução atual. Em caso de erro, retorna -10000.
getFoldableStates
public abstract getFoldableStates ()
Retorna a lista de estados dobráveis no dispositivo. Pode ser obtido com "cmd device_state print-states".
getInstalledPackageNames
public abstract getInstalledPackageNames ()
Busque os nomes dos pacotes de aplicativos presentes no dispositivo.
getIpAddress
public abstract String getIpAddress ()
Obtém o endereço IP do dispositivo.
devoluções |
---|
String | o endereço IP do dispositivo ou null se o dispositivo não tiver endereço IP |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
Retorne um objeto para obter o estado atual do keyguard ou nulo se não for suportado.
getMainUserId
public abstract 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 abstract getMainlineModuleInfo ()
Obtenha as informações sobre os módulos principais instalados no dispositivo.
public abstract 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 abstract 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 |
getOptions
public abstract TestDeviceOptions getOptions ()
Busque as opções de teste para o dispositivo.
getPrimaryUserId
public abstract 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 abstract InputStreamSource getScreenshot ()
Captura uma captura de tela do dispositivo.
obter captura de tela
public abstract 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 abstract 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 abstract 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 abstract 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 abstract 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 abstract 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.
getUserFlags
public abstract 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 abstract 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. |
lances |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
getUserSerialNumber
public abstract int getUserSerialNumber (int userId)
Retorna o número de série associado ao userId se encontrado, -10000 nos demais casos.
tem recurso
public abstract 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 abstract 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 executada |
extraArgs | String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis. |
devoluções |
---|
String | um ERROR(/String) com um código de erro ou null se for bem-sucedido. |
pacote de instalação
public abstract 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 | um ERROR(/String) com um código de erro ou null se for bem-sucedido. |
lances |
---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
| se a permissão de tempo de execução não for suportada pela plataforma no dispositivo. |
installPackageForUser
public abstract 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 | um ERROR(/String) com um código de erro ou null se for bem-sucedido. |
lances |
---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
| se a permissão de tempo de execução não for suportada pela plataforma no dispositivo. |
installPackageForUser
public abstract 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 realizada |
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 | um ERROR(/String) com um código de erro ou null se for bem-sucedido. |
instalarPacotes
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um extra). Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o apk em vários arquivos.
Parâmetros |
---|
packageFiles | : os arquivos apk locais |
reinstall | boolean : true se uma reinstalação deve ser executada |
extraArgs | String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis. |
devoluções |
---|
String | um ERROR(/String) com um código de erro ou null se for bem-sucedido. |
lances |
---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
| se a permissão de tempo de execução não for suportada pela plataforma no dispositivo. |
instalarPacotes
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Instale um aplicativo Android feito de vários arquivos APK (um pacote dividido principal e extra) que estão no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o apk em vários arquivos.
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 |
---|
packageFiles | : os caminhos de arquivo apk remoto 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 |
extraArgs | String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis. |
devoluções |
---|
String | um ERROR(/String) com um código de erro ou null se for bem-sucedido. |
lances |
---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
| se a permissão de tempo de execução não for suportada pela plataforma no dispositivo. |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um extra) para um determinado usuário. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o apk em vários arquivos.
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 |
---|
packageFiles | : os arquivos apk locais |
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 | um ERROR(/String) com um código de erro ou null se for bem-sucedido. |
lances |
---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
| se a permissão de tempo de execução não for suportada pela plataforma no dispositivo. |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um extra) para um determinado usuário. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o apk em vários arquivos.
Parâmetros |
---|
packageFiles | : os arquivos apk locais |
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 | um ERROR(/String) com um código de erro ou null se for bem-sucedido. |
lances |
---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
| se a permissão de tempo de execução não for suportada pela plataforma no dispositivo. |
instalarRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Instale um aplicativo Android feito de vários arquivos APK (um pacote dividido principal e extra) que estão no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o apk em vários arquivos.
Parâmetros |
---|
remoteApkPaths | : os caminhos do arquivo apk remoto |
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 | um ERROR(/String) com um código de erro ou null se for bem-sucedido. |
lances |
---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
| se a permissão de tempo de execução não for suportada pela plataforma no dispositivo. |
instalarRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Instale um aplicativo Android feito de vários arquivos APK (um pacote dividido principal e extra) que estão no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o apk em vários arquivos.
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 |
---|
remoteApkPaths | : os caminhos do arquivo apk remoto |
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 |
extraArgs | String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis. |
devoluções |
---|
String | um ERROR(/String) com um código de erro ou null se for bem-sucedido. |
lances |
---|
DeviceNotAvailableException | se a conexão com o dispositivo for perdida e não puder ser recuperada. |
| se a permissão de tempo de execução não for suportada pela plataforma no dispositivo. |
isHeadlessSystemUserMode
public abstract boolean isHeadlessSystemUserMode ()
Retorna se o dispositivo usa o modo de usuário do sistema headless.
isMainUserPermanentAdmin
public abstract 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 abstract boolean isMultiUserSupported ()
Determina se multiusuário é compatível.
devoluções |
---|
boolean | verdadeiro se multiusuário for suportado, falso caso contrário |
isPackageInstalled
public abstract 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 abstract 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 abstract 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 abstract 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 abstract 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 abstract 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 |
isWifiEnabled
public abstract boolean isWifiEnabled ()
Teste se o wi-fi está ativado.
Verifica se o wifi está ativado no dispositivo. Útil para confirmar o status do wi-fi antes de testes que não devem ser executados com wi-fi, por exemplo, testes de dados móveis.
devoluções |
---|
boolean | true se o wifi estiver ativado. false se desabilitado |
listDisplayIds
public abstract 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 abstract listDisplayIdsForStartingVisibleBackgroundUsers ()
Obtém a lista de exibições que podem ser usadas para start a user visible in the background
.
listarUsuários
public abstract 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. |
lances |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
log Bugreport
public abstract 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. |
registerDeviceActionReceiver
public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registra um IDeviceActionReceiver
para este dispositivo.
Todos os IDeviceActionReceiver
s registrados serão notificados antes do início de uma ação do dispositivo e após o término da ação do dispositivo.
removeAdmin
public abstract 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 abstract void removeOwners ()
Remova todos os proprietários de perfil de dispositivo existentes com o melhor esforço.
removeUser
public abstract 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 abstract 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 abstract 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 abstract void setSetting (int userId,
String namespace,
String key,
String value)
Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}
Parâmetros |
---|
userId | int |
namespace | String |
key | String |
value | String |
startUser
public abstract boolean startUser (int userId)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.
Parâmetros |
---|
userId | int : of the user to start in the background |
devoluções |
---|
boolean | true if the user was successfully started in the background. |
startUser
public abstract boolean startUser (int userId,
boolean waitFlag)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.
Parâmetros |
---|
userId | int : of the user to start in the background |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
devoluções |
---|
boolean | true if the user was successfully started in the background. |
startVisibleBackgroundUser
public abstract boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).
NOTE: this command doesn't check if the user exists, display is available, device supports such feature
, etc.
Parâmetros |
---|
userId | int : of the user to start in the background |
displayId | int : display to start user visible on |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
devoluções |
---|
boolean | true if the user was successfully started visible in the background. |
stopUser
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.
Parâmetros |
---|
userId | int : of the user to stop. |
waitFlag | boolean : will make the command wait until user is stopped. |
forceFlag | boolean : will force stop the user. |
devoluções |
---|
boolean | true if the user was successfully stopped. |
stopUser
public abstract boolean stopUser (int userId)
Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.
Parâmetros |
---|
userId | int : of the user to stop. |
devoluções |
---|
boolean | true if the user was successfully stopped. |
switchUser
public abstract boolean switchUser (int userId)
Switch to another userId with a default timeout. switchUser(int, long)
.
devoluções |
---|
boolean | True if the new userId matches the userId provider. False otherwise. |
switchUser
public abstract boolean switchUser (int userId,
long timeout)
Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.
Parâmetros |
---|
userId | int |
timeout | long : to wait before returning false for switch-user failed. |
devoluções |
---|
boolean | True if the new userId matches the userId provider. False otherwise. |
takeBugreport
public abstract Bugreport takeBugreport ()
Take a bugreport and returns it inside a Bugreport
object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close()
.
uninstallPackage
public abstract String uninstallPackage (String packageName)
Uninstall an Android package from device.
Parâmetros |
---|
packageName | String : the Android package to uninstall |
devoluções |
---|
String | a ERROR(/String) with an error code, or null if success. |
uninstallPackageForUser
public abstract String uninstallPackageForUser (String packageName,
int userId)
Uninstall an Android package from device for a given user.
Parâmetros |
---|
packageName | String : the Android package to uninstall |
userId | int : the integer user id to uninstall for. |
devoluções |
---|
String | a ERROR(/String) with an error code, or null if success. |
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-04-28 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"
}]