ProtoResultReporter

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

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

الفئات الفرعية المباشرة المعروفة FileProtoResultReporter ، StreamProtoResultReporter FileProtoResultReporter مراسل أولي يقوم بتفريغ TestRecord في ملف. StreamProtoResultReporter تنفيذ 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) في بعض الحالات ، يجب أن يكون السجل مرتبطًا بقوة بحالات الاختبار ، ولكن الفرصة للقيام بذلك في 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. تجاهل.
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	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 الفشل

بدأ الاحتجاج

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 : الوقت الذي انتهى فيه الاختبار ، والذي تم قياسه عبر 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 : 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 : الوقت الذي بدأ فيه التشغيل ، ويتم قياسه عبر 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 : الوقت الذي بدأ فيه الاختبار ، ويتم قياسه عبر 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