ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Fornece uma API confiável e de nível um pouco mais alto para uma ddmlib IDevice.

Tenta novamente comandos do dispositivo por um valor configurável e fornece uma interface de recuperação para dispositivos que não respondem.

Resumo

Classes aninhadas

class ITestDevice.ApexInfo

Uma classe de estrutura simples para armazenar informações sobre um único APEX

class ITestDevice.MountPointInfo

Uma classe de 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 do sistema sem cabeça.

abstract boolean checkConnectivity()

Verifique se o dispositivo tem conectividade de rede.

abstract boolean clearErrorDialogs()

Tente dispensar as caixas de diálogo de erro exibidas na interface do dispositivo.

abstract void clearLastConnectedWifiNetwork()

Limpa a última rede Wi-Fi conectada.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

Conecta-se a uma rede Wi-Fi.

abstract boolean 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 não tiver conectividade de rede no momento.

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

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

abstract int createUser(String name)

Crie um usuário com um nome e flags padrão 0.

abstract int createUser(String name, boolean guest, boolean ephemeral)

Criar um usuário com um nome e as flags fornecidas

abstract int createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)

Criar um usuário com um nome e as flags fornecidas

abstract int createUserNoThrow(String name)

Crie um usuário com um nome e flags padrão 0.

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Remove o IDeviceActionReceiver registrado.

abstract void disableKeyguard()

Tenta desativar o bloqueio de 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)

Tenta despejar a pilha do system_server.

abstract boolean enableNetworkMonitor()

Ativa o monitoramento de rede no dispositivo.

abstract getActiveApexes()

Busca as informações sobre os APEXes ativados no dispositivo.

abstract getAllSettings(String namespace)

Retorna pares de chave-valor do namespace solicitado.

abstract String getAndroidId(int userId)

Encontra e retorna o Android-ID associado a um userId, nulo se não encontrado.

abstract getAndroidIds()

Crie um mapa de IDs do Android encontrados que correspondem aos IDs do usuário.

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract getAppPackageInfos()

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

Busca os nomes dos pacotes de aplicativos presentes no dispositivo.

abstract String getIpAddress()

Recebe o endereço IP do dispositivo.

abstract KeyguardControllerState getKeyguardState()

Retorna um objeto para conferir o estado atual do bloqueio de teclado ou nulo, se não houver suporte.

abstract Integer getMainUserId()

Retorna o ID do usuário principal.

abstract getMainlineModuleInfo()

Receber informações sobre os módulos principais instalados no dispositivo.

abstract int getMaxNumberOfRunningUsersSupported()

Receba o número máximo de usuários em execução simultaneamente com suporte.

abstract int getMaxNumberOfUsersSupported()

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

abstract TestDeviceOptions getOptions()

Buscar as opções de teste do dispositivo.

abstract Integer getPrimaryUserId()

Este método foi descontinuado. getPrimaryUser foi descontinuado do serviço UserManager. Use ERROR(/android.os.UserManager#getMainUserId()) para acessar o primeiro usuário completo ou 0 para o sistema. Para sistemas sem cabeça, não é um usuário completo.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

Faz uma captura de tela do dispositivo.

abstract InputStreamSource getScreenshot(long displayId)

Faz uma captura de tela do ID de exibição fornecido do dispositivo.

abstract InputStreamSource getScreenshot(String format)

Faz uma captura de tela do dispositivo.

abstract InputStreamSource getScreenshot()

Faz uma captura de tela do dispositivo.

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

Retorna o valor da configuração solicitada.

abstract String getSetting(String namespace, String key)

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

abstract getUninstallablePackageNames()

Busca os nomes dos pacotes de aplicativos que podem ser desinstalados.

abstract int getUserFlags(int userId)

Encontre e retorne as flags de um determinado usuário.

abstract getUserInfos()

Recebe 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, ou -10000 em outros casos.

abstract boolean hasFeature(String feature)

Conferir se um recurso está disponível em um dispositivo.

abstract String installPackage(File packageFile, boolean reinstall, String... extraArgs)

Instale um pacote do Android no dispositivo.

abstract String installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

Instale um pacote do 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)

Instale um app Android feito de vários arquivos APK (um principal e pacotes divididos extras).

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

Instalar um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android.

default String installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)

Instale um aplicativo Android feito de vários arquivos APK (um principal e pacotes divididos extras) para um determinado usuário.

default String installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Instale um aplicativo Android feito de vários arquivos APK (um principal e pacotes divididos extras) para um determinado usuário.

default String installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android.

default String installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android.

abstract boolean isHeadlessSystemUserMode()

Retorna se o dispositivo usa o modo de usuário do sistema sem cabeça.

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)

Consultar o dispositivo para um determinado nome de pacote e ID do usuário para verificar se ele está instalado ou não para esse usuário.

abstract boolean isPackageInstalled(String packageName)

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

abstract boolean isUserRunning(int userId)

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

abstract boolean isUserSecondary(int userId)

Retorna se o usuário especificado é secundário de acordo com as flags.

abstract boolean isUserVisible(int userId)

Verifica se o usuário especificado está visível.

abstract boolean isUserVisibleOnDisplay(int userId, int displayId)

Verifica se o usuário está visível na tela.

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

Retorna se o dispositivo permite que os usuários sejam iniciados e apareçam no segundo plano no ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

Teste se o Wi-Fi está ativado.

abstract listDisplayIds()

Coletar a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys SurfaceFlinger".

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

Consegue a lista de telas que podem ser usadas para start a user visible in the background.

abstract listUsers()

Recebe a lista de usuários no dispositivo.

abstract boolean logBugreport(String dataName, ITestLogger listener)

Método auxiliar para registrar um relatório de bug para os repórteres.

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

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

Remove o administrador do dispositivo especificado no usuário especificado e retorna true se for bem-sucedido, false caso contrário.

abstract void removeOwners()

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

abstract boolean removeUser(int userId)

Remover um determinado usuário do dispositivo.

abstract boolean setDeviceOwner(String componentName, int userId)

Define um componente de administrador do dispositivo como proprietário do dispositivo no usuário especificado.

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

abstract boolean startUser(int userId, boolean waitFlag)

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

abstract boolean startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)

Inicia um determinado usuário em segundo plano, visível na tela especificada (ou seja, permitindo que o usuário inicie atividades nessa tela).

abstract boolean stopUser(int userId)

Interrompe um determinado usuário.

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

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

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

abstract Bugreport takeBugreport()

Retorna um bugreport dentro de um objeto Bugreport para processá-lo.

abstract String uninstallPackage(String packageName)

Desinstalar um pacote do Android do dispositivo.

abstract String uninstallPackageForUser(String packageName, int userId)

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

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Se esperado, aguarde o snapuserd ser concluído.

Métodos públicos

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Retorna se é permitido alternar para o usuário do sistema sem cabeça.

Retorna
boolean

Gera
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

Verifique se o dispositivo tem conectividade de rede.

Retorna
boolean true se o dispositivo tiver uma conexão de rede ativa, false caso contrário.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Tente dispensar as caixas de diálogo de erro exibidas na interface do dispositivo.

Retorna
boolean true se nenhuma caixa de diálogo estiver presente ou se ela tiver sido limpa. false se não forem.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Limpa a última rede Wi-Fi conectada. Ele precisa ser chamado ao iniciar uma nova invocação 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)

Conecta-se a uma rede Wi-Fi.

Ativa o Wi-Fi e bloqueia até que uma conexão seja estabelecida com uma das redes Wi-Fi fornecidas no mapa wifiSsidToPsk. Depois que uma conexão for estabelecida, a instância vai tentar restaurar a conexão após cada reinicialização até que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsidToPsk : um mapa de SSIDs de Wi-Fi para senhas.
Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Conecta-se a uma rede Wi-Fi.

Ativa o Wi-Fi e bloqueia até que uma conexão seja estabelecida com uma das redes Wi-Fi fornecidas no mapa wifiSsidToPsk. Depois que uma conexão for estabelecida, a instância vai tentar restaurar a conexão após cada reinicialização até que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsidToPsk : um mapa de SSIDs de Wi-Fi para senhas.
scanSsid boolean: se a verificação de SSIDs ocultos para essa rede será feita.
Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

connectToWifiNetwork

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 seja estabelecida com a rede Wi-Fi especificada. Depois que uma conexão é estabelecida, a instância tenta restaurar a conexão após cada reinicialização até que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsid String: o SSID do Wi-Fi a ser conectado
wifiPsk String: frase de acesso PSK ou nulo se não for criptografada
Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

connectToWifiNetwork

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 seja estabelecida com a rede Wi-Fi especificada. Depois que uma conexão é estabelecida, a instância tenta restaurar a conexão após cada reinicialização até que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsid String: o SSID do Wi-Fi a ser conectado
wifiPsk String: frase de acesso PSK ou nulo se não for criptografada
scanSsid boolean: se a verificação de SSID ocultos para essa rede será feita.
Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário
Gera
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 não tiver conectividade de rede no momento.

Parâmetros
scanSsid boolean: se a verificação de SSID ocultos para essa rede será feita
Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário
Gera
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 não tiver conectividade de rede no momento.

Retorna
boolean true se conectado à rede Wi-Fi. false caso contrário
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

Crie um usuário com um nome e flags padrão 0.

Parâmetros
name String: o nome do usuário a ser criado no dispositivo
Retorna
int o número inteiro do ID do usuário criado
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Criar um usuário com um nome e as flags fornecidas

Parâmetros
name String: o nome do usuário a ser criado no dispositivo
guest boolean: ativar a flag de usuário --guest durante a criação
ephemeral boolean: ativar a flag do usuário --ephemeral durante a criação
Retorna
int ID do usuário criado
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Criar um usuário com um nome e as flags fornecidas

Parâmetros
name String: o nome do usuário a ser criado no dispositivo
guest boolean: ativar a flag de usuário --guest durante a criação
ephemeral boolean: ativar a flag do usuário --ephemeral durante a criação
forTesting boolean: ativar a flag de teste --for-testing durante a criação
Retorna
int ID do usuário criado
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

Crie um usuário com um nome e flags padrão 0.

Parâmetros
name String: o nome do usuário a ser criado no dispositivo
Retorna
int O número inteiro do ID do usuário criado ou -1 para erro.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Remove o IDeviceActionReceiver registrado.

Parâmetros
deviceActionReceiver IDeviceActionReceiver: uma IDeviceActionReceiver que será removida.

disableKeyguard

public abstract void disableKeyguard ()

Tenta desativar o bloqueio de teclado.

Primeiro, aguarde o envio de entrada ficar pronto. Isso acontece na mesma hora em que o dispositivo informa BOOT_COMPLETE, aparentemente de forma assíncrona, porque a implementação atual do framework tem uma condição de corrida ocasional. O comando é enviado para dispensar o bloqueio de tela (funciona apenas em telas não seguras).

Gera
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Desativa o monitoramento de rede no dispositivo.

Retorna
boolean true se o monitoramento for desativado. false se ela falhar.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

Desconecta de uma rede Wi-Fi.

Remove todas as redes da lista de redes conhecidas e desativa o Wi-Fi.

Retorna
boolean true se desconectado da rede Wi-Fi. false se a desconexão falhar.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

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 para verificar a existência do arquivo
Retorna
boolean true se o arquivo existir, false caso contrário.
Gera
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)

Tenta despejar a pilha do system_server. É responsabilidade do autor da chamada limpar o arquivo descartado.

Parâmetros
process String: o nome do processo do dispositivo em que o dumpheap será usado.
devicePath String: o caminho no dispositivo em que o despejo será colocado. Ele precisa ser um local em que as permissões sejam permitidas.
Retorna
File o ERROR(/File) que contém o relatório. Valor nulo se algo falhar.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Ativa o monitoramento de rede no dispositivo.

Retorna
boolean true se o monitoramento for ativado. false se ela falhar.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

getActiveApexes

public abstract  getActiveApexes ()

Busca as informações sobre os APEXes ativados no dispositivo.

Retorna
ERROR(/Set) de ApexInfo ativados no momento no dispositivo
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

Retorna pares de chave-valor do namespace solicitado.

Parâmetros
namespace String: precisa ser um dos valores {"system", "secure", "global"}
Retorna
o mapa de pares de chave-valor. Valor nulo se o namespace não tiver suporte.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Encontra e retorna o Android-ID associado a um userId, nulo se não encontrado.

Parâmetros
userId int

Retorna
String

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Crie um mapa de IDs do Android encontrados que correspondem aos IDs do usuário. Não há garantia de que cada ID do usuário vai encontrar um ID do Android associado a essa função. Portanto, alguns IDs do usuário podem corresponder a "null".

Retorna
Mapa de IDs do Android encontrados que correspondem aos IDs de usuário.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Parâmetros
packageName String

Retorna
PackageInfo o PackageInfo ou null se as informações não puderem ser recuperadas
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Buscar informações de pacotes instalados no dispositivo.

Retorna
ERROR(/List) de PackageInfos instalados no dispositivo.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Recupera um relatório de bug do dispositivo.

A implementação desse recurso garante que ele continue funcionando em um dispositivo sem um cartão SD (ou em que o cartão SD ainda não foi montado).

Retorna
InputStreamSource Um InputStreamSource que vai produzir o conteúdo do relatório de bug sob demanda. Em caso de falha, o InputStreamSource vai produzir um ERROR(/InputStream) vazio.

getBugreportz

public abstract InputStreamSource getBugreportz ()

Recupera um bugreportz do dispositivo. O relatório de bug no formato ZIP contém o relatório principal e outros arquivos de registro úteis para depuração.

Compatível apenas com a versão do adb > 1.0.36.

Retorna
InputStreamSource Um InputStreamSource do arquivo ZIP que contém o bugreportz, retorna null em caso de falha.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Retorna
DeviceFoldableState

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

Retorna
int

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

Retorna
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Busca os nomes dos pacotes de aplicativos presentes no dispositivo.

Retorna
ERROR(/Set) dos nomes de pacotes String instalados no dispositivo.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Recebe o endereço IP do dispositivo.

Retorna
String o endereço IP do dispositivo ou null se ele não tiver um endereço IP
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Retorna um objeto para conferir o estado atual do bloqueio de teclado ou nulo, se não houver suporte.

Retorna
KeyguardControllerState um KeyguardControllerState que contém um snapshot do estado da proteção de tela e retorna "Null" se a consulta de proteção de tela não tiver suporte.
Gera
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.

Retorna
Integer o userId do usuário principal, se houver um, e nulo, se não houver.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se a saída do dispositivo não for a esperada.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Receber informações sobre os módulos principais instalados no dispositivo.

Retorna
ERROR(/Set) dos módulos principais String instalados no dispositivo.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Receba o número máximo de usuários em execução simultaneamente com suporte. O valor padrão é 0.

Retorna
int um número inteiro que indica o número de usuários em execução simultaneamente
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Receba o número máximo de usuários com suporte. O valor padrão é 0.

Retorna
int um número inteiro que indica o número de usuários com suporte
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Buscar as opções de teste do dispositivo.

Retorna
TestDeviceOptions TestDeviceOptions relacionado ao dispositivo em teste.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Este método foi descontinuado.
getPrimaryUser foi descontinuado do serviço UserManager. Use ERROR(/android.os.UserManager#getMainUserId()) para acessar o primeiro usuário completo ou 0 para o sistema. Para sistemas sem cabeça, não é um usuário completo.

Retorna o ID do usuário principal.

Retorna
Integer o userId do usuário principal, se houver um, e nulo, se não houver.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se a saída do dispositivo não for a esperada.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Faz uma captura de tela do dispositivo. Recomendamos o uso de getScreenshot(String) com codificação JPEG para tamanhos menores.

Parâmetros
format String: PNG, JPEG com suporte
rescale boolean: se a captura de tela precisa ser redimensionada para reduzir o tamanho da imagem resultante
Retorna
InputStreamSource uma InputStreamSource da captura de tela no formato ou null se a captura de tela não foi bem-sucedida.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Faz uma captura de tela do ID de exibição fornecido do dispositivo. O formato é PNG.

TODO: estender as implementações acima para oferecer suporte a "format" e "rescale"

Parâmetros
displayId long: o ID de exibição da tela para fazer capturas de tela.
Retorna
InputStreamSource uma InputStreamSource da captura de tela no formato ou null se a captura de tela não foi bem-sucedida.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

Faz uma captura de tela do dispositivo. Recomendamos usar getScreenshot(format) com codificação JPEG para tamanhos menores

Parâmetros
format String: PNG, JPEG com suporte
Retorna
InputStreamSource uma InputStreamSource da captura de tela no formato ou null se a captura de tela não foi bem-sucedida.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Faz uma captura de tela do dispositivo.

Retorna
InputStreamSource uma InputStreamSource da captura de tela no formato PNG ou null se a captura de tela não foi concluída.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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

Retorna o valor da configuração solicitada. namespace precisa ser um destes: {"system", "secure", "global"}

Parâmetros
userId int

namespace String

key String

Retorna
String o valor associado à chave namespace:key de um usuário. Valor nulo se não encontrado.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

Parâmetros
namespace String

key String

Retorna
String

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Busca os nomes dos pacotes de aplicativos que podem ser desinstalados. Atualmente, isso é definido como pacotes não do sistema e pacotes do sistema atualizados.

Retorna
ERROR(/Set) dos nomes de pacote String não desinstaláveis instalados no dispositivo.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Encontre e retorne as flags de um determinado usuário. As flags são definidas na classe "android.content.pm.UserInfo" no Android Open Source Project.

Parâmetros
userId int

Retorna
int as flags associadas ao userId fornecido, se encontrado, -10000 em outros casos.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Recebe o mapa de useId para UserInfo no dispositivo. Ocorrerá DeviceRuntimeException se a saída do dispositivo não for como esperado.

Retorna
a lista de objetos UserInfo.
Gera
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, ou -10000 em outros casos.

Parâmetros
userId int

Retorna
int

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

Conferir se um recurso está disponível em um dispositivo.

Parâmetros
feature String: qual formato precisa ser "feature:" ou "" diretamente.
Retorna
boolean Verdadeiro se o recurso for encontrado. Caso contrário, será falso.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Instale um pacote do Android no dispositivo.

Parâmetros
packageFile File: o arquivo apk a ser instalado
reinstall boolean: true se uma reinstalação precisar ser feita
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções disponíveis.
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

installPackage

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Instale um pacote do Android no dispositivo.

Observação: somente casos de uso que exigem controle explícito de concessão de permissão de execução no momento da instalação precisam chamar essa função.

Parâmetros
packageFile File: o arquivo apk a ser instalado
reinstall boolean: true se uma reinstalação precisar ser feita
grantPermissions boolean: se todas as permissões de execução precisam ser concedidas no momento da instalação
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções disponíveis.
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException Se a permissão de execução não tiver suporte da 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 a ser instalado
reinstall boolean: true se uma reinstalação precisar ser feita
userId int: o ID de usuário inteiro a ser instalado.
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções disponíveis.
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

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.

Observação: somente casos de uso que exigem controle explícito de concessão de permissão de execução no momento da instalação precisam chamar essa função.

Parâmetros
packageFile File: o arquivo apk a ser instalado
reinstall boolean: true se uma reinstalação precisar ser feita
grantPermissions boolean: se todas as permissões de execução precisam ser concedidas no momento da instalação
userId int: o ID de usuário inteiro a ser instalado.
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções disponíveis.
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException Se a permissão de execução não tiver suporte da plataforma no dispositivo.

installPackages

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

Instale um app Android feito de vários arquivos APK (um principal e pacotes divididos extras). Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

Parâmetros
packageFiles : os arquivos APK locais
reinstall boolean: true se uma reinstalação precisar ser feita
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções disponíveis.
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException Se a permissão de execução não tiver suporte da plataforma no dispositivo.

installPackages

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

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

Observação: somente casos de uso que exigem controle explícito de concessão de permissão de execução no momento da instalação precisam chamar essa função.

Parâmetros
packageFiles : os caminhos de arquivo APK remotos a serem instalados
reinstall boolean: true se uma reinstalação precisar ser feita
grantPermissions boolean: se todas as permissões de execução precisam ser concedidas no momento da instalação
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções disponíveis.
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException Se a permissão de execução não tiver suporte da 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 principal e pacotes divididos extras) para um determinado usuário. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

Parâmetros
packageFiles : os arquivos APK locais
reinstall boolean: true se uma reinstalação precisar ser feita
userId int: o ID de usuário inteiro a ser instalado.
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções disponíveis.
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException Se a permissão de execução não tiver suporte da 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 principal e pacotes divididos extras) para um determinado usuário. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

Observação: somente casos de uso que exigem controle explícito de concessão de permissão de execução no momento da instalação precisam chamar essa função.

Parâmetros
packageFiles : os arquivos APK locais
reinstall boolean: true se uma reinstalação precisar ser feita
grantPermissions boolean: se todas as permissões de execução precisam ser concedidas no momento da instalação
userId int: o ID de usuário inteiro a ser instalado.
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções disponíveis.
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException Se a permissão de execução não tiver suporte da plataforma no dispositivo.

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

Parâmetros
remoteApkPaths : os caminhos de arquivo de APK remotos
reinstall boolean: true se uma reinstalação precisar ser feita
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções disponíveis.
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException Se a permissão de execução não tiver suporte da plataforma no dispositivo.

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e pacotes divididos extras) que estão no dispositivo Android. Consulte "https://developer.android.com/studio/build/configure-apk-splits" para saber como dividir o APK em vários arquivos.

Observação: somente casos de uso que exigem controle explícito de concessão de permissão de execução no momento da instalação precisam chamar essa função.

Parâmetros
remoteApkPaths : os caminhos de arquivo de APK remotos
reinstall boolean: true se uma reinstalação precisar ser feita
grantPermissions boolean: se todas as permissões de execução precisam ser concedidas no momento da instalação
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para conferir as opções disponíveis.
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.
UnsupportedOperationException Se a permissão de execução não tiver suporte da plataforma no dispositivo.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Retorna se o dispositivo usa o modo de usuário do sistema sem cabeça.

Retorna
boolean

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

Retorna
boolean

Gera
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Determina se há suporte para vários usuários.

Retorna
boolean "true" se houver suporte para vários usuários. Caso contrário, será "false".
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Consultar o dispositivo para um determinado nome de pacote e ID do usuário para verificar se ele está instalado ou não para esse usuário.

Parâmetros
packageName String: o pacote que estamos verificando se está instalado.
userId String: o ID do usuário para o qual o pacote está instalado. Se for nulo, o usuário principal zero será usado.
Retorna
boolean Verdadeiro se o pacote for informado como instalado. Falso em outros casos.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Parâmetros
packageName String

Retorna
boolean Verdadeiro se o pacote for informado como instalado. Falso em outros casos.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

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

Parâmetros
userId int

Retorna
boolean Verdadeiro se o usuário estiver executando, falso em todos os outros casos.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

Retorna se o usuário especificado é secundário de acordo com as flags.

Parâmetros
userId int

Retorna
boolean Verdadeiro se o usuário for secundário. Caso contrário, será falso.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Verifica se o usuário especificado está visível.

Um usuário "visível" é aquele que interage com o usuário "humano" e, portanto, pode iniciar atividades de lançamento (normalmente na tela padrão).

Parâmetros
userId int

Retorna
boolean

Gera
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Verifica se o usuário está visível na tela.

Um usuário "visível" é aquele que interage com o usuário "humano" e, portanto, pode iniciar atividades de lançamento nessa tela.

Parâmetros
userId int

displayId int

Retorna
boolean

Gera
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Retorna se o dispositivo permite que os usuários sejam iniciados e apareçam no segundo plano no ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

Se sim, chame startVisibleBackgroundUser(int, int, boolean), transmitindo uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers() (que precisa incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Retorna
boolean

Gera
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

Se isso acontecer, chame startVisibleBackgroundUser(int, int, boolean), transmitindo uma tela retornada por listDisplayIdsForStartingVisibleBackgroundUsers().

Retorna
boolean

Gera
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Teste se o Wi-Fi está ativado.

Verifica se o Wi-Fi está ativado no dispositivo. Útil para declarar o status do Wi-Fi antes de testes que não são executados com Wi-Fi, por exemplo, testes de dados móveis.

Retorna
boolean true se o Wi-Fi estiver ativado. false se desativado
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

listDisplayIds

public abstract  listDisplayIds ()

Coletar a lista de IDs de telas disponíveis no dispositivo, conforme informado por "dumpsys SurfaceFlinger".

Retorna
A lista de telas. O padrão sempre retorna a tela padrão 0.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Consegue a lista de telas que podem ser usadas para start a user visible in the background.

Retorna
Gera
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Recebe a lista de usuários no dispositivo. DeviceRuntimeException será gerado se a saída do dispositivo não for como esperado.

Retorna
a lista de IDs de usuários.
Gera
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Método auxiliar para registrar um relatório de bug para os repórteres.

Parâmetros
dataName String: nome em que o bugreport será informado.
listener ITestLogger: um ITestLogger para registrar o bugreport.
Retorna
boolean Verdadeiro se a geração de registros foi bem-sucedida. Caso contrário, é falso.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

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

Parâmetros
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra um IDeviceActionReceiver para este dispositivo.

Todos os IDeviceActionReceivers registrados vão receber uma notificação antes do início de uma ação no dispositivo e depois que ela terminar.

Parâmetros
deviceActionReceiver IDeviceActionReceiver: uma IDeviceActionReceiver que será registrada.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Remove o administrador do dispositivo especificado no usuário especificado e retorna true se for bem-sucedido, false caso contrário.

Parâmetros
componentName String: o administrador do dispositivo a ser removido.
userId int: o usuário em que o administrador do dispositivo está.
Retorna
boolean Verdadeiro se for bem-sucedido. Caso contrário, será falso.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

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

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Remover um determinado usuário do dispositivo.

Parâmetros
userId int: do usuário a ser removido
Retorna
boolean "true" se a remoção do usuário foi bem-sucedida. Caso contrário, será "false".
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Define um componente de administrador do dispositivo como proprietário do dispositivo no usuário especificado.

Parâmetros
componentName String: de administrador do dispositivo para ser proprietário do dispositivo.
userId int: do usuário em que o proprietário do dispositivo mora.
Retorna
boolean Verdadeiro se for bem-sucedido. Caso contrário, será falso.
Gera
com.android.tradefed.device.DeviceNotAvailableException
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

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

Adicione um valor de configuração ao namespace de um determinado usuário. Algumas configurações só ficam disponíveis após uma reinicialização. namespace precisa ser um destes: {"system", "secure", "global"}

Parâmetros
userId int

namespace String

key String

value String

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

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

Parâmetros
userId int: do usuário para iniciar em segundo plano
Retorna
boolean Verdadeiro se o usuário foi iniciado em segundo plano.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Inicia um determinado usuário em segundo plano se ele estiver parado. Se o usuário já estiver em execução em segundo plano, esse método será um NOOP. É possível fornecer uma sinalização extra para aguardar a operação.

Parâmetros
userId int: do usuário para iniciar em segundo plano
waitFlag boolean: faz com que o comando aguarde até que o usuário seja iniciado e desbloqueado.
Retorna
boolean Verdadeiro se o usuário foi iniciado em segundo plano.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

public abstract boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Inicia um determinado usuário em segundo plano, visível na tela especificada (ou seja, permitindo que o usuário inicie atividades nessa tela).

OBSERVAÇÃO : este comando não verifica se o usuário existe, se a tela está disponível, device supports such feature etc.

Parâmetros
userId int: do usuário para iniciar em segundo plano
displayId int: tela para iniciar o usuário visível em
waitFlag boolean: faz com que o comando aguarde até que o usuário seja iniciado e desbloqueado.
Retorna
boolean true se o usuário foi iniciado com sucesso e está visível em segundo plano.
Gera
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Interrompe um determinado usuário. Se o usuário já estiver parado, esse método será uma operação sem efeito. Não é possível interromper o usuário atual e do sistema.

Parâmetros
userId int: do usuário para interromper.
Retorna
boolean "true" se o usuário foi interrompido.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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

Parar um determinado usuário. É possível fornecer sinalizações extras para aguardar a operação ter efeito e encerrar forçosamente o usuário. Não é possível interromper o usuário atual e do sistema.

Parâmetros
userId int: do usuário para interromper.
waitFlag boolean: faz com que o comando aguarde até que o usuário seja interrompido.
forceFlag boolean: força a interrupção do usuário.
Retorna
boolean "true" se o usuário foi interrompido.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

Mude para outro userId com um tempo limite padrão. switchUser(int, long).

Parâmetros
userId int

Retorna
boolean Verdadeiro se o novo userId corresponde ao provedor de userId. Falso em outros casos.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Mudar para outro userId com o tempo limite fornecido como prazo. Tentativa de desativar o bloqueio de teclado após a mudança de usuário.

Parâmetros
userId int

timeout long: para aguardar antes de retornar falso para o switch-user falhou.
Retorna
boolean Verdadeiro se o novo userId corresponde ao provedor de userId. Falso em outros casos.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Retorna um bugreport dentro de um objeto Bugreport para processá-lo. Retornar nulo em caso de problemas. O arquivo referenciado no objeto Bugreport precisa ser limpo usando Bugreport.close().

Retorna
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Desinstalar um pacote do Android do dispositivo.

Parâmetros
packageName String: o pacote Android a ser desinstalado
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Parâmetros
packageName String: o pacote Android a ser desinstalado
userId int: o ID de usuário inteiro a ser desinstalado.
Retorna
String um String com um código de erro ou null em caso de sucesso.
Gera
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 o snapuserd ser concluído.

Parâmetros
currentPhase SnapuserdWaitPhase

Gera
DeviceNotAvailableException