FileSystemLogSaver

public class FileSystemLogSaver
extends Object implements ILogSaver

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

ログをファイル システムに保存します。

概要

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

FileSystemLogSaver()

パブリック メソッド

LogFile getLogReportDir()

ログが保存されるディレクトリのパスまたは URL を含む LogFile を取得します。

void invocationEnded(long elapsedTime)

呼び出しが正常に終了したか、なんらかのエラー状態が原因で終了したかを報告します。

void invocationStarted(IInvocationContext context)

テスト呼び出しの開始を報告します。

また、ログを保存するための一意のファイル システム ディレクトリを report-dir/[branch/]build-id/test-tag/unique_dir の下に作成します。

LogFile saveLogData(String dataName, LogDataType dataType, InputStream dataStream)

ログデータを保存します。

LogDataType.isCompressed() が dataType に対して false を返して compressed-files が設定されている場合は、ログファイルを zip 形式で保存します。それ以外の場合は、ストリームは圧縮せずに保存されます。

LogFile saveLogFile(String dataName, LogDataType dataType, File fileToLog)

ログファイルを保存します。

void setCompressFiles(boolean compress)

保護されたメソッド

File generateLogReportDir(IBuildInfo buildInfo, File reportDir)

サブクラスが生成パス ロジックをカスタマイズできるように公開されたメソッド。

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

FileSystemLogSaver

public FileSystemLogSaver ()

パブリック メソッド

getLogReportDir

public LogFile getLogReportDir ()

ログが保存されるディレクトリのパスまたは URL を含む LogFile を取得します。

戻り値
LogFile LogFile。

invocationEnded

public void invocationEnded (long elapsedTime)

呼び出しが正常に終了したか、なんらかのエラー条件が原因で終了したかを報告します。

ITestInvocationListener.invocationEnded(long) が呼び出されると、TradeFederation フレームワークによって自動的に呼び出されます。

パラメータ
elapsedTime long: 呼び出しの所要時間（ミリ秒単位）

invocationStarted

public void invocationStarted (IInvocationContext context)

テスト呼び出しの開始を報告します。

ITestInvocationListener.invocationStarted(IInvocationContext) が呼び出される前に、TradeFederation フレームワークによって自動的に呼び出されます。

また、ログを保存するための一意のファイル システム ディレクトリを report-dir/[branch/]build-id/test-tag/unique_dir の下に作成します。ディレクトリの作成に失敗した場合は、ローカル ファイル システムの一時ディレクトリにログが書き込まれます。

パラメータ
context IInvocationContext: 呼び出しに関する情報。

saveLogData

public LogFile saveLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

ログデータを保存します。

ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) が呼び出されるたびに、TradeFederation フレームワークによって自動的に呼び出されます。追加のログデータを保存するヘルパー メソッドとして使用することもできます。

実装とポリシーによっては、ログが圧縮形式で保存される場合があります。ログは、Tradefed からアクセスできない場所に保存されることもあります。

LogDataType.isCompressed() が dataType に対して false を返して compressed-files が設定されている場合は、ログファイルを zip 形式で保存します。それ以外の場合は、ストリームは圧縮せずに保存されます。

パラメータ
dataName String: データのわかりやすい名前（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: データのわかりやすい名前（String）。例: device_logcat
dataType LogDataType: ファイルの LogDataType。
fileToLog File: 保存する ERROR(/File)。
戻り値
LogFile 保存したファイルのパスと URL を含む LogFile。

setCompressFiles

public void setCompressFiles (boolean compress)

パラメータ
compress boolean

保護されたメソッド

generateLogReportDir

protected File generateLogReportDir (IBuildInfo buildInfo, 
                File reportDir)

サブクラスが生成パス ロジックをカスタマイズできるようにする公開メソッド。

パラメータ
buildInfo IBuildInfo: IBuildInfo
reportDir File: レポート ディレクトリの ERROR(/File)。
戻り値
File 作成されたディレクトリ。