BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

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

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

الفئات الفرعية غير المباشرة المعروفة StatsdBeforeAfterGaugeMetricPostProcessor و StatsdEventMetricPostProcessor StatsdBeforeAfterGaugeMetricPostProcessor معالج ما بعد الذي يعالج مقاييس القياس التي تم جمعها في نهج "قبل / بعد" ، على سبيل المثال StatsdEventMetricPostProcessor معالج ما بعد الذي يعالج مقاييس الأحداث في تقارير الإحصائيات إلى أزواج ذات قيمة رئيسية ، باستخدام المُنسِّقات المحددة في المعالج.

---

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) في بعض الحالات ، يجب أن يكون السجل مرتبطًا بقوة بحالات الاختبار ، ولكن الفرصة للقيام بذلك في testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) غير ممكن. يحدّث تعيين تسجيل الدخول للاختبار.
	processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) نفذ هذه الطريقة لتجميع المقاييس والسجلات عبر جميع الاختبارات.
abstract	processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs) قم بتنفيذ هذه الطريقة من أجل إنشاء مجموعة من المقاييس الجديدة من المقاييس والسجلات الحالية.
	processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) نفذ هذه الطريقة لنشر مقاييس العملية والسجلات من كل اختبار.
final void	setLogSaver ( ILogSaver logSaver) اضبط ILogSaver للسماح للمنفذ بحفظ الملفات.
void	setUp () تجاوز هذه الطريقة في معالجات النشر التابعة للتهيئة قبل تشغيل الاختبار.
final void	testAssumptionFailure ( TestDescription test, String trace) يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ
final void	testAssumptionFailure ( TestDescription test, FailureDescription failure) يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ
final void	testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) بديل لـ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرة.
final void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) يُبلغ عن نهاية تنفيذ حالة اختبار فردية.
final void	testFailed ( TestDescription test, FailureDescription failure) يبلغ عن فشل حالة اختبار فردية.
final void	testFailed ( TestDescription test, String trace) يبلغ عن فشل حالة اختبار فردية.
final void	testIgnored ( TestDescription test) يتم استدعاؤها عندما لا يتم تشغيل الاختبار ، وذلك عمومًا بسبب إضافة تعليق توضيحي على طريقة الاختبار باستخدام org.junit. تجاهل.
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) testRunEnded (long elapsedTime, runMetrics) يبلغ عن نهاية التشغيل التجريبي.
final void	testRunFailed ( FailureDescription failure) فشل تشغيل اختبار التقارير في الإكمال بسبب فشل تم وصفه بواسطة FailureDescription .
final void	testRunFailed (String errorMessage) تقارير فشل التشغيل الاختباري بسبب خطأ فادح.
final void	testRunStarted (String runName, int testCount, int attemptNumber) يعلن عن بدء تشغيل اختباري.
final void	testRunStarted (String runName, int testCount) اختبار تشغيل عمليات الاسترجاعات
final void	testRunStarted (String runName, int testCount, int attemptNumber, long startTime) يعلن عن بدء تشغيل اختباري.
final void	testRunStopped (long elapsedTime) تم إيقاف تشغيل الاختبار التجريبي قبل الإكمال بناءً على طلب المستخدم.
final void	testStarted ( TestDescription test, long startTime) بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدد أيضًا وقت بدء الاختبار ، جنبًا إلى جنب مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لقياس دقيق .
final void	testStarted ( TestDescription test) حالات الاختبار

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

المنشئون العامة

BasePostProcessor

public BasePostProcessor ()

الطرق العامة

فيه

public final ITestInvocationListener init (ITestInvocationListener listener)

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

المعلمات
listener	ITestInvocationListener

عائدات
ITestInvocationListener

انتهى الدعاء

public final void invocationEnded (long elapsedTime)

التقارير التي تفيد بانتهاء الاستدعاء ، سواء بنجاح أو بسبب حالة خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.

المعلمات
elapsedTime	long : الوقت المنقضي للاستدعاء بالمللي ثانية

الدعاء فشل

public final void invocationFailed (FailureDescription failure)

يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.

المعلمات
failure	FailureDescription : وصف FailureDescription في وصف سبب الفشل

الدعاء فشل

public final void invocationFailed (Throwable cause)

يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.

المعلمات
cause	Throwable : Throwable الفشل

بدأ الاحتجاج

public final void invocationStarted (IInvocationContext context)

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

المعلمات
context	IInvocationContext : معلومات حول الاستدعاء

معطل

public final boolean isDisabled ()

إرجاع True إذا تم تعطيل الكائن بالكامل (تخطي كل من الإعداد والتفكيك). خطأ خلاف ذلك.

عائدات
boolean

جمعية السجل

public final 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 الذي تم تسجيله من قبل ويجب أن يكون مرتبطًا بحالة الاختبار.

processAllTestMetricsAndLogs

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

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

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

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

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

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

المعلمات
rawMetrics	: مجموعة المقاييس الأولية المتاحة للتشغيل.
runLogs	: مجموعة ملفات السجل للتشغيل التجريبي.

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

processTestMetricsAndLogs

public  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

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

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

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

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

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

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

اقامة

public void setUp ()

تجاوز هذه الطريقة في معالجات النشر التابعة للتهيئة قبل تشغيل الاختبار.

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 : FailureDescription يصف الفشل وسياقه.

انتهى الاختبار

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

بديل لـ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرة. ادمج مع testStarted(com.android.tradefed.result.TestDescription, long) لقياس دقيق.

المعلمات
test	TestDescription : يحدد الاختبار
endTime	long : الوقت الذي انتهى فيه الاختبار ، والذي تم قياسه عبر System.currentTimeMillis()
testMetrics	: ERROR(/Map) المقاييس المنبعثة

انتهى الاختبار

public final void testEnded (TestDescription test, 
                 testMetrics)

يُبلغ عن نهاية تنفيذ حالة اختبار فردية.

إذا لم يتم استدعاء testFailed(TestDescription, FailureDescription) ، فإن هذا الاختبار نجح. يقوم أيضًا بإرجاع أي مقاييس مفتاح / قيمة قد تكون قد انبعثت أثناء تنفيذ حالة الاختبار.

المعلمات
test	TestDescription : يحدد الاختبار
testMetrics	: ERROR(/Map) المقاييس المنبعثة

فشل الاختبار

public final void testFailed (TestDescription test, 
                FailureDescription failure)

يبلغ عن فشل حالة اختبار فردية.

سيتم استدعاؤه بين testStarted و testEnded.

المعلمات
test	TestDescription : يحدد الاختبار
failure	FailureDescription : FailureDescription يصف الفشل وسياقه.

فشل الاختبار

public final void testFailed (TestDescription test, 
                String trace)

يبلغ عن فشل حالة اختبار فردية.

سيتم استدعاؤه بين testStarted و testEnded.

المعلمات
test	TestDescription : يحدد الاختبار
trace	String : كومة تتبع الفشل

test تم تجاهله

public final void testIgnored (TestDescription test)

يتم استدعاؤها عندما لا يتم تشغيل الاختبار ، وذلك عمومًا بسبب إضافة تعليق توضيحي على طريقة الاختبار باستخدام org.junit. تجاهل.

المعلمات
test	TestDescription : يحدد الاختبار

testLog

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

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

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

testLog تم الحفظ

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

يتم الاتصال به عند حفظ سجل الاختبار.

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

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

انتهى الاختبار

public final void testModuleEnded ()

تقارير نهاية تشغيل الوحدة النمطية.

testModule بدأ

public final void testModuleStarted (IInvocationContext moduleContext)

تقارير بداية تشغيل وحدة نمطية. ترتبط رد الاتصال هذا بـ testModuleEnded() وهي اختيارية في التسلسل. يتم استخدامه فقط أثناء الجري الذي يستخدم الوحدات النمطية: المتسابقون القائمون على الجناح.

المعلمات
moduleContext	IInvocationContext : IInvocationContext للوحدة النمطية.

انتهى الاختبار

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

يبلغ عن نهاية التشغيل التجريبي. FIXME: لا يمكن أن يكون لدينا واجهتان لخريطة <> بنوع مختلف ، لذلك علينا استخدام HashMap هنا.

المعلمات
elapsedTime	long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية
runMetrics	: تم الإبلاغ عن أزواج المفتاح والقيمة في نهاية تشغيل اختباري باستخدام Metric .

testRunFailed

public final void testRunFailed (FailureDescription failure)

فشل تشغيل اختبار التقارير في الإكمال بسبب فشل تم وصفه بواسطة FailureDescription .

المعلمات
failure	FailureDescription : FailureDescription يصف الفشل وسياقه.

testRunFailed

public final void testRunFailed (String errorMessage)

تقارير فشل التشغيل الاختباري بسبب خطأ فادح.

المعلمات
errorMessage	String : String تصف سبب فشل التشغيل.

testRunStarted

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

يعلن عن بدء تشغيل اختباري.

المعلمات
runName	String : اسم التشغيل التجريبي
testCount	int : إجمالي عدد الاختبارات في التشغيل التجريبي
attemptNumber	int : رقم الطلب ، وتحديد المحاولات المختلفة لنفس runName التي يتم تشغيلها عدة مرات. tryNumber هو 0 مفهرس ويجب أن يزداد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال ، تمت إعادة محاولة الاختبار المحبب 3 مرات ، ويجب أن يكون له 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

اختبار تشغيل عمليات الاسترجاعات

المعلمات
runName	String : اسم التشغيل التجريبي
testCount	int : إجمالي عدد الاختبارات في التشغيل التجريبي

testRunStarted

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

يعلن عن بدء تشغيل اختباري.

المعلمات
runName	String : اسم التشغيل التجريبي
testCount	int : إجمالي عدد الاختبارات في التشغيل التجريبي
attemptNumber	int : رقم الطلب ، وتحديد المحاولات المختلفة لنفس runName التي يتم تشغيلها عدة مرات. tryNumber هو 0 مفهرس ويجب أن يزداد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال ، تمت إعادة محاولة الاختبار المحبب 3 مرات ، ويجب أن يكون له 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل وأن يكون رقم المحاولة من 0 إلى 3.
startTime	long : الوقت الذي بدأ فيه التشغيل ، ويتم قياسه عبر System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

تم إيقاف تشغيل الاختبار التجريبي قبل الإكمال بناءً على طلب المستخدم.

TODO: غير مستخدم حاليًا ، جرب الإزالة

المعلمات
elapsedTime	long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية

اختبار

public final void testStarted (TestDescription test, 
                long startTime)

بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدد أيضًا وقت بدء الاختبار ، جنبًا إلى جنب مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لقياس دقيق .

المعلمات
test	TestDescription : يحدد الاختبار
startTime	long : الوقت الذي بدأ فيه الاختبار ، ويتم قياسه عبر System.currentTimeMillis()

اختبار

public final void testStarted (TestDescription test)

حالات الاختبار

المعلمات
test	TestDescription : يحدد الاختبار

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

getMetricType

protected MetricMeasurement.DataType getMetricType ()

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

عائدات
MetricMeasurement.DataType

getRunName

protected String getRunName ()

عائدات
String