BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector

java.lang.Object
   ↳ com.android.tradefed.device.metric.BaseDeviceMetricCollector

IMetricCollector 的基本實作，可在 onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) 和 ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) 上開始及停止收集。

摘要

欄位

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

公用建構函式

BaseDeviceMetricCollector()

公用方法

final getBuildInfos()

傳回可在叫用中使用的建構資訊清單。

final getDevices()

傳回可在喚起動作中使用的裝置清單。

File getFileFromTestArtifacts(String fileName)

從測試構件或模組構件中擷取檔案，並將檔案快取至地圖，以利後續呼叫。
final ITestInvocationListener getInvocationListener()

傳回原始的 ITestInvocationListener，我們會將結果轉寄至該處。

final getRealDevices()

從 getDevices() 清單中傳回所有非暫存裝置。
String getRunName()

傳回觸發收集器的測試執行作業 mRunName 名稱。
ITestInvocationListener init(IInvocationContext context, ITestInvocationListener listener)

使用目前的內容和轉送結果的位置，初始化收集器。

final void invocationEnded(long elapsedTime)
final void invocationFailed(FailureDescription failure)
final void invocationFailed(Throwable cause)
final void invocationStarted(IInvocationContext context)

用於轉送的叫用事件監聽器

final boolean isDisabled()

如果整個物件已停用 (略過設定和拆解)，則傳回 True。
final void logAssociation(String dataName, LogFile logFile)

請勿在指標收集器實作中使用。

void onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)

當測試案例因假設失敗而失敗時的回呼。

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)

測試案例結束時的回呼。

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)

測試案例結束時的回呼。

void onTestFail(DeviceMetricData testData, TestDescription test)

測試案例失敗時的回呼。

void onTestRunEnd(DeviceMetricData runData, currentRunMetrics)

測試結束時的回呼。

void onTestRunFailed(DeviceMetricData testData, FailureDescription failure)
void onTestRunStart(DeviceMetricData runData)

開始執行測試時的回呼。

void onTestStart(DeviceMetricData testData)

測試案例啟動時的回呼。

final void setDisable(boolean isDisabled)

設定是否應停用物件。
final void setLogSaver(ILogSaver logSaver)

請勿在指標收集器實作中使用。

final void testAssumptionFailure(TestDescription test, String trace)
final void testAssumptionFailure(TestDescription test, FailureDescription failure)
final void testEnded(TestDescription test, long endTime, testMetrics)
final void testEnded(TestDescription test, testMetrics)
final void testFailed(TestDescription test, FailureDescription failure)
final void testFailed(TestDescription test, String trace)
final void testIgnored(TestDescription test)
final void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
final void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

請勿在指標收集器實作中使用。

final void testModuleEnded()
final void testModuleStarted(IInvocationContext moduleContext)
final void testRunEnded(long elapsedTime, runMetrics)
final void testRunFailed(FailureDescription failure)
final void testRunFailed(String errorMessage)
final void testRunStarted(String runName, int testCount, int attemptNumber)
final void testRunStarted(String runName, int testCount)

測試執行回呼

final void testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
final void testRunStopped(long elapsedTime)
final void testStarted(TestDescription test, long startTime)
final void testStarted(TestDescription test)

測試案例回呼

欄位

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

公用建構函式

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

公用方法

getBuildInfos

public final  getBuildInfos ()

傳回可在叫用作業中使用的建構資訊清單。

傳回

getDevices

public final  getDevices ()

傳回可在喚起作業中使用的裝置清單。

傳回

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

從測試構件或模組構件中擷取檔案，並將檔案快取至地圖，以利後續呼叫。

參數
fileName String：在構件中查詢的檔案名稱。
傳回
File 來自測試構件或模組構件的檔案。如果找不到檔案，則傳回空值。

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

傳回原始的 ITestInvocationListener，我們會將結果轉寄至該處。

傳回
ITestInvocationListener

getRealDevices

public final  getRealDevices ()

從 getDevices() 清單中傳回所有非暫存裝置。

傳回

getRunName

public String getRunName ()

傳回觸發收集器的測試執行作業 mRunName 名稱。

傳回
String mRunName，目前的測試執行名稱。

init

public ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

使用目前的內容和轉送結果的位置，初始化收集器。每個例項只會呼叫一次，且收集器應會更新其內部內容和事件監聽器。在測試執行期間，系統一律不會呼叫初始化。

除非您知道自己在做什麼，否則請勿覆寫。

參數
context IInvocationContext：正在進行叫用作業的 IInvocationContext。
listener ITestInvocationListener：放置結果的 ITestInvocationListener。
傳回
ITestInvocationListener 新的事件監聽器會包裝原始事件監聽器。

invocationEnded

public final void invocationEnded (long elapsedTime)

參數
elapsedTime long

invocationFailed

public final void invocationFailed (FailureDescription failure)

參數
failure FailureDescription

invocationFailed

public final void invocationFailed (Throwable cause)

參數
cause Throwable

invocationStarted

public final void invocationStarted (IInvocationContext context)

用於轉送的叫用事件監聽器

參數
context IInvocationContext

isDisabled

public final boolean isDisabled ()

如果整個物件已停用 (略過設定和拆卸)，則傳回 True。否則為 False。

傳回
boolean

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

請勿在指標收集器實作中使用。這是純轉寄。

參數
dataName String

logFile LogFile

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

當測試案例因假設失敗而失敗時的回呼。

參數
testData DeviceMetricData：保留測試案例資料的 DeviceMetricData。
test TestDescription：進行中的測試案例 TestDescription。

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

測試案例結束時的回呼。這時應該要清理了。

參數
testData DeviceMetricData：保留測試案例資料的 DeviceMetricData。會與 onTestStart(com.android.tradefed.device.metric.DeviceMetricData) 期間相同的物件。
currentTestCaseMetrics ：傳遞至 ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map) 的目前指標對應項目。
test TestDescription：進行中的測試案例 TestDescription。

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

測試案例結束時的回呼。這時應該要清理了。

參數
testData DeviceMetricData：保留測試案例資料的 DeviceMetricData。會與 onTestStart(com.android.tradefed.device.metric.DeviceMetricData) 期間相同的物件。
currentTestCaseMetrics ：傳遞至 ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map) 的目前指標對應項目。

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

測試案例失敗時的回呼。

參數
testData DeviceMetricData：保留測試案例資料的 DeviceMetricData。
test TestDescription：進行中的測試案例 TestDescription。

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

測試結束時的回呼。這時應該要清理了。

參數
runData DeviceMetricData：儲存執行作業資料的 DeviceMetricData。會與 onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) 期間相同的物件。
currentRunMetrics ：傳遞至 ITestLifeCycleReceiver.testRunEnded(long, Map) 的目前指標對應項目。

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

參數
testData DeviceMetricData

failure FailureDescription

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

開始測試時的回呼。

參數
runData DeviceMetricData：儲存執行作業資料的 DeviceMetricData。

onTestStart

public void onTestStart (DeviceMetricData testData)

測試案例啟動時的回呼。

參數
testData DeviceMetricData：保留測試案例資料的 DeviceMetricData。

setDisable

public final void setDisable (boolean isDisabled)

設定是否應停用物件。停用表示應略過設定和拆卸步驟。可用於在預設建構函式中，讓物件預設為停用。

參數
isDisabled boolean：物件應放置的狀態。

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

請勿在指標收集器實作中使用。這是純轉寄。

參數
logSaver ILogSaver

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

參數
test TestDescription

trace String

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

參數
test TestDescription

failure FailureDescription

testEnded

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

參數
test TestDescription

endTime long

testMetrics

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

參數
test TestDescription

testMetrics

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

參數
test TestDescription

failure FailureDescription

testFailed

public final void testFailed (TestDescription test, 
                String trace)

參數
test TestDescription

trace String

testIgnored

public final void testIgnored (TestDescription test)

參數
test TestDescription

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

參數
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

請勿在指標收集器實作中使用。這是純轉寄。

參數
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

testModuleEnded

public final void testModuleEnded ()

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

參數
moduleContext IInvocationContext

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

參數
elapsedTime long

runMetrics

testRunFailed

public final void testRunFailed (FailureDescription failure)

參數
failure FailureDescription

testRunFailed

public final void testRunFailed (String errorMessage)

參數
errorMessage String

testRunStarted

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

參數
runName String

testCount int

attemptNumber int

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

測試執行回呼

參數
runName String

testCount int

testRunStarted

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

參數
runName String

testCount int

attemptNumber int

startTime long

testRunStopped

public final void testRunStopped (long elapsedTime)

參數
elapsedTime long

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

參數
test TestDescription

startTime long

testStarted

public final void testStarted (TestDescription test)

測試案例回呼

參數
test TestDescription