ITestInvocationListener

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInvocationListener

已知的間接子類

AggregatePostProcessor ， AtraceCollector ， AtraceRunMetricCollector ， AveragePostProcessor ， BaseDeviceMetricCollector ， BasePostProcessor ， BuddyInfoMetricCollector ， BugreportCollector ， BugreportzMetricCollector ， BugreportzOnFailureCollector ， CollectingTestListener ， ConsoleResultReporter ， DebugHostLogOnFumpureCollector Heap ， DeviceUnavaly

AggregatePostProcessor	度量聚合器，它為多次迭代測試運行期間收集的數字度量提供最小值，最大值，均值，方差和標準偏差，並將其視為兩倍。
AtraceCollector	一個`IMetricCollector` ，在測試期間運行atrace並收集結果並將其記錄到調用中。
AtraceRunMetricCollector	從測試設備的給定目錄下的所有測試目錄中收集跟踪，記錄測試目錄，並對測試目錄下的跟踪文件進行後處理，並彙總指標。
AveragePostProcessor	實現後處理程序，以計算度量標準列表的平均值。
BaseDeviceMetricCollector	`IMetricCollector`基本實現，它允許在`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`和`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`上啟動和停止收集。
BasePostProcessor	每個實現都應擴展的基礎`IPostProcessor` 。
BuddyInfoMetricCollector	`ScheduledDeviceMetricCollector`用於定期收集碎片。
BugreportCollector	一個傳遞式`ITestInvocationListener` ，它在發生可配置事件時收集`ITestInvocationListener` ，然後在收集每個`ITestInvocationListener#testLog`報告後在其子`ITestInvocationListener#testLog`上調用`ITestInvocationListener#testLog` 。
BugreportzMetricCollector	`ScheduledDeviceMetricCollector`定期收集壓縮的錯誤報告。
BugreportzOnFailureCollector	測試用例失敗時收集錯誤報告。
收集測試監聽器	一個`ITestInvocationListener` ，它將收集所有測試結果。
ConsoleResultReporter	結果報告器將測試結果打印到控制台。
DebugHostLogOnFailureCollector	當發生測試用例失敗時，收集器將收集並記錄主機端日誌。
DeviceUnavailEmailResultReporter	當由於設備不可用異常而導致調用失敗時將發送電子郵件的`EmailResultReporter` 。
DumpHeapCollector	`ScheduledDeviceMetricCollector`用於定期收集進程的內存轉儲。
EmailResultReporter	一個簡單的結果報告程序基類，用於發送測試結果的電子郵件。
FailureEmailResultReporter	如果發生測試失敗或調用失敗，則發送`EmailResultReporter`通知的`EmailResultReporter` 。
FileProtoResultReporter	原始記者，將`TestRecord`轉儲到文件中。
FilePullerDeviceMetricCollector	一個`BaseDeviceMetricCollector` ，它偵聽來自設備的指標密鑰，並將其作為文件從設備中拉出。
FilePullerLogCollector	設備端報告的文件的記錄器。
FilteredResultForwarder	`ResultForwarder`變體，僅允許報告`TestDescription`的白名單。
FormattedGeneratorReporter	記者，可以生成特定格式的報告。
GraphicsStatsMetricCollector	`ScheduledDeviceMetricCollector`用於定期收集圖形統計信息。
HostStatsdMetricCollector	一個`IMetricCollector` ，它使用statsd實用程序命令從主機側收集statsd度量。
ICommandScheduler.IScheduledInvocationListener	調用完成時的調用事件偵聽器。
ILogSaverListener	保存日誌文件時，允許`ITestInvocationListener`偵聽。
IMetricCollector	報告測試結果時，此接口將被添加為裝飾器，以收集匹配的指標。
IPostProcessor	後處理器是一個貿易聯盟對象，旨在允許在測試之後和結果報告之前處理指標和日誌。
IShardableListener	可以分片的`ITestInvocationListener` 。
ITestSummaryListener	允許`ITestInvocationListener`通過摘要交換一些有限信息的接口。
IncidentReportCollector	拉並處理在設備端報告的事件報告。
InvocationFailureEmailResultReporter	一個`EmailResultReporter` ，它還可以將通知限制為僅調用失敗。
InvocationToJUnitResultForwarder	偵聽`ITestInvocationListener`事件並將其轉發到`TestListener` 。
IonHeapInfoMetricCollector	`ScheduledDeviceMetricCollector`用於定期收集音頻和系統內存堆。
JsonHttpTestResultReporter	結果報告器，對測試指標結果進行編碼，並將設備信息分支為JSON，然後將POST分支為HTTP服務終結點
LegacySubprocessResultsReporter	與CTS的M＆N版本兼容的凍結子過程結果報告程序的類。
LogSaverResultForwarder	一個`ResultForwarder`用於使用全局文件保護程序保存日誌。
LogcatCrashResultForwarder	特殊的偵聽器：在失敗（儀器進程崩潰）時，它將嘗試從logcat中提取崩潰，並將其添加到與測試關聯的失敗消息中。
LogcatOnFailureCollector	當測試用例失敗時，將捕獲並記錄logcat的收集器。
MemInfoMetricCollector	`ScheduledDeviceMetricCollector`用於定期收集內存轉儲。
指標XMLResultReporter	MetricsXMLResultReporter在測試的invocationEnded階段，將測試指標和運行指標寫入XML文件夾中由metrics-folder參數指定的文件夾中。
模塊監聽器	偵聽器附加到每個模塊的每個`IRemoteTest`以便收集結果列表。
NameMangleListener	報告結果時，將轉換測試方法，類和包名稱的代理偵聽器。
NativeCodeCoverageListener	一個`ResultForwarder` ，它將把本機覆蓋率測量值從設備中拉出並記錄為測試工件。
PagetypeInfoMetricCollector	`ScheduledDeviceMetricCollector`用於定期收集免費頁數。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector`基本實現，該實現允許從設備中提取perfetto文件並從中收集指標。
PrettyTestEventLogger	記錄器匹配事件並記錄它們，以使其更易於調試。
ProcessMaxMemoryCollector	`ScheduledDeviceMetricCollector`用於測量指定進程的峰值內存使用情況。
ProtoResultReporter	結果報告程序構建一個`TestRecord` protobuf，其中包含所有結果。
PythonBinaryHostTest.PythonForwarder	結果轉發器用二進制名稱替換運行名稱。
重新啟動原因收集器	在測試運行期間收集設備重新啟動的收集器，並按原因和計數報告它們。
ResultAndLogForwarder	結果和日誌事件的轉發器。
結果轉發器	一個`ITestInvocationListener` ，它將調用結果轉發到其他偵聽器列表。
RetryResultForwarder	`ResultForwarder`的擴展，始終將其推入給定的嘗試編號。
RuntimeRestartCollector	收集運行時重新啟動（系統服務器崩潰）的時間戳的收集器（如果有）。
ScheduleMultipleDeviceMetricCollector	一個`IMetricCollector` ，使之定期運行多個度量收集器。
ScheduledDeviceMetricCollector	一個`IMetricCollector` ，它允許以設置的時間間隔定期運行收集任務。
ScreenshotOnFailureCollector	當測試用例失敗時，收集器將捕獲並記錄屏幕截圖。
碎片監聽器	一個`ITestInvocationListener` ，它從一個調用碎片（也稱為一個拆分為並行運行在多個資源上）中收集結果，並將其轉發給另一個偵聽器。
碎片大師結果轉發器	一個`ResultForwarder` ，它結合了分片測試調用的結果。
StreamProtoResultReporter	`ProtoResultReporter`的實現
SubprocessResultsReporter	實現`ITestInvocationListener` ，將其指定為result_reporter，並從子流程轉發測試，測試運行，測試調用的結果。
SuiteResultReporter	收集整個套件調用的測試結果並輸出最終結果。
溫度收集器	`ScheduledDeviceMetricCollector`用於測量最小和最大設備溫度。
TestFailureEmailResultReporter	一個`EmailResultReporter` ，它還可以將通知限制為僅測試失敗。
TestFailureListener	當請求失敗時，偵聽器通常會在測試失敗時採取措施，如屏幕截圖，錯誤報告，logcat收集。
TextResultReporter	測試結果報告程序，將結果轉發到JUnit文本結果打印機。
TraceCmdCollector	一個`IMetricCollector` ，它在測試過程中使用trace-cmd收集跟踪，並將其記錄到調用中。
TraceMetricCollector	一個`ScheduledDeviceMetricCollector`用於定期收集內核調試跟踪。
TradefedSandboxRunner.StubScheduledInvocationListener	一個不執行任何操作的存根`IScheduledInvocationListener` 。
XmlFormattedGeneratorReporter	`FormattedGeneratorReporter`套件的`FormattedGeneratorReporter`實現結果為xml格式。
XmlResultReporter	將JUnit結果以與Ant的XMLJUnitResultFormatter一致的格式寫入XML文件。

來自測試調用的測試結果的偵聽器。

一個測試調用本身可以包含多個測試運行，因此調用順序為

invocationStarted（BuildInfo）
testRunStarted
testStarted
[testFailed]
testEnded
...
testRunEnded
...
testRunStarted
...
testRunEnded
[invocationFailed]
[testLog +]
調用結束
getSummary

概要

公開方法
`default TestSummary`	`getSummary ()` 允許InvocationListener返回摘要。
`default void`	`invocationEnded (long elapsedTime)` 報告調用已成功終止或由於某些錯誤情況而終止。
`default void`	`invocationFailed (Throwable cause)` 由於某些錯誤情況，報告不完整的調用。
`default void`	`invocationInterrupted ()` 調用`ICommandScheduler#shutdown()` ，使調用有機會在終止之前做一些事情。
`default void`	`invocationStarted (IInvocationContext context)` 報告測試調用的開始。
`default void`	`testModuleEnded ()` 報告模塊運行結束。
`default void`	`testModuleStarted (IInvocationContext moduleContext)` 報告模塊運行的開始。

公開方法

getSummary

public TestSummary getSummary ()

允許InvocationListener返回摘要。

退貨
`TestSummary`	匯總運行的`TestSummary` ，或者為null

調用結束

public void invocationEnded (long elapsedTime)

報告調用已成功終止或由於某些錯誤情況而終止。

將由TradeFederation框架自動調用。

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

調用失敗

public void invocationFailed (Throwable cause)

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

將由TradeFederation框架自動調用。

參量
`cause`	`Throwable` ：失敗的可`Throwable`原因

調用中斷

public void invocationInterrupted ()

調用ICommandScheduler#shutdown() ，使調用有機會在終止之前做一些事情。

調用開始

public void invocationStarted (IInvocationContext context)

報告測試調用的開始。

將由TradeFederation框架自動調用。報告者需要重寫此方法以支持多個設備報告。

參量
`context`	`IInvocationContext` ：有關調用的信息

testModuleEnded

public void testModuleEnded ()

報告模塊運行結束。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

報告模塊運行的開始。該回調與testModuleEnded()相關聯，並且在序列中是可選的。它僅在使用以下模塊的運行中使用：基於ITestSuite的運行器。

參量
`moduleContext`	`IInvocationContext` ：模塊的`IInvocationContext` 。