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

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

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

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

AggregatePostProcessor وAtraceCollector وAtraceRunMetricCollector وAveragePostProcessor وBaseDeviceMetricCollector وBasePostProcessor وBluetoothConnectionLatencyCollector وBluetoothConnectionStateCollector وBluetoothConnectionSuccessRatePostProcessor وBluetoothHciSnoopLogCollector وBugreportzOnFailureCollector وBugreportzOnTestCaseFailureCollector وClangCodeCoverageCollector وCodeCoverageCollector وCollectingTestListener و52 عنصرًا آخر

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	أداة جمع لتسجيل التطفل على واجهة وحدة تحكّم المضيف في بلوتوث على جهاز التحكّم في العينة وجمع السجلّ لكل اختبار
BugreportzOnFailureCollector	جمع تقرير أخطاء عند تعذُّر اختبار حالة
BugreportzOnTestCaseFailureCollector	جمع تقرير أخطاء عند تعذُّر تنفيذ حالة اختبار في إحدى عمليات التشغيل
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيستخرج قياسات تغطية Clang من الجهاز ويُسجّلها كعناصر اختبار
CodeCoverageCollector	`BaseDeviceMetricCollector` لسحب قياسات التغطية الأصلية من Java و من الجهاز وتسجيلها كعناصر اختبار
CollectingTestListener	`ITestInvocationListener` ستجمع جميع نتائج الاختبار.
ConsoleResultReporter	أداة إعداد التقارير لطباعة نتائج الاختبار في وحدة التحكّم
CountTestCasesCollector	احتساب عدد حالات الاختبار وإعداد تقارير عنها لـ `IRemoteTest` معيّن
DebugHostLogOnFailureCollector	أداة جمع ستجمع السجلات من جهة المضيف وتسجّلها عند حدوث خطأ في نموذج الاختبار.
DeviceTraceCollector	أداة جمع البيانات التي ستبدأ عملية تتبُّع perfetto عند بدء عملية تشغيل الاختبار وستسجِّل ملف تتبُّع في النهاية.
EventsLoggerListener	مستمع يسجِّل جميع الأحداث التي يتلقّاها في ملف
FileProtoResultReporter	أداة Proto reporter التي تُفرِغ `TestRecord` في ملف
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` يستمع إلى مفتاح المقاييس الواردة من الجهاز ويسحبها كملف من الجهاز.
FilePullerLogCollector	أداة تسجيل الملفات التي تم الإبلاغ عنها من جانب الجهاز
FormattedGeneratorReporter	أداة إعداد التقارير التي تتيح إنشاء تقارير بتنسيق معيّن
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيستخرج قياسات تغطية gcov من الجهاز ويُسجّلها كعناصر اختبار
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` التي ستسحب قياسات تغطية ملف kernel باستخدام gcov من debugfs وخارج الجهاز، ثم تسجّلها أخيرًا كعناصر اختبار
GranularRetriableTestWrapper.StartEndCollector	مساعد فئة لرصد بداية ونهاية التشغيل غير المتوفّرة
HostStatsdMetricCollector	`IMetricCollector` تجمع مقاييس statsd من جهة المضيف باستخدام أوامر أداة statsd
IMetricCollector	ستتم إضافة هذه الواجهة كمزيّن عند إعداد تقارير نتائج الاختبارات من أجل جمع المقاييس المطابقة.
IPostProcessor	معالجات ما بعد المعالجة هي عناصر في Trade Federation تهدف إلى السماح بمعالجة المقاييس والسجلات بعد الاختبارات وقبل إعداد تقارير النتائج.
InvocationProtoResultReporter	أدوات إعداد التقارير لتخزين معلومات التخزين المؤقت على مستوى الطلب وقائمة الوحدات
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` التي ستسحب قياسات تغطية Java من الجهاز وتُسجّلها كعناصر اختبار
JsonHttpTestResultReporter	أداة إعداد تقارير النتائج التي تُشفِّر نتائج مقاييس الاختبار وبيانات الفرع والجهاز إلى تنسيق JSON وتُرسِلها باستخدام POST إلى نقطة نهاية خدمة HTTP
LUCIResultReporter	أداة إعداد تقارير النتائج التي تحفظ نتائج الاختبار التي تحتاجها ResultDB وLUCI بتنسيق JSON (go/result-sink) وتسجِّل موقع الملف في وحدة التحكّم
LegacySubprocessResultsReporter	تنفيذ مجمّد لبرنامج إعداد تقارير نتائج العملية الفرعية الذي من المفترض أن يظل متوافقًا مع الإصدارات السابقة من TF/CTS (مثل الإصدار 8 والإصدارات الأحدث)، على الرغم من التغييرات في الفئة العليا
LogSaverResultForwarder	`ResultForwarder` لحفظ السجلات باستخدام أداة حفظ الملفات الشاملة
LogcatOnFailureCollector	أداة جمع ستسجِّل logcat وتُسجِّله عند تعذُّر اختبار حالة معيّنة.
LogcatTimingMetricCollector	أداة جمع مقاييس تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء اختبار واحد أو عدّة اختبارات متكرّرة باستخدام أنماط التعبير العادي المحدّدة لتحليل إشارات البدء والنهاية لحدث من أسطر logcat
MetricFilePostProcessor	تُستخدَم لتحميل ملف سجلّ المقاييس الذي تم جمعه أثناء مستوى الاختبار والتنفيذ.
MetricsXMLResultReporter	يُسجِّل MetricsXMLResultReporter مقاييس الاختبار ومقاييس التشغيل في ملف XML في مجلد محدّد بالمَعلمة metrics-folder في مرحلة invocationEnded من الاختبار.
ModuleListener	مستمع مرفق بكل `IRemoteTest` من كل وحدة من أجل جمع قائمة النتائج
ModuleLogcatCollector	إصدار أداة جمع سجلّات logcat ولكن للوحدة.
ModuleProtoResultReporter	أداة إعداد تقارير النتائج مخصّصة لإعداد تقارير عن النتائج على مستوى الوحدة فقط.
PerfettoGenericPostProcessor	وحدة معالجة لاحقة تعالج ملف proto لقياسات النص/الثنائية في perfetto إلى أزواج مفتاح/قيمة من خلال توسيع رسائل proto والحقول التي تحتوي على قيم سلاسل بشكل متكرر إلى أن يتم العثور على الحقل الذي يحتوي على قيمة رقمية.
PerfettoPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات perfetto من الجهاز وجمع المقاييس منه
ProtoResultReporter	ينشئ مُبلِّغ النتائج ملفًا بتنسيق `TestRecord` protobuf يحتوي على جميع النتائج.
RebootReasonCollector	أداة جمع تجمع عمليات إعادة تشغيل الجهاز أثناء إجراء الاختبار وتُبلغ عنها حسب السبب والعدد.
ReportPassedTests	الإبلاغ في ملف عن الفلاتر المحتمَلة لاستبعاد الاختبار الذي تم اجتيازه
ResultAggregator	إعادة توجيه خاصة تُجمِّع النتائج عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتخاذها
ResultAndLogForwarder	أداة إعادة توجيه للنتائج وأحداث السجلّ
ResultDBReporter	أداة إعداد تقارير النتائج التي تحمّل نتائج الاختبار إلى ResultDB
RetryLogSaverResultForwarder	مُعيد التوجيه الذي يتعامل أيضًا مع اجتياز المحاولة الحالية التي نحاول إجراؤها
RuntimeRestartCollector	أداة جمع تجمع الطوابع الزمنية لعمليات إعادة التشغيل أثناء التشغيل (أعطال خادم النظام) أثناء تنفيذ الاختبار ، إن وجدت.
ScreenshotOnFailureCollector	أداة جمع ستلتقط لقطة شاشة وتسجّلها عند تعذُّر تنفيذ حالة اختبار.
ShardListener	`ITestInvocationListener` يجمع النتائج من شريحة طلب (المعروفة أيضًا باسم تقسيم طلب التشغيل على موارد متعددة بشكل متزامن)، ويعيد توجيهها إلى مستمع آخر
ShardMainResultForwarder	`ResultForwarder` يجمع نتائج عمليات استدعاء الاختبار المجزّأة
ShowmapPullerMetricCollector	التنفيذ الأساسي `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منه
StatsdBeforeAfterGaugeMetricPostProcessor	معالج لاحق يعالج مقاييس القياس التي يتم جمعها باستخدام أسلوب "قبل/بعد"، أي
StatsdEventMetricPostProcessor	وحدة معالجة لاحقة تعالج مقاييس الأحداث في تقارير statsd إلى أزواج مفتاح/قيمة، باستخدام أدوات التنسيق المحدّدة في وحدة المعالجة
StatsdGenericPostProcessor	وحدة معالجة لاحقة تعالج تقارير statsd الثنائية إلى أزواج مفتاح/قيمة من خلال توسيع التقرير كبنية شجرة
StreamProtoResultReporter	تنفيذ `ProtoResultReporter`
SubprocessResultsReporter	تنفيذ `ITestInvocationListener` ليتم تحديده كـ result_reporter وإعادة توجيه نتائج الاختبار وعمليات تشغيل الاختبار وطلبات تشغيل الاختبار من العملية الفرعية
SuiteResultReporter	جمع نتائج الاختبار لطلب مجموعة كاملة وعرض النتائج النهائية
TextResultReporter	أداة إعداد تقارير نتائج الاختبار التي تعيد توجيه النتائج إلى طابعة النتائج النصية JUnit
TraceCmdCollector	`IMetricCollector` تجمع عمليات التتبّع أثناء الاختبار باستخدام trace-cmd، وتُسجّلها في عملية الاستدعاء.
XmlFormattedGeneratorReporter	تنفيذ `FormattedGeneratorReporter` الذي يُنشئ تنسيقًا xml لنتائج المجموعة
XmlResultReporter	يكتب نتائج JUnit في ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter في Ant.

السماح لتطبيقات ITestInvocationListener بالاستماع إلى عمليات حفظ ملفات السجلّ

يتيح ذلك لاستخدام ITestInvocationListener متعددة ملف السجلّ المحفوظ نفسه عند إنشاء التقارير، ويتجنّب أن يحفظ كل مستمع الملف بشكلٍ فردي عند استدعاء ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource).

يجب أن تكون الفِرق التي تنفّذ هذه الواجهة على دراية بأنّه سيتم استدعاء testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) عند استدعاء ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource).

وتُمرِّر هذه الفئة أيضًا مثيل ILogSaver الشامل حتى تتمكّن ITestInvocationListener من حفظ ملفات إضافية في الموقع نفسه.

ملخّص

الطرق العامة
`default void`	`logAssociation(String dataName, LogFile logFile)` في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` callback المباشر.
`default void`	`setLogSaver(ILogSaver logSaver)` اضبط `ILogSaver` للسماح للمنفِّذ بحفظ الملفات.
`default void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` يتمّ استدعاء هذه الدالة عند حفظ سجلّ الاختبار.

الطرق العامة

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callback المباشر. وبالتالي، يسمح هذا المرجع العكسي بتوفير ارتباط قوي بشكل صريح.

المعلمات
`dataName`	`String`: اسم البيانات
`logFile`	`LogFile`: `LogFile` الذي تم تسجيله من قبل ويجب أن يكون مرتبطًا بحالة الاختبار

setLogSaver

public void setLogSaver (ILogSaver logSaver)

اضبط ILogSaver للسماح للمنفِّذ بحفظ الملفات.

المعلمات
`logSaver`	`ILogSaver`: `ILogSaver`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

يتمّ استدعاء هذه الدالة عند حفظ سجلّ الاختبار.

يجب استخدامه بدلاً من ITestInvocationListener.testLog(String, LogDataType, InputStreamSource).

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