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 String adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)

Instale um pacote Android no dispositivo com o comando adb.

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

Instale um pacote Android no dispositivo com o comando adb.

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.

default boolean connectToWifiNetwork(Map<String, String> wifiSsidToPsk, boolean scanSsid)

Esse método foi descontinuado. use connectToWifiNetworkWithResult(Map,boolean).

default boolean connectToWifiNetwork(Map<String, String> wifiSsidToPsk)

Esse método foi descontinuado. use connectToWifiNetworkWithResult(Map).

default boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Esse método foi descontinuado. use connectToWifiNetworkWithResult(String,String).

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

Esse método foi descontinuado. use connectToWifiNetworkWithResult(String,String,boolean).

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

Esse método foi descontinuado. use connectToWifiNetworkIfNeededWithResult(String,String,boolean) em vez disso.

default boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

Esse método foi descontinuado. use connectToWifiNetworkIfNeededWithResult(String,String).

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult(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 IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult(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 IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)

Conecta-se a uma rede Wi-Fi.

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)

Conecta-se a uma rede Wi-Fi.

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)

Conecta-se a uma rede Wi-Fi.

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)

Conecta-se a uma rede Wi-Fi.

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 específico e as flags fornecidas.

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

Crie um usuário com um nome específico 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 bloqueio de tela.

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 Set<ITestDevice.ApexInfo> getActiveApexes()

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

abstract Map<String, String> 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 Map<Integer, String> getAndroidIds()

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

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract List<PackageInfo> 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 Set<DeviceFoldableState> getFoldableStates()

Retorna a lista de estados dobráveis no dispositivo.

abstract Set<String> getInstalledPackageNames()

Extraia 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 Set<String> 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(String userType)

Recebe o número máximo de usuários compatíveis do tipo de usuário especificado.

abstract int getMaxNumberOfUsersSupported()

Esse método foi descontinuado. use getMaxNumberOfUsersSupported(String userType) para receber o número máximo de usuários compatíveis para um determinado tipo de usuário.

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. Observação: para sistemas headless, não é um usuário completo.

abstract int getRemainingCreatableUserCount(String userType)

Retorna quantos usuários do tipo especificado podem ser criados neste dispositivo.

abstract InputStreamSource getScreenshot(Long displayId, String format, boolean rescale)

Faz uma captura de tela do dispositivo com o ID de exibição e o formato compatível.

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)

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

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 Set<String> 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 Map<Integer, UserInfo> 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 int getUserVisibleOnDisplay(int displayId)

Recebe o ID do usuário visível na tela especificada.

abstract boolean hasFeature(String feature)

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

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

Instale um pacote Android no dispositivo.

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

Instale um pacote Android no dispositivo.

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 String installPackageForUser(File packageFile, boolean reinstall, 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(List<File> packageFiles, boolean reinstall, String... extraArgs)

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

default String installPackages(List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

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

default String installPackagesForUser(List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)

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

default String installPackagesForUser(List<File> packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

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

abstract boolean isHeadlessSystemUserMode()

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

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

Retorna se este dispositivo é compatível com vários usuários alternáveis com login próprio e espaço personalizável.

abstract boolean isPackageInstalled(String packageName, String userId)

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

abstract boolean isPackageInstalled(String packageName)

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.

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 Set<Long> listDisplayIds()

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

abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers()

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

abstract ArrayList<Integer> 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 registrar 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)

Remove o administrador de dispositivo do usuário especificado e retorna 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)

Remove 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. Isso permite 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

adbInstallPackage

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

Instale um pacote Android no dispositivo com o comando adb.

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

adbInstallPackage

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

Instale um pacote Android no dispositivo com o comando adb.

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

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. Caso contrário, false.
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 boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

Esse método foi descontinuado.
use connectToWifiNetworkWithResult(Map,boolean).

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 Map: 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 boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk)

Esse método foi descontinuado.
use connectToWifiNetworkWithResult(Map).

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 Map: 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 boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Esse método foi descontinuado.
use connectToWifiNetworkWithResult(String,String).

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
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 boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Esse método foi descontinuado.
use connectToWifiNetworkWithResult(String,String,boolean).

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 desta 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 boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Esse método foi descontinuado.
use connectToWifiNetworkIfNeededWithResult(String,String,boolean) instead.

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 boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Esse método foi descontinuado.
use connectToWifiNetworkIfNeededWithResult(String,String).

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

connectToWifiNetworkIfNeededWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (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
IWifiHelper.WifiConnectionResult o WifiConnectionResult que indica o status da conexão.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeededWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (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
IWifiHelper.WifiConnectionResult o WifiConnectionResult que indica o status da conexão.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (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 desta rede.
Retorna
IWifiHelper.WifiConnectionResult o WifiConnectionResult que indica o status da conexão.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> 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 Map: um mapa de SSIDs de Wi-Fi para senhas.
Retorna
IWifiHelper.WifiConnectionResult o WifiConnectionResult que indica o status da conexão.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> 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 Map: um mapa de SSIDs de Wi-Fi para senhas.
scanSsid boolean: se é necessário verificar SSIDs ocultos para esta rede.
Retorna
IWifiHelper.WifiConnectionResult o WifiConnectionResult que indica o status da conexão.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (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 do PSK ou nulo se não estiver criptografada
Retorna
IWifiHelper.WifiConnectionResult o WifiConnectionResult que indica o status da conexão.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

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
IllegalStateException

createUser

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

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

Parâmetros
name String: do usuário a ser criado no dispositivo
guest boolean: ative a flag de 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
IllegalStateException

createUser

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

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

Parâmetros
name String: do usuário a ser criado no dispositivo
guest boolean: ative a flag de 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
IllegalStateException

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 bloqueio de tela.

Primeiro, aguarde a entrada ficar pronta. 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 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 Set<ITestDevice.ApexInfo> getActiveApexes ()

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

Retorna
Set<ITestDevice.ApexInfo> Set de ApexInfo ativados no dispositivo
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract Map<String, String> getAllSettings (String namespace)

Retorna pares de chave-valor do namespace solicitado.

Parâmetros
namespace String: precisa ser um dos valores {"system", "secure", "global"}
Retorna
Map<String, String> o mapa de pares de chave-valor. Nulo se o namespace for indisponí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 Map<Integer, String> getAndroidIds ()

Crie um mapa de IDs do Android encontrados 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 nulo.

Retorna
Map<Integer, String> 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 List<PackageInfo> getAppPackageInfos ()

Busca informações de pacotes instalados no dispositivo.

Retorna
List<PackageInfo> 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 sdcard (ou em que o sdcard 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 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 Set<DeviceFoldableState> getFoldableStates ()

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

Retorna
Set<DeviceFoldableState>

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract Set<String> getInstalledPackageNames ()

Extraia os nomes de pacotes de aplicativos presentes no dispositivo.

Retorna
Set<String> 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 null 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 Set<String> getMainlineModuleInfo ()

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

Retorna
Set<String> 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 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 (String userType)

Recebe o número máximo de usuários compatíveis do tipo de usuário especificado. O padrão é 0.

Parâmetros
userType String: o tipo de usuário, conforme definido no UserManager, como "android.os.usertype.full.SECONDARY".
Retorna
int um número inteiro que indica o número de usuários compatíveis do tipo de usuário especificado
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Esse método foi descontinuado.
use getMaxNumberOfUsersSupported(String userType) to obtain the max number of supported users for a given user type.

Recebe o número máximo de usuários alternáveis compatíveis, sem incluir convidados. Depois da versão 36 da API, não inclui usuários não alternáveis (como perfis). O padrão é 0.

Retorna
int um número inteiro que indica a quantidade de usuários alternáveis compatíveis
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. Observação: 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

getRemainingCreatableUserCount

public abstract int getRemainingCreatableUserCount (String userType)

Retorna quantos usuários do tipo especificado podem ser criados neste dispositivo.

Parâmetros
userType String: o tipo de usuário, conforme definido no UserManager, como "android.os.usertype.full.SECONDARY".
Retorna
int quantos usuários do tipo especificado podem ser adicionados
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (Long displayId, 
                String format, 
                boolean rescale)

Faz uma captura de tela do dispositivo com o ID de exibição e o formato compatível. Permitir redimensionamento para oferecer suporte a tamanhos menores

Parâmetros
displayId Long: o ID de exibição da tela de onde a captura de tela será feita.
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 feita.
Gera
com.android.tradefed.device.DeviceNotAvailableException
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 feita.
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 feita.
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 de onde a captura de tela será feita.
Retorna
InputStreamSource um InputStreamSource da captura de tela no formato ou null se a captura de tela não foi feita.
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 Set<String> 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 do sistema atualizados.

Retorna
Set<String> 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, ou -10000 em qualquer outro caso.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract Map<Integer, UserInfo> 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
Map<Integer, UserInfo> 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

getUserVisibleOnDisplay

public abstract int getUserVisibleOnDisplay (int displayId)

Recebe o ID do usuário visível na tela especificada.

Parâmetros
displayId int: o ID da tela.
Retorna
int o ID do usuário visível na tela especificada. Ele não diferencia um usuário em segundo plano visível do usuário em primeiro plano atual, já que ambos os tipos são visíveis. Para diferenciar, compare ainda mais com o resultado de getCurrentUser().
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, 
                boolean grantPermissions, 
                String... extraArgs)

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

installPackage

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

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

installPackageForUser

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

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

installPackageForUser

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                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 com sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

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 (List<File> packageFiles, 
                boolean reinstall, 
                String... extraArgs)

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

Parâmetros
packageFiles List: 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 com sucesso.
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 (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Instale um app 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 List: 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 com sucesso.
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 (List<File> packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Instale um app 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 List: 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 com sucesso.
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 (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Instale um app 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 List: 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 com sucesso.
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 ()

Retorna se este dispositivo é compatível com vários usuários alternáveis com login próprio e espaço personalizável.

Mesmo que seja "false", vários usuários ainda podem ser possíveis, desde que nenhuma interface de login seja necessária. Por exemplo, os perfis ainda podem ser compatíveis, já que não exigem uma interface de login.

Isso também verifica config_enableMultiUserUI. Por demanda, podemos presumir que os dispositivos em que isso é verdade estão configurados para permitir a adição de usuários secundários via adb.

Retorna
boolean se o dispositivo é compatível com vários usuários alternáveis.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

Parâmetros
packageName String: o pacote que estamos verificando se está instalado.
userId String: o ID do usuário para 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.

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 tela retornada por listDisplayIdsForStartingVisibleBackgroundUsers().

Retorna
boolean

Gera
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Teste se o Wi-Fi está ativado.

Verifica se o Wi-Fi está ativado no dispositivo. Útil para declarar o status do Wi-Fi antes de testes que não 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 Set<Long> listDisplayIds ()

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

Retorna
Set<Long> A lista de telas. O padrão sempre retorna a exibição padrão 0.
Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Retorna
Set<Integer>

Gera
DeviceNotAvailableException

listUsers

public abstract ArrayList<Integer> listUsers ()

Recebe a lista de usuários no dispositivo. Vai gerar DeviceRuntimeException se a saída do dispositivo não for a esperada.

Retorna
ArrayList<Integer> 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 registrar para os repórteres.

Parâmetros
dataName String: nome em que o bugreport será informado.
listener ITestLogger: um ITestLogger para registrar o bugreport.
Retorna
boolean 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)

Remove o administrador de dispositivo do usuário especificado e retorna 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)

Remove 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 no usuário especificado.

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 o comando esperar 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. Isso permite 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, 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 o comando esperar 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 verdadeiro 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 a operação ter efeito 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 verdadeiro 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 com sucesso.
Gera
DeviceNotAvailableException se a conexão com o dispositivo for perdida e não puder ser recuperada.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

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

Parâmetros
currentPhase SnapuserdWaitPhase

Gera
DeviceNotAvailableException