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

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

BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

java.lang.Object
↳	com.android.tradefed.postprocessor.BasePostProcessor

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

AggregatePostProcessor وAveragePostProcessor وMetricFilePostProcessor

AggregatePostProcessor	مجمّع مقاييس يقدّم الحدّ الأدنى والحدّ الأقصى والمتوسّط والتباين والانحراف المعياري والإجمالي والعدد والنسب المئوية اختياريًا للمقاييس الرقمية التي يتم جمعها أثناء عمليات تنفيذ الاختبار المتكرّرة، ويتعامل معها على أنّها أعداد مزدوجة.
AveragePostProcessor	تنفيذ وحدة معالجة ما بعد المعالجة التي تحسب متوسّط قائمة المقاييس
MetricFilePostProcessor	يُستخدَم لتحميل ملف سجلّ المقاييس الذي تم جمعه أثناء مستوى الاختبار والتنفيذ.

القاعدة IPostProcessor التي يجب أن تمتد إليها كل عملية تنفيذ تأكَّد من استدعاء طرق المعالجة بعد قبل أدوات إعداد تقارير النتائج النهائية.

ملخّص

وظائف الإنشاء العامة
`BasePostProcessor()`

الطرق العامة
`final ITestInvocationListener`	`init(ITestInvocationListener listener)` خطوة الإعداد لمحرر الصور.
`final void`	`invocationEnded(long elapsedTime)`
`final void`	`invocationFailed(FailureDescription failure)`
`final void`	`invocationFailed(Throwable cause)`
`final void`	`invocationStarted(IInvocationContext context)` أدوات معالجة أحداث الاستدعاء لإعادة التوجيه
`final boolean`	`isDisabled()` تعرِض True إذا كان العنصر بأكمله غير مفعَّل (يتم تخطّي كلّ من الإعداد والتفكيك).
`final void`	`logAssociation(String dataName, LogFile logFile)` تعديل عملية ربط السجلّ بالاختبار
	`processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)` يمكنك تنفيذ هذه الطريقة لتجميع المقاييس والسجلات في جميع الاختبارات.
`abstract`	`processRunMetricsAndLogs( rawMetrics, runLogs)` يمكنك تنفيذ هذه الطريقة لإنشاء مجموعة من المقاييس الجديدة من المقاييس الحالية وملفّات log.
	`processTestMetricsAndLogs(TestDescription testDescription, testMetrics, testLogs)` يمكنك تنفيذ هذه الطريقة لنشر المقاييس والسجلّات من كل اختبار.
`final void`	`setLogSaver(ILogSaver logSaver)`
`final void`	`testAssumptionFailure(TestDescription test, String trace)`
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`final void`	`testEnded(TestDescription test, testMetrics)`
`final void`	`testFailed(TestDescription test, FailureDescription failure)`
`final void`	`testFailed(TestDescription test, String trace)`
`final void`	`testIgnored(TestDescription test)`
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` استخدِم هذه الطريقة لتسجيل ملف من عملية تنفيذ PostProcessor.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`final void`	`testModuleEnded()`
`final void`	`testModuleStarted(IInvocationContext moduleContext)`
`final void`	`testRunEnded(long elapsedTime, runMetrics)`
`final void`	`testRunFailed(FailureDescription failure)`
`final void`	`testRunFailed(String errorMessage)`
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)`
`final void`	`testRunStarted(String runName, int testCount)` طلبات معاودة الاتصال في اختبار التنفيذ
`final void`	`testRunStopped(long elapsedTime)`
`final void`	`testStarted(TestDescription test, long startTime)`
`final void`	`testStarted(TestDescription test)` طلبات معاودة الاتصال لحالات الاختبار

الطرق المحمية
`MetricMeasurement.DataType`	`getMetricType()` يمكنك إلغاء هذه الطريقة لتغيير نوع المقياس إذا لزم الأمر.
`String`	`getRunName()`

وظائف الإنشاء العامة

BasePostProcessor

public BasePostProcessor ()

الطرق العامة

init

public final ITestInvocationListener init (ITestInvocationListener listener)

خطوة الإعداد لمحرر الصور. يتم ضمان استدعائه قبل أي من اختبارات callbacks.

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

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

invocationEnded

public final void invocationEnded (long elapsedTime)

المعلمات
`elapsedTime`	`long`

invocationFailed

public final void invocationFailed (FailureDescription failure)

المعلمات
`failure`	`FailureDescription`

invocationFailed

public final void invocationFailed (Throwable cause)

المعلمات
`cause`	`Throwable`

invocationStarted

public final void invocationStarted (IInvocationContext context)

أدوات معالجة أحداث الاستدعاء لإعادة التوجيه

المعلمات
`context`	`IInvocationContext`

isDisabled

public final boolean isDisabled ()

تعرِض True إذا كان العنصر بأكمله غير مفعَّل (يتم تخطّي كلّ من الإعداد والتفكيك). خطأ بخلاف ذلك.

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

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

تعديل عملية ربط السجلّ بالاختبار إذا تمّ استدعاء هذه الطريقة أثناء الاختبار، يعني ذلك أنّ السجلّ belongs to the test، وإلا سيكون سجلّ تشغيل.

المعلمات
`dataName`	`String`
`logFile`	`LogFile`

processAllTestMetricsAndLogs

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

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

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

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

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

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

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

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

processTestMetricsAndLogs

public  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

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

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

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

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

المعلمات
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

المعلمات
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

المعلمات
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

المعلمات
`test`	`TestDescription`
`testMetrics`

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

المعلمات
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public final void testFailed (TestDescription test, 
                String trace)

المعلمات
`test`	`TestDescription`
`trace`	`String`

testIgnored

public final void testIgnored (TestDescription test)

المعلمات
`test`	`TestDescription`

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

استخدِم هذه الطريقة لتسجيل ملف من عملية تنفيذ PostProcessor.

المعلمات
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

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

المعلمات
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testModuleEnded

public final void testModuleEnded ()

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

المعلمات
`moduleContext`	`IInvocationContext`

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

المعلمات
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public final void testRunFailed (FailureDescription failure)

المعلمات
`failure`	`FailureDescription`

testRunFailed

public final void testRunFailed (String errorMessage)

المعلمات
`errorMessage`	`String`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

المعلمات
`runName`	`String`
`testCount`	`int`
`attemptNumber`	`int`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

طلبات معاودة الاتصال في اختبار التنفيذ

المعلمات
`runName`	`String`
`testCount`	`int`

testRunStopped

public final void testRunStopped (long elapsedTime)

المعلمات
`elapsedTime`	`long`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

المعلمات
`test`	`TestDescription`
`startTime`	`long`

testStarted

public final void testStarted (TestDescription test)

طلبات معاودة الاتصال لحالات الاختبار

المعلمات
`test`	`TestDescription`

الطرق المحمية

getMetricType

protected MetricMeasurement.DataType getMetricType ()

يمكنك إلغاء هذه الطريقة لتغيير نوع المقياس إذا لزم الأمر. يتم ضبط المقياس تلقائيًا على نوع تمّت معالجته.

المرتجعات
`MetricMeasurement.DataType`

getRunName

protected String getRunName ()

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