ConsoleResultReporter

public class ConsoleResultReporter
extends TestResultListener implements ILogSaverListener, ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.TestResultListener
	↳	com.android.tradefed.result.ConsoleResultReporter

---

أداة تسجيل النتائج لطباعة نتائج الاختبار في وحدة التحكّم

تُطبع كل عملية تشغيل اختبار وكل حالة اختبار ومقاييس الاختبار وسجلات الاختبار ومواقع ملفات الاختبار.

ملخّص

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

الطرق العامة
void	invocationEnded(long elapsedTime) تشير هذه العلامة إلى البلاغات التي تفيد بإنهاء الاستدعاء، سواء بنجاح أو بسبب خطأ ما.
void	invocationStarted(IInvocationContext context) الإبلاغ عن بدء استدعاء الاختبار
void	logAssociation(String dataName, LogFile logFile) في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في عملية callback المباشرة testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).
void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) يتمّ استدعاء هذه الدالة عند حفظ سجلّ الاختبار.
void	testResult(TestDescription test, TestResult result)
void	testRunEnded(long elapsedTimeMillis, metrics) الإبلاغ عن نهاية عملية الاختبار
void	testRunFailed(FailureDescription failure) تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ وصفه FailureDescription.
void	testRunFailed(String errorMessage) تعذّر إكمال عملية اختبار التقارير بسبب خطأ فادح.
void	testRunStarted(String runName, int testCount) الإبلاغ عن بدء عملية تنفيذ اختبار

شركة إنشاءات عامة

Console -Reporter

public ConsoleResultReporter ()

الطرق العامة

invocationEnded

public void invocationEnded (long elapsedTime)

تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.

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

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

invocationStarted

public void invocationStarted (IInvocationContext context)

يبلِّغ عن بدء الاستدعاء للاختبار.

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

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

logAssociation

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

testLogSaved

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

يتمّ استدعاء هذه الدالة عند حفظ سجلّ الاختبار.

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

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

testResult

public void testResult (TestDescription test, 
                TestResult result)

المعلمات
test	TestDescription
result	TestResult

اختبار RunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 metrics)

الإبلاغ عن نهاية عملية الاختبار

المعلمات
elapsedTimeMillis	long: الوقت المنقضي الذي تم الإبلاغ عنه للجهاز، بالمللي ثانية
metrics	: أزواج المفتاح/القيمة التي يتم الإبلاغ عنها في نهاية عملية الاختبار

testRunFailed

public void testRunFailed (FailureDescription failure)

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

المعلمات
failure	FailureDescription: FailureDescription لوصف الخطأ وسياقه

testRunFailed

public void testRunFailed (String errorMessage)

تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح.

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

الإبلاغ عن بدء عملية تنفيذ اختبار

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