Dispositivo de teste

public class TestDevice
extends NativeDevice

java.lang.Object
   ↳ com.android.tradefed.device.NativeDevice (link em inglês)
     ↳ com.android.tradefed.device.TestDevice


Implementação de um ITestDevice para um dispositivo Android de pilha completa

Resumo

Classes aninhadas

class TestDevice.MicrodroidBuilder

Um builder usado para criar um Microdroid TestDevice. 

Campos

public static final String DISMISS_KEYGUARD_CMD

Comandos que podem ser usados para dispensar o bloqueio de teclado.

Construtores públicos

TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Métodos públicos

boolean canSwitchToHeadlessSystemUser()

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

boolean clearErrorDialogs()

Tentativa de dispensar todas as caixas de diálogo de erro exibidas no momento na interface do dispositivo.

int createUser(String name)

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

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

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

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

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

int createUserNoThrow(String name)

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

void disableKeyguard()

Tenta desativar o bloqueio de teclado.

boolean doesFileExist(String deviceFilePath)

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

boolean doesFileExist(String deviceFilePath, int userId)

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

File dumpHeap(String process, String devicePath)

Tenta despejar a heap do system_server.

getActiveApexes()

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

getAllSettings(String namespace)

Retorna pares de chave-valor do namespace solicitado.

String getAndroidId(int userId)

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

getAndroidIds()

Cria um mapa de IDs do Android encontrados que correspondem a IDs de usuário.

PackageInfo getAppPackageInfo(String packageName)

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

getAppPackageInfos()

Busca informações dos pacotes instalados no dispositivo.

InputStreamSource getBugreport()

Recupera um relatório de bug do dispositivo.

InputStreamSource getBugreportz()

Recupera um relatório de bugs do dispositivo.

DeviceFoldableState getCurrentFoldableState()

Retorna o estado dobrável atual do dispositivo ou retorna nulo caso ocorram problemas.

int getCurrentUser()

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

getFoldableStates()

Retorna a lista de estados dobráveis no dispositivo.

getInstalledPackageNames()

Busque os nomes dos pacotes de apps presentes no dispositivo.

KeyguardControllerState getKeyguardState()

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

Integer getMainUserId()

Retorna o ID do usuário principal.

getMainlineModuleInfo()

Consiga as informações sobre os módulos de linha principal instalados no dispositivo.

int getMaxNumberOfRunningUsersSupported()

Receba o número máximo permitido de usuários em execução simultânea.

int getMaxNumberOfUsersSupported()

Descubra o número máximo de usuários permitidos.

Integer getPrimaryUserId()

Retorna o ID do usuário principal.

InputStreamSource getScreenshot()

Faz uma captura de tela do dispositivo.

InputStreamSource getScreenshot(String format, boolean rescale)

Faz uma captura de tela do dispositivo.

InputStreamSource getScreenshot(String format)

Faz uma captura de tela do dispositivo.

InputStreamSource getScreenshot(long displayId)

Faz uma captura de tela do ID de tela do dispositivo.

String getSetting(String namespace, String key)

Consulte getSetting(int, String, String) e realizada em um usuário do sistema.

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

Retorna o valor da configuração solicitada.

getUninstallablePackageNames()

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

int getUserFlags(int userId)

Encontre e retorne as sinalizações de um determinado usuário.

getUserInfos()

Recebe o mapa de useId para UserInfo no dispositivo.

int getUserSerialNumber(int userId)

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

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)

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

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

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

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

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

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

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

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

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

boolean isAppEnumerationSupported()

Verificar se a plataforma do dispositivo oferece suporte à enumeração de apps

boolean isHeadlessSystemUserMode()

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

boolean isMainUserPermanentAdmin()

Informa 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 em busca de um nome de pacote específico para verificar se ele está instalado ou não.

boolean isPackageInstalled(String packageName, String userId)

Consulte o dispositivo em busca de um determinado nome de pacote e ID do 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 as sinalizações dele.

boolean isUserVisible(int userId)

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

boolean isUserVisibleOnDisplay(int userId, int displayId)

Verifica se o usuário especificado está visível na tela 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()

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

listDisplayIds()

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

listDisplayIdsForStartingVisibleBackgroundUsers()

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

listUsers()

Recebe a lista de usuários no dispositivo.

boolean logBugreport(String dataName, ITestLogger listener)

Método auxiliar para registrar um relatório de bug e registrá-lo.

void notifySnapuserd(SnapuserdWaitPhase waitPhase)
void postInvocationTearDown(Throwable exception)

Etapas extras para a limpeza específica do dispositivo que serão executadas após a invocação é concluída.

boolean removeAdmin(String componentName, int userId)

Remove o administrador do dispositivo de um determinado usuário e retorna true quando o processo é bem-sucedido. Caso contrário, retorna false.

void removeOwners()

Remova todos os proprietários de perfil de dispositivo existentes da melhor maneira possível.

boolean removeUser(int userId)

Remove determinado usuário do dispositivo.

boolean setDeviceOwner(String componentName, int userId)

Define um componente de administrador do dispositivo como proprietário do dispositivo em um determinado usuário.

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

Consulte setSetting(int, String, String, String) e realizada em um usuário do sistema.

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

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

void shutdownMicrodroid(ITestDevice microdroidDevice)

Desliga o dispositivo microdroide, se houver um.

boolean startUser(int userId)

Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento.

boolean startUser(int userId, boolean waitFlag)

Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento.

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

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

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

Interrompa um determinado usuário.

boolean stopUser(int userId)

Interrompe um determinado usuário.

boolean supportsMicrodroid()

Verifica as condições prévias para executar um microdroide.

boolean supportsMicrodroid(boolean protectedVm)

Verifica as condições prévias para executar um microdroide.

boolean switchUser(int userId)

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

boolean switchUser(int userId, long timeout)

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

Bugreport takeBugreport()

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

String uninstallPackage(String packageName)

Desinstala um pacote Android do dispositivo.

String uninstallPackageForUser(String packageName, int userId)

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

void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

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 receber o arquivo ZIP do bugreportz como um ERROR(/File).

long getCheckNewUserSleep()

Exposto para teste.

long getHostCurrentTime()

Exposto para teste

void prePostBootSetup()

Permite que cada tipo de dispositivo (AndroidNativeDevice, TestDevice) modifique 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 o bloqueio de 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 alternar para o usuário headless SYSTEM.

Retorna
boolean

Gera
DeviceNotAvailableException

ClearErrorDialogs

public boolean clearErrorDialogs ()

Tentativa de dispensar todas as caixas de diálogo de erro exibidas no momento na interface do dispositivo.

Retorna
boolean true se nenhuma caixa de diálogo estiver presente ou se elas tiverem sido apagadas. Caso contrário, false.

Gera
DeviceNotAvailableException

usuário

public int createUser (String name)

Cria um usuário com um nome determinado 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
DeviceNotAvailableException

usuário

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

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

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

guest boolean: ativa a flag de usuário --guest durante a criação.

ephemeral boolean: ativa a sinalização de usuário "-efêmero" durante a criação.

forTesting boolean: ativa a flag de teste --for-testing durante a criação.

Retorna
int ID do usuário criado

Gera
DeviceNotAvailableException

usuário

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

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

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

guest boolean: ativa a flag de usuário --guest durante a criação.

ephemeral boolean: ativa a sinalização de usuário "-efêmero" durante a criação.

Retorna
int ID do usuário criado

Gera
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

Cria um usuário com um nome determinado 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 para o erro.

Gera
DeviceNotAvailableException

desativarKeyguard

public void disableKeyguard ()

Tenta desativar o bloqueio de teclado.

Primeiro, aguarde até que o envio de entradas fique pronto. Isso acontece aproximadamente no mesmo momento em que o dispositivo informa BOOT_COMPLETE, de forma aparentemente assíncrona, porque o framework atual tem uma disputa ocasional. Em seguida, o comando é enviado para dispensar o bloqueio de teclado (funciona somente em aplicativos não seguros)

Gera
DeviceNotAvailableException

fazFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

Retorna
boolean true se o arquivo existir. Caso contrário, retorna false.

Gera
DeviceNotAvailableException

fazFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

Retorna
boolean true se o arquivo existir. Caso contrário, retorna false.

Gera
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Tenta despejar a heap do system_server. É responsabilidade do autor da chamada limpar o arquivo despejado.

Parâmetros
process String: o nome do processo do dispositivo em que o despejo de heap será feito.

devicePath String: o caminho no dispositivo em que o despejo será colocado. Precisa ser um local se houver permissão para isso.

Retorna
File o ERROR(/File) que contém o relatório. Nulo se algo falhar.

Gera
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

Retorna
ERROR(/Set) de ApexInfo ativados no dispositivo no momento

Gera
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

Retorna pares de chave-valor do namespace solicitado.

Parâmetros
namespace String: precisa ser {"system", "secure", "global"}

Retorna
o mapa de pares de chave-valor. Nulo se o namespace não for compatível.

Gera
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

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

Parâmetros
userId int

Retorna
String

Gera
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

Cria um mapa de IDs do Android encontrados que correspondem a IDs de usuário. Não há nenhum seguro de que cada usuário ID encontrou um ID do Android associado a essa função, de modo que alguns IDs de usuário podem ter correspondência de valores nulos.

Retorna
Foi encontrado um mapa de IDs do Android com IDs de usuário correspondentes.

Gera
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

Parâmetros
packageName String

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

Gera
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Busca informações dos pacotes instalados no dispositivo.

Retorna
ERROR(/List) de PackageInfos instalados no dispositivo.

Gera
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

Recupera um relatório de bug do dispositivo.

A implementação vai continuar funcionando em dispositivos sem cartão SD (ou onde o cartão SD ainda não está montado).

Retorna
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 relatório de bugs do dispositivo. O relatório de bug no formato ZIP contém o principal relatório de bug e 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, retorna nulo no em caso de falha.

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Retorna o estado dobrável atual do dispositivo ou retorna nulo caso ocorram problemas.

Retorna
DeviceFoldableState

Gera
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

Retorna
int

Gera
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

Retorna

Gera
DeviceNotAvailableException

getInstallPackageNames

public  getInstalledPackageNames ()

Busque os nomes dos pacotes de apps presentes no dispositivo.

Retorna
ERROR(/Set) de String nomes de pacotes atualmente instalados no dispositivo.

Gera
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

Retorna
KeyguardControllerState um KeyguardControllerState contendo um snapshot do estado do bloqueio de teclado e retorna Nulo se a consulta do Keyguard não tiver suporte.

Gera
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

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
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Consiga as informações sobre os módulos de linha principal instalados no dispositivo.

Retorna
ERROR(/Set) de String módulos de linha principal instalados atualmente no dispositivo.

Gera
DeviceNotAvailableException

getMaxNumberOfRunningUsersAllowed

public int getMaxNumberOfRunningUsersSupported ()

Receba o número máximo permitido de usuários em execução simultânea. O valor padrão é 0.

Retorna
int Um número inteiro que indica o número de usuários em execução simultânea

Gera
DeviceNotAvailableException

getMaxNumberOfUsersAllowed

public int getMaxNumberOfUsersSupported ()

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

Retorna
int Um número inteiro que indica o número de usuários compatíveis

Gera
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

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
DeviceNotAvailableException

getCaptura de tela

public InputStreamSource getScreenshot ()

Faz uma captura de tela do dispositivo.

Retorna
InputStreamSource uma InputStreamSource da captura de tela em formato PNG ou null se falha na captura de tela.

Gera
DeviceNotAvailableException

getCaptura de tela

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

Parâmetros
format String: PNG e JPEG compatíveis

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

Retorna
InputStreamSource um InputStreamSource da captura de tela no formato, ou null se o não foi possível fazer a captura de tela.

Gera
DeviceNotAvailableException

getCaptura de tela

public InputStreamSource getScreenshot (String format)

Faz uma captura de tela do dispositivo. É recomendável usar getCaptura de tela(format) em vez da codificação JPEG para tamanhos menores

Parâmetros
format String: PNG e JPEG compatíveis

Retorna
InputStreamSource uma InputStreamSource da captura de tela no formato, ou null se falha na captura de tela.

Gera
DeviceNotAvailableException

getCaptura de tela

public InputStreamSource getScreenshot (long displayId)

Faz uma captura de tela do ID de tela do dispositivo. O formato é PNG.

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

Parâmetros
displayId long: o ID da tela de onde a captura de tela será feita.

Retorna
InputStreamSource um InputStreamSource da captura de tela no formato, ou null se o não foi possível fazer a captura de tela.

Gera
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

Consulte getSetting(int, String, String) e realizada em um usuário do sistema.

Parâmetros
namespace String

key String

Retorna
String

Gera
DeviceNotAvailableException

getSetting

public 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:key de um usuário. Nulo se não for encontrado.

Gera
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

Retorna
ERROR(/Set) de nomes de pacotes String desinstaláveis atualmente instalados no dispositivo.

Gera
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

Encontre e retorne as sinalizações de um determinado usuário. As flags são definidas em "android.content.pm.UserInfo" no Android Open Source Project.

Parâmetros
userId int

Retorna
int as sinalizações associadas ao userId fornecido, se encontrados, -10000 em qualquer outro caso.

Gera
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

Recebe o mapa de useId para UserInfo no dispositivo. Uma DeviceRuntimeException vai ser gerada se a saída do dispositivo não for a esperada.

Retorna
a lista de objetos UserInfo.

Gera
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

Parâmetros
userId int

Retorna
int

Gera
DeviceNotAvailableException

hasFeature

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.

Retorna
boolean Verdadeiro se o atributo for encontrado. Caso contrário, será falso.

Gera
DeviceNotAvailableException

installPackage

public 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 realizada.

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException

installPackage

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

Instale um pacote Android no dispositivo.

Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em o horário de instalação precisa chamar essa função.

Parâmetros
packageFile File: o arquivo apk a ser instalado.

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

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

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException

installPackage

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

Instale um pacote Android no dispositivo.

Observação: somente casos de uso que exijam controle explícito da concessão de permissão de execução em o horário de instalação precisa chamar essa função.

Parâmetros
packageFile File: o arquivo apk a ser instalado.

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

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

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException

installPackageForUser

public 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: somente casos de uso que exijam controle explícito da concessão de permissão de execução em o horário de instalação precisa chamar essa função.

Parâmetros
packageFile File: o arquivo apk a ser instalado.

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

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

userId int: o ID do usuário inteiro para fazer a instalação.

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException

installPackageForUser

public 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 realizada.

userId int: o ID do usuário inteiro para fazer a instalação.

extraArgs String: argumentos extras opcionais a serem transmitidos. Consulte "adb shell pm -h" disponíveis .

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException

installPackages

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

Parâmetros
packageFiles

reinstall boolean

extraArgs String

Retorna
String

Gera
DeviceNotAvailableException

installPackages

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

Parâmetros
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

Retorna
String

Gera
DeviceNotAvailableException

installPackagesForUser

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

Parâmetros
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

Retorna
String

Gera
DeviceNotAvailableException

installPackagesForUser

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

Parâmetros
packageFiles

reinstall boolean

userId int

extraArgs String

Retorna
String

Gera
DeviceNotAvailableException

installRemotePackages

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

Parâmetros
remoteApkPaths

reinstall boolean

extraArgs String

Retorna
String

Gera
DeviceNotAvailableException

installRemotePackages

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

Parâmetros
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

Retorna
String

Gera
DeviceNotAvailableException

isAppEnumerationsupported

public boolean isAppEnumerationSupported ()

Verificar se a plataforma do dispositivo oferece suporte à enumeração de apps

Retorna
boolean Verdadeiro se a enumeração do app for compatível. Caso contrário, é falso.

Gera
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

Retorna
boolean

Gera
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Informa 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 boolean isMultiUserSupported ()

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

Retorna
boolean verdadeiro se for compatível com vários usuários, caso contrário será falso

Gera
DeviceNotAvailableException

isPackageInstall

public boolean isPackageInstalled (String packageName)

Consulte o dispositivo em busca de um nome de pacote específico para verificar se ele está instalado ou não.

Parâmetros
packageName String

Retorna
boolean Verdadeiro se o pacote for relatado como instalado. Falso, do contrário.

Gera
DeviceNotAvailableException

isPackageInstall

public boolean isPackageInstalled (String packageName, 
                String userId)

Consulte o dispositivo em busca de 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 em que o pacote está instalado. Se nulo, o usuário principal zero será usado.

Retorna
boolean Verdadeiro se o pacote for relatado como instalado. Falso, do contrário.

Gera
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

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

Parâmetros
userId int

Retorna
boolean Verdadeiro se o usuário estiver correndo e falso em todos os outros casos.

Gera
DeviceNotAvailableException

Secundário do usuário

public boolean isUserSecondary (int userId)

Retorna se o usuário especificado é um usuário secundário, de acordo com as sinalizações dele.

Parâmetros
userId int

Retorna
boolean verdadeiro se o usuário for secundário. Caso contrário, falso.

Gera
DeviceNotAvailableException

isUserVisible

public boolean isUserVisible (int userId)

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

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

Parâmetros
userId int

Retorna
boolean

Gera
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

Um rótulo "visível" usuário é um usuário que está interagindo com o ser humano usuário e, portanto, é capaz de iniciar atividades de inicialização nessa tela.

Parâmetros
userId int

displayId int

Retorna
boolean

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

Se isso acontecer, você pode chamar startVisibleBackgroundUser(int, int, boolean), transmitindo uma exibição retornada por listDisplayIdsForStartingVisibleBackgroundUsers() (que precisa incluir ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Retorna
boolean

Gera
DeviceNotAvailableException

isVisibleBackgroundUsersAllowed

public boolean isVisibleBackgroundUsersSupported ()

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

Se isso acontecer, você pode chamar startVisibleBackgroundUser(int, int, boolean), transmitindo uma tela retornada por listDisplayIdsForStartingVisibleBackgroundUsers().

Retorna
boolean

Gera
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

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

Retorna
A lista de exibições. O padrão sempre retorna a exibição padrão 0.

Gera
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Retorna

Gera
DeviceNotAvailableException

listUsers

public  listUsers ()

Recebe a lista de usuários no dispositivo. Gera DeviceRuntimeException se a saída do dispositivo não é o esperado.

Retorna
a lista de IDs de usuário.

Gera
DeviceNotAvailableException

relatório do bug

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Método auxiliar para registrar um relatório de bug e registrá-lo.

Parâmetros
dataName String: nome em que o relatório do bug será informado.

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

Retorna
boolean Verdadeiro se a geração de registros for bem-sucedida. Caso contrário, é falso.

notificarSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Parâmetros
waitPhase SnapuserdWaitPhase

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Etapas extras para a limpeza específica do dispositivo que serão executadas após a invocação é concluída.

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

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Remove o administrador do dispositivo de um determinado usuário e retorna true quando o processo é bem-sucedido. Caso contrário, retorna false.

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

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

Retorna
boolean Verdadeiro se for bem-sucedido, caso contrário, falso.

Gera
DeviceNotAvailableException

removeOwners

public void removeOwners ()

Remova todos os proprietários de perfil de dispositivo existentes da melhor maneira possível.

Gera
DeviceNotAvailableException

removeUser

public boolean removeUser (int userId)

Remove determinado usuário do dispositivo.

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

Retorna
boolean verdadeiro se conseguirmos remover o usuário, caso contrário é falso.

Gera
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Define um componente de administrador do dispositivo como proprietário do dispositivo em um determinado usuário.

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

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

Retorna
boolean Verdadeiro se for bem-sucedido, caso contrário, falso.

Gera
DeviceNotAvailableException

setSetting

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

Consulte setSetting(int, String, String, String) e realizada em um usuário do sistema.

Parâmetros
namespace String

key String

value String

Gera
DeviceNotAvailableException

setSetting

public 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ó estarão disponíveis após a reinicialização. O namespace precisa ser um destes: {"system", "secure", "global"}

Parâmetros
userId int

namespace String

key String

value String

Gera
DeviceNotAvailableException

stopdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Desliga o dispositivo microdroide, se houver um.

Parâmetros
microdroidDevice ITestDevice

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

usuáriode inicialização

public boolean startUser (int userId)

Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. Se o usuário já estiver executado em segundo plano, esse método é um NOOP.

Parâmetros
userId int: do usuário que começa em segundo plano

Retorna
boolean verdadeiro se o usuário tiver sido iniciado com sucesso em segundo plano.

Gera
DeviceNotAvailableException

usuáriode inicialização

public boolean startUser (int userId, 
                boolean waitFlag)

Inicia um determinado usuário em segundo plano, caso ele esteja interrompido no momento. Se o usuário já estiver executado em segundo plano, esse método é um NOOP. É possível fornecer uma flag extra para aguardar que a operação tenha efeito.

Parâmetros
userId int: do usuário que começa em segundo plano

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

Retorna
boolean verdadeiro se o usuário tiver sido iniciado com sucesso em segundo plano.

Gera
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

Parâmetros
userId int: do usuário que começa em segundo plano

displayId int: tela para iniciar visíveis ao usuário

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

Retorna
boolean true se o usuário tiver sido iniciado visível em segundo plano.

Gera
DeviceNotAvailableException

stopUser

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

Interrompa um determinado usuário. É possível fornecer sinalizações extras para aguardar até que a operação tenha efeito. e forçar o encerramento do usuário. Não é possível interromper o usuário atual e o do sistema.

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

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

forceFlag boolean: força o fechamento do usuário.

Retorna
boolean verdadeiro se o usuário tiver sido interrompido.

Gera
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

Interrompe um determinado usuário. Se o usuário já tiver sido interrompido, esse método será NOOP. Não é possível interromper o usuário atual e o do sistema.

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

Retorna
boolean verdadeiro se o usuário tiver sido interrompido.

Gera
DeviceNotAvailableException

suportaMicrodroid

public boolean supportsMicrodroid ()

Verifica as condições prévias para executar um microdroide.

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

suportaMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Verifica as condições prévias para executar um microdroide.

Parâmetros
protectedVm boolean: verdadeiro se o microdroide for projetado para ser executado em uma VM protegida.

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

switchUser

public 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 userId. Falso, do contrário.

Gera
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

Parâmetros
userId int

timeout long: aguardar antes de retornar "false" para a falha da troca de usuário.

Retorna
boolean Verdadeiro se o novo userId corresponder ao provedor userId. Falso, do contrário.

Gera
DeviceNotAvailableException

Relatório TakeBug

public Bugreport takeBugreport ()

Crie um relatório de bug e o retorne dentro de um objeto Bugreport para processá-lo. Retornar nulo em caso de problema. O arquivo referenciado no objeto Bugreport precisa ser limpo com Bugreport.close().

Retorna
Bugreport

desinstalarPackage

public String uninstallPackage (String packageName)

Desinstala um pacote Android do dispositivo.

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

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException

desinstalarPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

userId int: o ID do usuário inteiro para desinstalar.

Retorna
String um String com um código de erro ou null em caso de sucesso.

Gera
DeviceNotAvailableException

"waitForSnapuserd"

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Parâmetros
currentPhase SnapuserdWaitPhase

Gera
DeviceNotAvailableException

Métodos protegidos

createParser

protected AaptParser createParser (File appFile)

Parâmetros
appFile File

Retorna
AaptParser

doAdbReiniciar

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

Execute uma reinicialização do adb.

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

reason String: para esta reinicialização.

Gera
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

Retorna
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

Método auxiliar interno para receber o arquivo ZIP do bugreportz como um ERROR(/File).

Retorna
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Exposto para teste.

Retorna
long

getHostCurrentTime

protected long getHostCurrentTime ()

Exposto para teste

Retorna
long

Configuração PrePostBoot

protected void prePostBootSetup ()

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

Gera
DeviceNotAvailableException