LogRegistry

public class LogRegistry
extends Object implements ILogRegistry

java.lang.Object
↳	com.android.tradefed.log.LogRegistry

---

ILogRegistry 实现，用于多路复用和管理不同的记录器，并根据发出调用的线程的 ThreadGroup 使用适当的记录器。

请注意，注册表哈希基于线程所属的 ThreadGroup。如果线程是使用其自身显式提供的 ThreadGroup 分派的，则不会继承父线程的记录器，因此如果它想记录输出，则需要向 LogRegistry 注册自己的记录器。

摘要

公共方法
void	closeAndRemoveAllLogs() 关闭并移除此 LogRegistry 管理的所有日志。
void	dumpLogs() 用于将所有日志转储到文件的诊断方法。
void	dumpLogsToDir(File dir) 将日志数据保存到指定目录中的文件。
void	dumpToGlobalLog(ILeveledLogOutput log) 将 ILeveledLogOutput 日志记录器的全部内容转储到全局日志。
Log.LogLevel	getGlobalLogDisplayLevel() 返回全局日志的当前日志级别显示
static ILogRegistry	getLogRegistry() 获取 LogRegistry 实例
ILeveledLogOutput	getLogger() 获取与此线程关联的基础日志记录器。
void	logEvent(Log.LogLevel logLevel, ILogRegistry.EventType event, args) 调用此方法可在 Map 中记录具有关联信息的类型的事件。
void	printAndPromptLog(Log.LogLevel logLevel, String tag, String message) 当需要输出日志消息并尽可能在对话框中向用户显示该消息时发送。
void	printLog(Log.LogLevel logLevel, String tag, String message) 在需要输出日志消息时发送。
void	registerLogger(ILeveledLogOutput log) 将日志记录器注册为要为当前线程使用的实例。
static void	resetLocalGroup() 重置本地化内容。
void	saveGlobalLog() 将所有全局日志记录器内容保存到 tmp 文件中。
void	setGlobalLogDisplayLevel(Log.LogLevel logLevel) 设置全局日志的日志级别显示
static void	setLocalGroup(ThreadGroup tg) 跟踪使用 gRPC 服务器内属性时的本地化上下文
void	unregisterLogger() 取消注册当前线程有效的当前日志记录器。

公共方法

closeAndRemoveAllLogs

public void closeAndRemoveAllLogs ()

关闭并移除由此 LogRegistry 管理的所有日志。

dumpLogs

public void dumpLogs ()

用于将所有日志转储到文件的诊断方法。

dumpLogsToDir

public void dumpLogsToDir (File dir)

将日志数据保存到指定目录中的文件。

参数
dir	File：用于保存文件的目录，可以为 null，文件将保存在 tmp 目录中。

dumpToGlobalLog

public void dumpToGlobalLog (ILeveledLogOutput log)

将 ILeveledLogOutput 日志记录器的全部内容转储到全局日志。

如果您知道日志记录器的输出不会永久保存，但希望内容保存在某个位置且不会丢失，则此方法非常有用。

getGlobalLogDisplayLevel

public Log.LogLevel getGlobalLogDisplayLevel ()

返回全局日志的当前日志级别显示

返回
Log.LogLevel	logLevel 要使用的 LogLevel

getLogRegistry

public static ILogRegistry getLogRegistry ()

获取 LogRegistry 实例

返回
ILogRegistry	一个 LogRegistry，可用于注册、获取、写入和关闭日志

getLogger

public ILeveledLogOutput getLogger ()

获取与此线程关联的基础日志记录器。

返回
ILeveledLogOutput	此线程组的记录器，如果未为线程组注册记录器，则为全局记录器。

logEvent

public void logEvent (Log.LogLevel logLevel, 
                ILogRegistry.EventType event, 
                 args)

调用此方法可在 Map 中记录具有关联信息的类型的事件。系统会自动添加活动时间。

参数
logLevel	Log.LogLevel：要输出的 LogLevel。
event	ILogRegistry.EventType：要记录的事件的 ILogRegistry.EventType。
args	：要添加到日志条目中以获取有关事件的更多详细信息的参数映射。

printAndPromptLog

public void printAndPromptLog (Log.LogLevel logLevel, 
                String tag, 
                String message)

当需要输出日志消息并尽可能在对话框中向用户显示该消息时发送。

参数
logLevel	Log.LogLevel：表示消息优先级的 LogLevel 枚举。
tag	String：与消息关联的标记。
message	String：要显示的消息。

printLog

public void printLog (Log.LogLevel logLevel, 
                String tag, 
                String message)

在需要输出日志消息时发送。

参数
logLevel	Log.LogLevel：表示消息优先级的 LogLevel 枚举。
tag	String：与消息关联的标记。
message	String：要显示的消息。

registerLogger

public void registerLogger (ILeveledLogOutput log)

将日志记录器注册为要为当前线程使用的实例。

参数
log	ILeveledLogOutput

resetLocalGroup

public static void resetLocalGroup ()

重置本地化上下文。

saveGlobalLog

public void saveGlobalLog ()

将所有全局记录器内容保存到 tmp 文件。

setGlobalLogDisplayLevel

public void setGlobalLogDisplayLevel (Log.LogLevel logLevel)

设置全局日志的日志级别显示

参数
logLevel	Log.LogLevel：要使用的 LogLevel

setLocalGroup

public static void setLocalGroup (ThreadGroup tg)

跟踪在 gRPC 服务器内使用属性时本地化的上下文

参数
tg	ThreadGroup

unregisterLogger

public void unregisterLogger ()

取消注册当前线程有效的日志记录器。