本頁面由 Cloud Translation API 翻譯而成。

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

已知間接子類別

AggregatePostProcessor、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BasePostProcessor、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothConnectionSuccessRatePostProcessor、BluetoothHciSnoopLogCollector、BugreportCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector、CollectingTestListener 和其他 74 個。

AggregatePostProcessor	指標匯總工具，可針對在多次迭代測試執行期間收集到的數值指標，提供最小值、最大值、平均值、變異數、標準差、總數、計數，以及選用的百分位數，並將這些指標視為雙精度浮點值。
AtraceCollector	在測試期間執行追蹤記錄的 `IMetricCollector`，會收集結果並將結果記錄到叫用。
AtraceRunMetricCollector	從測試裝置的指定目錄中，收集所有測試目錄的追蹤記錄，記錄測試目錄，並對測試目錄下的追蹤記錄檔案進行後置處理，然後匯總指標。
AveragePostProcessor	實作後置處理器，計算指標清單的平均值。
BaseDeviceMetricCollector	`IMetricCollector` 的基本實作項目，可在 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 和 `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` 上開始及停止收集。
BasePostProcessor	每個實作項目都應擴充的基本 `IPostProcessor`。
BluetoothConnectionLatencyCollector	收集器會將預先定義的 statsd 持續時間指標設定推送至裝置，並收集每個設定檔的藍牙連線時間。
BluetoothConnectionStateCollector	這個收集器會收集 BluetoothConnectionStateChanged 指標，並記錄各個設定檔的連線狀態編號。
BluetoothConnectionSuccessRatePostProcessor	實作後置處理器，計算藍牙設定檔的成功率使用「metric-key-match」指定指標，這些指標在數值陣列中包含藍牙連線狀態。例如 [0、1、2、3、0、1、2、3]。
BluetoothHciSnoopLogCollector	收集器，可在 DUT 上啟用藍牙 HCI 窺探記錄，並收集每項測試的記錄。
BugreportCollector	在可設定事件發生時收集錯誤報告的傳遞 `ITestInvocationListener`，然後在收集每個錯誤報告後對其子項呼叫 `ITestInvocationListener#testLog`。
BugreportzOnFailureCollector	在測試案例失敗時收集錯誤報告。
BugreportzOnTestCaseFailureCollector	在執行期間收集測試案例失敗的錯誤報告。
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 Clang 涵蓋率測量資料，並將其記錄為測試構件。
收集 TestListener	用於收集所有測試結果的 `ITestInvocationListener`。
CommandStatusHandler	處理程序，可協助監控及更新叫用作業的狀態。
ConditionFailureMonitor	監控叫用作業是否發生任何失敗。
ConsoleResultReporter	用於將測試結果列印至控制台的結果回報器。
CountTestCasesCollector	計算並回報指定 `IRemoteTest` 的測試案例數量。
DebugHostLogOnFailureCollector	當測試案例失敗時，這個收集器會收集並記錄主機端記錄。
DeviceReleaseReporter	裝置發布報告器，可處理與要發布的裝置父項程序進行通訊。
DeviceTraceCollector	在測試開始執行時啟動 Perfetto 追蹤，並在測試結束時記錄追蹤檔案的收集器。
DeviceUnavailableMonitor	這個事件監聽器只會嘗試擷取測試案例層級的 DNAE。
EventsLoggerListener	會記錄其收到的所有事件至檔案的接聽程式
FileProtoResultReporter	將 `TestRecord` 轉儲至檔案的 Proto 報表工具。
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector`，可監聽來自裝置的指標鍵，並從裝置提取指標鍵。
FilePullerLogCollector	裝置端回報的檔案記錄器。
FilteredResultForwarder	`ResultForwarder` 的變化版本，僅允許回報 `TestDescription` 的許可清單。
FormattedGeneratorReporter	可讓您以特定格式產生報表的報表工具。
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 gcov 涵蓋率測量結果，並將其記錄為測試構件。
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` 會從 debugfs 和裝置中提取 gcov 核心涵蓋率測量值，然後將這些值記錄為測試構件。
GranularRetriableTestWrapper.StartEndCollector	用於擷取缺少的執行開始和結束時間的類別輔助程式。
HostStatsdMetricCollector	`IMetricCollector`，使用 Statsd 公用程式指令從主機端收集統計資料指標。
ICommandScheduler.IScheduledInvocationListener	叫用完成時的叫用事件監聽器。
ILogSaverListener	允許 `ITestInvocationListener` 監聽記錄檔儲存時的狀態。
IMetricCollector	在回報測試結果時，系統會將此介面新增為修飾符，以便收集相符的指標。
IPostProcessor	後置處理器是 Trade Federation 物件，可在測試完成後及結果回報前處理指標和記錄。
IShardableListener	可分割的 `ITestInvocationListener`。
ISupportGranularResults	指定 `ITestInvocationListener` 是否支援接收精細結果的介面。
ITestSummaryListener	可讓 `ITestInvocationListener` 透過摘要交換部分有限資訊的介面。
InvocationToJUnitResultForwarder	這個類別可監聽 `ITestInvocationListener` 事件並轉送至 `TestListener`。
JarHostTest.HostTestListener	除了 testRunStarted() 和 testRunEnded() 以外，所有事件都會由包裝函式事件監聽器轉送至內嵌事件監聽器。
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 Java 涵蓋率評估結果，並將其記錄為測試構件。
JsonHttpTestResultReporter	結果回報器，可將測試指標結果和分支、裝置資訊編碼為 JSON，並將其 POST 至 HTTP 服務端點
LUCIResultReporter	結果回報器可將 ResultDB 和 LUCI 所需的測試結果儲存為 JSON 格式 (go/result-sink)，並在控制台中記錄檔案位置。
LastShardDetector	執行本機資料分割時，有時我們只想在最後一個資料分割達到 `invocationEnded(long)` 時執行某些動作。
LegacySubprocessResultsReporter	凍結的子程序結果回報器實作項目，即使其超類別有所變更，仍應與較舊版本的 TF/CTS (例如 8 以上版本) 相容。
LogSaverResultForwarder	使用全域檔案儲存工具儲存記錄的 `ResultForwarder`。
LogcatCrashResultForwarder	特殊監聽器：在發生失敗 (檢測程序當機) 時，它會嘗試從 Logcat 中擷取當機事件，並將其加入與測試相關的失敗訊息。
LogcatOnFailureCollector	當測試案例失敗時，這個收集器會擷取並記錄 Logcat。
LogcatTimingMetricCollector	一種指標收集器，可在一或多項重複測試期間，使用指定的規則運算式模式剖析 Logcat 行中事件的開始與結束信號，藉此從 Logcat 收集時間資訊 (例如使用者切換時間)。
MetricFilePostProcessor	用於上傳在測試和執行層級收集的指標記錄檔。
MetricsXMLResultReporter	MetricsXMLResultReporter 會在測試的 invocationEnded 階段，將測試指標和執行指標寫入由 metrics-folder 參數指定的資料夾中 XML 檔案。
ModuleListener	監聽器會附加至每個模組的每個 `IRemoteTest`，以便收集結果清單。
ModuleLogcatCollector	Logcat 收集器的版本，但適用於模組。
ModuleProtoResultReporter	結果回報器，只會回報模組層級結果。
NameMangleListener	代理程式事件監聽器，用於在回報結果時轉譯測試方法、類別和套件名稱。
PassingTestFileReporter	`ITestInvocationListener`，可將通過測試的測試案例清單儲存至測試檔案
PerfettoGenericPostProcessor	此後處理器將處理文字/二進位指標 Perfetto proto 檔案，透過遞迴方式展開 proto 訊息和具有字串值的欄位，直到遇到包含數值的欄位為止。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector` 基礎實作，允許從裝置提取 Perfetto 檔案，並從中收集指標。
PrettyTestEventLogger	記錄事件並記錄事件，以便進行偵錯。
ProtoResultReporter	結果回報器會建構 `TestRecord` protobuf，其中包含所有結果。
PythonBinaryHostTest.PythonForwarder	將執行作業名稱替換為二進位檔名稱的結果轉發器。
RebootReasonCollector	收集器會在測試執行期間收集裝置重新啟動情形，並依據原因和計數回報。
RemoteTestTimeOutEnforcer	可用於檢查指定測試設定的執行時間，並在超過指定逾時時間時失敗的事件監聽器。
ReportPassedTests	在報表中加入可能的篩選器，以排除通過的測試。
ResultAggregator	特殊轉寄站，根據採取的重試策略，視需要匯總結果。
ResultAndLogForwarder	結果和記錄事件的轉送器。
ResultForwarder	將叫用結果轉送至其他事件監聽器清單的 `ITestInvocationListener`。
RetryLogSaverResultForwarder	轉送器，同時會處理傳遞目前嘗試的內容。
RetryResultForwarder	`ResultForwarder` 的擴充功能，一律會推送至指定嘗試次數。
RuntimeRestartCollector	收集器會在測試執行期間收集執行階段重新啟動 (系統伺服器當機) 的時間戳記 (如有)。
ScreenshotOnFailureCollector	在測試案例失敗時，會擷取並記錄螢幕截圖的收集器。
ShardListener	`ITestInvocationListener` 會收集呼叫分割作業 (也就是在多個資源上並行執行的呼叫分割作業) 的結果，並將結果轉送至其他事件監聽器。
ShardMainResultForwarder	將分割測試叫用作業的結果合併的 `ResultForwarder`。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作項目，可從裝置中提取 showmap 檔案，並收集相關指標。
StatsdBeforeAfterGaugeMetricPostProcessor	後續處理器會處理以「前後」方式收集的評估指標，也就是
StatsdEventMetricPostProcessor	使用處理器指定的格式設定工具，將統計資料報表中的事件指標處理成鍵/值組合。
StatsdGenericPostProcessor	後置處理器會將二進位值傳送的統計資料報告，以樹狀結構展開為鍵/值組合。
StreamProtoResultReporter	`ProtoResultReporter` 的實作方式
SubprocessResultsReporter	實作 `ITestInvocationListener` 並將其指定為 result_reporter，並從子程序的測試、測試執行作業、測試叫用結果中轉送出去。
SuiteResultReporter	收集整個套件叫用作業的測試結果，並輸出最終結果。
TestRunResultListener	可讀取最終測試執行狀態的事件監聽器。
TestTimeoutEnforcer	可用於檢查特定測試案例的執行時間，並在超過指定逾時時間時失敗的事件監聽器。
TextResultReporter	將結果轉送至 JUnit 文字結果印表機的測試結果回報器。
TraceCmdCollector	`IMetricCollector` 會在測試期間使用 trace-cmd 收集追蹤記錄，並將這些記錄記錄到叫用作業中。
TradefedSandboxRunner.StubScheduledInvocationListener	不執行任何操作的 Stub `IScheduledInvocationListener`。
XmlFormattedGeneratorReporter	實作 `FormattedGeneratorReporter`，以 XML 格式格式化套裝軟體結果。
XmlResultReporter	以與 Ant 的 XMLJUnitResultFormatter 一致的格式，將 JUnit 結果寫入 XML 檔案。

測試叫用作業的測試結果事件監聽器。

測試叫用本身可以包含多次測試執行作業，因此系統會依序發出呼叫序列

responseStarted(BuildInfo)
testRunStarted
testStarted
[testFailed]
testEnded
...
testRunEnded
...
testRunStarted
...
testRunEnded
[invocationFailed]
[testLog+]
invocationEnded
getSummary

摘要

公用方法
`default TestSummary`	`getSummary()` 允許 InvocationListener 傳回摘要。
`default void`	`invocationEnded(long elapsedTime)` 回報叫用已終止 (無論成功或因某些錯誤狀況而終止)。
`default void`	`invocationFailed(FailureDescription failure)` 回報因某些錯誤條件而不完整的叫用。
`default void`	`invocationFailed(Throwable cause)` 由於某些錯誤情況，因此回報未完成的叫用作業。
`default void`	`invocationInterrupted()` 在排程器關閉時呼叫，可讓叫用作業在終止前執行某些動作。
`default void`	`invocationSkipped(SkipReason reason)` 將叫用回報為略過
`default void`	`invocationStarted(IInvocationContext context)` 回報測試叫用作業的開始時間。
`default void`	`testModuleEnded()` 回報模組執行作業的結尾。
`default void`	`testModuleStarted(IInvocationContext moduleContext)` 回報模組開始執行的時間。

公用方法

getSummary

public TestSummary getSummary ()

允許 InvocationListener 傳回摘要。

傳回
`TestSummary`	摘要執行作業的 `TestSummary`，或空值

invocationEnded

public void invocationEnded (long elapsedTime)

回報叫用已終止，無論是成功或因某些錯誤條件而終止。

將由 TradeFederation 架構自動呼叫。

參數
`elapsedTime`	`long`：叫用作業的經過時間 (以毫秒為單位)

invocationFailed

public void invocationFailed (FailureDescription failure)

由於某些錯誤情況，因此回報未完成的叫用作業。

會由 TradeFederation 架構自動呼叫。

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

invocationFailed

public void invocationFailed (Throwable cause)

由於某些錯誤情況，因此回報未完成的叫用作業。

會由 TradeFederation 架構自動呼叫。

參數
`cause`	`Throwable`：失敗的 `Throwable` 原因

invocationInterrupted

public void invocationInterrupted ()

在排程器關閉時呼叫，可讓叫用作業在終止前執行某些動作。

invocationSkipped

public void invocationSkipped (SkipReason reason)

將叫用動作回報為略過

參數
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

回報測試叫用作業的開始時間。

會由 TradeFederation 架構自動呼叫。回報器需要覆寫這個方法，才能支援多裝置回報。

參數
`context`	`IInvocationContext`：叫用作業相關資訊

testModuleEnded

public void testModuleEnded ()

回報模組的執行完畢。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

回報模組開始執行的時間。這個回呼與 testModuleEnded() 相關聯，在序列中為選用項目。這個屬性只會在使用模組：套件式執行程式的執行期間使用。

參數
`moduleContext`	`IInvocationContext`：模組的 `IInvocationContext`。