À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

LogRegistry

public class LogRegistry
extends Object implements ILogRegistry

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

Implémentation de ILogRegistry qui multiplexe et gère différents enregistreurs, en utilisant celui qui convient en fonction du ThreadGroup du thread effectuant l'appel.

Notez que le Registre génère des hachages sur le ThreadGroup auquel un thread appartient. Si un thread est créé avec son propre ThreadGroup fourni explicitement, il n'héritera pas du journal du thread parent et devra donc enregistrer son propre journal auprès de LogRegistry s'il souhaite consigner la sortie.

Résumé

Méthodes publiques
`void`	`closeAndRemoveAllLogs()` Ferme et supprime tous les journaux gérés par ce LogRegistry.
`void`	`dumpLogs()` Méthode de diagnostic permettant d'extraire tous les journaux dans des fichiers.
`void`	`dumpLogsToDir(File dir)` Enregistrez les données de journal dans des fichiers du répertoire spécifié.
`void`	`dumpToGlobalLog(ILeveledLogOutput log)` Vide l'intégralité du contenu d'un enregistreur `ILeveledLogOutput` dans le journal global.
`Log.LogLevel`	`getGlobalLogDisplayLevel()` Affiche le niveau de journalisation actuel pour le journal global.
`static ILogRegistry`	`getLogRegistry()` Obtenir l'instance `LogRegistry`
`ILeveledLogOutput`	`getLogger()` Récupère le journal sous-jacent associé à ce thread.
`void`	`logEvent(Log.LogLevel logLevel, ILogRegistry.EventType event, args)` Appelez cette méthode pour consigner un événement d'un type avec les informations associées dans la carte.
`void`	`printAndPromptLog(Log.LogLevel logLevel, String tag, String message)` Envoyée lorsqu'un message de journal doit être imprimé et, si possible, présenté à l'utilisateur dans une boîte de dialogue.
`void`	`printLog(Log.LogLevel logLevel, String tag, String message)` Envoyée lorsqu'un message de journal doit être imprimé.
`void`	`registerLogger(ILeveledLogOutput log)` Enregistre le journalisateur en tant qu'instance à utiliser pour le thread actuel.
`static void`	`resetLocalGroup()` Réinitialise le contexte localisé.
`void`	`saveGlobalLog()` Enregistre tout le contenu des enregistreurs globaux dans des fichiers temporaires.
`void`	`setGlobalLogDisplayLevel(Log.LogLevel logLevel)` Définir l'affichage du niveau de journalisation pour le journal global
`static void`	`setLocalGroup(ThreadGroup tg)` Suit un contexte localisé lors de l'utilisation des propriétés dans le serveur gRPC
`void`	`unregisterLogger()` Désinscrit le journal actuellement en vigueur pour le thread actuel.

Méthodes publiques

closeAndRemoveAllLogs

public void closeAndRemoveAllLogs ()

Ferme et supprime tous les journaux gérés par ce LogRegistry.

dumpLogs

public void dumpLogs ()

Méthode de diagnostic permettant d'extraire tous les journaux dans des fichiers.

dumpLogsToDir

public void dumpLogsToDir (File dir)

Enregistrez les données de journal dans des fichiers du répertoire spécifié.

Paramètres
`dir`	`File`: répertoire dans lequel enregistrer le fichier. Peut être nul. Le fichier sera enregistré dans le répertoire "tmp".

dumpToGlobalLog

public void dumpToGlobalLog (ILeveledLogOutput log)

Vide l'intégralité du contenu d'un enregistreur ILeveledLogOutput dans le journal global.

Cela est utile lorsque vous savez que la sortie du journal ne sera pas enregistrée de manière permanente, mais que vous souhaitez que le contenu soit enregistré quelque part et ne soit pas perdu.

getGlobalLogDisplayLevel

public Log.LogLevel getGlobalLogDisplayLevel ()

Affiche le niveau de journalisation actuel pour le journal global.

Renvoie
`Log.LogLevel`	logLevel le `LogLevel` à utiliser

getLogRegistry

public static ILogRegistry getLogRegistry ()

Obtenir l'instance LogRegistry

Renvoie
`ILogRegistry`	un `LogRegistry` permettant d'enregistrer, d'obtenir, d'écrire et de fermer des journaux

getLogger

public ILeveledLogOutput getLogger ()

Récupère le journal sous-jacent associé à ce thread.

Renvoie
`ILeveledLogOutput`	le journal pour ce groupe de threads, ou le journal global si aucun n'a été enregistré pour le groupe de threads.

logEvent

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

Appelez cette méthode pour consigner un événement d'un type avec les informations associées dans la carte. L'heure de l'événement est automatiquement ajoutée.

Paramètres
`logLevel`	`Log.LogLevel`: `LogLevel` à imprimer.
`event`	`ILogRegistry.EventType`: `ILogRegistry.EventType` de l'événement à consigner.
`args`	: mappage des arguments à ajouter à l'entrée de journal pour obtenir plus d'informations sur l'événement.

printAndPromptLog

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

Envoyée lorsqu'un message de journal doit être imprimé et, si possible, présenté à l'utilisateur dans une boîte de dialogue.

Paramètres
`logLevel`	`Log.LogLevel`: énumération `LogLevel` représentant la priorité du message.
`tag`	`String`: balise associée au message.
`message`	`String`: message à afficher.

printLog

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

Envoyée lorsqu'un message de journal doit être imprimé.

Paramètres
`logLevel`	`Log.LogLevel`: énumération `LogLevel` représentant la priorité du message.
`tag`	`String`: balise associée au message.
`message`	`String`: message à afficher.

registerLogger

public void registerLogger (ILeveledLogOutput log)

Enregistre le journalisateur en tant qu'instance à utiliser pour le thread actuel.

Paramètres
`log`	`ILeveledLogOutput`

resetLocalGroup

public static void resetLocalGroup ()

Réinitialise le contexte localisé.

saveGlobalLog

public void saveGlobalLog ()

Enregistre tout le contenu des enregistreurs globaux dans des fichiers temporaires.

setGlobalLogDisplayLevel

public void setGlobalLogDisplayLevel (Log.LogLevel logLevel)

Définir l'affichage du niveau de journalisation pour le journal global

Paramètres
`logLevel`	`Log.LogLevel`: `LogLevel` à utiliser

setLocalGroup

public static void setLocalGroup (ThreadGroup tg)

Suit un contexte localisé lors de l'utilisation des propriétés dans le serveur gRPC

Paramètres
`tg`	`ThreadGroup`

unregisterLogger

public void unregisterLogger ()

Désinscrit le journal actuellement en vigueur pour le thread actuel.