ProtoResultReporter
public abstract class ProtoResultReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Object | |
↳ | com.android.tradefed.result.proto.ProtoResultReporter |
بناء المراسل نتيجة اختبار TestRecord
protobuf مع جميع النتائج في الداخل. يجب أن يتم تمديده للتعامل مع ما يجب القيام به مع البروتو النهائي في processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord)
.
ملخص
المنشأت العامة | |
---|---|
ProtoResultReporter () |
الأساليب العامة | |
---|---|
final void | invocationEnded (long elapsedTime) التقارير التي تفيد بانتهاء الاستدعاء ، سواء بنجاح أو بسبب حالة خطأ ما. |
void | invocationFailed ( FailureDescription failure) يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما. |
void | invocationFailed (Throwable cause) يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما. |
final void | invocationStarted ( IInvocationContext context) يُبلغ عن بدء استدعاء الاختبار. |
final void | logAssociation (String dataName, LogFile logFile) في بعض الحالات ، يجب أن يكون السجل مرتبطًا بقوة بحالات الاختبار ، ولكن الفرصة للقيام بذلك في |
void | processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs) استخدم سجل الاستدعاء لإرسال جميع السجلات النهائية للاستدعاء واحدًا تلو الآخر. |
void | processFinalProto (TestRecordProto.TestRecord finalRecord) التعامل مع البروتو النهائي مع جميع النتائج. |
void | processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) حدثت معالجة أولية لسجل اختبار الاحتجاج الجزئي بعد |
void | processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) حدثت معالجة بروتو سجل حالة الاختبار النهائي بعد |
void | processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) تم التعامل مع سجل حالة الاختبار الجزئي الأولي بعد |
void | processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) تم التعامل مع بروتو سجل الوحدة النهائية بعد إجراء |
void | processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) تم التعامل مع بروتو سجل الوحدة الجزئية بعد |
void | processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) حدث التعامل مع النسخة الأولية لسجل التشغيل النهائي بعد |
void | processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) تم التعامل مع النسخة الأولية لسجل التشغيل التجريبي الجزئي بعد |
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) بديل لـ |
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 | testModuleEnded () تقارير نهاية تشغيل الوحدة النمطية. |
final void | testModuleStarted ( IInvocationContext moduleContext) تقارير بداية تشغيل وحدة نمطية. |
final void | testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) يبلغ عن نهاية التشغيل التجريبي. |
final void | testRunFailed ( FailureDescription failure) فشل تشغيل اختبار التقارير في الإكمال بسبب فشل تم وصفه بواسطة |
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 | testStarted ( TestDescription test, long startTime) بديل عن |
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 : سبب ERROR(/Throwable) للفشل |
بدأ الاحتجاج
public final void invocationStarted (IInvocationContext context)
يُبلغ عن بدء استدعاء الاختبار.
سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation. يحتاج المراسلون إلى تجاوز هذه الطريقة لدعم تقارير الأجهزة المتعددة.
حدود | |
---|---|
context | IInvocationContext : معلومات حول الاستدعاء |
جمعية السجل
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 الذي تم تسجيله من قبل ويجب أن يكون مرتبطًا بحالة الاختبار. |
processFinalInvocationLogs
public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)
استخدم سجل الاستدعاء لإرسال جميع السجلات النهائية للاستدعاء واحدًا تلو الآخر.
حدود | |
---|---|
invocationLogs | TestRecordProto.TestRecord : النسخة الأولية النهائية التي تمثل الاستدعاء. |
معالجة FinalProto
public void processFinalProto (TestRecordProto.TestRecord finalRecord)
التعامل مع البروتو النهائي مع جميع النتائج.
حدود | |
---|---|
finalRecord | TestRecordProto.TestRecord : النسخة الأولية النهائية مع جميع نتائج الاستدعاء. |
processStartInvocation
public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
حدثت معالجة أولية لسجل اختبار الاحتجاج الجزئي بعد invocationStarted(com.android.tradefed.invoker.IInvocationContext)
.
حدود | |
---|---|
invocationStartRecord | TestRecordProto.TestRecord : تم ملء الأولي الجزئي بعد الاستدعاء. |
invocationContext | IInvocationContext : استدعاء IInvocationContext . |
انتهى عملية الاختبار
public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)
حدثت معالجة بروتو سجل حالة الاختبار النهائي بعد ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))
.
حدود | |
---|---|
testCaseRecord | TestRecordProto.TestRecord : النسخة الأولية النهائية التي تمثل حالة اختبار. |
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 : البروتو الجزئي الذي يمثل الوحدة. |
processTestRunEnded
public void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
حدث التعامل مع النسخة الأولية لسجل التشغيل النهائي بعد ERROR(/#testRunEnded(long,HashMap))
.
حدود | |
---|---|
runRecord | TestRecordProto.TestRecord : النسخة الأولية النهائية التي تمثل التشغيل. |
moduleInProgress | boolean : ما إذا كانت الوحدة قيد التقدم أم لا. |
processTestRunStarted
public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)
تم التعامل مع النسخة الأولية لسجل التشغيل التجريبي الجزئي بعد testRunStarted(String, int)
.
حدود | |
---|---|
runStartedRecord | TestRecordProto.TestRecord : يمثل البروتو الجزئي التشغيل. |
setGranularResults
public void setGranularResults (boolean granularResults)
حدود | |
---|---|
granularResults | boolean |
تعيينInlineRecordOfChildren
public void setInlineRecordOfChildren (boolean inline)
حدود | |
---|---|
inline | boolean |
دعم النتائج الحبيبية
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 : الوقت الذي انتهى فيه الاختبار ، تم قياسه عبر ERROR(/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 : كومة تتبع الفشل |
test تم تجاهله
public final void testIgnored (TestDescription test)
يتم استدعاؤه في حالة عدم إجراء اختبار ، بشكل عام بسبب إضافة تعليق توضيحي على طريقة الاختبار باستخدام org.junit. تجاهل.
حدود | |
---|---|
test | TestDescription : يحدد الاختبار |
انتهى الاختبار
public final void testModuleEnded ()
تقارير نهاية تشغيل الوحدة النمطية.
testModule بدأ
public final void testModuleStarted (IInvocationContext moduleContext)
تقارير بداية تشغيل وحدة نمطية. ترتبط رد الاتصال هذا بـ testModuleEnded()
وهي اختيارية في التسلسل. يتم استخدامه فقط أثناء الجري الذي يستخدم الوحدات النمطية: المتسابقون القائمون على الجناح.
حدود | |
---|---|
moduleContext | IInvocationContext : IInvocationContext للوحدة النمطية. |
انتهى الاختبار
public final void testRunEnded (long elapsedTimeMillis,runMetrics)
يبلغ عن نهاية التشغيل التجريبي. FIXME: لا يمكن أن يكون لدينا واجهتان لخريطة <> بنوع مختلف ، لذلك علينا استخدام HashMap هنا.
حدود | |
---|---|
elapsedTimeMillis | long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية |
runMetrics | Metric . |
testRunFailed
public final void testRunFailed (FailureDescription failure)
فشل تشغيل اختبار التقارير في الإكمال بسبب فشل تم وصفه بواسطة FailureDescription
.
حدود | |
---|---|
failure | FailureDescription : FailureDescription يصف الفشل وسياقه. |
testRunFailed
public final void testRunFailed (String errorMessage)
تقارير فشل التشغيل الاختباري بسبب خطأ فادح.
حدود | |
---|---|
errorMessage | String : ERROR(/String) تصف سبب فشل التشغيل. |
testRunStarted
public 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 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 : الوقت الذي بدأ فيه التشغيل ، تم قياسه عبر ERROR(/System#currentTimeMillis()) |
اختبار
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 : الوقت الذي بدأ فيه الاختبار ، تم قياسه عبر ERROR(/System#currentTimeMillis()) |
اختبار
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 |