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

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

TestRunResult

public class TestRunResult
extends Object

java.lang.Object
↳	com.android.tradefed.result.TestRunResult

保存單一測試執行的結果。

維持準確的測試次數，並追蹤未完成的測試。

這並非執行緒安全！測試* 回呼必須依序呼叫

摘要

常數
`String`	`ERROR_DIVIDER`

公用建構函式
`TestRunResult()` 建立空白的 `TestRunResult`。

公用方法
`void`	`addTestResult(TestDescription test, TestResult testResult)`
`Set<TestDescription>`	`getCompletedTests()` 取得已完成的測試集。
`long`	`getElapsedTime()` 傳回目前執行作業的經過時間。
`int`	`getExpectedTestCount()` 取得這個 TestRunResult 預期擁有的測試案例數量。
`Set<TestDescription>`	`getFailedTests()` 取得失敗的測試集。
`String`	`getName()`
`int`	`getNumAllFailedTests()` 傳回處於失敗狀態的測試總數 (失敗、假設失敗)
`int`	`getNumCompleteTests()` Gets the number of complete tests in this run ie with status != incomplete.
`int`	`getNumTests()` 取得這項執行作業中的測試數量。
`int`	`getNumTestsInState(TestStatus status)` Gets the number of tests in given state for this run.
`int`	`getNumTestsInState(TestResult.TestStatus ddmlibStatus)` 為與舊版狀態相容。
`Set<TestDescription>`	`getPassedTests()` 取得通過的測試集。
`FailureDescription`	`getRunFailureDescription()` 如果執行作業未失敗，則傳回執行作業失敗描述元 `null`。
`String`	`getRunFailureMessage()` 如果執行作業未失敗，則傳回執行作業失敗錯誤訊息 `null`。
`MultiMap<String, LogFile>`	`getRunLoggedFiles()` 傳回地圖副本，其中包含與該測試案例相關聯的所有記錄檔案。
`Map<String, String>`	`getRunMetrics()`
`HashMap<String, MetricMeasurement.Metric>`	`getRunProtoMetrics()`
`long`	`getStartTime()` 傳回第一次 testRunStart 呼叫的開始時間。
`Map<TestDescription, TestResult>`	`getTestEntriesInState(Collection<TestStatus> statuses)` 取得指定狀態的測試集。
`Map<TestDescription, TestResult>`	`getTestResults()` 傳回測試結果的地圖。
`Set<TestDescription>`	`getTestsInState(List<TestStatus> statuses)` 取得指定狀態的測試集。
`List<TestResult>`	`getTestsResultsInState(TestStatus status)` 傳回特定狀態的所有 `TestResult`。
`String`	`getTextSummary()` 傳回描述結果的易讀字串。
`boolean`	`hasFailedTests()`
`boolean`	`isRunComplete()`
`boolean`	`isRunFailure()`
`static TestRunResult`	`merge(List<TestRunResult> testRunResults)`
`static TestRunResult`	`merge(List<TestRunResult> testRunResults, MergeStrategy strategy)` 合併相同 testRunName 的多個 TestRunResults。
`void`	`resetRunFailure()` 重設執行失敗狀態。
`void`	`setAggregateMetrics(boolean metricAggregation)`
`void`	`setRunComplete(boolean runComplete)`
`void`	`testAssumptionFailure(TestDescription test, String trace)`
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)`
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)`
`void`	`testFailed(TestDescription test, FailureDescription failure)`
`void`	`testFailed(TestDescription test, String trace)`
`void`	`testIgnored(TestDescription test)`
`void`	`testLogSaved(String dataName, LogFile logFile)` 系統會儲存記錄的檔案相關資訊，並將其與進行中的測試案例或測試執行作業建立關聯。
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` 使用新的 proto 指標。
`void`	`testRunEnded(long elapsedTime, Map<String, String> runMetrics)`
`void`	`testRunFailed(FailureDescription failureDescription)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String runName, int testCount, long startTime)` 通知測試執行作業已啟動。
`void`	`testRunStarted(String runName, int testCount)` 通知測試執行作業已啟動。
`void`	`testRunStopped(long elapsedTime)`
`void`	`testSkipped(TestDescription test, SkipReason reason)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

常數

ERROR_DIVIDER

public static final String ERROR_DIVIDER

常數值： " ====Next Error==== "

公用建構函式

TestRunResult

public TestRunResult ()

建立空白的 TestRunResult。

公用方法

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

參數
`test`	`TestDescription`
`testResult`	`TestResult`

getCompletedTests

public Set<TestDescription> getCompletedTests ()

取得已完成的測試集。

傳回
`Set<TestDescription>`

getElapsedTime

public long getElapsedTime ()

傳回目前執行作業的經過時間。

傳回
`long`

getExpectedTestCount

public int getExpectedTestCount ()

取得這個 TestRunResult 預期擁有的測試案例數量。由於測試當機，實際數量可能少於預期數量。通常，這類不符情況表示測試執行失敗。

傳回
`int`

getFailedTests

public Set<TestDescription> getFailedTests ()

取得失敗的測試集。

傳回
`Set<TestDescription>`

getName

public String getName ()

傳回
`String`	測試執行名稱

getNumAllFailedTests

public int getNumAllFailedTests ()

傳回處於失敗狀態的測試總數 (失敗、假設失敗)

傳回
`int`

getNumCompleteTests

public int getNumCompleteTests ()

取得這項執行作業中已完成的測試數量，也就是狀態 != incomplete。

傳回
`int`

getNumTests

public int getNumTests ()

取得這次執行中的測試數量。

傳回
`int`

getNumTestsInState

public int getNumTestsInState (TestStatus status)

取得這項執行作業中處於指定狀態的測試數量。

參數
`status`	`TestStatus`

傳回
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

如要與舊版狀態相容，請改用 getNumTestsInState(TestStatus)。

參數
`ddmlibStatus`	`TestResult.TestStatus`

傳回
`int`

getPassedTests

public Set<TestDescription> getPassedTests ()

取得通過的測試集。

傳回
`Set<TestDescription>`

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

如果執行作業未失敗，則傳回執行作業失敗描述元 null。

傳回
`FailureDescription`

getRunFailureMessage

public String getRunFailureMessage ()

如果執行作業未失敗，則傳回執行作業失敗錯誤訊息 null。

傳回
`String`

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

傳回地圖副本，其中包含與該測試案例相關聯的所有記錄檔案。

傳回
`MultiMap<String, LogFile>`

getRunMetrics

public Map<String, String> getRunMetrics ()

傳回
`Map<String, String>`	測試執行指標的 `Map`。

getRunProtoMetrics

public HashMap<String, MetricMeasurement.Metric> getRunProtoMetrics ()

傳回
`HashMap<String, MetricMeasurement.Metric>`	以新 proto 格式執行測試的指標。`Map`

getStartTime

public long getStartTime ()

傳回第一次 testRunStart 呼叫的開始時間。

傳回
`long`

getTestEntriesInState

public Map<TestDescription, TestResult> getTestEntriesInState (Collection<TestStatus> statuses)

取得指定狀態的測試集。

參數
`statuses`	`Collection`

傳回
`Map<TestDescription, TestResult>`

getTestResults

public Map<TestDescription, TestResult> getTestResults ()

傳回測試結果的地圖。

傳回
`Map<TestDescription, TestResult>`

getTestsInState

public Set<TestDescription> getTestsInState (List<TestStatus> statuses)

取得指定狀態的測試集。

參數
`statuses`	`List`

傳回
`Set<TestDescription>`

getTestsResultsInState

public List<TestResult> getTestsResultsInState (TestStatus status)

傳回處於特定狀態的所有 TestResult。

參數
`status`	`TestStatus`

傳回
`List<TestResult>`

getTextSummary

public String getTextSummary ()

傳回描述結果的易讀字串。

傳回
`String`

hasFailedTests

public boolean hasFailedTests ()

傳回
`boolean`	`true` 如果測試執行期間有任何測試失敗或發生錯誤。

isRunComplete

public boolean isRunComplete ()

傳回
`boolean`	`true` (如果測試執行作業已完成)。

isRunFailure

public boolean isRunFailure ()

傳回
`boolean`	`true` 如果測試執行失敗。

合併

public static TestRunResult merge (List<TestRunResult> testRunResults)

參數
`testRunResults`	`List`

傳回
`TestRunResult`

另請參閱：

merge(List,MergeStrategy)

合併

public static TestRunResult merge (List<TestRunResult> testRunResults, 
                MergeStrategy strategy)

合併相同 testRunName 的多個 TestRunResults。如果測試案例出現在多個 TestRunResults 中，但結果不同 (例如「boottest-device」執行三次，結果為 FAIL-FAIL-PASS)，我們會串連所有 FAILED 執行的堆疊追蹤記錄，並信任最終執行結果的狀態、指標、記錄檔、開始/結束時間。

參數
`testRunResults`	`List`：要合併的 TestRunResult 清單。
`strategy`	`MergeStrategy`：合併結果時採用的合併策略。

傳回
`TestRunResult`	最終的 TestRunResult，其中包含來自 testRunResults 的合併資料。

resetRunFailure

public void resetRunFailure ()

重設執行失敗狀態。

有時重試時需要重設執行失敗狀態。請務必謹慎操作，以免清除實際的失敗記錄。

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

參數
`metricAggregation`	`boolean`

setRunComplete

public void setRunComplete (boolean runComplete)

參數
`runComplete`	`boolean`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

參數
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

參數
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

參數
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`	`HashMap`

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

參數
`test`	`TestDescription`
`testMetrics`	`HashMap`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

參數
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public void testFailed (TestDescription test, 
                String trace)

參數
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

參數
`test`	`TestDescription`

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

系統會儲存記錄的檔案相關資訊，並與進行中的測試案例或測試執行作業建立關聯。

參數
`dataName`	`String`：參照資料的名稱。
`logFile`	`LogFile`：代表物件儲存位置和相關資訊的 `LogFile` 物件。

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

使用新的 proto 指標的新介面。

參數
`elapsedTime`	`long`
`runMetrics`	`HashMap`

testRunEnded

public void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

參數
`elapsedTime`	`long`
`runMetrics`	`Map`

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

參數
`failureDescription`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

參數
`errorMessage`	`String`

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                long startTime)

通知測試執行作業已啟動。

參數
`runName`	`String`：與測試執行作業相關聯的名稱，用於追蹤。
`testCount`	`int`：與測試執行作業相關聯的預期測試案例數量。
`startTime`	`long`

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

通知測試執行作業已啟動。

參數
`runName`	`String`：與測試執行作業相關聯的名稱，用於追蹤。
`testCount`	`int`：與測試執行作業相關聯的預期測試案例數量。

testRunStopped

public void testRunStopped (long elapsedTime)

參數
`elapsedTime`	`long`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

參數
`test`	`TestDescription`
`reason`	`SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

參數
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

參數
`test`	`TestDescription`