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

公用建構函式

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

傳回
使用新原型格式產生的測試執行指標 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

合併

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

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

參數
testRunResults ：要合併的 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

測試結束

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

參數
test TestDescription

endTime long

testMetrics

測試結束

public void testEnded (TestDescription test, 
                 testMetrics)

參數
test TestDescription

testMetrics

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, 
                 runMetrics)

參數
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

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