اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

تُلغي تسجيل أداة تسجيل السجلّات الحالية السارية في سلسلة المحادثات الحالية.