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 o keyguard.

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

Tente descartar todas as caixas de diálogo de erro atualmente exibidas na interface do usuário 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 ()

Tenta 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 os 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 correspondentes a IDs de usuário.

PackageInfo getAppPackageInfo (String packageName)

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

getAppPackageInfos ()

Busca 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 alguns problemas ocorreram.

int getCurrentUser ()

Retorna 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 suportado.

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 em execução simultânea com suporte.

int getMaxNumberOfUsersSupported ()

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

Integer getPrimaryUserId ()

Retorna o ID do usuário primário.

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

String getSetting (String namespace, String key)

Consulte getSetting(int, String, String) e execute no 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 os sinalizadores de um determinado usuário.

getUserInfos ()

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

int getUserSerialNumber (int userId)

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

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 oferece suporte à 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 multiusuário é compatível.

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 fornecido está visível.

boolean isUserVisibleOnDisplay (int userId, int displayId)

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

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 para os repórteres.

void postInvocationTearDown (Throwable exception)

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

boolean removeAdmin (String componentName, int userId)

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

void removeOwners ()

Remova todos os proprietários de perfil de dispositivo 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)

Consulte 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 houver.

boolean startUser (int userId)

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

boolean startUser (int userId, boolean waitFlag)

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

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

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

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)

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

Bugreport takeBugreport ()

Pegue um relatório de bug e o retorne 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 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 teste

void prePostBootSetup ()

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

Campos

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Comandos que podem ser usados ​​para dispensar o keyguard.

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.

devoluções
boolean

lances
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

lances
DeviceNotAvailableException

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

lances
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 : habilite o sinalizador de usuário --guest durante a criação

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

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

devoluções
int id do usuário criado

lances
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 : habilite o sinalizador de usuário --guest durante a criação

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

devoluções
int id do usuário criado

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

lances
DeviceNotAvailableException

desativarKeyguard

public void disableKeyguard ()

Tenta desativar a proteção do teclado.

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

lances
DeviceNotAvailableException

doesFileExist

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.

lances
DeviceNotAvailableException

doesFileExist

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

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

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

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

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

lances
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

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

lances
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

Retorna pares de valores-chave do namespace solicitado.

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

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

lances
DeviceNotAvailableException

getAndroidId

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

lances
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

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

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

lances
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

Parâmetros
packageName String

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

lances
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Busca informações de pacotes instalados no dispositivo.

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

lances
DeviceNotAvailableException

getbugreport

public InputStreamSource getBugreport ()

Recupera um relatório de bug do dispositivo.

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

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

getbugreportz

public InputStreamSource getBugreportz ()

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

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

devoluções
InputStreamSource um InputStreamSource do arquivo zip contendo o bugreportz, retorna null em caso de falha.

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

devoluções
DeviceFoldableState

lances
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Retorna o id do usuário em execução atual. Em caso de erro, retorna -10000.

devoluções
int

lances
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

devoluções

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

lances
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 contendo um instantâneo do estado do keyguard e retorna Null se a consulta do Keyguard não for suportada.

lances
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

Retorna o id do usuário principal.

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

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

lances
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

lances
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

lances
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

Retorna o ID do usuário principal.

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

lances
DeviceNotAvailableException

obter captura de tela

public InputStreamSource getScreenshot ()

Captura uma captura de tela do dispositivo.

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

lances
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 de codificação JPEG para tamanho menor.

Parâmetros
format String : PNG suportado, JPEG

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

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

lances
DeviceNotAvailableException

obter captura de tela

public InputStreamSource getScreenshot (String format)

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

Parâmetros
format String : PNG suportado, JPEG

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

lances
DeviceNotAvailableException

obter captura de tela

public InputStreamSource getScreenshot (long displayId)

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

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

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

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

lances
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

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

Parâmetros
namespace String

key String

devoluções
String

lances
DeviceNotAvailableException

getSetting

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

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

Parâmetros
userId int

namespace String

key String

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

lances
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

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

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

lances
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

Parâmetros
userId int

devoluções
int

lances
DeviceNotAvailableException

tem recurso

public boolean hasFeature (String feature)

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

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

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

lances
DeviceNotAvailableException

pacote de instalação

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 deve ser realizada

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

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

lances
DeviceNotAvailableException

pacote de instalação

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

Instale um pacote Android no dispositivo.

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

Parâmetros
packageFile File : o arquivo apk para instalar

reinstall boolean : true se uma reinstalação deve ser 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 para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

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

lances
DeviceNotAvailableException

pacote de instalação

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

Instale um pacote Android no dispositivo.

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

Parâmetros
packageFile File : o arquivo apk para instalar

certFile File : true se uma reinstalação deve 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 para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

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

lances
DeviceNotAvailableException

installPackageForUser

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 os casos de uso que requerem controle explícito de concessão de permissão de tempo de execução no momento da instalação devem chamar esta função.

Parâmetros
packageFile File : o arquivo apk para instalar

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

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

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

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

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

lances
DeviceNotAvailableException

installPackageForUser

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 deve ser executada

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

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

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

lances
DeviceNotAvailableException

instalarPacotes

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

Parâmetros
packageFiles

reinstall boolean

extraArgs String

devoluções
String

lances
DeviceNotAvailableException

instalarPacotes

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

Parâmetros
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

devoluções
String

lances
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

devoluções
String

lances
DeviceNotAvailableException

installPackagesForUser

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

Parâmetros
packageFiles

reinstall boolean

userId int

extraArgs String

devoluções
String

lances
DeviceNotAvailableException

instalarRemotePackages

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

Parâmetros
remoteApkPaths

reinstall boolean

extraArgs String

devoluções
String

lances
DeviceNotAvailableException

instalarRemotePackages

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

Parâmetros
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

devoluções
String

lances
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Verifique se a plataforma no dispositivo oferece suporte à enumeração de aplicativos

devoluções
boolean Verdadeiro se a enumeração do aplicativo for suportada, falso caso contrário

lances
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

devoluções
boolean

lances
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

lances
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

Determina se multiusuário é compatível.

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

lances
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. Falso caso contrário.

lances
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 nulo, o usuário primário zero será usado.

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

lances
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 executando, falso em todos os outros casos.

lances
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 true se o usuário for secundário, false caso contrário.

lances
DeviceNotAvailableException

isUserVisible

public boolean isUserVisible (int userId)

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

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

Parâmetros
userId int

devoluções
boolean

lances
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

Parâmetros
userId int

displayId int

devoluções
boolean

lances
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

devoluções
boolean

lances
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

devoluções
boolean

lances
DeviceNotAvailableException

listDisplayIds

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.

lances
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

lances
DeviceNotAvailableException

listarUsuá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ários.

lances
DeviceNotAvailableException

log Bugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

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

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

postInvocation TearDown

public void postInvocationTearDown (Throwable exception)

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

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

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

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

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

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

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

lances
DeviceNotAvailableException

removeOwners

public void removeOwners ()

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

lances
DeviceNotAvailableException

removeUser

public boolean removeUser (int userId)

Remova um determinado usuário do dispositivo.

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

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

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

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

lances
DeviceNotAvailableException

setSetting

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

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

Parâmetros
namespace String

key String

value String

lances
DeviceNotAvailableException

setSetting

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

Parâmetros
userId int

namespace String

key String

value String

lances
DeviceNotAvailableException

desligamentoMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Desliga o dispositivo microdroid, se houver.

Parâmetros
microdroidDevice ITestDevice

lances
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public boolean startUser (int userId)

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

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

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

lances
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

lances
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

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

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

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

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

lances
DeviceNotAvailableException

stopUser

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

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

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

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

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

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

lances
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

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

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

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

lances
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 : true se o microdroid for executado na 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. Falso caso contrário.

lances
DeviceNotAvailableException

mudar de utilizador

public boolean switchUser (int userId, 
                long timeout)

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

Parâmetros
userId int

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

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

lances
DeviceNotAvailableException

takebugreport

public Bugreport takeBugreport ()

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

devoluções
Bugreport

pacote de desinstalação

public String uninstallPackage (String packageName)

Desinstale um pacote Android do dispositivo.

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

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

lances
DeviceNotAvailableException

desinstalarPacoteForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

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

lances
DeviceNotAvailableException

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

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

reason String : para esta reinicialização.

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

devoluções
long

prePostBootSetup

protected void prePostBootSetup ()

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

lances
DeviceNotAvailableException