Dispositivo de teste

public class TestDevice
extends NativeDevice

java.lang.Object
com.android.tradefed.device.NativeDevice
com.android.tradefed.device.TestDevice


Implementação de um ITestDevice para um dispositivo Android full stack

Resumo

Classes aninhadas

class TestDevice.MicrodroidBuilder

Um construtor usado para criar um Microdroid TestDevice.

Campos

public static final String DISMISS_KEYGUARD_CMD

Comandos que podem ser usados ​​para dispensar a proteção do teclado.

Construtores públicos

TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Métodos públicos

boolean canSwitchToHeadlessSystemUser ()

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

boolean clearErrorDialogs ()

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

int createUser (String name)

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

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

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

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

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

int createUserNoThrow (String name)

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

void disableKeyguard ()

Tentativas de desativar a proteção do teclado.

boolean doesFileExist (String deviceFilePath)

Método auxiliar para determinar se o arquivo no dispositivo existe.

boolean doesFileExist (String deviceFilePath, int userId)

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

File dumpHeap (String process, String devicePath)

Tente despejar o heap do system_server.

getActiveApexes ()

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

getAllSettings (String namespace)

Retorna pares de valores-chave do namespace solicitado.

String getAndroidId (int userId)

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

getAndroidIds ()

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

PackageInfo getAppPackageInfo (String packageName)

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

getAppPackageInfos ()

Busque informações de pacotes instalados no dispositivo.

InputStreamSource getBugreport ()

Recupera um relatório de bug do dispositivo.

InputStreamSource getBugreportz ()

Recupera um bugreportz do dispositivo.

DeviceFoldableState getCurrentFoldableState ()

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

int getCurrentUser ()

Retorne o ID do usuário em execução atual.

getFoldableStates ()

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

getInstalledPackageNames ()

Busque os nomes dos pacotes de aplicativos presentes no dispositivo.

KeyguardControllerState getKeyguardState ()

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

Integer getMainUserId ()

Retorna o ID do usuário principal.

getMainlineModuleInfo ()

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

int getMaxNumberOfRunningUsersSupported ()

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

int getMaxNumberOfUsersSupported ()

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

Integer getPrimaryUserId ()

Retorna o ID do usuário principal.

InputStreamSource getScreenshot ()

Captura uma captura de tela do dispositivo.

InputStreamSource getScreenshot (String format, boolean rescale)

Captura uma captura de tela do dispositivo.

InputStreamSource getScreenshot (String format)

Captura uma captura de tela do dispositivo.

InputStreamSource getScreenshot (long displayId)

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

String getSetting (String namespace, String key)

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

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

Retorne o valor da configuração solicitada.

getUninstallablePackageNames ()

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

int getUserFlags (int userId)

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

getUserInfos ()

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

int getUserSerialNumber (int userId)

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

boolean hasFeature (String feature)

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

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

Instale um pacote Android no dispositivo.

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

Instale um pacote Android no dispositivo.

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

Instale um pacote Android no dispositivo.

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

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

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

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

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

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

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

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

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

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

boolean isAppEnumerationSupported ()

Verifique se a plataforma no dispositivo suporta enumeração de aplicativos

boolean isHeadlessSystemUserMode ()

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

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.

boolean isMultiUserSupported ()

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

boolean isPackageInstalled (String packageName)

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

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.

boolean isUserRunning (int userId)

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

boolean isUserSecondary (int userId)

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

boolean isUserVisible (int userId)

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

boolean isUserVisibleOnDisplay (int userId, int displayId)

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

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

boolean isVisibleBackgroundUsersSupported ()

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

listDisplayIds ()

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

listDisplayIdsForStartingVisibleBackgroundUsers ()

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

listUsers ()

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

boolean logBugreport (String dataName, ITestLogger listener)

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

void postInvocationTearDown (Throwable exception)

Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a invocação.

boolean removeAdmin (String componentName, int userId)

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

void removeOwners ()

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

boolean removeUser (int userId)

Remova um determinado usuário do dispositivo.

boolean setDeviceOwner (String componentName, int userId)

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

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

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

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

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

void shutdownMicrodroid ( ITestDevice microdroidDevice)

Desliga o dispositivo microdroid, se existir.

boolean startUser (int userId)

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

boolean startUser (int userId, boolean waitFlag)

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

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

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

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

Pare um determinado usuário.

boolean stopUser (int userId)

Interrompe um determinado usuário.

boolean supportsMicrodroid ()

Verifica as pré-condições para executar um microdroid.

boolean supportsMicrodroid (boolean protectedVm)

Verifica as pré-condições para executar um microdroid.

boolean switchUser (int userId)

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

boolean switchUser (int userId, long timeout)

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

Bugreport takeBugreport ()

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

String uninstallPackage (String packageName)

Desinstale um pacote Android do dispositivo.

String uninstallPackageForUser (String packageName, int userId)

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

Métodos protegidos

AaptParser createParser (File appFile)
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

Execute uma reinicialização do adb.

InputStreamSource getBugreportInternal ()
File getBugreportzInternal ()

Método auxiliar interno para obter o arquivo zip bugreportz como um ERROR(/File) .

long getCheckNewUserSleep ()

Exposto para testes.

long getHostCurrentTime ()

Exposto para testes

void prePostBootSetup ()

Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) substitua esse método para configuração específica pós-inicialização.

Campos

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Comandos que podem ser usados ​​para dispensar a proteção do teclado.

Construtores públicos

Dispositivo de teste

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Métodos públicos

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Devoluções
boolean

Lança
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

Lança
DeviceNotAvailableException

criarUsuário

public int createUser (String name)

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

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

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

Lança
DeviceNotAvailableException

criarUsuário

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

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

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

guest boolean : habilita o sinalizador do usuário --guest durante a criação

ephemeral boolean : habilita o sinalizador do usuário --ephemeral durante a criação

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

Devoluções
int id do usuário criado

Lança
DeviceNotAvailableException

criarUsuário

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

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

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

guest boolean : habilita o sinalizador do usuário --guest durante a criação

ephemeral boolean : habilita o sinalizador do usuário --ephemeral durante a criação

Devoluções
int id do usuário criado

Lança
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

Lança
DeviceNotAvailableException

desabilitarKeyguard

public void disableKeyguard ()

Tentativas de desativar a proteção do teclado.

Primeiro espere que o despacho de entrada fique pronto, isso acontece quase ao mesmo tempo em que o dispositivo reporta BOOT_COMPLETE, aparentemente de forma assíncrona, porque a implementação da estrutura atual tem condições de corrida ocasionais. Em seguida, o comando é enviado para descartar a proteção do teclado (funciona apenas em dispositivos não seguros)

Lança
DeviceNotAvailableException

fazFileExist

public boolean doesFileExist (String deviceFilePath)

Método auxiliar para determinar se o arquivo no dispositivo existe.

Parâmetros
deviceFilePath String : o caminho absoluto do arquivo no dispositivo a ser verificado

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

Lança
DeviceNotAvailableException

fazFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Parâmetros
deviceFilePath String : o caminho absoluto do arquivo no dispositivo a ser verificado

userId int : O ID do usuário para verificar a existência do arquivo

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

Lança
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

Parâmetros
process String : o nome do processo do dispositivo no qual dumpheap.

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

Devoluções
File o ERROR(/File) que contém o relatório. Nulo se algo falhou.

Lança
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

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

Lança
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

Retorna pares de valores-chave do namespace solicitado.

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

Devoluções
o mapa de pares de valores-chave. Nulo se o namespace não for compatível.

Lança
DeviceNotAvailableException

obterAndroidId

public String getAndroidId (int userId)

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

Parâmetros
userId int

Devoluções
String

Lança
DeviceNotAvailableException

obterAndroidIds

public  getAndroidIds ()

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

Devoluções
Mapa de IDs de Android encontrados com IDs de usuário correspondentes.

Lança
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

Parâmetros
packageName String

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

Lança
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Busque informações de pacotes instalados no dispositivo.

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

Lança
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

Recupera um relatório de bug do dispositivo.

É garantido que a implementação disso continuará funcionando em um dispositivo sem cartão sd (ou onde o cartão sd ainda não está montado).

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

getBugreportz

public InputStreamSource getBugreportz ()

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

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

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

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Devoluções
DeviceFoldableState

Lança
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

Devoluções
int

Lança
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

Devoluções

Lança
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

Busque os nomes dos pacotes de aplicativos presentes no dispositivo.

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

Lança
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

Lança
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

Retorna o ID do usuário principal.

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

Lança
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

Lança
DeviceNotAvailableException

getMaxNumberOfRunningUsers suportados

public int getMaxNumberOfRunningUsersSupported ()

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

Devoluções
int um número inteiro indicando o número de usuários em execução simultânea

Lança
DeviceNotAvailableException

getMaxNumberOfUsers suportados

public int getMaxNumberOfUsersSupported ()

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

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

Lança
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

Retorna o ID do usuário principal.

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

Lança
DeviceNotAvailableException

obter captura de tela

public InputStreamSource getScreenshot ()

Captura uma captura de tela do dispositivo.

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

Lança
DeviceNotAvailableException

obter captura de tela

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

Parâmetros
format String : PNG e JPEG suportados

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

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

Lança
DeviceNotAvailableException

obter captura de tela

public InputStreamSource getScreenshot (String format)

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

Parâmetros
format String : PNG e JPEG suportados

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

Lança
DeviceNotAvailableException

obter captura de tela

public InputStreamSource getScreenshot (long displayId)

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

TODO: estender as implementações acima para suportar 'formatar' e 'redimensionar'

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

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

Lança
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

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

Parâmetros
namespace String

key String

Devoluções
String

Lança
DeviceNotAvailableException

getSetting

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

Retorne o valor da configuração solicitada. namespace deve ser um dos seguintes: {"system", "secure", "global"}

Parâmetros
userId int

namespace String

key String

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

Lança
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

Lança
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

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

Parâmetros
userId int

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

Lança
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

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

Devoluções
a lista de objetos UserInfo.

Lança
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

Parâmetros
userId int

Devoluções
int

Lança
DeviceNotAvailableException

temRecurso

public boolean hasFeature (String feature)

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

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

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

Lança
DeviceNotAvailableException

instalarPacote

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

Instale um pacote Android no dispositivo.

Parâmetros
packageFile File : o arquivo apk para instalar

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

extraArgs String : argumentos extras opcionais a serem passados. Consulte 'adb shell pm -h' para opções disponíveis.

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

Lança
DeviceNotAvailableException

instalarPacote

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

Instale um pacote Android no dispositivo.

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

Parâmetros
packageFile File : o arquivo apk para instalar

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

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

extraArgs String : argumentos extras opcionais a serem passados. Consulte 'adb shell pm -h' para opções disponíveis.

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

Lança
DeviceNotAvailableException

instalarPacote

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

Instale um pacote Android no dispositivo.

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

Parâmetros
packageFile File : o arquivo apk para instalar

certFile File : true se uma reinstalação precisar ser realizada

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

extraArgs String : argumentos extras opcionais a serem passados. Consulte 'adb shell pm -h' para opções disponíveis.

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

Lança
DeviceNotAvailableException

instalarPackageForUser

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

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

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

Parâmetros
packageFile File : o arquivo apk para instalar

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

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

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

extraArgs String : argumentos extras opcionais a serem passados. Consulte 'adb shell pm -h' para opções disponíveis.

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

Lança
DeviceNotAvailableException

instalarPackageForUser

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

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

Parâmetros
packageFile File : o arquivo apk para instalar

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

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

extraArgs String : argumentos extras opcionais a serem passados. Consulte 'adb shell pm -h' para opções disponíveis.

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

Lança
DeviceNotAvailableException

instalar pacotes

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

Parâmetros
packageFiles

reinstall boolean

extraArgs String

Devoluções
String

Lança
DeviceNotAvailableException

instalar pacotes

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

Parâmetros
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

Devoluções
String

Lança
DeviceNotAvailableException

instalarPackagesForUser

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

Parâmetros
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

Devoluções
String

Lança
DeviceNotAvailableException

instalarPackagesForUser

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

Parâmetros
packageFiles

reinstall boolean

userId int

extraArgs String

Devoluções
String

Lança
DeviceNotAvailableException

instalarRemotePackages

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

Parâmetros
remoteApkPaths

reinstall boolean

extraArgs String

Devoluções
String

Lança
DeviceNotAvailableException

instalarRemotePackages

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

Parâmetros
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

Devoluções
String

Lança
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Verifique se a plataforma no dispositivo suporta enumeração de aplicativos

Devoluções
boolean Verdadeiro se a enumeração de aplicativos for compatível; caso contrário, falso

Lança
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

Devoluções
boolean

Lança
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

Devoluções
boolean

Lança
DeviceNotAvailableException

isMultiUserSupportado

public boolean isMultiUserSupported ()

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

Devoluções
boolean verdadeiro se houver suporte para vários usuários; caso contrário, falso

Lança
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

Parâmetros
packageName String

Devoluções
boolean Verdadeiro se o pacote for relatado como instalado. Caso contrário, falso.

Lança
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

Devoluções
boolean Verdadeiro se o pacote for relatado como instalado. Caso contrário, falso.

Lança
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

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

Parâmetros
userId int

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

Lança
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

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

Parâmetros
userId int

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

Lança
DeviceNotAvailableException

isUserVisible

public boolean isUserVisible (int userId)

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

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

Parâmetros
userId int

Devoluções
boolean

Lança
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

Parâmetros
userId int

displayId int

Devoluções
boolean

Lança
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

Devoluções
boolean

Lança
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

Devoluções
boolean

Lança
DeviceNotAvailableException

listaDisplayIds

public  listDisplayIds ()

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

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

Lança
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Devoluções

Lança
DeviceNotAvailableException

listaUsuários

public  listUsers ()

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

Devoluções
a lista de IDs de usuário.

Lança
DeviceNotAvailableException

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

Parâmetros
dataName String : nome sob o qual o bugreport será reportado.

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

Devoluções
boolean Verdadeiro se o registro foi bem-sucedido; caso contrário, falso.

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Etapas extras para limpeza necessária específica do dispositivo que serão executadas após a invocação.

Parâmetros
exception Throwable : se houver, a exceção final levantada pela falha de invocação.

removerAdmin

public boolean removeAdmin (String componentName, 
                int userId)

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

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

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

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

Lança
DeviceNotAvailableException

removerProprietários

public void removeOwners ()

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

Lança
DeviceNotAvailableException

removerUsuário

public boolean removeUser (int userId)

Remova um determinado usuário do dispositivo.

Parâmetros
userId int : do usuário a ser removido

Devoluções
boolean verdadeiro se obtivermos sucesso na remoção do usuário; caso contrário, falso.

Lança
DeviceNotAvailableException

setDeviceOwner

public 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 reside o proprietário do dispositivo.

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

Lança
DeviceNotAvailableException

definirConfiguração

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

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

Parâmetros
namespace String

key String

value String

Lança
DeviceNotAvailableException

definirConfiguração

public 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 a reinicialização. namespace deve ser um dos seguintes: {"system", "secure", "global"}

Parâmetros
userId int

namespace String

key String

value String

Lança
DeviceNotAvailableException

desligamentoMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Desliga o dispositivo microdroid, se existir.

Parâmetros
microdroidDevice ITestDevice

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

usuário inicial

public boolean startUser (int userId)

Inicia um determinado usuário em segundo plano se ele estiver parado no momento. Se o usuário já estiver executando em segundo plano, este 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.

Lança
DeviceNotAvailableException

usuário inicial

public boolean startUser (int userId, 
                boolean waitFlag)

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

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.

Lança
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

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

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

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

Devoluções
boolean true se o usuário foi iniciado com sucesso e visível em segundo plano.

Lança
DeviceNotAvailableException

pararUsuário

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

Pare um determinado usuário. É possível fornecer sinalizadores extras para aguardar o efeito da operação 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 interrompido.

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

Devoluções
boolean true se o usuário foi interrompido com sucesso.

Lança
DeviceNotAvailableException

pararUsuário

public boolean stopUser (int userId)

Interrompe um determinado usuário. Se o usuário já estiver parado, este 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 sucesso.

Lança
DeviceNotAvailableException

suportaMicrodroid

public boolean supportsMicrodroid ()

Verifica as pré-condições para executar um microdroid.

Devoluções
boolean retorna verdadeiro se as pré-condições forem satisfeitas, falso caso contrário.

suportaMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Verifica as pré-condições para executar um microdroid.

Parâmetros
protectedVm boolean : verdadeiro se o microdroid for executado em VM protegida.

Devoluções
boolean retorna verdadeiro se as pré-condições forem satisfeitas, falso caso contrário.

mudar de utilizador

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

Lança
DeviceNotAvailableException

mudar de utilizador

public boolean switchUser (int userId, 
                long timeout)

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

Parâmetros
userId int

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

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

Lança
DeviceNotAvailableException

pegueBugreport

public Bugreport takeBugreport ()

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

Devoluções
Bugreport

desinstalarPackage

public String uninstallPackage (String packageName)

Desinstale um pacote Android do dispositivo.

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

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

Lança
DeviceNotAvailableException

desinstalarPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Desinstale 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 para desinstalar.

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

Lança
DeviceNotAvailableException

Métodos protegidos

criarParser

protected AaptParser createParser (File appFile)

Parâmetros
appFile File

Devoluções
AaptParser

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Execute uma reinicialização do adb.

Parâmetros
rebootMode NativeDevice.RebootMode : um modo desta reinicialização.

reason String : para esta reinicialização.

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

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

Devoluções
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

Método auxiliar interno para obter o arquivo zip bugreportz como um ERROR(/File) .

Devoluções
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Exposto para testes.

Devoluções
long

getHostCurrentTime

protected long getHostCurrentTime ()

Exposto para testes

Devoluções
long

prePostBootSetup

protected void prePostBootSetup ()

Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) substitua esse método para configuração específica pós-inicialização.

Lança
DeviceNotAvailableException