為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將於 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，建議使用 android-latest-release，而非 aosp-main。android-latest-release 資訊清單分支版本一律會參照推送至 AOSP 的最新版本。詳情請參閱「Android 開放原始碼計畫變更」一文。

TfMetricProtoUtil

public class TfMetricProtoUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.proto.TfMetricProtoUtil

Utility class to help with the Map<string, string=""> to Map<string, metric=""> transition.</string,></string,>

摘要

公用建構函式
`TfMetricProtoUtil()`

公用方法
`static`	`compatibleConvert( map)` 將 Map<string, metric=""> 轉換為 Map<string, string="">。 </string,></string,>
`static MetricMeasurement.Metric`	`doubleArrayToMetric( metric)` 將雙精度浮點數清單轉換為 `Metric`。
`static MetricMeasurement.Metric`	`doubleToMetric(Double metric)` 將簡單的 Double 指標轉換為 `Metric`。
`static MetricMeasurement.Metric`	`numericArrayToMetric( metric)` 將數值 (int64) 清單轉換為 `Metric`。
`static MetricMeasurement.Metric`	`numericToMetric(long value, String unit)` 為單一 long/int 值建立 `Metric`，並視需要提供單位。
`static MetricMeasurement.Metric`	`numericToMetric(Long metric)` 將簡單的數值指標轉換為 `Metric`。
`static MetricMeasurement.Metric`	`stringArrayToMetric( metric)` 將字串清單轉換為 `Metric`。
`static MetricMeasurement.Metric`	`stringToMetric(String metric)` 將簡單的字串指標 (舊格式) 轉換為 `Metric` (新格式)。
`static`	`upgradeConvert( metrics)` 將 Map<string, string=""> 轉換為 HashMap<string, metric="">。 </string,></string,>
`static`	`upgradeConvert( metrics, boolean smartNumbers)` 將 Map<string, string=""> 轉換為 HashMap<string, metric="">。 </string,></string,>

公用建構函式

TfMetricProtoUtil

public TfMetricProtoUtil ()

公用方法

compatibleConvert

public static  compatibleConvert ( map)

將 Map<string, metric=""> 轉換為 Map<string, string="">。</string,></string,>

參數
`map`

傳回

doubleArrayToMetric

public static MetricMeasurement.Metric doubleArrayToMetric ( metric)

將雙精度浮點數清單轉換為 Metric。

參數
`metric`	：包含指標的清單。

傳回
`MetricMeasurement.Metric`	建立的 `Metric`

doubleToMetric

public static MetricMeasurement.Metric doubleToMetric (Double metric)

將簡單的 Double 指標轉換為 Metric。

參數
`metric`	`Double`：包含指標的 Double。

傳回
`MetricMeasurement.Metric`	建立的 `Metric`

numericArrayToMetric

public static MetricMeasurement.Metric numericArrayToMetric ( metric)

將數值 (int64) 清單轉換為 Metric。

參數
`metric`	：包含指標的清單。

傳回
`MetricMeasurement.Metric`	建立的 `Metric`

numericToMetric

public static MetricMeasurement.Metric numericToMetric (long value, 
                String unit)

為單一 long/int 值建立 Metric，並視需要提供單位。

參數
`value`	`long`：要儲存的值。
`unit`	`String`：值的單位，如果沒有單位則為空值。

傳回
`MetricMeasurement.Metric`	填入資訊的 `Metric`。

numericToMetric

public static MetricMeasurement.Metric numericToMetric (Long metric)

將簡單的數值指標轉換為 Metric。

參數
`metric`	`Long`：包含指標的 Double。

傳回
`MetricMeasurement.Metric`	建立的 `Metric`

stringArrayToMetric

public static MetricMeasurement.Metric stringArrayToMetric ( metric)

將字串清單轉換為 Metric。

參數
`metric`	：包含指標的清單。

傳回
`MetricMeasurement.Metric`	建立的 `Metric`

stringToMetric

public static MetricMeasurement.Metric stringToMetric (String metric)

將簡單的字串指標 (舊格式) 轉換為 Metric (新格式)。

參數
`metric`	`String`：包含指標的字串。

傳回
`MetricMeasurement.Metric`	建立的 `Metric`

upgradeConvert

public static  upgradeConvert ( metrics)

將 Map<string, string=""> 轉換為 HashMap<string, metric="">，才能使用新介面。由於舊版格式的限制，資訊可能只會部分填入。</string,></string,>

參數
`metrics`

傳回

upgradeConvert

public static  upgradeConvert ( metrics, 
                boolean smartNumbers)

將 Map<string, string=""> 轉換為 HashMap<string, metric="">，才能使用新介面。由於舊版格式的限制，資訊可能只會部分填入。</string,></string,>

參數
`metrics`
`smartNumbers`	`boolean`：將數字轉換為 int 指標

傳回