為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

EventsLoggerListener

public class EventsLoggerListener
extends Object implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.EventsLoggerListener

這個監聽器會將收到的所有事件記錄到檔案中

摘要

公用建構函式
`EventsLoggerListener(String name)`

公用方法
`File`	`getLoggedEvents()`
`void`	`invocationEnded(long elapsedTime)` 回報是否因某種錯誤狀況而終止呼叫 (無論是否成功)。
`void`	`invocationFailed(FailureDescription failure)` Reports an incomplete invocation due to some error condition.
`void`	`invocationSkipped(SkipReason reason)` 回報已略過的叫用
`void`	`invocationStarted(IInvocationContext context)` Reports the start of the test invocation.
`void`	`logAssociation(String dataName, LogFile logFile)` 在某些情況下，記錄必須與測試案例密切相關，但無法在直接 `testLogSaved(String,LogDataType,InputStreamSource,LogFile)` 回呼中執行這項操作。
`void`	`testAssumptionFailure(TestDescription test, String trace)` 當原子測試標記假設為 false 的條件時，系統會呼叫這個函式
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` 當原子測試標記假設為 false 的條件時，系統會呼叫這個函式
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` `testEnded(TestDescription,Map)` 的替代方案，可直接指定結束時間。
`void`	`testFailed(TestDescription test, FailureDescription failure)` 回報個別測試案例的失敗情形。
`void`	`testFailed(TestDescription test, String trace)` 回報個別測試案例的失敗情形。
`void`	`testIgnored(TestDescription test)` 當測試不會執行時呼叫，通常是因為測試方法以 org.junit.Ignore 註解標註。
`void`	`testModuleEnded()` 回報模組執行作業的結束時間。
`void`	`testModuleStarted(IInvocationContext moduleContext)` 回報模組的執行開始時間。
`void`	`testRunEnded(long elapsedTimeMillis, HashMap<String, MetricMeasurement.Metric> runMetrics)` Reports end of test run.
`void`	`testRunFailed(FailureDescription failure)` 由於 `FailureDescription` 所述的錯誤，報表測試執行作業無法完成。
`void`	`testRunFailed(String errorMessage)` 發生嚴重錯誤，因此無法完成報表測試執行。
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` 回報測試執行的開始。
`void`	`testRunStarted(String runName, int testCount)` 回報測試執行的開始。
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` 回報測試執行的開始。
`void`	`testSkipped(TestDescription test, SkipReason reason)` Called when a test is skipped and did not execute for a reason that is not usually expected.
`void`	`testStarted(TestDescription test, long startTime)` `testStarted(TestDescription)` 的替代方案，我們也會指定測試開始時間，並搭配 `testEnded(TestDescription,long,Map)` 進行準確的評估。

公用建構函式

EventsLoggerListener

public EventsLoggerListener (String name)

參數
`name`	`String`

公用方法

getLoggedEvents

public File getLoggedEvents ()

傳回
`File`

invocationEnded

public void invocationEnded (long elapsedTime)

回報是否因某種錯誤情況而終止呼叫 (無論是否成功)。

TradeFederation 架構會自動呼叫。

參數
`elapsedTime`	`long`：以毫秒為單位的呼叫經過時間

invocationFailed

public void invocationFailed (FailureDescription failure)

由於發生某些錯誤情況，因此回報不完整的叫用。

TradeFederation 架構會自動呼叫。

參數
`failure`	`FailureDescription`：說明失敗原因的 `FailureDescription`

invocationSkipped

public void invocationSkipped (SkipReason reason)

將叫用回報為已略過

參數
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

回報測試呼叫的開始時間。

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

在某些情況下，記錄必須與測試案例密切相關，但無法在直接 testLogSaved(String,LogDataType,InputStreamSource,LogFile) 回呼中執行此操作。因此，這個回呼可明確提供強關聯。

參數
`dataName`	`String`：資料名稱
`logFile`	`LogFile`：先前記錄的 `LogFile`，應與測試案例建立關聯。

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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

testEnded(TestDescription,Map) 的替代方案，可直接指定結束時間。搭配 testStarted(TestDescription,long) 使用，可準確測量。

參數
`test`	`TestDescription`：識別測試
`endTime`	`long`：測試結束時間，透過 `System.currentTimeMillis()` 測量
`testMetrics`	`HashMap`：發出的指標 `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`：識別測試

testModuleEnded

public void testModuleEnded ()

回報模組執行作業的結束時間。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

回報模組的執行開始時間。這個回呼與 testModuleEnded() 相關聯，且在序列中為選用項目。只有在使用模組的執行期間，才會使用這個標記：以套件為基礎的執行器。

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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

測試執行結束時會回報。FIXME：我們無法使用不同型別的兩個 Map<> 介面，因此必須在此使用 HashMap。

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

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 的不同嘗試。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 的不同嘗試。attemptNumber 是以 0 為索引，每次執行新作業時都應遞增。舉例來說，如果測試精細重試 3 次，則在相同 runName 下應有 4 次執行，且 attemptNumber 為 0 到 3。
`startTime`	`long`：跑步開始時間，透過 `System.currentTimeMillis()` 測量

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(TestDescription) 的替代方案，我們也會指定測試開始時間，並搭配 testEnded(TestDescription,long,Map) 進行準確的評估。

參數
`test`	`TestDescription`：識別測試
`startTime`	`long`：測試開始時間，透過 `System.currentTimeMillis()` 測量