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

ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.invoker.ShardListener

ITestInvocationListener 會從叫用資料分割收集結果 (又稱為叫用分割，以平行在多個資源中執行)，並將結果轉送至其他事件監聽器。

摘要

公用建構函式
`ShardListener(ITestInvocationListener main)` 建立 `ShardListener`。

公用方法
	`getUnderlyingResultReporter()`
`void`	`invocationEnded(long elapsedTime)` 回報叫用已終止，無論是否成功或因某些錯誤條件而終止。
`void`	`invocationFailed(FailureDescription failure)` 由於某些錯誤情況，因此回報未完成的叫用作業。
`void`	`invocationFailed(Throwable cause)` 由於某些錯誤情況，因此回報未完成的叫用作業。
`void`	`invocationSkipped(SkipReason reason)` 將叫用動作回報為略過
`void`	`invocationStarted(IInvocationContext context)` 回報測試叫用作業的開始時間。
`void`	`logAssociation(String dataName, LogFile logFile)` 在某些情況下，記錄必須與測試案例密切相關，但可能無法使用直接 `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` 回呼執行這項操作。
`void`	`setSupportGranularResults(boolean enableGranularResults)`
`boolean`	`supportGranularResults()` 如果報表提供詳細結果，則傳回「是」；否則傳回「否」。
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` 提供測試叫用作業的相關記錄或偵錯資料。
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testModuleEnded()` 回報模組執行作業結束。
`void`	`testModuleStarted(IInvocationContext moduleContext)` 回報執行模組的開始。
`void`	`testRunEnded(long elapsedTime, runMetrics)` 測試執行結束報表。
`void`	`testRunFailed(FailureDescription failure)` 由於 `FailureDescription` 所述的錯誤，無法完成報表測試執行作業。
`void`	`testRunFailed(String failureMessage)` 由於發生致命錯誤，報表測試執行作業無法完成。
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` 回報測試執行作業的開始時間。

公用建構函式

ShardListener

public ShardListener (ITestInvocationListener main)

建立 ShardListener。

參數
`main`	`ITestInvocationListener`：應轉送結果的 `ITestInvocationListener`。為避免與其他 `ShardListener` 發生衝突，此物件會在轉寄結果時在 `main` 上同步處理。只有在呼叫區塊完成後，系統才會傳送結果。

公用方法

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

傳回

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` 原因

invocationSkipped

public void invocationSkipped (SkipReason reason)

將叫用動作回報為略過

參數
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

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

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

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

記錄檔關聯

public void logAssociation (String dataName, 
                LogFile logFile)

在某些情況下，記錄必須與測試案例建立強連結，但無法在直接 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 回呼上執行此操作。因此，這個回呼可明確提供強連結。

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

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

參數
`enableGranularResults`	`boolean`

支援 GranularResults

public boolean supportGranularResults ()

如果回報程式支援精細結果，會傳回 True，否則傳回 false。

傳回
`boolean`

testLog

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

提供測試叫用作業的相關記錄或偵錯資料。

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

TradeFederation 架構會自動呼叫這個方法，提供主機記錄，並在適用情況下提供裝置 Logcat。

參數
`dataName`	`String`：資料的 `String` 描述性名稱，例如「device_logcat」。請注意，每次叫用的 dataName 可能相同。也就是說，實作者必須能用相同 dataName 處理多次呼叫
`dataType`	`LogDataType`：資料的 `LogDataType`
`dataStream`	`InputStreamSource`：資料的 `InputStreamSource`。實作者應呼叫 createInputStream 開始讀取資料，並確保在完成時關閉產生的 InputStream。呼叫端應確保資料來源在 testLog 方法完成前仍存在且可供存取。

testLogSaved

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

參數
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testModuleEnded

public void testModuleEnded ()

回報模組執行作業結束。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

回報測試執行結束。

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

testRunFailed

public void testRunFailed (FailureDescription failure)

由於 FailureDescription 所述的錯誤，導致報表測試執行作業無法完成。

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

testRunFailed

public void testRunFailed (String failureMessage)

發生嚴重錯誤，因此無法完成報表測試。

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

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

參數
`name`	`String`：測試執行作業名稱
`numTests`	`int`：測試執行作業中的測試總數
`attemptNumber`	`int`：訂單號碼，用於識別同一個 runName 執行多次的不同嘗試。attemptNumber 的索引為 0，每次執行新測試時，應增加 1。舉例來說，如果測試重試 3 次，則在相同的 runName 下，應有 4 次總執行次數，而 attemptNumber 則從 0 到 3。
`startTime`	`long`：透過 `System.currentTimeMillis()` 測量的執行作業開始時間