自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

MetricUtility

public class MetricUtility
extends Object

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

包含用于存储测试指标、汇总类似测试中的指标以及将指标写入文件的常用实用程序方法。

摘要

公共构造函数
`MetricUtility()`

公共方法
	`aggregateMetrics( rawMetrics)` 以英文逗号分隔的汇总指标。
`File`	`aggregateStoredTestMetricsAndWriteToFile(String fileName)` 汇总从多次迭代的测试中收集的指标，并将汇总的指标写入测试结果文件。
`void`	`buildMetricFilterPatterns( strictIncludeRegEx)` 构建正则表达式模式以过滤指标。
	`filterMetrics( parsedMetrics)` 过滤出与模式匹配的指标。
`static`	`getStats( values, percentiles)` 根据给定值列表计算统计信息。
	`getStoredTestMetric()`
`static boolean`	`isAllDoubleValues( rawValues)` 如果所有值都可以解析为双精度值，则返回 true。
`void`	`setIterationSeparator(String separator)`
`void`	`setPercentiles( percentiles)`
`void`	`storeTestMetrics(TestDescription testDescription, testMetrics)` 用于存储各项测试指标，并将其用于汇总。
`File`	`writeResultsToFile(String testFileSuffix, String testHeaderName, metrics, File resultsFile)` 将指标写入文件。

公共构造函数

MetricUtility

public MetricUtility ()

公共方法

aggregateMetrics

public  aggregateMetrics ( rawMetrics)

以英文逗号分隔的汇总指标。

参数
`rawMetrics`	：测试运行期间收集的指标。

返回
	汇总指标。

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

汇总从多次迭代的测试中收集的指标，并将汇总的指标写入测试结果文件。

参数
`fileName`	`String`：写入指标时使用的文件名。

返回
`File`

buildMetricFilterPatterns

public void buildMetricFilterPatterns ( strictIncludeRegEx)

构建正则表达式模式以过滤指标。

参数
`strictIncludeRegEx`

filterMetrics

public  filterMetrics ( parsedMetrics)

过滤出与模式匹配的指标。

参数
`parsedMetrics`

返回

getStats

public static  getStats ( values, 
                 percentiles)

根据给定值列表计算统计信息。

参数
`values`	：用于计算汇总的原始值。
`percentiles`	：要包含在最终指标中的统计信息。

返回
	汇总值。

getStoredTestMetric

public  getStoredTestMetric ()

返回

isAllDoubleValues

public static boolean isAllDoubleValues ( rawValues)

如果所有值都可以解析为双精度值，则返回 true。否则，返回 false。

参数
`rawValues`	：值会经过验证的列表。

返回
`boolean`

setIterationSeparator

public void setIterationSeparator (String separator)

参数
`separator`	`String`

setPercentiles

public void setPercentiles ( percentiles)

参数
`percentiles`

storeTestMetrics

public void storeTestMetrics (TestDescription testDescription, 
                 testMetrics)

用于存储各项测试指标，并将其用于汇总。

参数
`testDescription`	`TestDescription`：包含类名称和测试名称等测试详细信息。
`testMetrics`	：为测试收集的指标。

writeResultsToFile

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

将指标写入文件。

参数
`testFileSuffix`	`String`：用于测试指标文件名的后缀。
`testHeaderName`	`String`：指标将写入测试标头名称下。
`metrics`	：写入文件。
`resultsFile`	`File`：如果为 null，则创建新文件并写入指标；否则，将测试标头名称和指标附加到文件。

返回
`File`	文件中包含相应指标。