Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

SimplePerfUtil

public class SimplePerfUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.SimplePerfUtil

Classe utilitária para despachar comandos simples e coletar resultados.

Confira também:

Introdução ao simpleperf

Resumo

Métodos públicos
`void`	`executeCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Executa o comando adb shell especificado, com o simpleperf envolvido. É responsabilidade do caller analisar o resultado do simpleperf pelo receptor.
`SimplePerfResult`	`executeCommand(String command)` Executa o comando adb shell especificado com o simpleperf envolvido. O resultado do Simpleperf será analisado e retornado ao autor da chamada.
`void`	`executeCommand(String command, IShellOutputReceiver receiver)` Executa o comando adb shell especificado com o simpleperf envolvido. É responsabilidade do caller analisar o resultado do simpleperf pelo receptor.
`List<String>`	`getArgumentList()` Receber argumento para o comando simpleperf
`static SimplePerfUtil`	`newInstance(ITestDevice device, SimplePerfUtil.SimplePerfType type)` Construtor SimplePerfUtil O caller precisa definir o dispositivo e o tipo simpleperf ao inicializar a instância.
`void`	`setArgumentList(List<String> arguList)` Definir argumento no comando simpleperf

Métodos protegidos
`String`	`commandStringPreparer(String command)`

Métodos públicos

executeCommand

public void executeCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Executa o comando adb shell especificado com o simpleperf envolvido.

É responsabilidade do caller analisar o resultado do simpleperf pelo receptor.

Parâmetros
`command`	`String`: comando a ser executado no dispositivo
`receiver`	`IShellOutputReceiver`: objeto `IShellOutputReceiver` para direcionar a saída do shell.
`maxTimeToOutputShellResponse`	`long`: o período máximo em que o comando pode ficar sem gerar uma resposta. A unidade é especificada em `timeUnit`.
`timeUnit`	`TimeUnit`: unidade timeUnit para `maxTimeToOutputShellResponse`. Consulte `TimeUnit`.
`retryAttempts`	`int`: o número máximo de novas tentativas de execução do comando se ele falhar devido a uma exceção. DeviceNotResponsiveException será gerado se `retryAttempts` forem executados sem sucesso.

Gera
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada

executeCommand

public SimplePerfResult executeCommand (String command)

Executa o comando adb shell especificado com o simpleperf envolvido.

O resultado do Simpleperf será analisado e retornado ao chamador.

Parâmetros
`command`	`String`: comando a ser executado no dispositivo

Retorna
`SimplePerfResult`	O objeto `SimplePerfResult` contém todas as informações de resultado.

Gera
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada

executeCommand

public void executeCommand (String command, 
                IShellOutputReceiver receiver)

Executa o comando adb shell especificado com o simpleperf envolvido.

É responsabilidade do caller analisar o resultado do simpleperf pelo receptor.

Parâmetros
`command`	`String`: comando a ser executado no dispositivo
`receiver`	`IShellOutputReceiver`: objeto `IShellOutputReceiver` para direcionar a saída do shell.

Gera
`DeviceNotAvailableException`	se a conexão com o dispositivo for perdida e não puder ser recuperada

getArgumentList

public List<String> getArgumentList ()

Receber argumento para o comando simpleperf

Retorna
`List<String>`	lista de subcomandos e argumentos (aceita nulo)

newInstance

public static SimplePerfUtil newInstance (ITestDevice device, 
                SimplePerfUtil.SimplePerfType type)

Construtor SimplePerfUtil

O caller precisa definir o dispositivo e o tipo simpleperf ao inicializar a instância.

Parâmetros
`device`	`ITestDevice`: dispositivo de teste `ITestDevice`
`type`	`SimplePerfUtil.SimplePerfType`: `SimplePerfType` indica qual modo do simpleperf

Retorna
`SimplePerfUtil`	uma instância SimplePerfUtil recém-criada

Gera
`NullPointerException`

setArgumentList

public void setArgumentList (List<String> arguList)

Definir argumento no comando simpleperf

Parâmetros
`arguList`	`List`: lista de subcomandos e argumentos

Métodos protegidos

commandStringPreparer

protected String commandStringPreparer (String command)

Parâmetros
`command`	`String`

Retorna
`String`