تمت ترجمة هذه الصفحة بواسطة 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 وCollectingTestListener و75 عملية أخرى

AggregatePostProcessor	مجمّع مقاييس يقدّم الحدّ الأدنى والحدّ الأقصى والمتوسّط والتباين والانحراف المعياري والإجمالي والعدد والنسب المئوية اختياريًا للمقاييس الرقمية التي يتم جمعها أثناء عمليات تنفيذ الاختبار المتكرّرة، ويتعامل معها على أنّها أعداد مزدوجة.
AtraceCollector	`IMetricCollector` التي تُجري عملية تتبُّع أثناء الاختبار وتجمع النتيجة وتُسجّلها في الطلب
AtraceRunMetricCollector	تجمع هذه الوظيفة عمليات التتبّع من جميع الدليل التجريبي ضمن الدليل المحدّد من الجهاز التجريبي، وتسجّل الدليل التجريبي وتعالج ملفات التتبّع بعد تسجيلها ضمن الدليل التجريبي وتجميع المقاييس.
متوسط ما بعد المعالجة	تنفيذ وحدة معالجة ما بعد المعالجة التي تحسب متوسّط قائمة المقاييس
BaseDeviceMetricCollector	هي آلية تنفيذ أساسية لـ `IMetricCollector` التي تسمح ببدء جمع البيانات وإيقافها على `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` و`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BasePostProcessor	تمثّل هذه السمة `IPostProcessor` الأساسي الذي يجب تمديده في كل عملية تنفيذ.
BluetoothConnectionLatencyCollector	سترسل أداة التجميع إعدادات مقياس المدة المحدّدة مسبقًا إلى الأجهزة وستجمع مدة اتصال البلوتوث لكل ملف شخصي.
BluetoothConnectionStateCollector	ستجمع أداة التجميع هذه مقاييس BluetoothConnectionStateChanged وستسجّل رقم حالة الاتصال لكل ملف شخصي.
BluetoothConnectionSuccessRatePostProcessor	تنفيذ المعالج اللاحق الذي يحسب معدّل النجاح لملف شخصي على البلوتوث استخدِم "metric-key-match" لتحديد المقاييس التي تحتوي على حالات اتصال البلوتوث في صفيف صعِد رقمي مثال [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	أداة جمع لتسجيل التطفل على واجهة وحدة تحكّم المضيف في بلوتوث على جهاز التحكّم في العينة وجمع السجلّ لكل اختبار
BugreportCollector	`ITestInvocationListener` للمرور بدون معالجة تجمع تقارير الأخطاء عند حدوث أحداث قابلة للضبط ، ثم تستدعي `ITestInvocationListener#testLog` في عناصرها الفرعية بعد جمع كل تقرير أخطاء.
BugreportzOnFailureCollector	جمع تقرير بالأخطاء عند تعذُّر تقديم حالة اختبار.
BugreportzOnTestCaseFailureCollector	جمع تقرير أخطاء عند تعذُّر تنفيذ حالة اختبار في إحدى عمليات التشغيل
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` التي ستسحب قياسات تغطية Clang من الجهاز وتُسجّلها كعناصر اختبار
CollectingTestListener	تمثّل هذه السمة `ITestInvocationListener` الذي سيجمع كل نتائج الاختبارات.
CommandStatusHandler	معالِج يساعد في مراقبة حالة طلب الاستدعاء وتعديلها
ConditionFailureMonitor	راقِب أيّ أخطاء من طلب التنفيذ.
ConsoleResultReporter	أداة الإبلاغ عن النتائج لطباعة نتائج الاختبار في وحدة التحكّم.
CountTestCasesCollector	احتساب عدد حالات الاختبار وإعداد تقارير عنها لـ `IRemoteTest` معيّن
DebugHostLogOnFailureCollector	المجمِّع الذي سيجمع السجلات من جهة المضيف ويسجِّلها عند حدوث فشل في حالة الاختبار.
DeviceReleaseReporter	مُرسِل إصدارات الأجهزة الذي يتعامل مع عملية التواصل مع الوالدَين بشأن الأجهزة التي سيتم إصدارها
DeviceTraceCollector	أداة جمع البيانات التي ستبدأ عملية تتبُّع perfetto عند بدء عملية تشغيل الاختبار وستسجِّل ملف تتبُّع في النهاية.
DeviceUnavailableMonitor	يحاول هذا المستمع تسجيل بيانات تحليل الأداء على مستوى نموذج الاختبار فقط.
EventsLoggerListener	أداة معالجة الحدث التي تسجّل جميع الأحداث التي تتلقّاها في ملف
FileProtoResultReporter	أداة Proto reporter التي تُفرِغ `TestRecord` في ملف
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` يستمع إلى مفتاح المقاييس الواردة من الجهاز ويسحبها كملف من الجهاز.
FilePullerLogCollector	أداة تسجيل الملف الذي تم الإبلاغ عنه من جانب الجهاز
FilteredResultforwarder	نوع من `ResultForwarder` لا يسمح إلا بتسجيل قائمة مسموح بها من `TestDescription`.
FormattedGeneratorReporter	جهة الإبلاغ التي تسمح بإنشاء التقارير بتنسيق معيّن.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` لسحب قياسات تغطية gcov من الجهاز وتسجيلها كعناصر اختبار
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` التي ستسحب قياسات تغطية ملف kernel باستخدام gcov من debugfs وخارج الجهاز، ثم تسجّلها أخيرًا كعناصر اختبار
GranularRetriableTestWrapper.StartEndCollector	مساعد فئة لرصد بداية ونهاية التشغيل غير المتوفّرة
HostStatsdMetricCollector	`IMetricCollector` يجمع المقاييس التي تم إحصاءاتها من جهة المضيف باستخدام أوامر أداة الإحصاءات.
ICommandscheduler.IscheduleInvocationListener	أداة الاستماع لأحداث الاستدعاء عند اكتمال الاستدعاء
ILogSaverListener	السماح لتطبيقات `ITestInvocationListener` بالاستماع إلى عمليات حفظ ملفات السجلّ
IMetricCollector	ستتم إضافة هذه الواجهة كمزيّن عند إعداد تقارير نتائج الاختبارات من أجل جمع المقاييس المطابقة.
IPostProcessor	معالجات ما بعد المعالجة هي عناصر في Trade Federation تهدف إلى السماح بمعالجة المقاييس والسجلات بعد الاختبارات وقبل إعداد تقارير النتائج.
IShardableListener	`ITestInvocationListener` يمكن تجزئةه.
ISupportGranularResults	واجهة تحدِّد ما إذا كان `ITestInvocationListener` يتيح تلقّي نتائج تحليلات العميل الدقيقة أم لا
ITestInvocationListener	أداة معالجة نتائج الاختبار من استدعاء الاختبار.
ITestSummaryListener	واجهة تتيح لـ "`ITestInvocationListener`" تبادل بعض المعلومات المحدودة عبر الملخّصات.
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 أثناء اختبار واحد أو عدّة اختبارات متكرّرة باستخدام أنماط التعبير العادي المحدّدة لتحليل إشارات البدء والنهاية لحدث من أسطر logcat
MetricFilePostProcessor	تُستخدَم لتحميل ملف سجلّ المقاييس الذي تم جمعه أثناء مستوى الاختبار والتشغيل.
MetricsXMLResultReporter	يُسجِّل MetricsXMLResultReporter مقاييس الاختبار ومقاييس التشغيل في ملف XML في مجلد محدّد بالمَعلمة metrics-folder في مرحلة invocationEnded من الاختبار.
ModuleListener	مستمع مرفق بكل `IRemoteTest` من كل وحدة من أجل جمع قائمة النتائج
ModuleLogcatCollector	إصدار أداة جمع سجلّات logcat ولكن للوحدة.
ModuleProtoResultReporter	أداة إعداد تقارير النتائج مخصّصة لإعداد تقارير عن النتائج على مستوى الوحدة فقط.
NameMangleListener	مستمع وكيل لترجمة أسماء طريقة الاختبار والفئة والحزمة عند تسجيل النتائج
PassingTestFileReporter	تمثّل هذه السمة `ITestInvocationListener` تحفظ قائمة حالات الاختبار التي تم اجتيازها في ملف اختبار.
PerfettoGenericPostProcessor	وحدة معالجة لاحقة تعالج ملف proto لقياسات النص/الثنائي perfetto إلى أزواج مفتاح/قيمة من خلال توسيع رسائل proto والحقول التي تحتوي على قيم سلاسل بشكل متكرر إلى أن يتم العثور على الحقل الذي يحتوي على قيمة رقمية.
PerfettoPullerMetricCollector	التنفيذ الأساسي `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات perfetto من الجهاز وجمع المقاييس منه
PrettyTestEventLogger	أداة تسجيل تتطابق مع الأحداث وتُسجّلها لتسهيل تصحيح الأخطاء
ProtoResultReporter	ينشئ مُبلِّغ النتائج ملفًا بتنسيق `TestRecord` protobuf يحتوي على جميع النتائج.
PythonBinaryHostTest.PythonForwarder	تعمل أداة إعادة توجيه النتائج على استبدال اسم عملية التشغيل بالاسم الثنائي.
RewreasonCollector	يجمع هذا المجمِّع عمليات إعادة تشغيل الجهاز أثناء إجراء الاختبار ويبلِّغ عنها حسب السبب والعدد.
RemoteTestTimeOutEnforcer	المستمعون الذين يسمحون بالتحقق من وقت تنفيذ إعداد اختبار معيّن وإفشاله إذا تجاوز مهلة معيّنة
ReportPassedTests	أدرِج في ملف الفلاتر المحتمَلة لاستبعاد الاختبار الذي تم اجتيازه.
ResultAggregator	إعادة توجيه خاصة تُجمِّع النتائج عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتخاذها
ResultAndLogForwarder	أداة إعادة توجيه للنتائج وأحداث السجلّ
أداة إعادة توجيه النتائج	نوع `ITestInvocationListener` يعيد توجيه نتائج الاستدعاء إلى قائمة بالمستمعين الآخرين
renameLogSaverResultforwarder	مسؤول إعادة التوجيه الذي يتعامل أيضًا مع اجتياز المحاولة الحالية التي نحن بصددها.
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.StubscheduleInvocationListener	رمز مقتطف `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 لبدء قراءة البيانات والتأكّد من إغلاق InsertStream الناتج عند اكتماله. على المُتصلين التأكّد من بقاء مصدر البيانات حاضرًا ويمكن الوصول إليه إلى أن تكتمل طريقة testLog.