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() Saves all the global loggers contents to tmp files.
void	setGlobalLogDisplayLevel(Log.LogLevel logLevel) 設定全域記錄的記錄層級顯示方式
static void	setLocalGroup(ThreadGroup tg) 使用 gRPC 伺服器內的屬性時，追蹤本地化環境。
void	unregisterLogger() Unregisters the current logger in effect for the current thread.

公用方法

closeAndRemoveAllLogs

public void closeAndRemoveAllLogs ()

關閉並移除這個 LogRegistry 管理的所有記錄。

dumpLogs

public void dumpLogs ()

診斷方法，可將所有記錄傾印至檔案。

dumpLogsToDir

public void dumpLogsToDir (File dir)

將記錄資料儲存至指定目錄中的檔案。

參數
dir	File：儲存檔案的目錄，可為空值，檔案會儲存在 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, 
                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 ()

將所有全域記錄器內容儲存至 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 ()

取消註冊目前執行緒的現行記錄器。