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

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

ITestLogger

public interface ITestLogger

com.android.tradefed.log.ITestLogger

الفئات الفرعية غير المباشرة المعروفة

‫AggregatePostProcessor وAtraceCollector وAtraceRunMetricCollector وAveragePostProcessor وBaseDeviceMetricCollector وBasePostProcessor وBluetoothConnectionLatencyCollector وBluetoothConnectionStateCollector وBluetoothConnectionSuccessRatePostProcessor وBluetoothHciSnoopLogCollector وBugreportCollector وBugreportzOnFailureCollector وBugreportzOnTestCaseFailureCollector وClangCodeCoverageCollector وCodeCoverageCollector و83 غيرها

AggregatePostProcessor	أداة تجميع المقاييس التي تعرض الحد الأدنى والحد الأقصى والمتوسط والتباين والانحراف المعياري والإجمالي والعدد، بالإضافة إلى النِسَب المئوية الاختيارية للمقاييس الرقمية التي يتم جمعها أثناء عمليات تشغيل الاختبار المتعددة التكرار، مع التعامل معها كأرقام مضاعفة.
AtraceCollector	`IMetricCollector` هو برنامج يتم تشغيله أثناء الاختبار ويجمع النتائج والسجلات ويضيفها إلى عملية الاستدعاء.
AtraceRunMetricCollector	يجمع عمليات التتبُّع من جميع أدلة الاختبار ضمن الدليل المحدّد من الجهاز الاختباري، ويسجّل دليل الاختبار، ويعالج ملفات التتبُّع بعد ذلك ضمن دليل الاختبار، ويجمع المقاييس.
AveragePostProcessor	تنفيذ معالج لاحق يحسب متوسط قائمة المقاييس
BaseDeviceMetricCollector	التنفيذ الأساسي لـ `IMetricCollector` الذي يتيح بدء عملية الجمع وإيقافها في `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` و`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`
BasePostProcessor	الفئة الأساسية `IPostProcessor` التي يجب أن يوسّعها كل تنفيذ.
BluetoothConnectionLatencyCollector	سيرسل أداة جمع البيانات إعدادات مقياس المدة المحدّدة مسبقًا في statsd إلى الأجهزة، وسيجمع مدة اتصال البلوتوث لكل ملف شخصي.
BluetoothConnectionStateCollector	سيجمع هذا الجامع مقاييس BluetoothConnectionStateChanged ويسجّل رقم حالة الاتصال لكل ملف شخصي.
BluetoothConnectionSuccessRatePostProcessor	تنفيذ معالج لاحق يحسب معدّل النجاح لملف تعريف البلوتوث استخدِم "metric-key-match" لتحديد المقاييس التي تحتوي على حالات اتصال البلوتوث في مصفوفة رقمية، مثل [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	أداة جمع لتفعيل تسجيل التطفل على واجهة وحدة تحكّم المضيف للبلوتوث على الجهاز قيد الاختبار وجمع السجلّ لكل اختبار
BugreportCollector	`ITestInvocationListener` هي أداة تمرير تجمع تقارير الأخطاء عند وقوع أحداث قابلة للضبط، ثم تستدعي `ITestInvocationListener.testLog` على العناصر التابعة لها بعد جمع كل تقرير خطأ.
BugreportzOnFailureCollector	جمع bugreportz عند تعذُّر تنفيذ حالة اختبار
BugreportzOnTestCaseFailureCollector	جمع bugreportz عند تعذُّر تنفيذ حالة اختبار في عملية تشغيل
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيستخرج قياسات التغطية في Clang من الجهاز ويسجّلها كعناصر اختبار.
CodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيجلب مقاييس تغطية Java والرمز البرمجي الأصلي من الجهاز ويسجّلها كعناصر اختبار.
CollectingTestListener	`ITestInvocationListener` سيجمع كل نتائج الاختبار.
CommandStatusHandler	معالج يساعد في تتبُّع حالة عملية استدعاء وتعديلها.
ConditionFailureMonitor	راقِب أي حالات تعذُّر من عملية الاستدعاء.
ConsoleResultReporter	أداة إعداد التقارير عن النتائج لطباعة نتائج الاختبار في وحدة التحكّم
CountTestCasesCollector	احتساب عدد حالات الاختبار لـ `IRemoteTest` معيّن وإعداد تقرير عنه
DebugHostLogOnFailureCollector	أداة تجميع ستجمع سجلات جانب المضيف وتسجّلها عند حدوث خطأ في حالة الاختبار.
DeviceReleaseReporter	فئة Device release reporter التي تتعامل مع التواصل مع العملية الرئيسية للأجهزة التي سيتم إطلاقها.
DeviceTraceCollector	أداة تجميع ستبدأ تتبُّع Perfetto عند بدء تشغيل الاختبار وتسجيل ملف التتبُّع في النهاية.
DeviceUnavailableMonitor	يحاول هذا المستمع تسجيل DNAE على مستوى حالة الاختبار فقط.
EventsLoggerListener	معالج الأحداث الذي يسجّل جميع الأحداث التي يتلقّاها في ملف
FileProtoResultReporter	أداة إعداد التقارير بتنسيق Proto التي تنقل `TestRecord` إلى ملف.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` يستمع إلى مفتاح المقاييس الوارد من الجهاز ويجلبها كملف من الجهاز.
FilePullerLogCollector	مسجّل الملف الذي تم الإبلاغ عنه من جهة الجهاز
FilteredResultForwarder	صيغة `ResultForwarder` التي تسمح فقط بالإبلاغ عن قائمة `TestDescription` المسموح بها.
FormattedGeneratorReporter	أداة إعداد التقارير التي تتيح إنشاء التقارير بتنسيق معيّن
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيجلب قياسات تغطية gcov من الجهاز ويسجّلها كعناصر اختبار.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيستخرج قياسات تغطية gcov kernel من debugfs ومن الجهاز، ثم يسجّلها أخيرًا كعناصر اختبار.
GranularRetriableTestWrapper.StartEndCollector	فئة مساعدة لرصد حالات عدم توفّر وقتَي بدء التشغيل وإنهائه
HostStatsdMetricCollector	`IMetricCollector` التي تجمع مقاييس statsd من جهة المضيف باستخدام أوامر أداة statsd.
ICommandScheduler.IScheduledInvocationListener	أداة معالجة أحداث الاستدعاء عند اكتمال الاستدعاء
ILogSaverListener	يسمح هذا الإذن `ITestInvocationListener` بالاستماع إلى وقت حفظ ملفات السجلّ.
IMetricCollector	ستتم إضافة هذه الواجهة كعنصر تزييني عند إعداد تقارير بنتائج الاختبارات من أجل جمع المقاييس المطابقة.
IPostProcessor	المعالجات اللاحقة هي عنصر في Trade Federation يهدف إلى السماح بمعالجة المقاييس والسجلات بعد الاختبارات وقبل إعداد تقارير النتائج.
IShardableListener	`ITestInvocationListener` يمكن تقسيمها إلى أجزاء
ISupportGranularResults	واجهة تحدّد ما إذا كان `ITestInvocationListener` يتيح تلقّي النتائج التفصيلية أم لا.
ITestInvocationListener	معالج نتائج الاختبار من استدعاء الاختبار
ITestSummaryListener	واجهة تتيح لـ `ITestInvocationListener` تبادل بعض المعلومات المحدودة من خلال الملخّصات.
InvocationProtoResultReporter	المسؤول عن تخزين معلومات التخزين المؤقت على مستوى الاستدعاء وقائمة الوحدات
InvocationToJUnitResultForwarder	فئة تستمع إلى أحداث `ITestInvocationListener` وتعيد توجيهها إلى `TestListener`.
JarHostTest.HostTestListener	أداة معالجة برنامج التضمين التي تعيد توجيه جميع الأحداث باستثناء testRunStarted()‎ وtestRunEnded()‎ إلى أداة المعالجة المضمّنة.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيجلب قياسات تغطية Java من الجهاز ويسجّلها كعناصر اختبار.
JsonHttpTestResultReporter	أداة إعداد تقارير النتائج التي ترمّز نتائج مقاييس الاختبار ومعلومات الفرع والجهاز إلى JSON وPOST إلى نقطة نهاية خدمة HTTP
LUCIResultReporter	أداة إعداد تقارير النتائج التي تحفظ نتائج الاختبارات التي تحتاجها ResultDB وLUCI بتنسيق JSON (go/result-sink) وتسجّل موقع الملف في وحدة التحكّم.
LastShardDetector	عند تنفيذ التقسيم على مستوى الجهاز، نريد أحيانًا تنفيذ بعض الإجراءات فقط عندما يصل الجزء الأخير إلى `invocationEnded(long)`.
LegacySubprocessResultsReporter	تنفيذ ثابت لأداة تسجيل نتائج العمليات الفرعية يجب أن يظل متوافقًا مع الإصدارات السابقة من TF/CTS (مثل 8 والإصدارات الأحدث)، على الرغم من التغييرات في الفئة الرئيسية.
LogSaverResultForwarder	`ResultForwarder` لحفظ السجلات باستخدام أداة حفظ الملفات العامة
LogcatCrashResultForwarder	المستمع الخاص: عند حدوث حالات فشل (تعطُّل عملية القياس)، سيحاول استخراج معلومات من logcat حول التعطُّل وإضافتها إلى رسالة الخطأ المرتبطة بالاختبار.
LogcatOnFailureCollector	أداة تجميع ستسجّل logcat عند تعذُّر تنفيذ حالة اختبار.
LogcatTimingMetricCollector	أداة لجمع المقاييس تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء إجراء اختبار واحد أو أكثر من الاختبارات المتكرّرة باستخدام أنماط regex المحدّدة لتحليل إشارات البدء والانتهاء لحدث من أسطر logcat.
MetricFilePostProcessor	يُستخدَم لتحميل ملف سجلّ المقاييس الذي تمّ جمعه أثناء الاختبار وعلى مستوى التشغيل.
MetricsXMLResultReporter	تكتب أداة MetricsXMLResultReporter مقاييس الاختبار ومقاييس التشغيل في ملف XML في مجلد محدّد بواسطة المَعلمة metrics-folder في مرحلة invocationEnded من الاختبار.
ModuleListener	يتم ربط أداة معالجة الأحداث بكل `IRemoteTest` في كل وحدة من أجل جمع قائمة النتائج.
ModuleLogcatCollector	إصدار أداة جمع logcat ولكن للوحدة.
ModuleProtoResultReporter	أداة إعداد تقارير النتائج التي تهدف إلى إعداد تقارير عن النتائج على مستوى الوحدة فقط.
ModuleResultsAndMetricsForwarder	هي امتداد لـ `ResultAndLogForwarder` يضيف مقاييس إضافية ذات صلة بالوحدة إلى نتائج الاختبار.
NameMangleListener	أداة معالجة وكيل لترجمة أسماء طرق الاختبار والفئات والحِزم عند الإبلاغ عن النتائج.
PassingTestFileReporter	`ITestInvocationListener` يحفظ قائمة بحالات الاختبار الناجحة في ملف اختبار
PerfettoFilePullerCollector	أداة تجميع تسحب ملفات تتبُّع Perfetto من الجهاز، وتضغطها اختياريًا، وتضيفها إلى سجلّات الاختبار.
PerfettoGenericPostProcessor	معالج لاحق يعالج ملف perfetto proto للمقاييس النصية/الثنائية إلى أزواج مفتاح/قيمة من خلال توسيع رسائل proto والحقول بشكل متكرر باستخدام قيم السلسلة إلى أن يتم العثور على الحقل الذي يحتوي على قيمة رقمية.
PerfettoPullerMetricCollector	تم إيقاف هذا الصف نهائيًا. يُرجى استخدام `PerfettoFilePullerCollector` و`ERROR(/PerfettoTracePostProcessor)` بدلاً منها.
PerfettoTracePostProcessor	معالج لاحق يستردّ ملفات تتبُّع Perfetto من سجلّات الاختبار ويشغّل معالج التتبُّع عليها لإنتاج نموذج أولي لمقياس Perfetto.
PrettyTestEventLogger	مسجّل يطابق الأحداث ويسجّلها لتسهيل عملية تصحيح الأخطاء
ProtoResultReporter	يجب أن ينشئ برنامج إعداد التقارير عن النتائج `TestRecord` بروتوكول buffer يحتوي على جميع النتائج.
PtsBotTest	إجراء اختبارات PTS-bot
PythonBinaryHostTest.PythonForwarder	أداة إعادة توجيه النتائج لاستبدال اسم التشغيل باسم الملف الثنائي
RebootReasonCollector	أداة جمع تجمع عمليات إعادة تشغيل الجهاز أثناء التشغيل التجريبي وتُبلغ عنها حسب السبب وعدد المرات.
RemoteTestTimeOutEnforcer	أدوات معالجة تتيح التحقّق من وقت تنفيذ إعداد اختبار معيّن وإيقافه إذا تجاوز المهلة المحدّدة.
ReportPassedTests	الإبلاغ في ملف عن الفلاتر المحتملة لاستبعاد الاختبارات الناجحة
ResultAggregator	برنامج إعادة توجيه خاص يجمع النتائج عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتّخاذها.
ResultAndLogForwarder	أداة إعادة توجيه النتائج وأحداث السجلّ
ResultDBReporter	أداة إعداد تقارير النتائج التي تحمّل نتائج الاختبار إلى ResultDB.
ResultForwarder	`ITestInvocationListener` يعيد توجيه نتائج الاستدعاء إلى قائمة بمستمعين آخرين.
ResultReporter
RetryLogSaverResultForwarder	دالة إعادة توجيه تعالج أيضًا تمرير المحاولة الحالية التي نحن بصددها.
RetryResultForwarder	إضافة `ResultForwarder` التي يتم إرسالها دائمًا إلى رقم محاولة معيّن
RuntimeRestartCollector	أداة تجميع تجمع الطوابع الزمنية لعمليات إعادة التشغيل أثناء وقت التشغيل (تعطُّل خادم النظام) أثناء تنفيذ الاختبار، إن وُجدت.
ScreenshotOnFailureCollector	أداة تجميع ستلتقط لقطة شاشة وتسجّلها عند تعذُّر حالة اختبار.
ShardListener	`ITestInvocationListener` يجمع النتائج من جزء من عملية الاستدعاء (يُعرف أيضًا باسم تقسيم عملية الاستدعاء لتنفيذها على موارد متعددة بالتوازي)، ويعيد توجيهها إلى مستمع آخر.
ShardMainResultForwarder	`ResultForwarder` يجمع نتائج عمليات استدعاء الاختبارات المقسّمة.
ShowmapPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منها.
StatsdBeforeAfterGaugeMetricPostProcessor	معالج لاحق يعالج مقاييس المقياس التي تم جمعها بطريقة "قبل/بعد"، أي
StatsdEventMetricPostProcessor	معالج لاحق يعالج مقاييس الأحداث في تقارير statsd إلى أزواج المفتاح/القيمة، باستخدام أدوات التنسيق المحدّدة في المعالج.
StatsdGenericPostProcessor	معالج لاحق يعالج تقارير statsd الثنائية بتنسيق proto إلى أزواج مفتاح/قيمة من خلال توسيع التقرير كبنية شجرية.
StreamProtoResultReporter	مثال على تنفيذ `ProtoResultReporter`
SubprocessResultsReporter	تنفيذ `ITestInvocationListener` ليتم تحديده على أنّه result_reporter وإعادة توجيه نتائج الاختبارات وعمليات تشغيل الاختبارات وطلبات الاختبار من العملية الفرعية.
SuiteResultReporter	جمع نتائج الاختبارات لتنفيذ مجموعة اختبارات كاملة وعرض النتائج النهائية
TestRunResultListener	معالج أحداث يتيح قراءة حالة تشغيل الاختبار النهائي.
TestTimeoutEnforcer	برامج معالجة الأحداث التي تتيح التحقّق من وقت تنفيذ حالة اختبار معيّنة وإيقافها إذا تجاوزت المهلة المحدّدة.
TextResultReporter	أداة إعداد تقارير عن نتائج الاختبار تعيد توجيه النتائج إلى أداة طباعة النتائج النصية في JUnit.
TraceCmdCollector	`IMetricCollector` يجمع عمليات التتبُّع أثناء الاختبار باستخدام trace-cmd، ويسجّلها في عملية الاستدعاء.
TradefedSandboxRunner.StubScheduledInvocationListener	دالة صورية `IScheduledInvocationListener` لا تنفّذ أي إجراء.
XmlFormattedGeneratorReporter	تنفيذ `FormattedGeneratorReporter` الذي يحدد تنسيق نتائج الحزمة بتنسيق xml
XmlResultReporter	تكتب هذه السمة نتائج JUnit في ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter في Ant.

هي كيان يمكنه تسجيل تدفقات البيانات من أنواع مختلفة.

ملخّص

الطُرق العامة
`default void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` تعرض هذه السمة بيانات السجلّ أو تصحيح الأخطاء المرتبطة بعملية استدعاء الاختبار.

الطُرق العامة

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

تعرض هذه السمة بيانات السجلّ أو تصحيح الأخطاء المرتبطة بعملية استدعاء الاختبار.

يجب استدعاء هذه الدالة قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

سيستدعي إطار عمل TradeFederation هذه الطريقة تلقائيًا، مع توفير سجلّ المضيف، وسجلّ logcat للجهاز إذا كان ذلك منطبقًا.

المعلمات
`dataName`	`String`: اسم وصفي `String` للبيانات، مثل "device_logcat". ملاحظة قد لا يكون dataName فريدًا لكل استدعاء، أي يجب أن يتمكّن المنفّذون من التعامل مع عمليات استدعاء متعدّدة باستخدام dataName نفسه.
`dataType`	‫`LogDataType`: `LogDataType` البيانات
`dataStream`	`InputStreamSource`: `InputStreamSource` البيانات على المنفّذين استدعاء createInputStream لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند الانتهاء. على المتصلين التأكّد من أنّ مصدر البيانات يظل متاحًا ويمكن الوصول إليه إلى أن تكتمل طريقة testLog.