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)

呼叫這個方法，即可將地圖中某類型事件的相關資訊記錄下來。

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

呼叫這個方法，即可記錄地圖中某類型事件的相關資訊。系統會自動新增活動時間。

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

為目前執行緒註銷目前有效的記錄器。