Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

LogRegistry

public class LogRegistry
extends Object implements ILogRegistry

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

Eine ILogRegistry-Implementierung, die verschiedene Logger multiplexiert und verwaltet und den jeweils passenden Logger basierend auf dem ThreadGroup des Threads verwendet, der den Aufruf ausführt.

Die Registry-Hashes werden in der ThreadGroup registriert, zu der ein Thread gehört. Wenn ein Thread mit einer eigenen explizit angegebenen ThreadGroup erstellt wird, erbt er nicht den Logger des übergeordneten Threads. Er muss also seinen eigenen Logger bei der LogRegistry registrieren, wenn er Ausgaben protokollieren möchte.

Zusammenfassung

Öffentliche Methoden
`void`	`closeAndRemoveAllLogs()` Schließt und entfernt alle Logs, die von dieser LogRegistry verwaltet werden.
`void`	`dumpLogs()` Diagnosemethode zum Speichern aller Logs in Dateien.
`void`	`dumpLogsToDir(File dir)` Speichern Sie die Logdaten in Dateien im angegebenen Verzeichnis.
`void`	`dumpToGlobalLog(ILeveledLogOutput log)` Gibt den gesamten Inhalt eines `ILeveledLogOutput`-Loggers in das globale Log aus.
`Log.LogLevel`	`getGlobalLogDisplayLevel()` Gibt die aktuelle Anzeige der Protokollebene für das globale Protokoll zurück.
`static ILogRegistry`	`getLogRegistry()` `LogRegistry`-Instanz abrufen
`ILeveledLogOutput`	`getLogger()` Ruft den zugrunde liegenden Logger ab, der diesem Thread zugeordnet ist.
`void`	`logEvent(Log.LogLevel logLevel, ILogRegistry.EventType event, Map<String, String> args)` Rufen Sie diese Methode auf, um ein Ereignis eines Typs mit den zugehörigen Informationen in der Karte zu protokollieren.
`void`	`printAndPromptLog(Log.LogLevel logLevel, String tag, String message)` Wird gesendet, wenn ein Logeintrag ausgegeben und dem Nutzer nach Möglichkeit in einem Dialogfeld angezeigt werden muss.
`void`	`printLog(Log.LogLevel logLevel, String tag, String message)` Wird gesendet, wenn ein Logeintrag ausgegeben werden muss.
`void`	`registerLogger(ILeveledLogOutput log)` Registriert den Logger als die Instanz, die für den aktuellen Thread verwendet werden soll.
`static void`	`resetLocalGroup()` Setzt den lokalisierten Kontext zurück.
`void`	`saveGlobalLog()` Speichert alle Inhalte der globalen Logger in temporären Dateien.
`void`	`setGlobalLogDisplayLevel(Log.LogLevel logLevel)` Logebene für das globale Log festlegen
`static void`	`setLocalGroup(ThreadGroup tg)` Verfolgt einen lokalisierten Kontext bei Verwendung der Eigenschaften im gRPC-Server.
`void`	`unregisterLogger()` Hebt die Registrierung des aktuellen Loggers für den aktuellen Thread auf.

Öffentliche Methoden

closeAndRemoveAllLogs

public void closeAndRemoveAllLogs ()

Schließt und entfernt alle Logs, die von dieser LogRegistry verwaltet werden.

dumpLogs

public void dumpLogs ()

Diagnosemethode zum Speichern aller Logs in Dateien.

dumpLogsToDir

public void dumpLogsToDir (File dir)

Speichern Sie die Logdaten in Dateien im angegebenen Verzeichnis.

Parameter
`dir`	`File`: Verzeichnis zum Speichern der Datei. Kann null sein. Die Datei wird dann im temporären Verzeichnis gespeichert.

dumpToGlobalLog

public void dumpToGlobalLog (ILeveledLogOutput log)

Gibt den gesamten Inhalt eines ILeveledLogOutput-Loggers in das globale Log aus.

Das ist in Szenarien nützlich, in denen Sie wissen, dass die Ausgabe des Loggers nicht dauerhaft gespeichert wird, Sie aber möchten, dass die Inhalte irgendwo gespeichert werden und nicht verloren gehen.

getGlobalLogDisplayLevel

public Log.LogLevel getGlobalLogDisplayLevel ()

Gibt die aktuelle Anzeige der Protokollebene für das globale Protokoll zurück.

Gibt Folgendes zurück:
`Log.LogLevel`	logLevel: der zu verwendende `LogLevel`

getLogRegistry

public static ILogRegistry getLogRegistry ()

LogRegistry-Instanz abrufen

Gibt Folgendes zurück:
`ILogRegistry`	ein `LogRegistry`, mit dem Logs registriert, abgerufen, geschrieben und geschlossen werden können

getLogger

public ILeveledLogOutput getLogger ()

Ruft den zugrunde liegenden Logger ab, der diesem Thread zugeordnet ist.

Gibt Folgendes zurück:
`ILeveledLogOutput`	Der Logger für diese Threadgruppe oder der globale Logger, falls keiner für die Threadgruppe registriert wurde.

logEvent

public void logEvent (Log.LogLevel logLevel, 
                ILogRegistry.EventType event, 
                Map<String, String> args)

Rufen Sie diese Methode auf, um ein Ereignis eines Typs mit den zugehörigen Informationen in der Karte zu protokollieren. Die Uhrzeit des Termins wird automatisch hinzugefügt.

Parameter
`logLevel`	`Log.LogLevel`: Die zu druckende `LogLevel`.
`event`	`ILogRegistry.EventType`: die `ILogRegistry.EventType` des zu protokollierenden Ereignisses.
`args`	`Map`: Die Zuordnung von Argumenten, die dem Logeintrag hinzugefügt werden sollen, um weitere Details zum Ereignis zu erhalten.

printAndPromptLog

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

Wird gesendet, wenn ein Logeintrag ausgegeben und dem Nutzer nach Möglichkeit in einem Dialogfeld angezeigt werden muss.

Parameter
`logLevel`	`Log.LogLevel`: Die `LogLevel`-Aufzählung, die die Priorität der Nachricht darstellt.
`tag`	`String`: Das Tag, das der Nachricht zugeordnet ist.
`message`	`String`: Die anzuzeigende Meldung.

printLog

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

Wird gesendet, wenn ein Logeintrag ausgegeben werden muss.

Parameter
`logLevel`	`Log.LogLevel`: Die `LogLevel`-Aufzählung, die die Priorität der Nachricht darstellt.
`tag`	`String`: Das Tag, das der Nachricht zugeordnet ist.
`message`	`String`: Die anzuzeigende Meldung.

registerLogger

public void registerLogger (ILeveledLogOutput log)

Registriert den Logger als die Instanz, die für den aktuellen Thread verwendet werden soll.

Parameter
`log`	`ILeveledLogOutput`

resetLocalGroup

public static void resetLocalGroup ()

Setzt den lokalisierten Kontext zurück.

saveGlobalLog

public void saveGlobalLog ()

Speichert alle Inhalte der globalen Logger in temporären Dateien.

setGlobalLogDisplayLevel

public void setGlobalLogDisplayLevel (Log.LogLevel logLevel)

Logebene für das globale Log festlegen

Parameter
`logLevel`	`Log.LogLevel`: die zu verwendende `LogLevel`

setLocalGroup

public static void setLocalGroup (ThreadGroup tg)

Verfolgt einen lokalisierten Kontext bei Verwendung der Eigenschaften im gRPC-Server.

Parameter
`tg`	`ThreadGroup`

unregisterLogger

public void unregisterLogger ()

Hebt die Registrierung des aktuellen Loggers für den aktuellen Thread auf.