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

IPostProcessor

public interface IPostProcessor
implements IDisableable, ILogSaverListener, ITestInvocationListener

com.android.tradefed.postprocessor.IPostProcessor

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

‫AggregatePostProcessor وAveragePostProcessor وBasePostProcessor وBluetoothConnectionSuccessRatePostProcessor وMetricFilePostProcessor وPerfettoGenericPostProcessor وPerfettoTracePostProcessor وStatsdBeforeAfterGaugeMetricPostProcessor وStatsdEventMetricPostProcessor وStatsdGenericPostProcessor

AggregatePostProcessor	أداة تجميع المقاييس التي تعرض الحد الأدنى والحد الأقصى والمتوسط والتباين والانحراف المعياري والإجمالي والعدد، بالإضافة إلى النِسَب المئوية الاختيارية للمقاييس الرقمية التي يتم جمعها أثناء عمليات تشغيل الاختبار المتعددة التكرار، مع التعامل معها كأرقام مضاعفة.
AveragePostProcessor	تنفيذ معالج لاحق يحسب متوسط قائمة المقاييس
BasePostProcessor	الفئة الأساسية `IPostProcessor` التي يجب أن يوسّعها كل تنفيذ.
BluetoothConnectionSuccessRatePostProcessor	تنفيذ معالج لاحق يحسب معدّل النجاح لملف تعريف البلوتوث استخدِم "metric-key-match" لتحديد المقاييس التي تحتوي على حالات اتصال البلوتوث في مصفوفة رقمية، مثل [0, 1, 2, 3, 0, 1, 2, 3].
MetricFilePostProcessor	يُستخدَم لتحميل ملف سجلّ المقاييس الذي تمّ جمعه أثناء الاختبار وعلى مستوى التشغيل.
PerfettoGenericPostProcessor	معالج لاحق يعالج ملف perfetto proto للمقاييس النصية/الثنائية إلى أزواج مفتاح/قيمة من خلال توسيع رسائل proto والحقول بشكل متكرر باستخدام قيم السلسلة إلى أن يتم العثور على الحقل الذي يحتوي على قيمة رقمية.
PerfettoTracePostProcessor	معالج لاحق يستردّ ملفات تتبُّع Perfetto من سجلّات الاختبار ويشغّل معالج التتبُّع عليها لإنتاج نموذج أولي لمقياس Perfetto.
StatsdBeforeAfterGaugeMetricPostProcessor	معالج لاحق يعالج مقاييس المقياس التي تم جمعها بطريقة "قبل/بعد"، أي
StatsdEventMetricPostProcessor	معالج لاحق يعالج مقاييس الأحداث في تقارير statsd إلى أزواج المفتاح/القيمة، باستخدام أدوات التنسيق المحدّدة في المعالج.
StatsdGenericPostProcessor	معالج لاحق يعالج تقارير statsd الثنائية بتنسيق proto إلى أزواج مفتاح/قيمة من خلال توسيع التقرير كبنية شجرية.

المعالجات اللاحقة هي عنصر في Trade Federation يهدف إلى السماح بمعالجة المقاييس والسجلات بعد الاختبارات وقبل إعداد تقارير النتائج. يتيح ذلك إجراء بعض عمليات المعالجة اللاحقة للبيانات وتلقّي جميع عناصر result_reporter لها، بدلاً من إجراء المعالجة اللاحقة داخل عنصر result_reporter واحد فقط ومواجهة مشكلة في تمرير البيانات الجديدة.

ملخّص

الطُرق العامة
`abstract ITestInvocationListener`	`init(ITestInvocationListener listener)` خطوة التهيئة لما بعد المعالجة
`abstract`	`processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)` نفِّذ هذه الطريقة لتجميع المقاييس والسجلات في جميع الاختبارات.
`abstract`	`processRunMetricsAndLogs( rawMetrics, runLogs)` نفِّذ هذه الطريقة لإنشاء مجموعة من المقاييس الجديدة من المقاييس والسجلات الحالية.
`abstract`	`processTestMetricsAndLogs(TestDescription testDescription, testMetrics, testLogs)` نفِّذ هذه الطريقة لمعالجة المقاييس والسجلّات من كل اختبار بعد انتهائه.

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

init

public abstract ITestInvocationListener init (ITestInvocationListener listener)

خطوة التهيئة لما بعد المعالجة يجب أن يتم استدعاؤها قبل أي من عمليات معاودة الاتصال الخاصة بالاختبارات.

المعلمات
`listener`	`ITestInvocationListener`

المرتجعات
`ITestInvocationListener`

processAllTestMetricsAndLogs

public abstract  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

نفِّذ هذه الطريقة لتجميع المقاييس والسجلات في جميع الاختبارات. سيتم تسجيل المقاييس الناتجة عن هذه الطريقة على أنّها مقاييس تشغيل. يجب عرض المقاييس التي تم إنشاؤها حديثًا فقط، مع اسم مفتاح فريد (لا يُسمح بتعارض مع المفاتيح الحالية).

المعلمات
`allTestMetrics`	‫`ListMultimap`: HashMultimap يخزّن المقاييس من كل اختبار مجمّعة حسب أسماء المقاييس.
`allTestLogs`	: خريطة تخزّن خريطة كل اختبار لملفات السجلّات التي يتمّ ربطها بأسماء البيانات، باستخدام `TestDescription` لكل اختبار كمفاتيح.

المرتجعات
	مجموعة المقاييس التي تم إنشاؤها حديثًا من جميع مقاييس الاختبار

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

نفِّذ هذه الطريقة لإنشاء مجموعة من المقاييس الجديدة من المقاييس والسجلات الحالية. يجب عرض المقاييس التي تم إنشاؤها حديثًا فقط، مع اسم مفتاح فريد (لا يُسمح بتعارض مع المفاتيح الحالية).

المعلمات
`rawMetrics`	: مجموعة المقاييس الأولية المتاحة لعملية التشغيل
`runLogs`	: مجموعة ملفات السجلّ لتنفيذ الاختبار

المرتجعات
	مجموعة المقاييس التي تم إنشاؤها حديثًا من مقاييس التشغيل

processTestMetricsAndLogs

public abstract  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

نفِّذ هذه الطريقة لمعالجة المقاييس والسجلّات من كل اختبار بعد انتهائه. يجب عرض المقاييس التي تم إنشاؤها حديثًا فقط، مع اسم مفتاح فريد (لا يُسمح بتعارض مع المفاتيح الحالية).

المعلمات
`testDescription`	‫`TestDescription`: عنصر TestDescription الذي يصف الاختبار
`testMetrics`	: مجموعة المقاييس من الاختبار
`testLogs`	: مجموعة الملفات التي تم تسجيلها أثناء الاختبار

المرتجعات
	مجموعة المقاييس التي تم إنشاؤها حديثًا من مقاييس الاختبار