ModuleResultsAndMetricsForwarder

public class ModuleResultsAndMetricsForwarder
extends ResultAndLogForwarder

java.lang.Object
   ↳ com.android.tradefed.result.ResultForwarder
     ↳ com.android.tradefed.result.ResultAndLogForwarder
       ↳ com.android.tradefed.result.ModuleResultsAndMetricsForwarder


ResultAndLogForwarder 的擴充功能,可在測試結果中加入額外的模組相關指標。

摘要

公用建構函式

ModuleResultsAndMetricsForwarder(ITestInvocationListener... listeners)

公用方法

void setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)

設定嘗試是否應回報為隔離。

void setModuleId(String moduleId)
void setTestMappingSources( testMappingSources)

設定要插入指標的測試對應來源。

void testEnded(TestDescription test, long endTime, testMetrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) 的替代方案,可直接指定結束時間。

void testEnded(TestDescription test, testMetrics)

回報個別測試案例的執行結束時間。

void testFailed(TestDescription test, FailureDescription failure)

回報個別測試案例的失敗情形。

void testFailed(TestDescription test, String trace)

回報個別測試案例的失敗情形。

void testRunEnded(long elapsedTimeMillis, runMetrics)

回報測試執行結束。

void testRunFailed(FailureDescription failure)

由於 FailureDescription 所述的錯誤,無法完成報表測試執行作業。

void testRunFailed(String errorMessage)

由於發生致命錯誤,因此無法完成報表測試。

void testRunStarted(String runName, int testCount, int attemptNumber)

回報測試執行作業的開始時間。

void testRunStarted(String runName, int testCount)

回報測試執行作業的開始時間。

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

回報測試執行作業的開始時間。

void testStarted(TestDescription test, long startTime)

testStarted(com.android.tradefed.result.TestDescription) 的替代方案,我們也會指定測試開始時間,並搭配 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) 進行精確評估。

void testStarted(TestDescription test)

回報個別測試案例的開始時間。

公用建構函式

ModuleResultsAndMetricsForwarder

public ModuleResultsAndMetricsForwarder (ITestInvocationListener... listeners)

參數
listeners ITestInvocationListener

公用方法

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

設定嘗試是否應回報為隔離。

參數
isolation CurrentInvocation.IsolationGrade

setModuleId

public void setModuleId (String moduleId)

參數
moduleId String

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

設定要插入指標的測試對應來源。

參數
testMappingSources

testEnded

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

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) 的替代方案,可直接指定結束時間。搭配 testStarted(com.android.tradefed.result.TestDescription, long) 使用,可獲得精確的測量結果。

參數
test TestDescription:用於識別測試

endTime long:測試結束的時間,透過 System.currentTimeMillis() 測量

testMetrics :傳送指標的 ERROR(/Map)

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

回報個別測試案例的執行結束時間。

如果未叫用 testFailed(TestDescription, FailureDescription),則表示這項測試已通過。也會傳回在測試案例執行期間可能已發出的任何鍵/值指標。

參數
test TestDescription:用於識別測試

testMetrics :傳送指標的 ERROR(/Map)

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

回報個別測試案例的失敗情形。

會在 testStarted 和 testEnded 之間呼叫。

參數
test TestDescription:用於識別測試

failure FailureDescriptionFailureDescription 可說明失敗和相關情境。

testFailed

public void testFailed (TestDescription test, 
                String trace)

回報個別測試案例的失敗情形。

會在 testStarted 和 testEnded 之間呼叫。

參數
test TestDescription:用於識別測試

trace String:失敗的堆疊追蹤

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

回報測試執行結束。

參數
elapsedTimeMillis long:裝置回報的經過時間,以毫秒為單位

runMetrics :測試執行結束時回報的鍵/值組合

testRunFailed

public void testRunFailed (FailureDescription failure)

由於 FailureDescription 所述的錯誤,導致報表測試執行作業無法完成。

參數
failure FailureDescriptionFailureDescription 可說明失敗和相關情境。

testRunFailed

public void testRunFailed (String errorMessage)

由於發生致命錯誤,因此無法完成報表測試執行作業。

參數
errorMessage StringString,說明執行失敗的原因。

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

回報測試執行作業的開始時間。

參數
runName String:測試執行作業名稱

testCount int:測試執行作業中的測試總數

attemptNumber int:訂單號碼,用於識別同一個 runName 執行多次的不同嘗試。attemptNumber 的索引為 0,每次執行時都應遞增。舉例來說,如果測試以細部重試 3 次,則在相同的 runName 下應有 4 次執行,而 attemptNumber 則從 0 到 3。

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

回報測試執行作業的開始時間。

參數
runName String:測試執行作業名稱

testCount int:測試執行作業中的測試總數

testRunStarted

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

回報測試執行作業的開始時間。

參數
runName String:測試執行作業名稱

testCount int:測試執行作業中的測試總數

attemptNumber int:訂單號碼,用於識別同一個 runName 執行多次的不同嘗試。attemptNumber 的索引為 0,每次執行新測試時,應增加 1。舉例來說,如果測試細部重試 3 次,則在相同的 runName 下,應有 4 次總執行次數,而 attemptNumber 則從 0 到 3。

startTime long:透過 System.currentTimeMillis() 測量的執行時間

testStarted

public void testStarted (TestDescription test, 
                long startTime)

testStarted(com.android.tradefed.result.TestDescription) 的替代方案,我們也會指定測試開始時間,並搭配 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) 進行精確評估。

參數
test TestDescription:用於識別測試

startTime long:測試開始的時間,透過 System.currentTimeMillis() 測量

testStarted

public void testStarted (TestDescription test)

回報個別測試案例的開始時間。較舊的介面,應盡可能使用 testStarted(com.android.tradefed.result.TestDescription)

參數
test TestDescription:用於識別測試