自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

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)` 将日志记录器注册为要为当前线程使用的实例。
`void`	`saveGlobalLog()` 将所有全局记录器内容保存到 tmp 文件中。
`void`	`setGlobalLogDisplayLevel(Log.LogLevel logLevel)` 设置全局日志的日志级别显示
`void`	`unregisterLogger()` 取消注册当前线程有效的当前日志记录器。

public void closeAndRemoveAllLogs ()

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

public void dumpLogs ()

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

public void dumpLogsToDir (File dir)

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

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

public void dumpToGlobalLog (ILeveledLogOutput log)

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

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

public Log.LogLevel getGlobalLogDisplayLevel ()

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

返回
`Log.LogLevel`	logLevel 要使用的 `LogLevel`

public static ILogRegistry getLogRegistry ()

获取 LogRegistry 实例

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

public ILeveledLogOutput getLogger ()

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

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

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

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

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

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

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

public void registerLogger (ILeveledLogOutput log)

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

参数
`log`	`ILeveledLogOutput`

public void saveGlobalLog ()

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

public void setGlobalLogDisplayLevel (Log.LogLevel logLevel)

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

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

public void unregisterLogger ()

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