EventsLoggerListener

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 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) رد الاتصال 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) 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) 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 : الوقت المنقضي للاستدعاء في مللي ثانية

فشل الاستدعاء

public void invocationFailed (FailureDescription failure)

يُبلغ عن استدعاء غير مكتمل بسبب بعض حالات الخطأ.

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

حدود
failure FailureDescription : FailureDescription الذي يصف سبب الفشل

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) رد الاتصال 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 الذي يصف الفشل وسياقه.

انتهى الاختبار

public 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 testFailed (TestDescription test, 
                FailureDescription failure)

الإبلاغ عن فشل حالة اختبار فردية.

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

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

failure FailureDescription : FailureDescription الذي يصف الفشل وسياقه.

فشل الاختبار

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

تقارير نهاية تشغيل الوحدة النمطية.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

حدود
moduleContext IInvocationContext : IInvocationContext للوحدة.

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

تقارير نهاية التشغيل التجريبي. إصلاح: لا يمكن أن يكون لدينا واجهتان Map<> بنوع مختلف، لذا يتعين علينا استخدام HashMap هنا.

حدود
elapsedTimeMillis long : أبلغ الجهاز عن الوقت المنقضي، بالمللي ثانية

runMetrics : أزواج القيمة الرئيسية التي تم الإبلاغ عنها في نهاية التشغيل التجريبي باستخدام Metric .

فشل تشغيل الاختبار

public void testRunFailed (FailureDescription failure)

فشل تشغيل اختبار التقارير في الاكتمال بسبب الفشل الموصوف بواسطة FailureDescription .

حدود
failure FailureDescription : FailureDescription الذي يصف الفشل وسياقه.

فشل تشغيل الاختبار

public void testRunFailed (String errorMessage)

فشل تشغيل اختبار التقارير بسبب حدوث خطأ فادح.

حدود
errorMessage String : String تصف سبب فشل التشغيل.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

يُعلن عن بداية التشغيل التجريبي.

حدود
runName String : اسم التشغيل التجريبي

testCount int : العدد الإجمالي للاختبارات في التشغيل التجريبي

attemptNumber int : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 0 ويجب أن يتزايد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال، تتم إعادة محاولة الاختبار 3 مرات، ويجب أن يحتوي على 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 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 : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 0 ويجب أن يتزايد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال، تتم إعادة محاولة الاختبار 3 مرات، ويجب أن يحتوي على 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.

startTime long : الوقت الذي بدأ فيه التشغيل، ويتم قياسه عبر System.currentTimeMillis()

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

reason SkipReason : SkipReason

testStarted

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