ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

java.lang.Object
↳ com.android.tradefed.result.proto.ProtoResultReporter

يقوم مراسل النتائج ببناء نموذج TestRecord مع جميع النتائج بداخله. يجب أن يتم توسيعه للتعامل مع ما يجب فعله بالنموذج الأولي النهائي في processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord) .

ملخص
المقاولين العامة
ProtoResultReporter ()
الأساليب العامة
final void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationSkipped ( SkipReason reason)

يُبلغ عن استدعاء تم تخطيه

final void invocationStarted ( IInvocationContext context)

تقارير بداية استدعاء الاختبار.

final void logAssociation (String dataName, LogFile logFile)

في بعض الحالات، يجب أن يرتبط السجل بقوة بحالات الاختبار، ولكن تكون الفرصة متاحة للقيام بذلك من خلال testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) رد الاتصال testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) غير ممكن.

void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

استخدم سجل الاستدعاء لإرسال كافة السجلات النهائية للاستدعاء واحدًا تلو الآخر.

void processFinalProto (TestRecordProto.TestRecord finalRecord)

التعامل مع النموذج النهائي مع جميع النتائج.

void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

تم التعامل مع النموذج الأولي لسجل اختبار الاستدعاء الجزئي بعد invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

تم التعامل مع النموذج الأولي لسجل حالة الاختبار النهائي بعد حدوث ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

تم التعامل مع النموذج الأولي لسجل حالة الاختبار الجزئي بعد testStarted(com.android.tradefed.result.TestDescription, long) .

void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

تم التعامل مع النموذج الأولي لسجل الوحدة النمطية بعد حدوث testModuleEnded() .

void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

تم التعامل مع النموذج الأولي لسجل الوحدة الجزئية بعد حدوث testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

معالجة النموذج الأولي لسجل التشغيل النهائي بعد حدوث ERROR(/#testRunEnded(long,HashMap)) .

void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

معالجة النموذج الأولي لسجل التشغيل الاختباري الجزئي بعد حدوث testRunStarted(String, int) .

void setGranularResults (boolean granularResults)
void setInlineRecordOfChildren (boolean inline)
boolean supportGranularResults ()

يُرجع صحيحًا إذا كان المُبلغ يدعم النتائج التفصيلية، ويُرجع خطأ بخلاف ذلك.

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)) حيث يمكننا تحديد وقت الانتهاء مباشرة.

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.Ignore.

final void testModuleEnded ()

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

final void testModuleStarted ( IInvocationContext moduleContext)

يُبلغ عن بداية تشغيل الوحدة النمطية.

final void testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics)

تقارير نهاية التشغيل التجريبي.

final void testRunFailed ( FailureDescription failure)

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

final void testRunFailed (String errorMessage)

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

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

يُعلن عن بداية التشغيل التجريبي.

final void testRunStarted (String runName, int testCount)

يُعلن عن بداية التشغيل التجريبي.

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

يُعلن عن بداية التشغيل التجريبي.

final void testSkipped ( TestDescription test, SkipReason reason)

يتم استدعاؤه عند تخطي الاختبار وعدم تنفيذه لسبب غير متوقع عادةً.

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)

تقارير بداية حالة اختبار فردية.

الأساليب المحمية
TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

ينشئ مرجعًا تابعًا للوحدة النمطية.

المقاولين العامة
ProtoResultReporter
public ProtoResultReporter ()

الأساليب العامة
انتهت الدعوة
public final void invocationEnded (long elapsedTime)

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

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

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

فشل الاستدعاء
public void invocationFailed (FailureDescription failure)

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

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

حدود
failure FailureDescription : FailureDescription الذي يصف سبب الفشل

فشل الاستدعاء
public void invocationFailed (Throwable cause)

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

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

حدود
cause Throwable : السبب Throwable للفشل

invocationSkipped
public void invocationSkipped (SkipReason reason)

يُبلغ عن استدعاء تم تخطيه

حدود
reason SkipReason

invocationStarted
public final void invocationStarted (IInvocationContext context)

تقارير بداية استدعاء الاختبار.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation. يحتاج المراسلون إلى تجاوز هذه الطريقة لدعم التقارير على أجهزة متعددة.

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

logAssociation
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) رد الاتصال testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) غير ممكن. وبالتالي، يسمح رد الاتصال هذا بتوفير ارتباط قوي بشكل صريح.

حدود
dataName String : اسم البيانات

logFile LogFile : LogFile الذي تم تسجيله من قبل ويجب أن يرتبط بحالة الاختبار.

ProcessFinalInvocationLogs
public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

استخدم سجل الاستدعاء لإرسال كافة السجلات النهائية للاستدعاء واحدًا تلو الآخر.

حدود
invocationLogs TestRecordProto.TestRecord : النموذج النهائي الذي يمثل الاستدعاء.

this.processFinalProto
public void processFinalProto (TestRecordProto.TestRecord finalRecord)

التعامل مع النموذج النهائي مع جميع النتائج.

حدود
finalRecord TestRecordProto.TestRecord : النموذج الأولي النهائي مع جميع نتائج الاستدعاء.

this.processStartInvocation
public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

تم التعامل مع النموذج الأولي لسجل اختبار الاستدعاء الجزئي بعد invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

حدود
invocationStartRecord TestRecordProto.TestRecord : النموذج الأولي الجزئي الذي يتم ملؤه بعد بدء الاستدعاء.

invocationContext IInvocationContext : الاستدعاء IInvocationContext .

this.processTestCaseEnded
public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

تم التعامل مع النموذج الأولي لسجل حالة الاختبار النهائي بعد حدوث ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

حدود
testCaseRecord TestRecordProto.TestRecord : النموذج الأولي النهائي الذي يمثل حالة اختبار.

this.processTestCaseStarted
public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

تم التعامل مع النموذج الأولي لسجل حالة الاختبار الجزئي بعد testStarted(com.android.tradefed.result.TestDescription, long) .

حدود
testCaseStartedRecord TestRecordProto.TestRecord : النموذج الجزئي الذي يمثل حالة الاختبار.

ProcessTestModuleEnd
public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

تم التعامل مع النموذج الأولي لسجل الوحدة النمطية بعد حدوث testModuleEnded() .

حدود
moduleRecord TestRecordProto.TestRecord : النموذج النهائي الذي يمثل الوحدة.

ProcessTestModuleStarted
public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

تم التعامل مع النموذج الأولي لسجل الوحدة الجزئية بعد حدوث testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

حدود
moduleStartRecord TestRecordProto.TestRecord : النموذج الجزئي الذي يمثل الوحدة.

this.processTestRunEnded
public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

معالجة النموذج الأولي لسجل التشغيل النهائي بعد حدوث ERROR(/#testRunEnded(long,HashMap)) .

حدود
runRecord TestRecordProto.TestRecord : النموذج الأولي النهائي الذي يمثل التشغيل.

moduleInProgress boolean : ما إذا كانت الوحدة قيد التقدم أم لا.

عمليةTestRunStarted
public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

معالجة النموذج الأولي لسجل التشغيل الاختباري الجزئي بعد حدوث testRunStarted(String, int) .

حدود
runStartedRecord TestRecordProto.TestRecord : النموذج الجزئي الذي يمثل التشغيل.

setGranularResults
public void setGranularResults (boolean granularResults)

حدود
granularResults boolean

setInlineRecordOfChildren
public void setInlineRecordOfChildren (boolean inline)

حدود
inline boolean

supportGranularResults
public boolean supportGranularResults ()

يُرجع صحيحًا إذا كان المُبلغ يدعم النتائج التفصيلية، ويُرجع خطأ بخلاف ذلك.

عائدات
boolean

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 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 : تتبع مكدس الفشل

testIgnored
public final void testIgnored (TestDescription test)

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

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

testModuleEnded
public final void testModuleEnded ()

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

testModuleStarted
public final void testModuleStarted (IInvocationContext moduleContext)

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

حدود
moduleContext IInvocationContext : IInvocationContext للوحدة.

testRunEnded
public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

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

فشل تشغيل الاختبار
public final void testRunFailed (FailureDescription failure)

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

حدود
failure FailureDescription : FailureDescription الذي يصف الفشل وسياقه.

فشل تشغيل الاختبار
public final void testRunFailed (String errorMessage)

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

حدود
errorMessage String : String تصف سبب فشل التشغيل.

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

يُعلن عن بداية التشغيل التجريبي.

حدود
runName String : اسم التشغيل التجريبي

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

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

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

يُعلن عن بداية التشغيل التجريبي.

حدود
runName String : اسم التشغيل التجريبي

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

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

يُعلن عن بداية التشغيل التجريبي.

حدود
runName String : اسم التشغيل التجريبي

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

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

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

testSkipped
public final void testSkipped (TestDescription test, 
                SkipReason reason)

يتم استدعاؤه عند تخطي الاختبار وعدم تنفيذه لسبب غير متوقع عادةً. ستتم محاولة إعادة هذه الاختبارات لمحاولة الحصول على التنفيذ المناسب.

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

reason SkipReason : SkipReason

testStarted
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()

testStarted
public final void testStarted (TestDescription test)

تقارير بداية حالة اختبار فردية. الواجهة الأقدم، يجب أن تستخدم testStarted(com.android.tradefed.result.TestDescription) كلما أمكن ذلك.

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

الأساليب المحمية
createModuleChildReference
protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

ينشئ مرجعًا تابعًا للوحدة النمطية.

حدود
record TestRecordProto.TestRecord

عائدات
TestRecordProto.ChildReference