自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 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`：如果為空值，則建立新檔案並寫入指標；否則，則將測試標頭名稱和指標附加到檔案中。

傳回
`File`	檔案。