A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 ThreadGroup del thread che effettua la chiamata.

Tieni presente gli hash del registro di sistema nel ThreadGroup a cui appartiene un thread. Se un thread viene generato con il proprio ThreadGroup fornito in modo esplicito, non erediterà il logger del thread padre e quindi 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 nei file.
`void`	`dumpLogsToDir(File dir)` Salva i dati dei log nei file della directory specificata.
`void`	`dumpToGlobalLog(ILeveledLogOutput log)` Scarica l'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, Map<String, String> args)` Chiama questo metodo per registrare un evento da un tipo con le informazioni associate nella mappa.
`void`	`printAndPromptLog(Log.LogLevel logLevel, String tag, String message)` Inviato quando è necessario stampare un messaggio di log e, se possibile, visualizzarlo all'utente in una finestra di dialogo.
`void`	`printLog(Log.LogLevel logLevel, String tag, String message)` Inviato 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 temporanei.
`void`	`setGlobalLogDisplayLevel(Log.LogLevel logLevel)` Imposta il livello di log visualizzato per il log globale
`static void`	`setLocalGroup(ThreadGroup tg)` Traccia un contesto localizzato quando utilizzi le proprietà all'interno del server gRPC
`void`	`unregisterLogger()` Annulla la registrazione del logger corrente in vigore 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 nei 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 null, il file verrà salvato nella directory tmp.

dumpToGlobalLog

public void dumpToGlobalLog (ILeveledLogOutput log)

Scarica l'intero contenuto di un logger ILeveledLogOutput nel log globale.

Ciò è utile in scenari in cui sai che l'output del logger non verrà salvato in modo permanente, 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

Resi
`Log.LogLevel`	logLevel the `LogLevel` to use

getLogRegistry

public static ILogRegistry getLogRegistry ()

Recupera l'istanza LogRegistry

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

getLogger

public ILeveledLogOutput getLogger ()

Recupera il logger sottostante associato a questo thread.

Resi
`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, 
                Map<String, String> args)

Chiama questo metodo per registrare un evento da 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`	`Map`: la mappa degli argomenti da aggiungere alla voce di log per ottenere maggiori dettagli sull'evento.

printAndPromptLog

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

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

Parametri
`logLevel`	`Log.LogLevel`: l'enumerazione `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)

Inviato quando è necessario stampare un messaggio di log.

Parametri
`logLevel`	`Log.LogLevel`: l'enumerazione `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 temporanei.

setGlobalLogDisplayLevel

public void setGlobalLogDisplayLevel (Log.LogLevel logLevel)

Imposta il livello di log visualizzato per il log globale

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

setLocalGroup

public static void setLocalGroup (ThreadGroup tg)

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

Parametri
`tg`	`ThreadGroup`

unregisterLogger

public void unregisterLogger ()

Annulla la registrazione del logger corrente in vigore per il thread corrente.