LogSaverResultForwarder(日志保存结果转发器)

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object 中
   ↳ com.android.tradefed.result.ResultForwarder
     ↳ com.android.tradefed.result.LogSaverResultForwarder


ResultForwarder,用于通过全局文件保存程序保存日志。

摘要

公共构造函数

LogSaverResultForwarder(ILogSaver logSaver, listeners, IConfiguration config)

公共方法

void invocationEnded(long elapsedTime)

报告调用已终止(无论是成功终止还是由于某些错误) 条件。

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) 回调。

static void logFile( listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type)

在完成前记录最终文件

static void reportEndHostLog( listeners, ILogSaver saver, String name)

报告正在进行的会话的 host_log。

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

提供来自测试调用的关联日志或调试数据。

此外,使用全局 ILogSaver 保存日志文件并调用 ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile) 实现 ILogSaverListener 接口的监听器。

void testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)

仅转发 testLog,而不是先保存日志。

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

在保存测试日志时调用。

如果 LogSaverResultForwarder 封装在另一个函数中,请确保转发 testLogSaved 回调传递给其下方的监听器。

公共构造函数

LogSaverResultForwarder(日志保存结果转发器)

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners, 
                IConfiguration config)

参数
logSaver ILogSaver

listeners

config IConfiguration

公共方法

invocationEnded

public void invocationEnded (long elapsedTime)

报告调用已终止(无论是成功终止还是由于某些错误) 条件。

将由 TradeFederation 框架自动调用。

参数
elapsedTime long:调用所用的时间(以毫秒为单位)

invocationStarted

public void invocationStarted (IInvocationContext context)

报告测试调用的开始。

将由 TradeFederation 框架自动调用。报告者需要覆盖 此方法支持多设备报告。

参数
context IInvocationContext:调用的相关信息

logAssociation

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 LogFileLogFile 之前记录,应与 测试用例。

日志文件

public static void logFile ( listeners, 
                ILogSaver saver, 
                InputStreamSource source, 
                String name, 
                LogDataType type)

在完成前记录最终文件

参数
listeners

saver ILogSaver

source InputStreamSource

name String

type LogDataType

reportEndHostLog

public static void reportEndHostLog ( listeners, 
                ILogSaver saver, 
                String name)

报告正在进行的会话的 host_log。

参数
listeners

saver ILogSaver

name String

testLog

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

提供来自测试调用的关联日志或调试数据。

必须在 ERROR(/ITestInvocationListener#invocationFailed(Throwable)) 或之前调用 ERROR(/ITestInvocationListener#invocationEnded(long))

TradeFederation 框架将自动调用此方法,并提供主机日志 以及设备 logcat(如果适用)。

此外,使用全局 ILogSaver 保存日志文件并调用 ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile) 实现 ILogSaverListener 接口的监听器。

参数
dataName String:数据的 String 描述性名称。例如“device_logcat”。注意事项 每次调用的 dataName 可能不唯一。例如,实施人员必须能够处理 具有相同 dataName 的多个调用

dataType LogDataType:数据的 LogDataType

dataStream InputStreamSource:数据的 InputStreamSource。实现人员应调用 createInputStream 以开始读取数据,并确保关闭生成的 InputStream。调用方应确保数据源始终保持不变 存在且可访问,直到 testLog 方法完成为止。

testLogForward

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

仅转发 testLog,而不是先保存日志。

参数
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

在保存测试日志时调用。

应用于替代 ITestInvocationListener#testLog(String, LogDataType, InputStreamSource)

如果 LogSaverResultForwarder 封装在另一个函数中,请确保转发 testLogSaved 回调传递给其下方的监听器。

参数
dataName String:数据的 String 描述性名称。例如“device_logcat”。注意事项 每次调用的 dataName 可能不唯一。例如,实施人员必须能够处理 具有相同 dataName 的多个调用

dataType LogDataType:数据的 LogDataType

dataStream InputStreamSource:数据的 InputStreamSource。实现人员应调用 createInputStream 以开始读取数据,并确保关闭生成的 InputStream。

logFile LogFile:包含已保存文件的元数据的 LogFile