A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

LogRegistry

public class LogRegistry
extends Object implements ILogRegistry

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

Un'implementazione di ILogRegistry che esegue il multiplexing e gestisce diversi logger, utilizzando quello appropriato in base al ILogRegistry del thread che effettua la chiamata.ThreadGroup

Tieni presente che gli hash del registry si basano sul ThreadGroup a cui appartiene un thread. Se un thread viene generato con il proprio ThreadGroup specificato esplicitamente, non erediterà il logger del thread principale e, di conseguenza, dovrà registrare il proprio logger con LogRegistry se vuole registrare l'output.

Riepilogo

Metodi pubblici
`void`	`closeAndRemoveAllLogs()` Chiude e rimuove tutti i log gestiti da questo LogRegistry.
`void`	`dumpLogs()` Metodo di diagnostica per scaricare tutti i log in file.
`void`	`dumpLogsToDir(File dir)` Salva i dati dei log nei file della directory specificata.
`void`	`dumpToGlobalLog(ILeveledLogOutput log)` Esegue il dump dell'intero contenuto di un logger `ILeveledLogOutput` nel log globale.
`Log.LogLevel`	`getGlobalLogDisplayLevel()` Restituisce la visualizzazione del livello di log corrente per il log globale
`static ILogRegistry`	`getLogRegistry()` Recupera l'istanza `LogRegistry`
`ILeveledLogOutput`	`getLogger()` Recupera il logger sottostante associato a questo thread.
`void`	`logEvent(Log.LogLevel logLevel, ILogRegistry.EventType event, args)` Chiama questo metodo per registrare un evento di un tipo con le informazioni associate nella mappa.
`void`	`printAndPromptLog(Log.LogLevel logLevel, String tag, String message)` Viene inviato quando è necessario stampare un messaggio di log e, se possibile, mostrarlo all'utente in una finestra di dialogo.
`void`	`printLog(Log.LogLevel logLevel, String tag, String message)` Inviata quando è necessario stampare un messaggio di log.
`void`	`registerLogger(ILeveledLogOutput log)` Registra il logger come istanza da utilizzare per il thread corrente.
`static void`	`resetLocalGroup()` Reimposta il contesto localizzato.
`void`	`saveGlobalLog()` Salva tutti i contenuti dei logger globali in file TMP.
`void`	`setGlobalLogDisplayLevel(Log.LogLevel logLevel)` Impostare la visualizzazione del livello di log per il log globale
`static void`	`setLocalGroup(ThreadGroup tg)` Monitora un contesto localizzato quando utilizzi le proprietà all'interno del server gRPC
`void`	`unregisterLogger()` Annullamento della registrazione del logger corrente attivo per il thread corrente.

Metodi pubblici

closeAndRemoveAllLogs

public void closeAndRemoveAllLogs ()

Chiude e rimuove tutti i log gestiti da questo LogRegistry.

dumpLogs

public void dumpLogs ()

Metodo di diagnostica per scaricare tutti i log in file.

dumpLogsToDir

public void dumpLogsToDir (File dir)

Salva i dati dei log nei file della directory specificata.

Parametri
`dir`	`File`: directory in cui salvare il file, può essere nullo, il file verrà salvato nella directory tmp.

dumpToGlobalLog

public void dumpToGlobalLog (ILeveledLogOutput log)

Esegue il dump dell'intero contenuto di un logger ILeveledLogOutput nel log globale.

Questo è utile in scenari in cui sai che l'output del logger non verrà salvato definitivamente, ma vuoi che i contenuti vengano salvati da qualche parte e non persi.

getGlobalLogDisplayLevel

public Log.LogLevel getGlobalLogDisplayLevel ()

Restituisce la visualizzazione del livello di log corrente per il log globale

Ritorni
`Log.LogLevel`	logLevel il `LogLevel` da utilizzare

getLogRegistry

public static ILogRegistry getLogRegistry ()

Recupera l'istanza LogRegistry

Ritorni
`ILogRegistry`	un `LogRegistry` che può essere utilizzato per registrare, recuperare, scrivere e chiudere i log

getLogger

public ILeveledLogOutput getLogger ()

Recupera il logger sottostante associato a questo thread.

Ritorni
`ILeveledLogOutput`	il logger per questo gruppo di thread o il logger globale se non ne è stato registrato uno per il gruppo di thread.

logEvent

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

Chiama questo metodo per registrare un evento di un tipo con le informazioni associate nella mappa. L'ora dell'evento viene aggiunta automaticamente.

Parametri
`logLevel`	`Log.LogLevel`: il `LogLevel` da stampare.
`event`	`ILogRegistry.EventType`: il `ILogRegistry.EventType` dell'evento da registrare.
`args`	: la mappa degli argomenti da aggiungere alla voce del log per ottenere ulteriori dettagli sull'evento.

printAndPromptLog

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

Viene inviato quando è necessario stampare un messaggio di log e, se possibile, mostrarlo all'utente in una finestra di dialogo.

Parametri
`logLevel`	`Log.LogLevel`: l'enum `LogLevel` che rappresenta la priorità del messaggio.
`tag`	`String`: il tag associato al messaggio.
`message`	`String`: il messaggio da visualizzare.

printLog

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

Inviata quando è necessario stampare un messaggio di log.

Parametri
`logLevel`	`Log.LogLevel`: l'enum `LogLevel` che rappresenta la priorità del messaggio.
`tag`	`String`: il tag associato al messaggio.
`message`	`String`: il messaggio da visualizzare.

registerLogger

public void registerLogger (ILeveledLogOutput log)

Registra il logger come istanza da utilizzare per il thread corrente.

Parametri
`log`	`ILeveledLogOutput`

resetLocalGroup

public static void resetLocalGroup ()

Reimposta il contesto localizzato.

saveGlobalLog

public void saveGlobalLog ()

Salva tutti i contenuti dei logger globali in file TMP.

setGlobalLogDisplayLevel

public void setGlobalLogDisplayLevel (Log.LogLevel logLevel)

Impostare la visualizzazione del livello di log per il log globale

Parametri
`logLevel`	`Log.LogLevel`: il `LogLevel` da utilizzare

setLocalGroup

public static void setLocalGroup (ThreadGroup tg)

Monitora un contesto localizzato quando utilizzi le proprietà all'interno del server gRPC

Parametri
`tg`	`ThreadGroup`

unregisterLogger

public void unregisterLogger ()

Annullamento della registrazione del logger corrente attivo per il thread corrente.