BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector , IDeviceActionReceiver

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

公共方法

void extraInit ( IInvocationContext context, ITestInvocationListener listener)
final getBuildInfos ()

返回調用中可用的構建信息列表。

final getDevices ()

返回調用中可用的設備列表。

File getFileFromTestArtifacts (String fileName)

從測試工件或模塊工件中檢索文件並將其緩存在映射中以供後續調用使用。

final ITestInvocationListener getInvocationListener ()

返回我們轉發結果的原始ITestInvocationListener 。

String getModuleName ()
final getRealDevices ()

返回getDevices()列表中的所有非存根設備。

String getRunName ()

返回觸發收集器的測試運行mRunName的名稱。

final 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。

boolean isDisabledReceiver ()

IDeviceActionReceiver是否被禁用。

final void logAssociation (String dataName, LogFile logFile)

不要使用內部指標收集器實現。

void onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)

當測試用例因假設失敗而失敗時回調。

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

測試用例結束時的回調。

void onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)

測試用例結束時的回調。

void onTestFail ( DeviceMetricData testData, TestDescription test)

測試用例失敗時回調。

void onTestModuleEnded ()

允許捕獲模塊結束事件。

void onTestModuleStarted ()

允許捕獲模塊啟動事件。

void onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)

測試運行結束時回調。

void onTestRunFailed ( DeviceMetricData testData, FailureDescription failure)

testRunFailed 事件的回調

void onTestRunStart ( DeviceMetricData runData)

測試運行開始時的回調。

void onTestStart ( DeviceMetricData testData)

測試用例啟動時的回調。

void rebootEnded ( ITestDevice device)

在設備重啟結束時獲取通知。

void rebootStarted ( ITestDevice device)

在設備中開始重新啟動時獲取通知。

final void setDisable (boolean isDisabled)

設置對像是否應該被禁用。

void setDisableReceiver (boolean isDisabled)

設置是否應禁用IDeviceActionReceiver 。

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) testEnded ( TestDescription test, long endTime, testMetrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))的替代方法，我們可以在其中直接指定結束時間。

final void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

報告單個測試用例的執行結束。

final void testFailed ( TestDescription test, FailureDescription failure)

報告單個測試用例的失敗。

final void testFailed ( TestDescription test, String trace)

報告單個測試用例的失敗。

final void testIgnored ( TestDescription test)

當測試不會運行時調用，通常是因為測試方法用 org.junit.Ignore 註釋。

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) testRunEnded (long elapsedTime, runMetrics)

報告測試運行結束。

final void testRunFailed ( FailureDescription failure)

由於FailureDescription描述的故障，報告測試運行未能完成。

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)

testStarted(com.android.tradefed.result.TestDescription)的替代方法，我們還指定測試何時開始，並結合ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))進行準確測量.

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

公共方法

額外初始化

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

投擲
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

獲取構建信息

public final  getBuildInfos ()

返回調用中可用的構建信息列表。

退貨

獲取設備

public final  getDevices ()

返回調用中可用的設備列表。

退貨

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

從測試工件或模塊工件中檢索文件並將其緩存在映射中以供後續調用使用。

參數
fileName String ：要在工件中查找的文件的名稱。

退貨
File來自測試工件或模塊工件的文件。如果找不到文件，則返回 null。

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

返回我們轉發結果的原始ITestInvocationListener 。

退貨
ITestInvocationListener

獲取模塊名稱

public String getModuleName ()

退貨
String

獲取真實設備

public final  getRealDevices ()

返回getDevices()列表中的所有非存根設備。

退貨

獲取運行名稱

public String getRunName ()

返回觸發收集器的測試運行mRunName的名稱。

退貨
String mRunName，當前測試運行名稱。

在裡面

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

使用當前上下文和轉發結果的位置初始化收集器。每個實例只會調用一次，收集器應該更新其內部上下文和偵聽器。 Init 永遠不會在之前的測試運行期間被調用。

除非您知道自己在做什麼，否則不要覆蓋。

參數
context IInvocationContext ：正在進行的調用的IInvocationContext 。

listener ITestInvocationListener ：放置結果的ITestInvocationListener 。

退貨
ITestInvocationListener新的聽眾包裝了原來的聽眾。

投擲
DeviceNotAvailableException

調用結束

public final void invocationEnded (long elapsedTime)

報告調用已終止，無論是成功終止還是由於某些錯誤情況。

將由 TradeFederation 框架自動調用。

參數
elapsedTime long ：調用經過的時間（以毫秒為單位）

調用失敗

public final void invocationFailed (FailureDescription failure)

報告由於某些錯誤情況導致的不完整調用。

將由 TradeFederation 框架自動調用。

參數
failure FailureDescription ：描述失敗原因的FailureDescription

調用失敗

public final void invocationFailed (Throwable cause)

報告由於某些錯誤情況導致的不完整調用。

將由 TradeFederation 框架自動調用。

參數
cause Throwable : 失敗的ERROR(/Throwable)原因

調用開始

public final void invocationStarted (IInvocationContext context)

用於轉發的調用偵聽器

參數
context IInvocationContext ：有關調用的信息

被禁用

public final boolean isDisabled ()

如果禁用整個對象（跳過設置和拆卸），則返回 True。否則為假。

退貨
boolean

isDisabledReceiver

public boolean isDisabledReceiver ()

IDeviceActionReceiver是否被禁用。

退貨
boolean如果禁用則返回 true，否則返回 false。

日誌關聯

public final void logAssociation (String dataName, 
                LogFile logFile)

不要使用內部指標收集器實現。這是純轉發。

參數
dataName String ：數據的名稱

logFile LogFile ：之前記錄的LogFile ，應該與測試用例相關聯。

測試假設失敗

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

當測試用例因假設失敗而失敗時回調。

參數
testData DeviceMetricData ：保存測試用例數據的DeviceMetricData 。

test TestDescription ：正在進行的測試用例的TestDescription 。

投擲
DeviceNotAvailableException

在測試結束時

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

測試用例結束時的回調。這應該是清理的時間。

參數
testData DeviceMetricData ：保存測試用例數據的DeviceMetricData 。將與onTestStart(com.android.tradefed.device.metric.DeviceMetricData)期間的對象相同。

currentTestCaseMetrics ：傳遞給ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))當前指標圖。

test TestDescription ：正在進行的測試用例的TestDescription 。

投擲
DeviceNotAvailableException

在測試結束時

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

測試用例結束時的回調。這應該是清理的時間。

參數
testData DeviceMetricData ：保存測試用例數據的DeviceMetricData 。將與onTestStart(com.android.tradefed.device.metric.DeviceMetricData)期間的對象相同。

currentTestCaseMetrics ：傳遞給ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))當前指標圖。

投擲
DeviceNotAvailableException

測試失敗

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

測試用例失敗時回調。

參數
testData DeviceMetricData ：保存測試用例數據的DeviceMetricData 。

test TestDescription ：正在進行的測試用例的TestDescription 。

投擲
DeviceNotAvailableException

onTestModule結束

public void onTestModuleEnded ()

允許捕獲模塊結束事件。

投擲
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

允許捕獲模塊啟動事件。

投擲
DeviceNotAvailableException

onTestRun結束

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

測試運行結束時回調。這應該是清理的時間。

參數
runData DeviceMetricData ：保存運行數據的DeviceMetricData 。將與onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)期間的對象相同。

currentRunMetrics ：傳遞給ERROR(/#testRunEnded(long,Map))的當前指標圖。

投擲
DeviceNotAvailableException

onTestRun失敗

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

testRunFailed 事件的回調

投擲
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

測試運行開始時的回調。

參數
runData DeviceMetricData ：保存運行數據的DeviceMetricData 。

投擲
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

測試用例啟動時的回調。

參數
testData DeviceMetricData ：保存測試用例數據的DeviceMetricData 。

投擲
DeviceNotAvailableException

重啟結束

public void rebootEnded (ITestDevice device)

在設備重啟結束時獲取通知。

注意：接收器應避免在此回調期間重新啟動。任何重啟嘗試都將被忽略。

參數
device ITestDevice ：重啟結束的ITestDevice 。

投擲
DeviceNotAvailableException

重啟開始

public void rebootStarted (ITestDevice device)

在設備中開始重新啟動時獲取通知。

注意：接收器應避免在此回調期間重新啟動。任何重啟嘗試都將被忽略。

參數
device ITestDevice ：重啟開始的ITestDevice 。

投擲
DeviceNotAvailableException

設置禁用

public final void setDisable (boolean isDisabled)

設置對像是否應該被禁用。禁用意味著應該跳過設置和拆卸步驟。可用於在默認構造函數中默認禁用對象。

參數
isDisabled boolean : 對象應該處於的狀態。

設置禁用接收器

public void setDisableReceiver (boolean isDisabled)

設置是否應禁用IDeviceActionReceiver 。禁用意味著它不會註冊到設備以接收設備操作事件。

參數
isDisabled boolean

設置日誌保存器

public final void setLogSaver (ILogSaver logSaver)

不要使用內部指標收集器實現。這是純轉發。

參數
logSaver ILogSaver ： ILogSaver

測試假設失敗

public final void testAssumptionFailure (TestDescription test, 
                String trace)

當原子測試標記它假定條件為假時調用

參數
test TestDescription ：標識測試

trace String ：失敗的堆棧跟踪

測試假設失敗

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

當原子測試標記它假定條件為假時調用

參數
test TestDescription ：標識測試

failure FailureDescription ：描述故障及其上下文的FailureDescription 。

測試結束

public final 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 ：測試結束的時間，通過ERROR(/System#currentTimeMillis())測量

testMetrics : 發出的指標的ERROR(/Map)

測試結束

public final void testEnded (TestDescription test, 
                 testMetrics)

報告單個測試用例的執行結束。

如果未調用testFailed(TestDescription, FailureDescription) ，則此測試通過。還返回在測試用例執行期間可能發出的任何鍵/值指標。

參數
test TestDescription ：標識測試

testMetrics : 發出的指標的ERROR(/Map)

測試失敗

public final void testFailed (TestDescription test, 
                FailureDescription failure)

報告單個測試用例的失敗。

將在 testStarted 和 testEnded 之間調用。

參數
test TestDescription ：標識測試

failure FailureDescription ：描述故障及其上下文的FailureDescription 。

測試失敗

public final void testFailed (TestDescription test, 
                String trace)

報告單個測試用例的失敗。

將在 testStarted 和 testEnded 之間調用。

參數
test TestDescription ：標識測試

trace String ：失敗的堆棧跟踪

測試忽略

public final void testIgnored (TestDescription test)

當測試不會運行時調用，通常是因為測試方法用 org.junit.Ignore 註釋。

參數
test TestDescription ：標識測試

測試日誌

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

提供來自測試調用的關聯日誌或調試數據。

必須在ERROR(/ITestInvocationListener#invocationFailed(Throwable))或ERROR(/ITestInvocationListener#invocationEnded(long))之前調用

TradeFederation 框架將自動調用此方法，提供主機日誌和設備 logcat（如果適用）。

參數
dataName String ：數據的ERROR(/String)描述性名稱。例如“device_logcat”。注意 dataName 每次調用可能不是唯一的。即實現者必須能夠處理具有相同數據名的多個調用

dataType LogDataType ：數據的LogDataType

dataStream InputStreamSource ：數據的InputStreamSource 。實施者應調用 createInputStream 開始讀取數據，並確保在完成後關閉生成的 InputStream。調用者應確保數據源保持存在且可訪問，直到 testLog 方法完成。

測試日誌已保存

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

不要使用內部指標收集器實現。這是純轉發。

參數
dataName String ：數據的ERROR(/String)描述性名稱。例如“device_logcat”。注意 dataName 每次調用可能不是唯一的。即實現者必須能夠處理具有相同數據名的多個調用

dataType LogDataType ：數據的LogDataType

dataStream InputStreamSource ：數據的InputStreamSource 。實施者應調用 createInputStream 開始讀取數據，並確保在完成後關閉生成的 InputStream。

logFile LogFile ：包含已保存文件的元數據的LogFile 。

測試模塊結束

public final void testModuleEnded ()

報告模塊運行結束。

測試模塊啟動

public final void testModuleStarted (IInvocationContext moduleContext)

報告模塊運行的開始。此回調與testModuleEnded()關聯，並且在序列中是可選的。它僅在使用模塊的運行期間使用：基於套件的運行器。

參數
moduleContext IInvocationContext ：模塊的IInvocationContext 。

測試運行結束

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

報告測試運行結束。 FIXME: 我們不能有兩個不同類型的 Map<> 接口，所以我們必須在這裡使用 HashMap。

參數
elapsedTime long ：設備報告經過的時間，以毫秒為單位

runMetrics ：在測試運行結束時使用Metric報告的鍵值對。

測試運行失敗

public final void testRunFailed (FailureDescription failure)

由於FailureDescription描述的故障，報告測試運行未能完成。

參數
failure FailureDescription ：描述故障及其上下文的FailureDescription 。

測試運行失敗

public final void testRunFailed (String errorMessage)

報告測試運行由於致命錯誤而未能完成。

參數
errorMessage String : ERROR(/String)描述運行失敗的原因。

測試運行開始

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

報告測試運行的開始。

參數
runName String : 測試運行名稱

testCount int : 測試運行中的測試總數

attemptNumber int : order number，標識同一 runName 多次運行的不同嘗試。 attemptNumber 是從 0 開始索引的，每次發生新的運行時都應該遞增。例如，一個測試被精細地重試了 3 次，它應該在同一個 runName 下總共運行 4 次，並且 attemptNumber 是從 0 到 3。

測試運行開始

public final void testRunStarted (String runName, 
                int testCount)

測試運行回調

參數
runName String : 測試運行名稱

testCount int : 測試運行中的測試總數

測試運行開始

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

報告測試運行的開始。

參數
runName String : 測試運行名稱

testCount int : 測試運行中的測試總數

attemptNumber int : order number，標識同一 runName 多次運行的不同嘗試。 attemptNumber 是從 0 開始索引的，每次發生新的運行時都應該遞增。例如，一個測試被精細地重試了 3 次，它應該在相同的 runName 下總共運行 4 次，並且 attemptNumber 是從 0 到 3。

startTime long ：運行開始的時間，通過ERROR(/System#currentTimeMillis())測量

測試運行已停止

public final void testRunStopped (long elapsedTime)

由於用戶請求，報告測試運行在完成之前停止。

TODO：目前未使用，考慮刪除

參數
elapsedTime long ：設備報告經過的時間，以毫秒為單位

測試開始

public final 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 ：測試開始的時間，通過ERROR(/System#currentTimeMillis())測量

測試開始

public final void testStarted (TestDescription test)

測試用例回調

參數
test TestDescription ：標識測試