本頁面由 Cloud Translation API 翻譯而成。

TestRunResult

public class TestRunResult
extends Object

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

保留單次測試的結果。

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

但執行緒安全！必須依序呼叫 test* 回呼

摘要

欄位
`public static final String`	`ERROR_DIVIDER`

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

公用方法
	`getCompletedTests()` 取得已完成的測試組合。
`long`	`getElapsedTime()` 傳回目前執行作業的經過時間。
`int`	`getExpectedTestCount()` 取得這個 TestRunResult 預期的測試案例數量。
	`getFailedTests()` 取得失敗的測試組合。
`String`	`getName()`
`int`	`getNumAllFailedTests()` 傳回失敗狀態 (失敗或假設失敗) 的測試總數
`int`	`getNumCompleteTests()` 取得此執行作業中已完成測試的數量，也就是狀態 != 未完成。
`int`	`getNumTests()` 取得這項執行作業中的測試數量。
`int`	`getNumTestsInState(TestStatus status)` 取得本次執行作業特定狀態的測試數量。
`int`	`getNumTestsInState(TestResult.TestStatus ddmlibStatus)` 適用於較舊狀態的相容性。
	`getPassedTests()` 取得一組通過的測試。
`FailureDescription`	`getRunFailureDescription()` 如未執行失敗，會傳回執行失敗描述元 `null`。
`String`	`getRunFailureMessage()` 如果執行失敗，會傳回 `null` 執行失敗錯誤訊息。
`MultiMap<String, LogFile>`	`getRunLoggedFiles()` 傳回地圖副本，其中包含與該測試案例相關的所有記錄檔案。
	`getRunMetrics()`
	`getRunProtoMetrics()`
`long`	`getStartTime()` 傳回第一次 testRunStart 呼叫的開始時間。
	`getTestResults()` 傳回測試結果的對應。
	`getTestsInState( statuses)` 取得特定狀態的測試組合。
	`getTestsResultsInState(TestStatus status)` 傳回特定狀態的所有 `TestResult`。
`String`	`getTextSummary()` 傳回使用者容易理解的結果說明字串。
`boolean`	`hasFailedTests()`
`boolean`	`isRunComplete()`
`boolean`	`isRunFailure()`
`static TestRunResult`	`merge( testRunResults)`
`static TestRunResult`	`merge( 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, testMetrics)`
`void`	`testEnded(TestDescription test, 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, runMetrics)` 使用新版 proto 指標的新版介面。
`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)`

欄位

錯誤_DIVIDER

public static final String ERROR_DIVIDER

公用建構函式

TestRunResult

public TestRunResult ()

建立空白的 TestRunResult。

公用方法

getCompletedTests

public  getCompletedTests ()

取得已完成的測試組合。

傳回

getElapsedTime

public long getElapsedTime ()

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

傳回
`long`

getexpectedTestCount

public int getExpectedTestCount ()

取得這個 TestRunResult 預期的測試案例數量。實際數字可能會低於預期數量。通常情況下，不相符值代表測試執行失敗。

傳回
`int`

getFailedTests

public  getFailedTests ()

取得失敗的測試組合。

傳回

getName

public String getName ()

傳回
`String`	測試執行作業名稱

getNumAllFailedTests

public int getNumAllFailedTests ()

傳回失敗狀態 (失敗或假設失敗) 的測試總數

傳回
`int`

getNumCompleteTests

public int getNumCompleteTests ()

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

傳回
`int`

getNumTests

public int getNumTests ()

取得這項執行作業中的測試數量。

傳回
`int`

getNumTestsInState

public int getNumTestsInState (TestStatus status)

取得本次執行作業特定狀態的測試數量。

參數
`status`	`TestStatus`

傳回
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

適用於較舊狀態的相容性。請改用 getNumTestsInState(com.android.tradefed.result.TestStatus)。

參數
`ddmlibStatus`	`TestResult.TestStatus`

傳回
`int`

getPassedTests

public  getPassedTests ()

取得一組通過的測試。

傳回

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

如未執行失敗，會傳回執行失敗描述元 null。

傳回
`FailureDescription`

getRunFailureMessage

public String getRunFailureMessage ()

如果執行失敗，會傳回 null 執行失敗錯誤訊息。

傳回
`String`

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

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

傳回
`MultiMap<String, LogFile>`

getRunMetrics

public  getRunMetrics ()

傳回
	測試執行指標的 `ERROR(/Map)`。

getRunProtoMetrics

public  getRunProtoMetrics ()

傳回
	使用新的 proto 格式的測試執行指標 `ERROR(/Map)`。

getStartTime

public long getStartTime ()

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

傳回
`long`

getTestResults

public  getTestResults ()

傳回測試結果的對應。

傳回

getTestsInState

public  getTestsInState ( statuses)

取得特定狀態的測試組合。

參數
`statuses`

傳回

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

傳回特定狀態的所有 TestResult。

參數
`status`	`TestStatus`

傳回

取得文字摘要

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 ( testRunResults)

參數
`testRunResults`

傳回
`TestRunResult`

另請參閱：

ERROR(/#merge(List, MergeStrategy))

合併

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

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

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

傳回
`TestRunResult`	包含 testRunResults 合併資料的最終 TestRunResult。

重設執行失敗

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`

測試結束

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

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

測試結束

public void testEnded (TestDescription test, 
                 testMetrics)

參數
`test`	`TestDescription`
`testMetrics`

測試失敗

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

測試失敗

public void testFailed (TestDescription test, 
                String trace)

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

已忽略測試

public void testIgnored (TestDescription test)

參數
`test`	`TestDescription`

testLog 已儲存

public void testLogSaved (String dataName, 
                LogFile logFile)

系統會儲存所記錄檔案的相關資訊，並連結至測試案例或測試執行作業正在進行中。

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

參數
`elapsedTime`	`long`
`runMetrics`

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`

測試略過

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`