ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

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

Resumo

Classes aninhadas

class ITestDevice.ApexInfo

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

class ITestDevice.MountPointInfo

Uma classe struct simples para armazenar informações sobre um único ponto de montagem

Métodos públicos

abstract boolean canSwitchToHeadlessSystemUser ()

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

abstract boolean checkConnectivity ()

Verifique se o dispositivo tem conectividade de rede.

abstract boolean clearErrorDialogs ()

Tente descartar todas as caixas de diálogo de erro atualmente exibidas na interface do usuário do dispositivo.

abstract void clearLastConnectedWifiNetwork ()

Limpa a última rede wi-fi conectada.

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

Conecta-se a uma rede wi-fi.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Conecta-se a uma rede wi-fi.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Conecta-se a uma rede wi-fi.

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

Conecta-se a uma rede wi-fi.

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

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

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

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

abstract int createUser (String name)

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

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

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

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

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

abstract int createUserNoThrow (String name)

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

abstract void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Remove o IDeviceActionReceiver registrado.

abstract void disableKeyguard ()

Tenta desativar a proteção do teclado.

abstract boolean disableNetworkMonitor ()

Desativa o monitoramento de rede no dispositivo.

abstract boolean disconnectFromWifi ()

Desconecta de uma rede wi-fi.

abstract boolean doesFileExist (String deviceFilePath, int userId)

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

abstract File dumpHeap (String process, String devicePath)

Tente despejar o heap do system_server.

abstract boolean enableNetworkMonitor ()

Ativa o monitoramento de rede no dispositivo.

abstract getActiveApexes ()

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

abstract getAllSettings (String namespace)

Retorna pares de valores-chave do namespace solicitado.

abstract String getAndroidId (int userId)

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

abstract getAndroidIds ()

Crie um mapa de IDs de Android encontrados correspondentes a IDs de usuário.

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract getAppPackageInfos ()

Busca informações de pacotes instalados no dispositivo.

abstract InputStreamSource getBugreport ()

Recupera um relatório de bug do dispositivo.

abstract InputStreamSource getBugreportz ()

Recupera um bugreportz do dispositivo.

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

Retorna o id do usuário em execução atual.

abstract getFoldableStates ()

Retorna a lista de estados dobráveis ​​no dispositivo.

abstract getInstalledPackageNames ()

Busque os nomes dos pacotes de aplicativos presentes no dispositivo.

abstract String getIpAddress ()

Obtém o endereço IP do dispositivo.

abstract KeyguardControllerState getKeyguardState ()

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

abstract Integer getMainUserId ()

Retorna o id do usuário principal.

abstract getMainlineModuleInfo ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

Obtenha o número máximo de usuários em execução simultânea com suporte.

abstract int getMaxNumberOfUsersSupported ()

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

abstract TestDeviceOptions getOptions ()

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

abstract Integer getPrimaryUserId ()

Retorna o ID do usuário primário.

abstract InputStreamSource getScreenshot ()

Captura uma captura de tela do dispositivo.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

Captura uma captura de tela do dispositivo.

abstract InputStreamSource getScreenshot (String format)

Captura uma captura de tela do dispositivo.

abstract InputStreamSource getScreenshot (long displayId)

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

abstract String getSetting (String namespace, String key)

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

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

Retorna o valor da configuração solicitada.

abstract getUninstallablePackageNames ()

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

abstract int getUserFlags (int userId)

Encontre e retorne os sinalizadores de um determinado usuário.

abstract getUserInfos ()

Obtém o mapa de useId para UserInfo no dispositivo.

abstract int getUserSerialNumber (int userId)

Retorna o número de série associado ao userId se encontrado, -10000 nos demais casos.

abstract boolean hasFeature (String feature)

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

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

Instale um pacote Android no dispositivo.

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

Instale um pacote Android no dispositivo.

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

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

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

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

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

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um extra).

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

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

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

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

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

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

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

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

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

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

abstract boolean isHeadlessSystemUserMode ()

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

abstract boolean isMainUserPermanentAdmin ()

Retorna se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para o status de não administrador.

abstract boolean isMultiUserSupported ()

Determina se multiusuário é suportado.

abstract boolean isPackageInstalled (String packageName)

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

abstract boolean isPackageInstalled (String packageName, String userId)

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

abstract boolean isUserRunning (int userId)

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

abstract boolean isUserSecondary (int userId)

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

abstract boolean isUserVisible (int userId)

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

abstract boolean isUserVisibleOnDisplay (int userId, int displayId)

Verifica se o usuário fornecido está visível na exibição fornecida.

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Retorna se o dispositivo permite que os usuários sejam iniciados visíveis em segundo plano no ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

abstract boolean isVisibleBackgroundUsersSupported ()

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

abstract boolean isWifiEnabled ()

Teste se o wi-fi está ativado.

abstract listDisplayIds ()

Colete a lista de IDs de exibição disponíveis no dispositivo, conforme relatado por "Dumpsys SurfaceFlinger".

abstract listDisplayIdsForStartingVisibleBackgroundUsers ()

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

abstract listUsers ()

Obtém a lista de usuários no dispositivo.

abstract boolean logBugreport (String dataName, ITestLogger listener)

Método auxiliar para obter um relatório de bug e registrá-lo para os repórteres.

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Registra um IDeviceActionReceiver para este dispositivo.

abstract boolean removeAdmin (String componentName, int userId)

Remova o administrador do dispositivo fornecido em determinado usuário e retorne true se for bem-sucedido, false caso contrário.

abstract void removeOwners ()

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

abstract boolean removeUser (int userId)

Remova um determinado usuário do dispositivo.

abstract boolean setDeviceOwner (String componentName, int userId)

Defina um componente de administração do dispositivo como proprietário do dispositivo em determinado usuário.

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

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

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

Adicione um valor de configuração ao namespace de um determinado usuário.

abstract boolean startUser (int userId)

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

abstract boolean startUser (int userId, boolean waitFlag)

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

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

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

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

Pare um determinado usuário.

abstract boolean stopUser (int userId)

Interrompe um determinado usuário.

abstract boolean switchUser (int userId)

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

abstract boolean switchUser (int userId, long timeout)

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

abstract Bugreport takeBugreport ()

Pegue um relatório de bug e o retorne dentro de um objeto Bugreport para tratá-lo.

abstract String uninstallPackage (String packageName)

Desinstale um pacote Android do dispositivo.

abstract String uninstallPackageForUser (String packageName, int userId)

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

Métodos públicos

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

devoluções
boolean

lances
DeviceNotAvailableException

verificarConectividade

public abstract boolean checkConnectivity ()

Verifique se o dispositivo tem conectividade de rede.

devoluções
boolean true se o dispositivo tiver uma conexão de rede funcionando, false overwise.

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Tente descartar todas as caixas de diálogo de erro atualmente exibidas na interface do usuário do dispositivo.

devoluções
boolean true se nenhuma caixa de diálogo estiver presente ou se as caixas de diálogo forem limpas com êxito. false caso contrário.

lances
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 chamada para evitar a conexão com a rede wi-fi usada no teste anterior após a reinicialização do dispositivo.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Conecta-se a uma rede wi-fi.

Ativa o wifi e bloqueia até que uma conexão bem-sucedida seja feita com uma das redes wifi fornecidas no mapa wifiSsidToPsk. Depois que uma conexão é estabelecida, a instância tentará restaurá-la após cada reinicialização até que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsidToPsk : Um mapa de SSIDs wi-fi para senhas.

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

devoluções
boolean true se conectado à rede wi-fi com sucesso. false caso contrário

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Conecta-se a uma rede wi-fi.

Ativa o wifi e bloqueia até que uma conexão bem-sucedida seja feita com uma das redes wifi fornecidas no mapa wifiSsidToPsk. Depois que uma conexão é estabelecida, a instância tentará restaurá-la após cada reinicialização até que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsidToPsk : Um mapa de SSIDs wi-fi para senhas.

devoluções
boolean true se conectado à rede wi-fi com sucesso. false caso contrário

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

Liga o wi-fi e bloqueia até que uma conexão bem-sucedida seja feita com a rede wi-fi especificada. Depois que uma conexão é estabelecida, a instância tentará restaurá-la após cada reinicialização até que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsid String : o ssid wi-fi para se conectar

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

devoluções
boolean true se conectado à rede wi-fi com sucesso. false caso contrário

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

Liga o wi-fi e bloqueia até que uma conexão bem-sucedida seja feita com a rede wi-fi especificada. Depois que uma conexão é estabelecida, a instância tentará restaurá-la após cada reinicialização até que ITestDevice#disconnectFromWifi() ou ITestDevice#clearLastConnectedWifiNetwork() seja chamado.

Parâmetros
wifiSsid String : o ssid wi-fi para se conectar

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

scanSsid boolean : se deve procurar SSID oculto para esta rede.

devoluções
boolean true se conectado à rede wi-fi com sucesso. false caso contrário

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

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

devoluções
boolean true se conectado à rede wi-fi com sucesso. false caso contrário

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

devoluções
boolean true se conectado à rede wi-fi com sucesso. false caso contrário

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

criarusuário

public abstract int createUser (String name)

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

Parâmetros
name String : do usuário a ser criado no dispositivo

devoluções
int o número inteiro para o ID do usuário criado

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

criarusuário

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

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

Parâmetros
name String : do usuário a ser criado no dispositivo

guest boolean : habilite o sinalizador de usuário --guest durante a criação

ephemeral boolean : habilite o sinalizador de usuário --ephemeral durante a criação

forTesting boolean : habilite o sinalizador de teste --for-testing durante a criação

devoluções
int id do usuário criado

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

criarusuário

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

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

Parâmetros
name String : do usuário a ser criado no dispositivo

guest boolean : habilite o sinalizador de usuário --guest durante a criação

ephemeral boolean : habilite o sinalizador de usuário --ephemeral durante a criação

devoluções
int id do usuário criado

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

Parâmetros
name String : do usuário a ser criado no dispositivo

devoluções
int o número inteiro para o ID do usuário criado ou -1 para erro.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Remove o IDeviceActionReceiver registrado.

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

desativarKeyguard

public abstract void disableKeyguard ()

Tenta desativar a proteção do teclado.

Primeiro, espere que o envio de entrada fique pronto, isso acontece ao mesmo tempo em que o dispositivo relata BOOT_COMPLETE, aparentemente de forma assíncrona, porque a implementação atual da estrutura tem uma condição de corrida ocasional. Em seguida, o comando é enviado para descartar o keyguard (funciona apenas em não-seguros)

lances
DeviceNotAvailableException

desativarNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Desativa o monitoramento de rede no dispositivo.

devoluções
boolean true se o monitoramento for desabilitado com sucesso. false se falhou.

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

desconectarDeWifi

public abstract boolean disconnectFromWifi ()

Desconecta de uma rede wi-fi.

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

devoluções
boolean true se desconectado da rede wi-fi com sucesso. false se a desconexão falhou.

lances
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 contra o qual verificar a existência do arquivo

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

lances
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 para despejar.

devicePath String : o caminho no dispositivo onde colocar o dump. Este deve ser um local onde as permissões permitem.

devoluções
File o ERROR(/File) contendo o relatório. Nulo se algo falhou.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Ativa o monitoramento de rede no dispositivo.

devoluções
boolean true se o monitoramento for ativado com êxito. false se falhou.

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

getActiveApexes

public abstract  getActiveApexes ()

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

devoluções
ERROR(/Set) de ApexInfo atualmente ativado no dispositivo

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

Retorna pares de valores-chave do namespace solicitado.

Parâmetros
namespace String : deve ser um dos {"system", "secure", "global"}

devoluções
o mapa de pares chave-valor. Nulo se o namespace não for suportado.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

Parâmetros
userId int

devoluções
String

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Crie um mapa de IDs de Android encontrados correspondentes a IDs de usuário. Não há garantia de que cada ID de usuário encontrará um ID de Android associado a esta função, portanto, alguns IDs de usuário podem corresponder a null.

devoluções
Mapa de IDs de Android encontrados com IDs de usuários correspondentes.

lances
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

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

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Busca informações de pacotes instalados no dispositivo.

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

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getbugreport

public abstract InputStreamSource getBugreport ()

Recupera um relatório de bug do dispositivo.

A implementação disso é garantida para continuar a funcionar em um dispositivo sem um cartão SD (ou onde o cartão SD ainda não está montado).

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

getbugreportz

public abstract InputStreamSource getBugreportz ()

Recupera um bugreportz do dispositivo. O relatório de bug em formato zip contém o relatório de bug principal e outros arquivos de log que são úteis para depuração.

Compatível apenas com 'versão adb' > 1.0.36

devoluções
InputStreamSource um InputStreamSource do arquivo zip contendo 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.

devoluções
DeviceFoldableState

lances
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, retorna -10000.

devoluções
int

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

devoluções

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Busque os nomes dos pacotes de aplicativos presentes no dispositivo.

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

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Obtém o endereço IP do dispositivo.

devoluções
String o endereço IP do dispositivo ou null se o dispositivo não tiver endereço IP

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

devoluções
KeyguardControllerState um KeyguardControllerState contendo um instantâneo do estado do keyguard e retorna Null se a consulta do Keyguard não for suportada.

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

getMainUserId

public abstract Integer getMainUserId ()

Retorna o id do usuário principal.

devoluções
Integer o userId do usuário principal, se houver, e nulo se não houver usuário principal.

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

devoluções
ERROR(/Set) dos módulos da linha principal String atualmente instalados no dispositivo.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Obtenha o número máximo de usuários em execução simultânea com suporte. O padrão é 0.

devoluções
int um inteiro indicando o número de usuários em execução simultaneamente

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Obtenha o número máximo de usuários suportados. O padrão é 0.

devoluções
int um número inteiro indicando o número de usuários suportados

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Retorna o ID do usuário primário.

devoluções
Integer o userId do usuário principal, se houver, e null se não houver usuário principal.

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

obter captura de tela

public abstract InputStreamSource getScreenshot ()

Captura uma captura de tela do dispositivo.

devoluções
InputStreamSource um InputStreamSource da captura de tela em formato png ou null se a captura de tela não for bem-sucedida.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obter captura de tela

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Captura uma captura de tela do dispositivo. Recomendado usar getScreenshot(String) em vez de codificação JPEG para tamanho menor.

Parâmetros
format String : PNG suportado, JPEG

rescale boolean : se a captura de tela deve ser redimensionada para reduzir o tamanho da imagem resultante

devoluções
InputStreamSource um InputStreamSource da captura de tela no formato ou null se a captura de tela não for bem-sucedida.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obter captura de tela

public abstract InputStreamSource getScreenshot (String format)

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

Parâmetros
format String : PNG suportado, JPEG

devoluções
InputStreamSource um InputStreamSource da captura de tela no formato ou null se a captura de tela não for bem-sucedida.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

obter captura de tela

public abstract InputStreamSource getScreenshot (long displayId)

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

TODO: estender as implementações acima para suportar 'format' e 'rescale'

Parâmetros
displayId long : o ID de exibição da tela para obter a captura de tela.

devoluções
InputStreamSource um InputStreamSource da captura de tela no formato ou null se a captura de tela não for bem-sucedida.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

Parâmetros
namespace String

key String

devoluções
String

lances
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 deve ser um dos seguintes: {"system", "secure", "global"}

Parâmetros
userId int

namespace String

key String

devoluções
String o valor associado ao namespace:key de um usuário. Nulo se não for encontrado.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

devoluções
ERROR(/Set) de nomes de pacotes String instaláveis ​​atualmente instalados no dispositivo.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Encontre e retorne os sinalizadores de um determinado usuário. Os sinalizadores são definidos na classe "android.content.pm.UserInfo" no Android Open Source Project.

Parâmetros
userId int

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

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Obtém o mapa de useId para UserInfo no dispositivo. Lançará DeviceRuntimeException se a saída do dispositivo não for a esperada.

devoluções
a lista de objetos UserInfo.

lances
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Retorna o número de série associado ao userId se encontrado, -10000 nos demais casos.

Parâmetros
userId int

devoluções
int

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

tem recurso

public abstract boolean hasFeature (String feature)

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

Parâmetros
feature String : qual formato deve ser "recurso: " ou " " diretamente.

devoluções
boolean Verdadeiro se o recurso for encontrado, falso caso contrário.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pacote de instalação

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

Instale um pacote Android no dispositivo.

Parâmetros
packageFile File : o arquivo apk para instalar

reinstall boolean : true se uma reinstalação deve ser realizada

extraArgs String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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

pacote de instalação

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

Instale um pacote Android no dispositivo.

Nota: Somente os casos de uso que requerem controle explícito de concessão de permissão de tempo de execução no momento da instalação devem chamar esta função.

Parâmetros
packageFile File : o arquivo apk para instalar

reinstall boolean : true se uma reinstalação deve ser executada

grantPermissions boolean : se todas as permissões de tempo de execução devem ser concedidas no momento da instalação

extraArgs String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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

installPackageForUser

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

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

Nota: Somente os casos de uso que requerem controle explícito de concessão de permissão de tempo de execução no momento da instalação devem chamar esta função.

Parâmetros
packageFile File : o arquivo apk para instalar

reinstall boolean : true se uma reinstalação deve ser executada

grantPermissions boolean : se todas as permissões de tempo de execução devem ser concedidas no momento da instalação

userId int : o id de usuário inteiro para o qual instalar.

extraArgs String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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

installPackageForUser

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

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

Parâmetros
packageFile File : o arquivo apk para instalar

reinstall boolean : true se uma reinstalação deve ser realizada

userId int : o id de usuário inteiro para o qual instalar.

extraArgs String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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

instalarPacotes

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

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um extra). Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o apk em vários arquivos.

Parâmetros
packageFiles : os arquivos apk locais

reinstall boolean : true se uma reinstalação deve ser realizada

extraArgs String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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

instalarPacotes

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

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

Nota: Somente os casos de uso que requerem controle explícito de concessão de permissão de tempo de execução no momento da instalação devem chamar esta função.

Parâmetros
packageFiles : os caminhos de arquivo apk remoto para instalar

reinstall boolean : true se uma reinstalação deve ser executada

grantPermissions boolean : se todas as permissões de tempo de execução devem ser concedidas no momento da instalação

extraArgs String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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

installPackagesForUser

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

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um extra) para um determinado usuário. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o apk em vários arquivos.

Nota: Somente os casos de uso que requerem controle explícito de concessão de permissão de tempo de execução no momento da instalação devem chamar esta função.

Parâmetros
packageFiles : os arquivos apk locais

reinstall boolean : true se uma reinstalação deve ser realizada

grantPermissions boolean : se todas as permissões de tempo de execução devem ser concedidas no momento da instalação

userId int : o id de usuário inteiro para o qual instalar.

extraArgs String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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

installPackagesForUser

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

Instale um aplicativo Android feito de vários arquivos APK (um pacote principal e um extra) para um determinado usuário. Consulte "https://developer.android.com/studio/build/configure-apk-splits" sobre como dividir o apk em vários arquivos.

Parâmetros
packageFiles : os arquivos apk locais

reinstall boolean : true se uma reinstalação deve ser realizada

userId int : o id de usuário inteiro para o qual instalar.

extraArgs String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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

instalarRemotePackages

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

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

Parâmetros
remoteApkPaths : os caminhos do arquivo apk remoto

reinstall boolean : true se uma reinstalação deve ser realizada

extraArgs String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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

instalarRemotePackages

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

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

Nota: Somente os casos de uso que requerem controle explícito de concessão de permissão de tempo de execução no momento da instalação devem chamar esta função.

Parâmetros
remoteApkPaths : os caminhos do arquivo apk remoto

reinstall boolean : true se uma reinstalação deve ser executada

grantPermissions boolean : se todas as permissões de tempo de execução devem ser concedidas no momento da instalação

extraArgs String : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

devoluções
boolean

lances
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

Retorna se o usuário principal é um administrador permanente e não pode ser excluído ou rebaixado para o status de não administrador.

devoluções
boolean

lances
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Determina se multiusuário é suportado.

devoluções
boolean verdadeiro se multiusuário for suportado, falso caso contrário

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Parâmetros
packageName String

devoluções
boolean Verdadeiro se o pacote for relatado como instalado. Falso caso contrário.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

Parâmetros
packageName String : o pacote que estamos verificando se está instalado.

userId String : O ID do usuário para o qual estamos verificando se o pacote está instalado. Se nulo, o usuário primário zero será usado.

devoluções
boolean Verdadeiro se o pacote for relatado como instalado. Falso caso contrário.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

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

Parâmetros
userId int

devoluções
boolean Verdadeiro se o usuário estiver executando, falso em todos os outros casos.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Parâmetros
userId int

devoluções
boolean true se o usuário for secundário, false caso contrário.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

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

Um usuário "visível" é um usuário que está interagindo com o usuário "humano" e, portanto, é capaz de iniciar atividades de inicialização (normalmente na exibição padrão).

Parâmetros
userId int

devoluções
boolean

lances
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Verifica se o usuário fornecido está visível na exibição fornecida.

Um usuário "visível" é um usuário que está interagindo com o usuário "humano" e, portanto, é capaz de iniciar atividades de lançamento nesse monitor.

Parâmetros
userId int

displayId int

devoluções
boolean

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

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

devoluções
boolean

lances
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

devoluções
boolean

lances
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Teste se o wi-fi está ativado.

Verifica se o wifi está ativado no dispositivo. Útil para confirmar o status do wi-fi antes de testes que não devem ser executados com wi-fi, por exemplo, testes de dados móveis.

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

lances
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 exibição disponíveis no dispositivo, conforme relatado por "Dumpsys SurfaceFlinger".

devoluções
A lista de exibições. Padrão sempre retorna a exibição padrão 0.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

devoluções

lances
DeviceNotAvailableException

listarUsuários

public abstract  listUsers ()

Obtém a lista de usuários no dispositivo. Lançará DeviceRuntimeException se a saída do dispositivo não for a esperada.

devoluções
a lista de IDs de usuários.

lances
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

log Bugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Método auxiliar para obter um relatório de bug e registrá-lo para os repórteres.

Parâmetros
dataName String : nome sob o qual o relatório de bug será reportado.

listener ITestLogger : um ITestLogger para registrar o relatório de bug.

devoluções
boolean True se o registro foi bem-sucedido, false caso contrário.

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registra um IDeviceActionReceiver para este dispositivo.

Todos os IDeviceActionReceiver s registrados serão notificados antes do início de uma ação do dispositivo e após o término da ação do dispositivo.

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Remova o administrador do dispositivo fornecido em determinado usuário e retorne true se for bem-sucedido, false caso contrário.

Parâmetros
componentName String : do administrador do dispositivo a ser removido.

userId int : do usuário em que o administrador do dispositivo reside.

devoluções
boolean Verdadeiro se for bem-sucedido, falso caso contrário.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

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

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Remova um determinado usuário do dispositivo.

Parâmetros
userId int : do usuário para remover

devoluções
boolean true se obtivermos sucesso na remoção do usuário, false caso contrário.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Defina um componente de administração do dispositivo como proprietário do dispositivo em determinado usuário.

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

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

devoluções
boolean Verdadeiro se for bem-sucedido, falso caso contrário.

lances
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

lances
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ó estarão disponíveis após uma reinicialização. namespace deve ser um dos seguintes: {"system", "secure", "global"}

Parâmetros
userId int

namespace String

key String

value String

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

Inicia um determinado usuário em segundo plano se estiver parado no momento. Se o usuário já estiver executando em segundo plano, esse método é um NOOP.

Parâmetros
userId int : do usuário para iniciar em segundo plano

devoluções
boolean true se o usuário foi iniciado com êxito em segundo plano.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Inicia um determinado usuário em segundo plano se estiver parado no momento. Se o usuário já estiver executando em segundo plano, esse método é um NOOP. Possível fornecer sinalizador extra para aguardar a operação ter efeito.

Parâmetros
userId int : do usuário para iniciar em segundo plano

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

devoluções
boolean true se o usuário foi iniciado com êxito em segundo plano.

lances
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 exibição fornecida (ou seja, permitindo que o usuário inicie atividades nessa exibição).

NOTA: este comando não verifica se o usuário existe, o display está disponível, device supports such feature , etc.

Parâmetros
userId int : do usuário para iniciar em segundo plano

displayId int : exibir para iniciar o usuário visível em

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

devoluções
boolean true se o usuário foi iniciado com êxito visível em segundo plano.

lances
DeviceNotAvailableException

stopUser

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

Pare um determinado usuário. Possível fornecer sinalizadores extras para aguardar a operação ter efeito e forçar o encerramento do usuário. Não é possível parar o usuário atual e do sistema.

Parâmetros
userId int : do usuário para parar.

waitFlag boolean : fará o comando esperar até que o usuário seja parado.

forceFlag boolean : forçará a parada do usuário.

devoluções
boolean true se o usuário foi interrompido com êxito.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Interrompe um determinado usuário. Se o usuário já estiver parado, esse método é um NOOP. Não é possível parar o usuário atual e do sistema.

Parâmetros
userId int : do usuário para parar.

devoluções
boolean true se o usuário foi interrompido com êxito.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

mudar de utilizador

public abstract boolean switchUser (int userId)

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

Parâmetros
userId int

devoluções
boolean Verdadeiro se o novo userId corresponder ao provedor userId. Falso caso contrário.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

mudar de utilizador

public abstract boolean switchUser (int userId, 
                long timeout)

Alterne para outro userId com o tempo limite fornecido como prazo. Tentativa de desabilitar a proteção do teclado após a alteração do usuário ser bem-sucedida.

Parâmetros
userId int

timeout long : para esperar antes de retornar false para switch-user falhou.

devoluções
boolean Verdadeiro se o novo userId corresponder ao provedor userId. Falso caso contrário.

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takebugreport

public abstract Bugreport takeBugreport ()

Pegue um relatório de bug e o retorne dentro de um objeto Bugreport para tratá-lo. Retorna nulo em caso de emissão. O arquivo referenciado no objeto Bugreport precisa ser limpo por meio de Bugreport.close() .

devoluções
Bugreport

pacote de desinstalação

public abstract String uninstallPackage (String packageName)

Desinstale um pacote Android do dispositivo.

Parâmetros
packageName String : o pacote do Android a ser desinstalado

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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

desinstalarPacoteForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Parâmetros
packageName String : o pacote do Android a ser desinstalado

userId int : o id de usuário inteiro para desinstalar.

devoluções
String uma String com um código de erro ou null se for bem-sucedida.

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