A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco 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, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

MetricUtility

public class MetricUtility
extends Object

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

Contém métodos de utilitário comuns para armazenar as métricas de teste, agregar as métricas em testes semelhantes e gravar as métricas em um arquivo.

Resumo

Construtores públicos
`MetricUtility()`

Métodos públicos
	`aggregateMetrics( rawMetrics)` Métricas agregadas separadas por vírgulas.
`File`	`aggregateStoredTestMetricsAndWriteToFile(String fileName)` Agrupe as métricas coletadas de várias iterações do teste e grave as métricas agregadas em um arquivo de resultados do teste.
`void`	`buildMetricFilterPatterns( strictIncludeRegEx)` Crie padrões de expressão regular para filtrar as métricas.
	`filterMetrics( parsedMetrics)` Filtre as métricas que correspondem ao padrão.
`static`	`getStats( values, percentiles)` Calcule as estatísticas da lista de valores fornecida.
	`getStoredTestMetric()`
`static boolean`	`isAllDoubleValues( rawValues)` Retorna verdadeiro se todos os valores puderem ser analisados como valor duplo.
`void`	`setIterationSeparator(String separator)`
`void`	`setPercentiles( percentiles)`
`void`	`storeTestMetrics(TestDescription testDescription, testMetrics)` Usado para armazenar as métricas de teste individuais e usá-las para agregação.
`File`	`writeResultsToFile(String testFileSuffix, String testHeaderName, metrics, File resultsFile)` Gravar métricas em um arquivo.

Construtores públicos

MetricUtility

public MetricUtility ()

Métodos públicos

aggregateMetrics

public  aggregateMetrics ( rawMetrics)

Métricas agregadas separadas por vírgulas.

Parâmetros
`rawMetrics`	: métricas coletadas durante a execução do teste.

Retorna
	métricas agregadas.

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

Agrupe as métricas coletadas de várias iterações do teste e grave as métricas agregadas em um arquivo de resultados do teste.

Parâmetros
`fileName`	`String`: nome do arquivo a ser usado ao gravar as métricas.

Retorna
`File`

buildMetricFilterPatterns

public void buildMetricFilterPatterns ( strictIncludeRegEx)

Crie padrões de expressão regular para filtrar as métricas.

Parâmetros
`strictIncludeRegEx`

filterMetrics

public  filterMetrics ( parsedMetrics)

Filtre as métricas que correspondem ao padrão.

Parâmetros
`parsedMetrics`

Retorna

getStats

public static  getStats ( values, 
                 percentiles)

Calcule as estatísticas da lista de valores fornecida.

Parâmetros
`values`	: valores brutos para calcular a agregação.
`percentiles`	: estatísticas a serem incluídas nas métricas finais.

Retorna
	valores agregados.

getStoredTestMetric

public  getStoredTestMetric ()

Retorna

isAllDoubleValues

public static boolean isAllDoubleValues ( rawValues)

Retorna verdadeiro se todos os valores puderem ser analisados como valor duplo. Caso contrário, retorne "false".

Parâmetros
`rawValues`	: lista cujos valores são validados.

Retorna
`boolean`

setIterationSeparator

public void setIterationSeparator (String separator)

Parâmetros
`separator`	`String`

setPercentiles

public void setPercentiles ( percentiles)

Parâmetros
`percentiles`

storeTestMetrics

public void storeTestMetrics (TestDescription testDescription, 
                 testMetrics)

Usado para armazenar as métricas de teste individuais e usá-las para agregação.

Parâmetros
`testDescription`	`TestDescription`: contém os detalhes do teste, como nome da classe e nome do teste.
`testMetrics`	: métricas coletadas para o teste.

writeResultsToFile

public File writeResultsToFile (String testFileSuffix, 
                String testHeaderName, 
                 metrics, 
                File resultsFile)

Gravar métricas em um arquivo.

Parâmetros
`testFileSuffix`	`String`: é usado como sufixo no nome do arquivo da métrica de teste.
`testHeaderName`	`String`: as métricas serão gravadas com o nome do cabeçalho do teste.
`metrics`	: para gravar no arquivo.
`resultsFile`	`File`: se for nulo, crie um novo arquivo e grave as métricas. Caso contrário, anexe o nome do cabeçalho de teste e a métrica ao arquivo.

Retorna
`File`	com a métrica.