أداة إعداد سجلّ الأحداث

public class EventsLoggerListener
extends Object implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.EventsLoggerListener

---

مستمع يسجِّل جميع الأحداث التي يتلقّاها في ملف

ملخّص

وظائف الإنشاء العامة
EventsLoggerListener(String name)

الطرق العامة
File	getLoggedEvents()
void	invocationEnded(long elapsedTime) تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.
void	invocationFailed(FailureDescription failure) تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.
void	invocationSkipped(SkipReason reason) الإبلاغ عن طلب استدعاء كطلب تم تخطّيه
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	testAssumptionFailure(TestDescription test, String trace) يتم استدعاؤه عندما يُبلغ الاختبار الذري عن أنه يفترض شرطًا خاطئًا
void	testAssumptionFailure(TestDescription test, FailureDescription failure) يتم استدعاؤه عندما يُبلغ الاختبار الذري عن أنه يفترض شرطًا خاطئًا
void	testEnded(TestDescription test, long endTime, testMetrics) بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً.
void	testFailed(TestDescription test, FailureDescription failure) الإبلاغ عن تعذُّر اختبار فردي
void	testFailed(TestDescription test, String trace) الإبلاغ عن تعذُّر اختبار فردي
void	testIgnored(TestDescription test) يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.
void	testModuleEnded() الإبلاغ عن نهاية تشغيل وحدة
void	testModuleStarted(IInvocationContext moduleContext) الإبلاغ عن بدء تشغيل وحدة
void	testRunEnded(long elapsedTimeMillis, runMetrics) الإبلاغ عن نهاية عملية الاختبار
void	testRunFailed(FailureDescription failure) تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ وصفه FailureDescription.
void	testRunFailed(String errorMessage) تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح.
void	testRunStarted(String runName, int testCount, int attemptNumber) الإبلاغ عن بدء عملية تنفيذ اختبار
void	testRunStarted(String runName, int testCount) الإبلاغ عن بدء عملية تنفيذ اختبار
void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) الإبلاغ عن بدء عملية تنفيذ اختبار
void	testSkipped(TestDescription test, SkipReason reason) يتمّ استدعاء هذه الدالة عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً.
void	testStarted(TestDescription test, long startTime) بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار ، مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لإجراء قياس دقيق.

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

EventsLoggerListener

public EventsLoggerListener (String name)

المعلمات
name	String

الطرق العامة

getLoggedEvents

public File getLoggedEvents ()

المرتجعات
File

تم إنهاء الاستدعاء

public void invocationEnded (long elapsedTime)

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

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

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

invocationFailed

public void invocationFailed (FailureDescription failure)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

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

المعلمات
failure	FailureDescription: FailureDescription الذي يصف سبب التعذُّر

invocationSkipped

public void invocationSkipped (SkipReason reason)

الإبلاغ عن طلب استدعاء كطلب تم تخطّيه

المعلمات
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

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

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

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

ارتباط لوغاريتمي

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.

المعلمات
test	TestDescription: لتحديد الاختبار
trace	String: تتبع تسلسل استدعاء الدوال البرمجية للفشل

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.

المعلمات
test	TestDescription: لتحديد الاختبار
failure	FailureDescription: FailureDescription لوصف الخطأ وسياقه

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بين السمتَين testStarted(com.android.tradefed.result.TestDescription, long) وtestStarted(com.android.tradefed.result.TestDescription, long) لقياس الأداء بدقة.

المعلمات
test	TestDescription: لتحديد الاختبار
endTime	long: وقت انتهاء الاختبار، ويتم قياسه من خلال System.currentTimeMillis()
testMetrics	: ERROR(/Map) من المقاييس المنبعثة

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

الإبلاغ عن تعذُّر اختبار فردي

سيتمّ استدعاؤه بين testStarted وtestEnded.

المعلمات
test	TestDescription: لتحديد الاختبار
failure	FailureDescription: FailureDescription لوصف الخطأ وسياقه

testFailed

public void testFailed (TestDescription test, 
                String trace)

الإبلاغ عن تعذُّر اختبار فردي

سيتمّ استدعاؤه بين testStarted وtestEnded.

المعلمات
test	TestDescription: لتحديد الاختبار
trace	String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testIgnored

public void testIgnored (TestDescription test)

يتم استدعاء هذه الوظيفة عندما لا يتم إجراء الاختبار، وعادةً ما يكون ذلك بسبب إضافة تعليقات توضيحية إلى طريقة الاختبار باستخدام org.junit.ignore.

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

testModuleEnded

public void testModuleEnded ()

الإبلاغ عن نهاية تشغيل وحدة

تم بدء الاختبار

public void testModuleStarted (IInvocationContext moduleContext)

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

المعلمات
moduleContext	IInvocationContext: السمة IInvocationContext في الوحدة

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

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, 
                int attemptNumber)

تبلّغ عن بدء إجراء اختبار.

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

testRunStarted

public 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 نفسها التي يتم تنفيذها عدة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد في كلّ مرّة يتمّ فيها تنفيذ عملية تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عمليات التشغيل التي تمّ إجراؤها 4 مرّات ضمن اسم التشغيل نفسه، ويجب أن تتراوح مَعلمة attemptNumber بين 0 و3.
startTime	long: وقت بدء الجري، ويتم قياسه من خلال System.currentTimeMillis()

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

المعلمات
test	TestDescription: لتحديد الاختبار
reason	SkipReason: SkipReason

تم بدء الاختبار

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