シャードリスナー

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.オブジェクト
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)で関連付けることができます。 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)コールバックはできません。

void setSupportGranularResults (boolean enableGranularResults)
boolean supportGranularResults ()

レポーターが詳細な結果をサポートする場合は True を返し、そうでない場合は false を返します。

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) testRunEnded (long elapsedTime, runMetrics)

テスト実行の終了を報告します。

void testRunFailed ( FailureDescription failure)

FailureDescriptionで説明される障害のため、レポートのテスト実行が完了できませんでした。

void testRunFailed (String failureMessage)

レポートのテスト実行は、致命的なエラーのため完了できませんでした。

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

テスト実行の開始を報告します。

パブリックコンストラクター

シャードリスナー

public ShardListener (ITestInvocationListener main)

ShardListenerを作成します。

パラメーター
main ITestInvocationListener : 結果が転送されるITestInvocationListener 。他のShardListenerとの衝突を防ぐために、このオブジェクトは結果を転送するときにmainで同期します。また、結果は呼び出しシャードが完了した場合にのみ送信されます。

パブリックメソッド

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

戻り値

呼び出し終了

public void invocationEnded (long elapsedTime)

正常に終了したか、何らかのエラー条件により呼び出しが終了したことを報告します。

TradeFederation フレームワークによって自動的に呼び出されます。

パラメーター
elapsedTime long : 呼び出しの経過時間 (ミリ秒)

呼び出し失敗

public void invocationFailed (FailureDescription failure)

何らかのエラー状態が原因で不完全な呼び出しを報告します。

TradeFederation フレームワークによって自動的に呼び出されます。

パラメーター
failure FailureDescription : 失敗の原因を説明するFailureDescription

呼び出し失敗

public void invocationFailed (Throwable cause)

何らかのエラー状態が原因で不完全な呼び出しを報告します。

TradeFederation フレームワークによって自動的に呼び出されます。

パラメーター
cause Throwable : Throwableの失敗の原因

呼び出しがスキップされました

public void invocationSkipped (SkipReason reason)

呼び出しがスキップされたと報告します

パラメーター
reason SkipReason

呼び出し開始

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)で関連付けることができます。 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

サポート粒状の結果

public boolean supportGranularResults ()

レポーターが詳細な結果をサポートする場合は True を返し、そうでない場合は false を返します。

戻り値
boolean

テストログ

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 メソッドが完了するまで、データのソースが存在し、アクセス可能な状態にあることを確認する必要があります。

テストログが保存されました

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

パラメーター
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

テストモジュール終了

public void testModuleEnded ()

モジュールの実行の終了を報告します。

テストモジュールが開始されました

public void testModuleStarted (IInvocationContext moduleContext)

モジュールの実行の開始を報告します。このコールバックはtestModuleEnded()に関連付けられており、シーケンス内ではオプションです。これは、モジュール (スイート ベースのランナー) を使用する実行中にのみ使用されます。

パラメーター
moduleContext IInvocationContext : モジュールのIInvocationContext

テスト実行終了

public void testRunEnded (long elapsedTime, 
                 runMetrics)

テスト実行の終了を報告します。修正: タイプの異なる 2 つの Map<> インターフェイスを使用することはできないため、ここでは HashMap を使用する必要があります。

パラメーター
elapsedTime long : デバイスが報告した経過時間 (ミリ秒単位)

runMetrics : Metricを使用したテスト実行の終了時に報告されたキーと値のペア。

テスト実行失敗

public void testRunFailed (FailureDescription failure)

FailureDescriptionで説明される障害のため、レポートのテスト実行が完了できませんでした。

パラメーター
failure FailureDescription : 失敗とそのコンテキストを説明するFailureDescription

テスト実行失敗

public void testRunFailed (String failureMessage)

レポートのテスト実行は、致命的なエラーのため完了できませんでした。

パラメーター
failureMessage String : 実行失敗の理由を説明するString

テスト実行開始しました

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

テスト実行の開始を報告します。

パラメーター
name String : テスト実行名

numTests int : テスト実行のテストの総数

attemptNumber int : 順序番号。複数回実行される同じ runName の異なる試行を識別します。 attemptNumber は 0 から始まるインデックスであり、新しい実行が発生するたびに増加する必要があります。たとえば、テストは 3 回詳細に再試行され、同じ runName で合計 4 回の実行が必要で、attemptNumber は 0 ~ 3 です。

startTime long : System.currentTimeMillis()によって測定された実行の開始時刻