自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

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

ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

已知間接子類別

AggregatePostProcessor、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BasePostProcessor、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothConnectionSuccessRatePostProcessor、BluetoothHciSnoopLogCollector、BugreportCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector、CodeCoverageCollector 等 84 個。

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	Collector 可在 DUT 上啟用藍牙 HCI 窺探記錄，並收集各項測試的記錄。
BugreportCollector	這個傳遞 `ITestInvocationListener` 會在可設定的事件發生時收集錯誤報告，並在收集每份錯誤報告後，對子項呼叫 `ITestInvocationListener.testLog`。
BugreportzOnFailureCollector	測試案例失敗時，收集 bugreportz。
BugreportzOnTestCaseFailureCollector	在執行測試案例時，如果發生失敗情形，請收集錯誤報告。
ClangCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Clang 涵蓋範圍測量結果，並將其記錄為測試構件。
CodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Java 和原生涵蓋範圍測量結果，並將其記錄為測試構件。
CollectingTestListener	`ITestInvocationListener`，用於收集所有測試結果。
CommandStatusHandler	處理常式，可協助監控及更新叫用狀態。
ConditionFailureMonitor	監控呼叫作業是否發生任何失敗。
ConsoleResultReporter	結果報告工具，可將測試結果列印到控制台。
CountTestCasesCollector	計算並回報指定 `IRemoteTest` 的測試案例數量。
CountingTestResultListener	`TestResultListener`，可追蹤測試總數 (以 `TestStatus` 為單位)
DebugHostLogOnFailureCollector	收集器會在測試案例失敗時收集並記錄主機端記錄。
DeviceReleaseReporter	裝置發布回報程式，負責與父項程序通訊，以發布裝置。
DeviceTraceCollector	這個收集器會在測試執行開始時啟動 Perfetto 追蹤記錄，並在結束時記錄追蹤記錄檔。
DeviceUnavailableMonitor	這個接聽程式只會嘗試擷取測試案例層級的 DNAE。
EventsLoggerListener	這個監聽器會將收到的所有事件記錄到檔案中
FileProtoResultReporter	Proto 報告器，可將 `TestRecord` 傾印至檔案。
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector`，可監聽裝置傳來的指標金鑰，並從裝置中擷取這些金鑰做為檔案。
FilePullerLogCollector	記錄裝置端回報的檔案。
FilteredResultForwarder	`ResultForwarder` 的變體，只允許回報許可清單中的 `TestDescription`。
FormattedGeneratorReporter	可產生特定格式報表的 Reporter。
GcovCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 gcov 涵蓋範圍測量結果，並將其記錄為測試構件。
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector`，可從 debugfs 和裝置中提取 gcov 核心涵蓋範圍測量結果，最後將這些結果記錄為測試構件。
GranularRetriableTestWrapper.StartEndCollector	課程助手可偵測跑步活動的開始和結束時間。
HostStatsdMetricCollector	`IMetricCollector`：使用 statsd 公用程式指令從主機端收集 statsd 指標。
ICommandScheduler.IScheduledInvocationListener	在叫用完成時，用於叫用事件的監聽器。
ILogSaverListener	允許 `ITestInvocationListener` 監聽記錄檔的儲存時間。
IMetricCollector	回報測試結果時，這個介面會以裝飾器形式新增，以便收集相符的指標。
IPostProcessor	後續處理器是 Trade Federation 物件，用於在測試後和結果回報前處理指標和記錄。
IShardableListener	可分片的 `ITestInvocationListener`。
ISupportGranularResults	介面，用於指定 `ITestInvocationListener` 是否支援接收精細結果。
ITestInvocationListener	測試結果的接聽器 (來自測試呼叫)。
ITestSummaryListener	介面，可讓 `ITestInvocationListener` 透過摘要交換部分有限資訊。
InvocationProtoResultReporter	記者儲存叫用層級的快取資訊和模組清單
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	指標收集器，可使用指定的 regex 模式剖析 logcat 幾行中的事件開始和結束信號，在一次或多次重複測試期間，從 logcat 收集時間資訊 (例如使用者切換時間)。
MetricFilePostProcessor	用於上傳在測試和執行層級收集的指標記錄檔。
MetricsXMLResultReporter	在測試的 invocationEnded 階段，MetricsXMLResultReporter 會將測試指標和執行指標寫入 metrics-folder 參數指定的資料夾中的 XML 檔案。
ModuleListener	附加至每個模組的每個 `IRemoteTest` 的監聽器，用於收集結果清單。
ModuleLogcatCollector	記錄收集器版本，但適用於模組。
ModuleProtoResultReporter	結果回報器，僅用於回報模組層級的結果。
ModuleResultsAndMetricsForwarder	`ResultAndLogForwarder` 的擴充功能，可將額外的模組相關指標新增至測試結果。
NameMangleListener	Proxy 監聽器，可在回報結果時翻譯測試方法、類別和套件名稱。
PassingTestFileReporter	`ITestInvocationListener`，可將通過的測試案例清單儲存至測試檔案
PerfettoFilePullerCollector	收集器會從裝置中提取 perfetto 追蹤記錄檔案，並視需要壓縮檔案，然後將檔案新增至測試記錄。
PerfettoGenericPostProcessor	後續處理器，可將文字/二進位指標 perfetto proto 檔案處理為鍵/值組合，方法是遞迴展開 proto 訊息和具有字串值的欄位，直到遇到具有數值的欄位為止。
PerfettoPullerMetricCollector	這個類別已淘汰。請改用 `PerfettoFilePullerCollector` 和 `ERROR(/PerfettoTracePostProcessor)`。
PerfettoTracePostProcessor	後處理器：從測試記錄中擷取 perfetto 追蹤記錄檔案，並對這些檔案執行追蹤記錄處理器，以產生 perfetto 指標 proto。
PrettyTestEventLogger	記錄器會比對事件並記錄，方便您進行偵錯。
ProtoResultReporter	結果回報器會建構 `TestRecord` protobuf，內含所有結果。
PythonBinaryHostTest.PythonForwarder	結果轉送器，可將執行名稱替換為二進位名稱。
RebootReasonCollector	收集測試執行期間的裝置重新啟動次數，並依據原因和次數回報。
RemoteTestTimeOutEnforcer	這個監聽器可檢查特定測試設定的執行時間，並在超過指定逾時時間時導致測試失敗。
ReportPassedTests	在檔案中回報可排除通過測試的篩選器。
ResultAggregator	特殊轉送器，可根據採取的重試策略，在需要時彙整結果。
ResultAndLogForwarder	轉送結果和記錄事件。
ResultDBReporter	結果回報工具，可將測試結果上傳至 ResultDB。
ResultForwarder	`ITestInvocationListener`，可將叫用結果轉送至其他接聽者的清單。
ResultReporter
RetryLogSaverResultForwarder	轉送器，也會處理傳遞目前的嘗試次數。
RetryResultForwarder	`ResultForwarder` 的擴充功能，一律會推送至指定的嘗試次數。
RuntimeRestartCollector	收集測試執行期間執行階段重新啟動 (系統伺服器當機) 時間戳記的收集器 (如有)。
ScreenshotOnFailureCollector	收集器，會在測試案例失敗時擷取並記錄螢幕截圖。
ShardListener	`ITestInvocationListener`：從叫用分片收集結果 (又稱「叫用分割」，可在多個資源上平行執行)，並將結果轉送至其他接聽程式。
ShardMainResultForwarder	`ResultForwarder`，可合併分片測試調用的結果。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作，可從裝置中提取 showmap 檔案，並從中收集指標。
StatsdBeforeAfterGaugeMetricPostProcessor	後續處理器，會以「前後」方式處理收集到的計量表指標，也就是：
StatsdEventMetricPostProcessor	後置處理器會使用處理器上指定的格式化工具，將 statsd 報表中的事件指標處理為鍵/值組合。
StatsdGenericPostProcessor	後處理器：將二進位 proto statsd 報表處理成鍵/值組合，方法是將報表展開為樹狀結構。
StreamProtoResultReporter	`ProtoResultReporter` 的實作
SubprocessResultsReporter	實作 `ITestInvocationListener`，指定為 result_reporter，並從子程序轉送測試、測試執行、測試調用的結果。
SuiteResultReporter	收集整個套件呼叫的測試結果，並輸出最終結果。
TestResultListener	ITestLifecycleListener 的簡化版本，適用於只關心個別測試結果的實作者。
TestRunResultListener	可讀取最終測試執行狀態的接聽程式。
TestTimeoutEnforcer	這個接聽程式可檢查特定測試案例的執行時間，並在超過指定逾時時間時讓測試案例失敗。
TextResultReporter	測試結果回報工具，可將結果轉送至 JUnit 文字結果印表機。
TraceCmdCollector	`IMetricCollector`，在測試期間使用 trace-cmd 收集追蹤記錄，並將記錄寫入叫用。
TradefedSandboxRunner.StubScheduledInvocationListener	不會執行任何動作的虛設常式 `IScheduledInvocationListener`。
XmlFormattedGeneratorReporter	實作 `FormattedGeneratorReporter`，將套件結果格式化為 XML 格式。
XmlResultReporter	以符合 Ant 的 XMLJUnitResultFormatter 格式，將 JUnit 結果寫入 XML 檔案。

在插樁測試執行期間接收事件通知。

以 org.junit.runner.notification.RunListener 為範本

呼叫順序如下：

testRunStarted
testStarted
[testFailed]
[testAssumptionFailure]
[testIgnored]
testEnded
....
[testRunFailed]
testRunEnded

摘要

公用方法
`default void`	`testAssumptionFailure(TestDescription test, String trace)` 當原子測試標記假設條件為 false 時，系統會呼叫這個函式。
`default void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` 當原子測試標記假設條件為 false 時，系統會呼叫這個函式。
`default void`	`testEnded(TestDescription test, long endTime, testMetrics)` `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` 的替代方案，可直接指定結束時間。
`default void`	`testEnded(TestDescription test, testMetrics)` 回報個別測試案例的執行結束時間。
`default void`	`testFailed(TestDescription test, FailureDescription failure)` 回報個別測試案例的失敗情形。
`default void`	`testFailed(TestDescription test, String trace)` 回報個別測試案例的失敗情形。
`default void`	`testIgnored(TestDescription test)` Called when a test will not be run, generally because a test method is annotated with org.junit.Ignore.
`default void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` Reports end of test run.
`default void`	`testRunFailed(FailureDescription failure)` 由於 `FailureDescription` 所述的失敗情形，報表測試執行作業無法完成。
`default void`	`testRunFailed(String errorMessage)` 由於發生嚴重錯誤，報表測試執行作業無法完成。
`default void`	`testRunStarted(String runName, int testCount, int attemptNumber)` 回報測試執行的開始時間。
`default void`	`testRunStarted(String runName, int testCount)` 回報測試執行的開始時間。
`default void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` 回報測試執行的開始時間。
`default void`	`testRunStopped(long elapsedTime)` 由於使用者要求，報表測試執行作業在完成前停止。
`default void`	`testSkipped(TestDescription test, SkipReason reason)` Called when a test is skipped and did not execute for a reason that is not usually expected.
`default void`	`testStarted(TestDescription test, long startTime)` `testStarted(com.android.tradefed.result.TestDescription)` 的替代方案，我們也會指定測試開始時間，並搭配 `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` 進行準確的評估。
`default void`	`testStarted(TestDescription test)` 回報個別測試案例的開始時間。

公用方法

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

當原子測試標記假設為 false 的條件時呼叫

參數
`test`	`TestDescription`：識別測試
`trace`	`String`：失敗的堆疊追蹤

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

當原子測試標記假設為 false 的條件時呼叫

參數
`test`	`TestDescription`：識別測試
`failure`	`FailureDescription`：`FailureDescription`，說明失敗情形和相關情境。

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`	`FailureDescription`：`FailureDescription`，說明失敗情形和相關情境。

testFailed

public void testFailed (TestDescription test, 
                String trace)

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

會在 testStarted 和 testEnded 之間呼叫。

參數
`test`	`TestDescription`：識別測試
`trace`	`String`：失敗的堆疊追蹤

testIgnored

public void testIgnored (TestDescription test)

當測試不會執行時呼叫，通常是因為測試方法已使用 org.junit.Ignore 註解。

參數
`test`	`TestDescription`：識別測試

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

報告測試執行結束時間。

參數
`elapsedTimeMillis`	`long`：裝置回報的經過時間 (以毫秒為單位)
`runMetrics`	：在測試執行結束時回報的鍵/值組合

testRunFailed

public void testRunFailed (FailureDescription failure)

由於 FailureDescription 所述的失敗情形，報表測試執行作業無法完成。

參數
`failure`	`FailureDescription`：`FailureDescription`，說明失敗情形和相關情境。

testRunFailed

public void testRunFailed (String errorMessage)

發生嚴重錯誤，導致報表測試執行作業無法完成。

參數
`errorMessage`	`String`：`String`，說明執行失敗的原因。

testRunStarted

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

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

參數
`runName`	`String`：測試執行作業名稱
`testCount`	`int`：測試執行作業中的測試總數
`attemptNumber`	`int`：訂單號碼，用於識別相同 runName 的不同嘗試，該 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 的不同嘗試，該 runName 會多次執行。attemptNumber 是以 0 為索引，每次執行新作業時都應遞增。舉例來說，如果測試細部重試 3 次，則在相同 runName 下應有 4 次執行作業，且 attemptNumber 為 0 到 3。
`startTime`	`long`：跑步開始時間，透過 `System.currentTimeMillis()` 測量

testRunStopped

public void testRunStopped (long elapsedTime)

由於使用者要求，報表測試執行作業在完成前停止。

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

參數
`elapsedTime`	`long`：裝置回報的經過時間 (以毫秒為單位)

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Called when a test is skipped and did not execute for a reason that is not usually expected. 系統會嘗試重試這些測試，以確保正常執行。

參數
`test`	`TestDescription`：識別測試
`reason`	`SkipReason`：`SkipReason`

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`：識別測試