اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

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 و57 غيرها

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

المعلمات
`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` الذي يحتوي على البيانات الوصفية للملف المحفوظ