ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


Fornece uma API confiável e de nível ligeiramente superior para um IDevice ddmlib.

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.

Resumo

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 mudar para o usuário SYSTEM sem cabeça.

abstract boolean checkConnectivity ()

Verifique se o dispositivo tem conectividade de rede.

abstract boolean clearErrorDialogs ()

Tente descartar quaisquer caixas de diálogo de erro exibidas atualmente na IU do dispositivo.

abstract void clearLastConnectedWifiNetwork ()

Limpa a última rede wifi conectada.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Conecta-se a uma rede wi-fi.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

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ó se conecta se o dispositivo atualmente não tiver conectividade de rede.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

Uma variante de connectToWifiNetwork(String, String) que só se conecta se o dispositivo atualmente não tiver conectividade de rede.

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)

Crie um usuário com um determinado nome e os sinalizadores fornecidos

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 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 ()

Tentativas de desativar a proteção do teclado.

abstract boolean disableNetworkMonitor ()

Desativa o monitoramento de rede no dispositivo.

abstract boolean disconnectFromWifi ()

Desconecta de uma rede wifi.

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 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 que correspondam aos IDs de usuário.

abstract PackageInfo getAppPackageInfo (String packageName)

Busque informações sobre um pacote instalado no dispositivo.

abstract getAppPackageInfos ()

Busque 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 ocorrerem alguns problemas.

abstract int getCurrentUser ()

Retorne 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 com suporte em execução simultânea.

abstract int getMaxNumberOfUsersSupported ()

Obtenha o número máximo de usuários com suporte.

abstract TestDeviceOptions getOptions ()

Busque as opções de teste para o dispositivo.

abstract Integer getPrimaryUserId ()

Retorna o ID do usuário principal.

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.

abstract InputStreamSource getScreenshot ()

Captura uma captura de tela do dispositivo.

abstract String getSetting (int userId, String namespace, String key)

Retorne o valor da configuração solicitada.

abstract String getSetting (String namespace, String key)

Veja getSetting(int, String, String) e executado no usuário do sistema.

abstract getUninstallablePackageNames ()

Obtenha 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)

Retorne o número de série associado ao userId se encontrado, -10000 em qualquer outro caso.

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, int userId, String... extraArgs)

Instale um pacote Android no dispositivo para um determinado usuário.

abstract String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, 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 pacote dividido 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 principal e um pacote dividido extra) que estão no dispositivo Android.

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 pacote dividido extra) para um determinado usuário.

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 pacote dividido 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 principal e um pacote dividido 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 principal e um pacote dividido 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 há suporte para vários usuários.

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 isPackageInstalled (String packageName)

Consulte o dispositivo para obter um determinado nome de pacote para verificar se ele está instalado ou não.

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 determinado está visível.

abstract boolean isUserVisibleOnDisplay (int userId, int displayId)

Verifica se o usuário determinado está visível na exibição especificada.

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 wifi 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 aos repórteres.

default void notifySnapuserd ( SnapuserdWaitPhase waitPhase)

Notifique o dispositivo para aguardar a conclusão do snapuserd.

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Registra um IDeviceActionReceiver para este dispositivo.

abstract 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 .

abstract void removeOwners ()

Remova todos os proprietários de perfis de dispositivos 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)

Veja 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 ele estiver parado no momento.

abstract boolean startUser (int userId, boolean waitFlag)

Inicia um determinado usuário em segundo plano se ele estiver parado no momento.

abstract 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).

abstract boolean stopUser (int userId)

Interrompe um determinado usuário.

abstract boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)

Pare 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)

Mude para outro userId com o tempo limite fornecido como prazo.

abstract Bugreport takeBugreport ()

Pegue um relatório de bug e retorne-o 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.

default void waitForSnapuserd ( SnapuserdWaitPhase currentPhase)

Se esperado, aguarde a conclusão do snapuserd.

Métodos públicos

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Retorna se é permitido mudar para o usuário SYSTEM sem cabeça.

Devoluções
boolean

Lança
DeviceNotAvailableException

verificar conectividade

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 caso contrário.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

clearErrorDialogs

public abstract 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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

limparLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Limpa a última rede wifi conectada. Deve ser chamado ao iniciar uma nova invocação para evitar a conexão à rede wifi usada no teste anterior após a reinicialização do dispositivo.

conectarToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Conecta-se a uma rede wi-fi.

Liga o wifi e bloqueia até que uma conexão bem-sucedida seja feita com uma das redes wifi fornecidas no mapa wifiSsidToPsk. Assim que a conexão for 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 wifi para senhas.

Devoluções
boolean true se conectado à rede wifi com sucesso. false caso contrário

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

conectarToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Conecta-se a uma rede wi-fi.

Liga o wifi e bloqueia até que uma conexão bem-sucedida seja feita com uma das redes wifi fornecidas no mapa wifiSsidToPsk. Assim que a conexão for 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 wifi para senhas.

scanSsid boolean : se deve procurar SSIDs ocultos para esta rede.

Devoluções
boolean true se conectado à rede wifi com sucesso. false caso contrário

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

conectarToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Conecta-se a uma rede wi-fi.

Ativa o Wi-Fi e bloqueia até que uma conexão bem-sucedida seja feita à rede Wi-Fi especificada. Assim que a conexão for 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 do wifi ao qual se conectar

wifiPsk String : senha PSK ou nula se não criptografada

Devoluções
boolean true se conectado à rede wifi com sucesso. false caso contrário

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

conectarToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Conecta-se a uma rede wi-fi.

Ativa o Wi-Fi e bloqueia até que uma conexão bem-sucedida seja feita à rede Wi-Fi especificada. Assim que a conexão for 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 do wifi ao qual 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 wifi com sucesso. false caso contrário

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Uma variante de connectToWifiNetwork(String, String) que só se conecta se o dispositivo atualmente não tiver conectividade de rede.

Parâmetros
scanSsid boolean : se deve procurar SSID oculto para esta rede

Devoluções
boolean true se conectado à rede wifi com sucesso. false caso contrário

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Uma variante de connectToWifiNetwork(String, String) que só se conecta se o dispositivo atualmente não tiver conectividade de rede.

Devoluções
boolean true se conectado à rede wifi com sucesso. false caso contrário

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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 : 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

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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 : 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

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

cancelar registroDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Remove o IDeviceActionReceiver registrado.

Parâmetros
deviceActionReceiver IDeviceActionReceiver : Um IDeviceActionReceiver que será removido.

desabilitarKeyguard

public abstract 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)

Lança
DeviceNotAvailableException

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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

desconectarFromWifi

public abstract boolean disconnectFromWifi ()

Desconecta de uma rede wifi.

Remove todas as redes da lista de redes conhecidas e desativa o wifi.

Devoluções
boolean true se desconectado da rede wifi com sucesso. false se a desconexão falhou.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

fazFileExist

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 para verificar a existência do arquivo

Devoluções
boolean true se o arquivo existir, false caso contrário.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

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 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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

habilitarNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Ativa o monitoramento de rede no dispositivo.

Devoluções
boolean true se o monitoramento for habilitado com êxito. false se falhou.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

getActiveApexes

public abstract  getActiveApexes ()

Busque as informações sobre APEXes ativados no dispositivo.

Devoluções
ERROR(/Set) do ApexInfo atualmente ativado no dispositivo

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obterAndroidId

public abstract String getAndroidId (int userId)

Encontre e retorne o android-id associado a um userId, nulo se não for encontrado.

Parâmetros
userId int

Devoluções
String

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obterAndroidIds

public abstract  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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Busque informações sobre um pacote instalado no dispositivo.

Parâmetros
packageName String

Devoluções
PackageInfo o PackageInfo ou null se as informações não puderem ser recuperadas

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Busque informações de pacotes instalados no dispositivo.

Devoluções
ERROR(/List) de PackageInfo s instalados no dispositivo.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract 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).

Devoluções
InputStreamSource Um InputStreamSource que produzirá o conteúdo do relatório de bug sob demanda. Em caso de falha, o InputStreamSource produzirá um ERROR(/InputStream) vazio.

getBugreportz

public abstract 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

Devoluções
InputStreamSource um InputStreamSource do arquivo zip que contém o bugreportz, retorna nulo em caso de falha.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

Retorna o estado dobrável atual do dispositivo ou nulo se ocorrerem alguns problemas.

Devoluções
DeviceFoldableState

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Retorne o ID do usuário em execução atual. Em caso de erro, retorne -10000.

Devoluções
int

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

Retorna a lista de estados dobráveis ​​no dispositivo. Pode ser obtido com "cmd device_state print-states".

Devoluções

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Busque os nomes dos pacotes de aplicativos presentes no dispositivo.

Devoluções
ERROR(/Set) de nomes de pacotes String atualmente instalados no dispositivo.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Retorne um objeto para obter o estado atual do keyguard ou nulo se não for compatível.

Devoluções
KeyguardControllerState um KeyguardControllerState que contém um instantâneo do estado do keyguard e retorna Null se a consulta Keyguard não for suportada.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

getMainUserId

public abstract 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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se a saída do dispositivo não for a esperada.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsers suportados

public abstract 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

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsers suportados

public abstract 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

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOpções

public abstract TestDeviceOptions getOptions ()

Busque as opções de teste para o dispositivo.

Devoluções
TestDeviceOptions TestDeviceOptions relacionadas ao dispositivo em teste.

getPrimaryUserId

public abstract 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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se a saída do dispositivo não for a esperada.
DeviceNotAvailableException

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 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

Devoluções
InputStreamSource um InputStreamSource da captura de tela em formato ou null se a captura de tela não tiver sido bem-sucedida.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obter captura de tela

public abstract 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

Devoluções
InputStreamSource um InputStreamSource da captura de tela em formato ou null se a captura de tela não tiver sido bem-sucedida.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obter captura de tela

public abstract 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.

Devoluções
InputStreamSource um InputStreamSource da captura de tela em formato ou null se a captura de tela não tiver sido bem-sucedida.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obter captura de tela

public abstract InputStreamSource getScreenshot ()

Captura uma captura de tela do dispositivo.

Devoluções
InputStreamSource um InputStreamSource da captura de tela no formato png ou null se a captura de tela não tiver sido bem-sucedida.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract 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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

Veja getSetting(int, String, String) e executado no usuário do sistema.

Parâmetros
namespace String

key String

Devoluções
String

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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.

Parâmetros
userId int

Devoluções
int os sinalizadores associados ao userId fornecido, se encontrado, -10000 em qualquer outro caso.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Retorne o número de série associado ao userId se encontrado, -10000 em qualquer outro caso.

Parâmetros
userId int

Devoluções
int

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

temRecurso

public abstract 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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

instalarPacote

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 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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

instalarPacote

public abstract 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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException se a permissão de tempo de execução não for suportada pela plataforma no dispositivo.

instalarPackageForUser

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 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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

instalarPackageForUser

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 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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException se a permissão de tempo de execução não for suportada pela plataforma no dispositivo.

instalar pacotes

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um pacote dividido 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 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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException se a permissão de tempo de execução não for suportada pela plataforma no dispositivo.

instalar pacotes

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um pacote dividido 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 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
packageFiles : os caminhos do arquivo apk remoto 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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException se a permissão de tempo de execução não for suportada pela plataforma no dispositivo.

instalarPackagesForUser

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 pacote dividido 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 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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException se a permissão de tempo de execução não for suportada pela plataforma no dispositivo.

instalarPackagesForUser

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 pacote dividido 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 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
packageFiles : os arquivos apk locais

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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException 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 principal e um pacote dividido 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 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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException 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 principal e um pacote dividido 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 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
remoteApkPaths : os caminhos do arquivo apk remoto

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.

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException 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.

Devoluções
boolean

Lança
DeviceNotAvailableException

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.

Devoluções
boolean

Lança
DeviceNotAvailableException

isMultiUserSupportado

public abstract 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

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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 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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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. Caso contrário, falso.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Verifique se um determinado usuário está em execução.

Parâmetros
userId int

Devoluções
boolean Verdadeiro se o usuário estiver em execução, falso em todos os outros casos.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

Retorna se o usuário especificado é um usuário secundário de acordo com seus sinalizadores.

Parâmetros
userId int

Devoluções
boolean verdadeiro se o usuário for secundário; caso contrário, falso.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract 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).

Parâmetros
userId int

Devoluções
boolean

Lança
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract 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

Devoluções
boolean

Lança
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public 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) .

Nesse caso, você pode chamar startVisibleBackgroundUser(int, int, boolean) , passando uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers() (que deve incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

Devoluções
boolean

Lança
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano.

Nesse caso, você pode chamar startVisibleBackgroundUser(int, int, boolean) , passando uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers() .

Devoluções
boolean

Lança
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Teste se o wifi está ativado.

Verifica se o wifi está habilitado no dispositivo. Útil para afirmar o status do wifi antes de testes que não deveriam ser executados com wifi, por exemplo, testes de dados móveis.

Devoluções
boolean true se o wifi estiver ativado. false se desabilitado

Lança
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

listaDisplayIds

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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Obtém a lista de exibições que podem ser usadas para start a user visible in the background .

Devoluções

Lança
DeviceNotAvailableException

listaUsuá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ário.

Lança
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract 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)

Notifique o dispositivo para aguardar a conclusão do snapuserd.

Parâmetros
waitPhase SnapuserdWaitPhase

registrarDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra um IDeviceActionReceiver para este dispositivo.

Todos IDeviceActionReceiver 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.

Parâmetros
deviceActionReceiver IDeviceActionReceiver : Um IDeviceActionReceiver que será registrado.

removerAdmin

public abstract 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.

Lança
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removerProprietários

public abstract void removeOwners ()

Remova todos os proprietários de perfil de dispositivo existentes com o melhor esforço.

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

Remover

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 É verdade que se tivéssemos sucesso na remoção do usuário, false caso contrário.

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

SetDevicewner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Defina um componente de administrador do dispositivo como proprietário do dispositivo em determinado usuário.

Parâmetros
componentName String : do administrador do dispositivo para ser proprietário do dispositivo.

userId int : do usuário em que o proprietário do dispositivo mora.

Devoluções
boolean É verdade se for bem -sucedido, false caso contrário.

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

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

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

SetSetting

public abstract void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Adicione um valor de configuração ao espaço para nome de um determinado usuário. Algumas configurações só estarão disponíveis após uma reinicialização. o espaço para nome deve ser um dos: {"System", "Secure", "Global"}

Parâmetros
userId int

namespace String

key String

value String

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

StartUser

public abstract boolean startUser (int userId)

Inicia um determinado usuário em segundo plano se estiver parado atualmente. Se o usuário já estiver em execução em segundo plano, esse método é um Noop.

Parâmetros
userId int : do usuário para começar em segundo plano

Devoluções
boolean Verdadeiro se o usuário foi iniciado com sucesso em segundo plano.

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

StartUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Inicia um determinado usuário em segundo plano se estiver parado atualmente. Se o usuário já estiver em execução 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 começar em segundo plano

waitFlag boolean : fará o comando esperar até que o usuário seja iniciado e desbloqueado.

Devoluções
boolean Verdadeiro se o usuário foi iniciado com sucesso em segundo plano.

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

StartVisibleBackgroundUser

public 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 as atividades nessa exibição).

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 começar 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 sucesso visível em segundo plano.

Lança
DeviceNotAvailableException

StopUser

public abstract 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 Verdadeiro se o usuário foi interrompido com sucesso.

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

StopUser

public abstract 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 término 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 Verdadeiro se o usuário foi interrompido com sucesso.

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

mudar de utilizador

public abstract boolean switchUser (int userId)

Mude para outro ID do usuário com um tempo limite padrão. switchUser(int, long) .

Parâmetros
userId int

Devoluções
boolean Verdadeiro se o novo UserID corresponder ao provedor do usuário do usuário. Caso contrário, falso.

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

mudar de utilizador

public abstract boolean switchUser (int userId, 
                long timeout)

Mude para outro ID do usuário com o tempo limite fornecido como prazo. Tente desativar o Keyguard depois que a mudança do usuário for bem -sucedida.

Parâmetros
userId int

timeout long : esperar antes de retornar false para o usuário do interruptor falhou.

Devoluções
boolean Verdadeiro se o novo UserID corresponder ao provedor do usuário do usuário. Caso contrário, falso.

Lança
com.android.tradefed.device.DeviceNotAvilableException
DeviceNotAvailableException

Takebugreport

public abstract Bugreport takeBugreport ()

Pegue um relatório de bugs e o retorne dentro de um objeto Bugreport para lidar com ele. Retorne nulo em caso de emissão. O arquivo referenciado no objeto BugReport precisa ser limpo via Bugreport.close() .

Devoluções
Bugreport

desinstalepackage

public abstract String uninstallPackage (String packageName)

Desinstale um pacote Android do dispositivo.

Parâmetros
packageName String : o pacote Android para desinstalar

Devoluções
String uma String com um código de erro ou null se o sucesso.

Lança
DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

desinstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Desinstale um pacote Android do dispositivo para um determinado usuário.

Parâmetros
packageName String : o pacote Android para desinstalar

userId int : O ID do usuário inteiro para desinstalar.

Devoluções
String uma String com um código de erro ou null se o sucesso.

Lança
DeviceNotAvailableException Se a conexão com o dispositivo for perdida e não puder ser recuperada.

waitforsnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Se esperado, aguarde a conclusão do Snapuserd.

Parâmetros
currentPhase SnapuserdWaitPhase

Lança
DeviceNotAvailableException