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) في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callback المباشر.
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) الإبلاغ عن بدء عملية تنفيذ اختبار

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

ConsoleResultReporter

public ConsoleResultReporter ()

الطرق العامة

invocationEnded

public void invocationEnded (long elapsedTime)

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

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

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

invocationStarted

public void invocationStarted (IInvocationContext context)

الإبلاغ عن بدء استدعاء الاختبار

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في عملية callback المباشرة 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 لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند اكتمال العملية.
logFile	‫LogFile: LogFile الذي يحتوي على البيانات الوصفية للملف المحفوظ

testResult

public void testResult (TestDescription test, 
                TestResult result)

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

testRunEnded

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: إجمالي عدد الاختبارات في اختبار التنفيذ