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, Map<String, String> args) 调用此方法可记录类型中的事件，并在映射中包含关联的信息。
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() 将所有全局记录器的内容保存到临时文件。
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，文件将保存在临时目录中。

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, 
                Map<String, String> args)

调用此方法可记录类型中的事件，并在映射中包含关联的信息。系统会自动添加事件时间 。

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

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 ()

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

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 ()

取消注册当前线程中生效的当前记录器。