ILogSaver
public interface ILogSaver
com.android.tradefed.result.ILogSaver |
このインターフェイスを実装するクラスは、ログを中央の場所に保存するためのメソッドを提供します。
ILogSaver
は構成で宣言され、ログを中央の場所に保存する役割を果たします。 ILogSaverListener
が追加のファイルを同じ場所に保存できるように、メソッドも公開します。
まとめ
公開メソッド | |
---|---|
abstract LogFile | getLogReportDir () ログが保存されるディレクトリのパスや URL を含む |
abstract void | invocationEnded (long elapsedTime) 呼び出しが正常に終了したか、何らかのエラー状態により終了したことを報告します。 |
abstract void | invocationStarted ( IInvocationContext context) テスト呼び出しの開始を報告します。 |
abstract LogFile | saveLogData (String dataName, LogDataType dataType, InputStream dataStream) ログデータを保存します。 |
default LogFile | saveLogDataRaw (String dataName, LogDataType dataType, InputStream dataStream) このメソッドは非推奨です。代わりに |
default LogFile | saveLogFile (String dataName, LogDataType dataType, File fileToLog) ログ ファイルを保存します。 |
公開メソッド
getLogReportDir
public abstract LogFile getLogReportDir ()
ログが保存されるディレクトリのパスや URL を含むLogFile
を取得します。
戻り値 | |
---|---|
LogFile | LogFile 。 |
呼び出し終了
public abstract void invocationEnded (long elapsedTime)
呼び出しが正常に終了したか、何らかのエラー状態により終了したことを報告します。
ITestInvocationListener#invocationEnded(long)
が呼び出された後、TradeFederation フレームワークによって自動的に呼び出されます。
パラメーター | |
---|---|
elapsedTime | long : 呼び出しの経過時間 (ミリ秒) |
呼び出し開始
public abstract void invocationStarted (IInvocationContext context)
テスト呼び出しの開始を報告します。
ITestInvocationListener#invocationStarted(IInvocationContext)
呼び出される前に、TradeFederation フレームワークによって自動的に呼び出されます。
パラメーター | |
---|---|
context | IInvocationContext : 呼び出しに関する情報。 |
saveLogData
public abstract LogFile saveLogData (String dataName, LogDataType dataType, InputStream dataStream)
ログデータを保存します。
ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource)
呼び出されるたびに、TradeFederation フレームワークによって自動的に呼び出されます。また、追加のログ データを保存するためのヘルパー メソッドとして使用することもできます。
実装とポリシーによっては、ログが圧縮形式で保存される場合があります。ログは、Tradefed がアクセスできない場所に保存される場合もあります。
パラメーター | |
---|---|
dataName | String : データのERROR(/String) 記述名。例: "device_logcat" |
dataType | LogDataType : ファイルのLogDataType 。 |
dataStream | InputStream : データのERROR(/InputStream) 。 |
戻り値 | |
---|---|
LogFile | 保存されたファイルのパスと URL を含むLogFile 。 |
スロー | |
---|---|
| ログファイルを生成できなかった場合 |
saveLogDataRaw
public LogFile saveLogDataRaw (String dataName, LogDataType dataType, InputStream dataStream)
このメソッドは非推奨です。
代わりにsaveLogData(String, com.android.tradefed.result.LogDataType, InputStream)
を使用してください
ログ データを変更せずに保存するためのヘルパー メソッド。
ログは、Tradefed がアクセスできない場所に保存される場合があります。
パラメーター | |
---|---|
dataName | String : データのERROR(/String) 記述名。例: "device_logcat"。 |
dataType | LogDataType : ファイルのタイプと拡張子を含むLogDataType |
dataStream | InputStream : データのERROR(/InputStream) 。 |
戻り値 | |
---|---|
LogFile | 保存されたファイルのパスと URL を含むLogFile 。 |
スロー | |
---|---|
| ログファイルを生成できなかった場合 |
saveLogFile
public LogFile saveLogFile (String dataName, LogDataType dataType, File fileToLog)
ログ ファイルを保存します。
ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource)
呼び出され、ストリームがファイルを参照するたびに、TradeFederation フレームワークによって自動的に呼び出されます。
実装とポリシーによっては、ログが圧縮形式で保存される場合があります。ログは、Tradefed がアクセスできない場所に保存される場合もあります。
パラメーター | |
---|---|
dataName | String : データのERROR(/String) 記述名。例: "device_logcat" |
dataType | LogDataType : ファイルのLogDataType 。 |
fileToLog | File : 保存するERROR(/File) 。 |
戻り値 | |
---|---|
LogFile | 保存されたファイルのパスと URL を含むLogFile 。 |
スロー | |
---|---|
| ログファイルを生成できなかった場合 |