Esta página foi traduzida pela API Cloud Translation.

dispositivo de teste

public class TestDevice
extends NativeDevice

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

Subclasses diretas conhecidas

ManagedRemoteDevice , NestedRemoteDevice , RemoteAndroidDevice

ManagedRemoteDevice	Um dispositivo rodando dentro de uma máquina virtual que gerenciamos remotamente por meio de uma instância Tradefed dentro da VM.
NestedRemoteDevice	Representação do dispositivo rodando dentro de uma VM Cuttlefish remota.
RemoteAndroidDevice	Implementação de um `ITestDevice` para um dispositivo android full stack conectado via adb connect.

Subclasses indiretas conhecidas

LocalAndroidVirtualDevice , RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	A classe para dispositivos virtuais locais em execução no host TradeFed.
RemoteAndroidVirtualDevice	Estende o comportamento `RemoteAndroidDevice` para um dispositivo Android de pilha completa em execução no Google Compute Engine (Gce).

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 é suportado.
`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 na mesma hora 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 suportado.

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 `ERROR(/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 suportado.

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 de linha principal `ERROR(/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 desinstalados `ERROR(/String)` 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`	um `ERROR(/String)` com um código de erro ou `null` se for bem-sucedido.

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`	um `ERROR(/String)` com um código de erro ou `null` se for bem-sucedido.

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`	um `ERROR(/String)` com um código de erro ou `null` se for bem-sucedido.

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 realizada
`grantPermissions`	`boolean` : se todas as permissões de tempo de execução devem ser concedidas no momento da instalação
`userId`	`int` : o id de usuário inteiro para o qual instalar.
`extraArgs`	`String` : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
`String`	um `ERROR(/String)` com um código de erro ou `null` se for bem-sucedido.

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 realizada
`userId`	`int` : o id de usuário inteiro para o qual instalar.
`extraArgs`	`String` : argumentos extras opcionais para passar. Consulte 'adb shell pm -h' para ver as opções disponíveis.

devoluções
`String`	um `ERROR(/String)` com um código de erro ou `null` se for bem-sucedido.

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.

postInvocationTearDown

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`	um `ERROR(/String)` com um código de erro ou `null` se for bem-sucedido.

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`	um `ERROR(/String)` com um código de erro ou `null` se for bem-sucedido.

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`

dispositivo de teste

Resumo

Classes aninhadas

Campos

Construtores públicos

Métodos públicos

Métodos protegidos

Campos

DISMISS_KEYGUARD_CMD

Construtores públicos

dispositivo de teste

Métodos públicos

canSwitchToHeadlessSystemUser

clearErrorDialogs

criarusuário

criarusuário

criarusuário

createUserNoThrow

desativarKeyguard

doesFileExist

doesFileExist

dumpHeap

getActiveApexes

getAllSettings

getAndroidId

getAndroidIds

getAppPackageInfo

getAppPackageInfos

getbugreport

getbugreportz

getCurrentFoldableState

getCurrentUser

getFoldableStates

getInstalledPackageNames

getKeyguardState

getMainUserId

getMainlineModuleInfo

getMaxNumberOfRunningUsersSupported

getMaxNumberOfUsersSupported

getPrimaryUserId

obter captura de tela

obter captura de tela

obter captura de tela

obter captura de tela

getSetting

getSetting

getUninstallablePackageNames

getUserFlags

getUserInfos

getUserSerialNumber

tem recurso

pacote de instalação

pacote de instalação

pacote de instalação

installPackageForUser

installPackageForUser

instalarPacotes

instalarPacotes

installPackagesForUser

installPackagesForUser

instalarRemotePackages

instalarRemotePackages

isAppEnumerationSupported

isHeadlessSystemUserMode

isMainUserPermanentAdmin

isMultiUserSupported

isPackageInstalled

isPackageInstalled

isUserRunning

isUserSecondary

isUserVisible

isUserVisibleOnDisplay

isVisibleBackgroundUsersOnDefaultDisplaySupported

isVisibleBackgroundUsersSupported

listDisplayIds

listDisplayIdsForStartingVisibleBackgroundUsers

listarUsuários

log Bugreport

postInvocationTearDown

removeAdmin