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

Tenta novamente os comandos do dispositivo por um período configurável e fornece uma interface de recuperação 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 headless.

abstract boolean checkConnectivity()

Verifique se o dispositivo tem conectividade de rede.

abstract boolean clearErrorDialogs()

Tente dispensar todas 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 específico e flags padrão 0.

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

Crie um usuário com um nome e as flags fornecidas.

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

Crie um usuário com um nome e as flags fornecidas.

abstract int createUserNoThrow(String name)

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

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Remove o IDeviceActionReceiver registrado.

abstract void disableKeyguard()

Tenta desativar o keyguard.

abstract boolean disableNetworkMonitor()

Desativa o monitoramento de rede no dispositivo.

abstract boolean disconnectFromWifi()

Desconecta de uma rede Wi-Fi.

abstract boolean doesFileExist(String deviceFilePath, int userId)

Método auxiliar para determinar se o arquivo no dispositivo existe para um determinado usuário.

abstract File dumpHeap(String process, String devicePath)

Tente despejar o heap do system_server.

abstract boolean enableNetworkMonitor()

Ativa o monitoramento de rede no dispositivo.

abstract getActiveApexes()

Busca as informações sobre os APEXs 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. Retorna nulo se não for encontrado.

abstract getAndroidIds()

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

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract getAppPackageInfos()

Busca informações de pacotes instalados no dispositivo.

abstract InputStreamSource getBugreport()

Recupera um relatório do 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 problemas.

abstract int getCurrentUser()

Retorna o ID do usuário em execução no momento.

abstract getFoldableStates()

Retorna a lista de estados dobráveis no dispositivo.

abstract getInstalledPackageNames()

Busca os nomes de pacotes de aplicativos presentes no dispositivo.

abstract String getIpAddress()

Recebe o endereço IP do dispositivo.

abstract KeyguardControllerState getKeyguardState()

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

abstract Integer getMainUserId()

Retorna o ID do usuário principal.

abstract getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

Recebe o número máximo de usuários que podem ser executados simultaneamente.

abstract int getMaxNumberOfUsersSupported()

Recebe o número máximo de usuários aceitos.

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

Esse método foi descontinuado. getPrimaryUser foi descontinuado do serviço UserManager. Use ERROR(/android.os.UserManager#getMainUserId()) para receber o primeiro usuário completo ou 0 para o sistema. Em sistemas headless, não é um usuário completo.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

Captura uma captura de tela do dispositivo.

abstract InputStreamSource getScreenshot(long displayId)

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

abstract InputStreamSource getScreenshot(String format)

Captura uma captura de tela do dispositivo.

abstract InputStreamSource getScreenshot()

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

Extraia os nomes de pacotes de aplicativos que podem ser desinstalados.

abstract int getUserFlags(int userId)

Encontra e retorna 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, -10000 em qualquer outro caso.

abstract boolean hasFeature(String feature)

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

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

Instala um pacote Android no dispositivo.

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

Instala um pacote Android no dispositivo.

abstract String installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)

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

abstract String installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

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

abstract boolean installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)

Instala APKs com modo incremental.

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

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

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

Instale um aplicativo Android feito de vários arquivos APK (um 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 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 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 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 vários usuários são aceitos.

abstract boolean isPackageInstalled(String packageName, String userId)

Consulte o dispositivo para um determinado nome de pacote e 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 um determinado nome de pacote e verifique se ele está instalado ou não.

abstract boolean isUserRunning(int userId)

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

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 especificado está visível na tela 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 Wi-Fi está ativado.

abstract listDisplayIds()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

Recebe 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 criar um relatório de bug e registrá-lo para os 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 de dispositivo do usuário especificado e retorne true se a operação for bem-sucedida ou false caso contrário.

abstract void removeOwners()

Remova todos os proprietários de perfis de dispositivos atuais com o melhor esforço.

abstract boolean removeUser(int userId)

Remova um usuário específico do dispositivo.

abstract boolean setDeviceOwner(String componentName, int userId)

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

abstract void setSetting(String namespace, String key, String value)

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

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

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

Interrompe um determinado usuário.

abstract boolean switchUser(int userId)

Mude para outro userId com um tempo limite padrão.

abstract boolean switchUser(int userId, long timeout)

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

abstract Bugreport takeBugreport()

Recebe um bugreport e o retorna em um objeto Bugreport para processamento.

abstract String uninstallPackage(String packageName)

Desinstala um pacote Android do dispositivo.

abstract String uninstallPackageForUser(String packageName, int userId)

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

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Se for o caso, aguarde a conclusão do snapuserd.

Métodos públicos

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Retorna se é permitido mudar para o usuário SYSTEM headless.

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 todas as caixas de diálogo de erro exibidas na interface do dispositivo.

Retorna
boolean true se não houver caixas de diálogo ou se elas forem limpas. 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. Isso deve 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 feita com uma das redes Wi-Fi fornecidas no mapa wifiSsidToPsk. 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
wifiSsidToPsk : um mapa de SSIDs de Wi-Fi para senhas.
Retorna
boolean true se a conexão com a rede Wi-Fi for bem-sucedida. 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 feita com uma das redes Wi-Fi fornecidas no mapa wifiSsidToPsk. 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
wifiSsidToPsk : um mapa de SSIDs de Wi-Fi para senhas.
scanSsid boolean: se é necessário verificar SSIDs ocultos para esta rede.
Retorna
boolean true se a conexão com a rede Wi-Fi for bem-sucedida. 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 feita com a rede Wi-Fi especificada. Depois que uma conexão é estabelecida, a instância tenta restaurá-la após cada reinicialização até que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsid String: o SSID do Wi-Fi a que você quer se conectar
wifiPsk String: senha PSK ou nula se não estiver criptografada
Retorna
boolean true se a conexão com a rede Wi-Fi for bem-sucedida. 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 feita com a rede Wi-Fi especificada. Depois que uma conexão é estabelecida, a instância tenta restaurá-la após cada reinicialização até que ITestDevice.disconnectFromWifi() ou ITestDevice.clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsid String: o SSID do Wi-Fi a que você quer se conectar
wifiPsk String: senha do PSK ou nulo se não estiver criptografada
scanSsid boolean: se é necessário verificar o SSID oculto dessa rede.
Retorna
boolean true se a conexão com a rede Wi-Fi for bem-sucedida. 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 é necessário verificar o SSID oculto desta rede
Retorna
boolean true se a conexão com a rede Wi-Fi for bem-sucedida. 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 a conexão com a rede Wi-Fi for bem-sucedida. 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 específico e flags padrão 0.

Parâmetros
name String: 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)

Crie um usuário com um nome e as flags fornecidas.

Parâmetros
name String: do usuário a ser criado no dispositivo
guest boolean: ative a flag do usuário --guest durante a criação
ephemeral boolean: ative 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)

Crie um usuário com um nome e as flags fornecidas.

Parâmetros
name String: do usuário a ser criado no dispositivo
guest boolean: ative a flag do usuário --guest durante a criação
ephemeral boolean: ative a flag do usuário --ephemeral durante a criação
forTesting boolean: ative 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 específico e flags padrão 0.

Parâmetros
name String: do usuário a ser criado no dispositivo
Retorna
int o número inteiro do ID do usuário criado ou -1 em caso de 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 keyguard.

Primeiro, aguarde a preparação do envio de entrada. Isso acontece aproximadamente ao mesmo tempo 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. Em seguida, o comando é enviado para dispensar o keyguard (funciona apenas em dispositivos não seguros)

Gera
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Desativa o monitoramento de rede no dispositivo.

Retorna
boolean true se o monitoramento for desativado. false se houver falha.
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 a desconexão da rede Wi-Fi for bem-sucedida. 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 em relação ao qual a existência do arquivo será verificada
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)

Tente despejar o heap do system_server. É responsabilidade do chamador limpar o arquivo despejado.

Parâmetros
process String: o nome do processo do dispositivo em que o dumpheap será executado.
devicePath String: o caminho no dispositivo onde colocar o despejo. Esse precisa ser um local em que as permissões permitem isso.
Retorna
File o ERROR(/File) que contém o relatório. 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 houver falha.
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 APEXs ativados no dispositivo.

Retorna
ERROR(/Set) de ApexInfo ativados 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. Nulo se o namespace não for compatível.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Encontra e retorna o android-id associado a um userId. Retorna nulo se não for 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 que correspondem aos IDs de usuário. Não há garantia de que cada ID de usuário vai encontrar um ID do Android associado a essa função. Portanto, alguns IDs de usuário podem corresponder a "null".

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

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Parâmetros
packageName String

Retorna
PackageInfo o PackageInfo ou null se não for possível recuperar as informações
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Busca 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 do bug do dispositivo.

A implementação disso tem garantia de continuar funcionando em um dispositivo sem um cartão SD (ou em que o cartão SD ainda não está montado).

Retorna
InputStreamSource Um InputStreamSource que vai produzir o conteúdo do bugreport on demand. 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 "adb version" > 1.0.36

Retorna
InputStreamSource um InputStreamSource do arquivo ZIP que contém o bugreportz. Retorne nulo em caso de falha.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Retorna
DeviceFoldableState

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Retorna o ID do usuário em execução no momento. 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 obtido com "cmd device_state print-states".

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Busca os nomes de pacotes de aplicativos presentes no dispositivo.

Retorna
ERROR(/Set) de String nomes de pacotes 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 o dispositivo 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 ()

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

Retorna
KeyguardControllerState um KeyguardControllerState que contém um snapshot do estado do keyguard e retorna Null se a consulta do Keyguard não for compatível.
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 um usuário principal.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException se a saída do dispositivo não for a esperada.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Recebe o número máximo de usuários que podem ser executados simultaneamente. O valor padrão é 0.

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Recebe o número máximo de usuários aceitos. O valor padrão é 0.

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

getOptions

public abstract TestDeviceOptions getOptions ()

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

Retorna
TestDeviceOptions TestDeviceOptions relacionado ao dispositivo em teste.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Esse método foi descontinuado.
getPrimaryUser foi descontinuado do serviço UserManager. Use ERROR(/android.os.UserManager#getMainUserId()) para receber o primeiro usuário completo ou 0 para o sistema. Em sistemas headless, não é um usuário completo.

Retorna o ID do usuário principal.

Retorna
Integer o userId do usuário principal, se houver, e nulo se não houver um usuário principal.
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)

Captura uma captura de tela do dispositivo. Recomendamos usar getScreenshot(String) com codificação JPEG para um tamanho menor.

Parâmetros
format String: PNG e JPEG compatíveis
rescale boolean: se a captura de tela precisa ser redimensionada para reduzir o tamanho da imagem resultante.
Retorna
InputStreamSource um InputStreamSource da captura de tela no formato ou null se a captura de tela não foi concluída.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Faz uma captura de tela do dispositivo com o ID de exibição especificado. 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 capturar a captura de tela.
Retorna
InputStreamSource um InputStreamSource da captura de tela no formato ou null se a captura de tela não foi concluída.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

Captura uma captura de tela do dispositivo. Recomendado usar getScreenshot(format) com codificação JPEG para um tamanho menor

Parâmetros
format String: PNG e JPEG compatíveis
Retorna
InputStreamSource um InputStreamSource da captura de tela no formato ou null se a captura de tela não foi concluída.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Captura uma captura de tela do dispositivo.

Retorna
InputStreamSource um 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. O namespace precisa ser um destes: {"system", "secure", "global"}

Parâmetros
userId int

namespace String

key String

Retorna
String o valor associado ao namespace:chave de um usuário. Nulo se não for 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 ()

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

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

getUserFlags

public abstract int getUserFlags (int userId)

Encontra e retorna 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 encontradas, -10000 em qualquer outro caso.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Recebe o mapa de useId para UserInfo no dispositivo. Vai gerar DeviceRuntimeException se a saída do dispositivo não for a esperada.

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, -10000 em qualquer outro caso.

Parâmetros
userId int

Retorna
int

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

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

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

installPackage

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

Instala um pacote 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 ver as opções disponíveis.
Retorna
String um String com um código de erro ou null se a operação for concluída corretamente.
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)

Instala um pacote Android no dispositivo.

Observação: só os casos de uso que exigem controle explícito da concessão de permissão de execução no momento da instalação devem 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 ambiente de execução devem ser concedidas no momento da instalação.
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.
Retorna
String um String com um código de erro ou null se a operação for concluída corretamente.
Gera
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 compatível com a plataforma no dispositivo.

installPackageForUser

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Instala 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 para instalar.
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.
Retorna
String um String com um código de erro ou null se a operação for concluída corretamente.
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)

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

Observação: só os casos de uso que exigem controle explícito da concessão de permissão de execução no momento da instalação devem 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 ambiente 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 transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.
Retorna
String um String com um código de erro ou null se a operação for concluída corretamente.
Gera
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 compatível com a plataforma no dispositivo.

installPackageWithIncrementalMode

public abstract boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

Instala APKs com modo incremental.

Parâmetros
apkFiles File: os arquivos APK a serem instalados.
extraArgs String

userId String

Retorna
boolean

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackages

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

Instale um aplicativo 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 ver as opções disponíveis.
Retorna
String um String com um código de erro ou null se a operação for concluída corretamente.
Gera
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 compatível com a 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 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: só os casos de uso que exigem controle explícito da concessão de permissão de execução no momento da instalação devem chamar essa função.

Parâmetros
packageFiles : os caminhos remotos dos arquivos APK a serem instalados
reinstall boolean: true se uma reinstalação precisar ser feita.
grantPermissions boolean: se todas as permissões de ambiente de execução devem ser concedidas no momento da instalação.
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.
Retorna
String um String com um código de erro ou null se a operação for concluída corretamente.
Gera
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 compatível com a 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 para instalar.
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.
Retorna
String um String com um código de erro ou null se a operação for concluída corretamente.
Gera
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 compatível com a 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: só os casos de uso que exigem controle explícito da concessão de permissão de execução no momento da instalação devem 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 ambiente 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 transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.
Retorna
String um String com um código de erro ou null se a operação for concluída corretamente.
Gera
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 compatível com a plataforma no dispositivo.

installRemotePackages

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

Instale um aplicativo Android feito de vários arquivos APK (um 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 remotos dos arquivos APK
reinstall boolean: true se uma reinstalação precisar ser feita.
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.
Retorna
String um String com um código de erro ou null se a operação for concluída corretamente.
Gera
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 compatível com a 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 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: só os casos de uso que exigem controle explícito da concessão de permissão de execução no momento da instalação devem chamar essa função.

Parâmetros
remoteApkPaths : os caminhos remotos dos arquivos APK
reinstall boolean: true se uma reinstalação precisar ser feita.
grantPermissions boolean: se todas as permissões de ambiente de execução devem ser concedidas no momento da instalação.
extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" para ver as opções disponíveis.
Retorna
String um String com um código de erro ou null se a operação for concluída corretamente.
Gera
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 compatível com a plataforma no dispositivo.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Retorna se o dispositivo usa o modo de usuário do sistema headless.

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 vários usuários são aceitos.

Retorna
boolean true se o recurso multiusuário for compatível, false caso contrário
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Consulte o dispositivo para um determinado nome de pacote e 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 quem estamos verificando se o pacote está instalado. Se for nulo, o usuário principal zero será usado.
Retorna
boolean Verdadeiro se o pacote for informado como instalado. Caso contrário, retorna "falso".
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Parâmetros
packageName String

Retorna
boolean Verdadeiro se o pacote for informado como instalado. Caso contrário, retorna "falso".
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

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

Parâmetros
userId int

Retorna
boolean True se o usuário estiver executando, false 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 dele.

Parâmetros
userId int

Retorna
boolean "true" se o usuário for secundário. Caso contrário, "false".
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 está interagindo com o usuário "humano" e, portanto, pode iniciar atividades de inicialização (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 especificado está visível na tela especificada.

Um usuário "visível" é aquele que está interagindo com o usuário "humano" e, portanto, pode iniciar atividades de inicialização na 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 visíveis em segundo plano no ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

Se for o caso, chame startVisibleBackgroundUser(int, int, boolean), transmitindo uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers() (que deve 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 visíveis em segundo plano.

Se isso acontecer, chame startVisibleBackgroundUser(int, int, boolean), transmitindo uma exibição 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 devem ser 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 ()

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

Recebe 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. Vai gerar DeviceRuntimeException se a saída do dispositivo não for a esperada.

Retorna
a lista de IDs de usuário.
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 criar um relatório de bug e registrá-lo para os repórteres.

Parâmetros
dataName String: nome em que o relatório de bug será informado.
listener ITestLogger: um ITestLogger para registrar o bugreport.
Retorna
boolean True se o registro for bem-sucedido. Caso contrário, false.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Notifique 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 e depois de uma ação no dispositivo.

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Remova o administrador de dispositivo do usuário especificado e retorne true se a operação for bem-sucedida ou false caso contrário.

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

removeOwners

public abstract void removeOwners ()

Remova todos os proprietários de perfis de dispositivos atuais com o melhor esforço.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Remova um usuário específico do dispositivo.

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

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

Parâmetros
componentName String: de administrador do dispositivo para proprietário do dispositivo.
userId int: do usuário em que o proprietário do dispositivo mora.
Retorna
boolean True se for bem-sucedido. Caso contrário, false.
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)

Adiciona um valor de configuração ao namespace de um determinado usuário. Algumas configurações só vão estar disponíveis após uma reinicialização. 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á uma 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á uma NOOP. É possível fornecer uma flag extra para aguardar o efeito da 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 : esse comando não verifica se o usuário existe, se a exibição está disponível, se é 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 tiver sido iniciado com sucesso 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 NOOP. Não é possível interromper o usuário atual e do sistema.

Parâmetros
userId int: do usuário a ser interrompido.
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)

Interrompe um determinado usuário. É possível fornecer flags extras para aguardar o efeito da operação e encerrar o usuário à força. Não é possível interromper o usuário atual e do sistema.

Parâmetros
userId int: do usuário a ser interrompido.
waitFlag boolean: faz com que o comando aguarde até que o usuário seja interrompido.
forceFlag boolean: vai forçar 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 corresponder ao provedor de userId. Caso contrário, retorna "falso".
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Mude para outro userId com o tempo limite fornecido como prazo. Tentar desativar o bloqueio de tela depois que a mudança de usuário for concluída.

Parâmetros
userId int

timeout long: aguardar antes de retornar "false" para a troca de usuário com falha.
Retorna
boolean Verdadeiro se o novo userId corresponder ao provedor de userId. Caso contrário, retorna "falso".
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Recebe um bugreport e o retorna em um objeto Bugreport para processamento. Retorne nulo em caso de problema. O arquivo referenciado no objeto Bugreport precisa ser limpo com Bugreport.close().

Retorna
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Desinstala um pacote 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 se a operação for concluída corretamente.
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)

Desinstala 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 se a operação for concluída corretamente.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Se for o esperado, aguarde a conclusão do snapuserd.

Parâmetros
currentPhase SnapuserdWaitPhase

Gera
DeviceNotAvailableException