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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

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

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

AggregatePostProcessor	أداة تجميع المقاييس التي تعرض الحد الأدنى والحد الأقصى والمتوسط والتباين والانحراف المعياري والإجمالي والعدد، بالإضافة إلى النِسَب المئوية الاختيارية للمقاييس الرقمية التي يتم جمعها أثناء عمليات تشغيل الاختبار المتعددة التكرار، مع التعامل معها كأرقام مضاعفة.
AndroidBuildResultReporter	إرسال نتائج الاختبار إلى Android Build API
AtraceCollector	`IMetricCollector` هو برنامج يتم تشغيله أثناء الاختبار لجمع النتائج وتسجيلها في سجلّ الاستدعاء.
AtraceRunMetricCollector	يجمع عمليات التتبُّع من جميع أدلة الاختبار ضمن الدليل المحدّد من الجهاز الاختباري، ويسجّل دليل الاختبار، ويعالج ملفات التتبُّع بعد ذلك ضمن دليل الاختبار، ويجمع المقاييس.
AveragePostProcessor	تنفيذ معالج لاحق يحسب متوسط قائمة المقاييس
BaseDeviceMetricCollector	التنفيذ الأساسي لـ `IMetricCollector` الذي يتيح بدء عملية الجمع وإيقافها في `onTestRunStart(DeviceMetricData)` و`onTestRunEnd(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` وإعداد تقرير بها
CoverageMetadataCollector	`ILogSaverListener` الذي يجمع قياسات التغطية المسجّلة وينشئ CoverageMetadataProto لمعالجتها بواسطة خدمة "تغطية الرموز البرمجية" في Android
DebugHostLogOnFailureCollector	المجمِّع الذي سيجمع سجلّات جانب المضيف ويسجّلها عند حدوث خطأ في حالة الاختبار.
DeviceTraceCollector	أداة تجميع ستبدأ تتبُّع Perfetto عند بدء تشغيل الاختبار وتسجيل ملف التتبُّع في النهاية.
EventsLoggerListener	أداة معالجة تسجّل جميع الأحداث التي تتلقّاها في ملف
FileProtoResultReporter	أداة إعداد تقارير Proto التي تنقل `TestRecord` إلى ملف.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` يستمع إلى مفتاح المقاييس الوارد من الجهاز ويجلبها كملف من الجهاز.
FilePullerLogCollector	مسجّل الملف الذي تم الإبلاغ عنه من جهة الجهاز
FormattedGeneratorReporter	أداة إعداد التقارير التي تتيح إنشاء التقارير بتنسيق معيّن
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيجلب قياسات التغطية باستخدام gcov من الجهاز ويسجّلها كعناصر اختبار.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيستخرج قياسات تغطية gcov kernel من debugfs ومن الجهاز، ثم يسجّلها أخيرًا كعناصر اختبار.
GeminiDebuggingPostProcessor	معالج ما بعد الإنتاج ينشئ طلبات بحث لتصحيح الأخطاء.
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 ولكن للوحدة.
ModulePerfettoCollector	أداة تجميع ستبدأ عملية تتبُّع Perfetto عند بدء وحدة الاختبار وانتهائها وإعادة تشغيل الجهاز.
ModuleProtoResultReporter	أداة إعداد تقارير النتائج التي تهدف إلى إعداد تقارير عن النتائج على مستوى الوحدة فقط
ModuleResultsAndMetricsForwarder	تمثّل هذه السمة امتدادًا للسمة `ResultAndLogForwarder`، وهي تضيف مقاييس إضافية ذات صلة بالوحدة إلى نتائج الاختبار.
PerfettoFilePullerCollector	أداة تجميع تسحب ملفات تتبُّع Perfetto من الجهاز، وتضغطها اختياريًا، وتضيفها إلى سجلّات الاختبار.
PerfettoGenericPostProcessor	معالج لاحق يعالج ملف proto الخاص بمقياس نصي/ثنائي في أزواج مفتاح/قيمة من خلال التوسيع بشكل متكرر لرسائل proto والحقول ذات القيم النصية إلى أن يتم العثور على الحقل ذي القيمة الرقمية.
PerfettoPullerMetricCollector	تم إيقاف هذه الفئة نهائيًا. يُرجى استخدام `PerfettoFilePullerCollector` و`ERROR(/PerfettoTracePostProcessor)` بدلاً من ذلك.
PerfettoTracePostProcessor	معالج لاحق يستردّ ملفات تتبُّع Perfetto من سجلّات الاختبار ويشغّل معالج التتبُّع عليها لإنتاج نموذج أولي لمقياس Perfetto.
ProtoResultReporter	يُنشئ برنامج إعداد التقارير عن النتائج `TestRecord` بروتوكول buffer يحتوي على جميع النتائج.
RebootReasonCollector	أداة جمع تجمع عمليات إعادة تشغيل الجهاز أثناء التشغيل التجريبي وتُبلغ عنها حسب السبب وعدد المرات.
RemoteTestTimeOutEnforcer	برامج معالجة الأحداث التي تتيح التحقّق من وقت تنفيذ إعداد اختبار معيّن وإيقافه إذا تجاوز المهلة المحدّدة.
ReportPassedTests	الإبلاغ في ملف عن الفلاتر المحتملة لاستبعاد الاختبارات الناجحة
ResultAggregator	معالج خاص يعرض النتائج المجمّعة عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتّخاذها.
ResultAndLogForwarder	أداة إعادة التوجيه للنتائج وأحداث السجلات
ResultDBReporter	أداة إعداد تقارير النتائج التي تحمّل نتائج الاختبار إلى ResultDB.
ResultReporter
RetryLogSaverResultForwarder	دالة إعادة توجيه تعالج أيضًا تمرير المحاولة الحالية التي نحن بصددها.
RuntimeRestartCollector	أداة جمع تجمع الطوابع الزمنية لعمليات إعادة التشغيل أثناء وقت التشغيل (تعطُّل خادم النظام) أثناء تنفيذ الاختبار، إن وُجدت.
ScreenRecordOnFailureCollector	أداة تجميع ستسجّل لقطة شاشة وتدوّنها عند تعذُّر تنفيذ حالة اختبار.
ScreenshotOnFailureCollector	أداة تجميع ستلتقط لقطة شاشة وتسجّلها عند تعذُّر إحدى حالات الاختبار.
ShardListener	`ITestInvocationListener` يجمع النتائج من جزء من عملية الاستدعاء (يُعرف أيضًا باسم تقسيم عملية الاستدعاء لتنفيذها على موارد متعددة بالتوازي)، ويعيد توجيهها إلى مستمع آخر.
ShardMainResultForwarder	`ResultForwarder` يجمع نتائج عمليات استدعاء الاختبارات المجزأة.
ShowmapPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منها.
SimpleperfProfilePostProcessor	معالج لاحق يعثر على بيانات تحديد الأداء في simpleperf وينشئ ملف تعريف pprof.
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 بالاستماع إلى وقت حفظ ملفات السجلّ.

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

يجب أن تكون الفئات التي تنفّذ هذه الواجهة على دراية بأنّه سيتم استدعاء testLogSaved(String,LogDataType,InputStreamSource,LogFile) كلّما تم استدعاء ITestInvocationListener.testLog(String,LogDataType,InputStreamSource).

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

ملخّص

الإجراءات العامة
`default void`	`logAssociation(String dataName, LogFile logFile)` في بعض الحالات، يجب أن يكون السجلّ مرتبطًا بشكل كبير بحالات الاختبار، ولكن لا يمكن إجراء ذلك في معاودة الاتصال المباشرة `testLogSaved(String,LogDataType,InputStreamSource,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,LogDataType,InputStreamSource,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` الذي يحتوي على البيانات الوصفية للملف المحفوظ