ITestLifeCycleReceiver
public
interface
ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
تتلقّى إشعارات بالأحداث أثناء عمليات تشغيل اختبارات الأدوات.
تم وضع نموذج لها استنادًا إلى org.junit.runner.notification.RunListener
سيكون تسلسل المكالمات على النحو التالي:
- testRunStarted
- testStarted
- [تعذّر الاختبار]
- [testAssumptionFailure]
- [تم تجاهله]
- testEnded
- ....
- [فشل اختبار التشغيل]
- testRunEnded
ملخّص
الطرق العامة | |
---|---|
default
void
|
testAssumptionFailure(TestDescription test, String trace)
يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح. |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح. |
default
void
|
testEnded(TestDescription test, long endTime,
بديل |
default
void
|
testEnded(TestDescription test,
تعمل هذه السياسة على الإبلاغ عن نهاية تنفيذ حالة اختبار فردية. |
default
void
|
testFailed(TestDescription test, FailureDescription failure)
الإبلاغ عن تعذُّر حالة اختبار فردية |
default
void
|
testFailed(TestDescription test, String trace)
الإبلاغ عن تعذُّر اختبار فردي |
default
void
|
testIgnored(TestDescription test)
يتم استدعاء هذه الوظيفة عندما لا يتم إجراء الاختبار، وعادةً ما يكون ذلك بسبب إضافة تعليقات توضيحية إلى طريقة الاختبار باستخدام org.junit.ignore. |
default
void
|
testRunEnded(long elapsedTimeMillis,
الإبلاغ عن نهاية عملية الاختبار |
default
void
|
testRunFailed(FailureDescription failure)
تعذّر إكمال تشغيل اختبار التقارير بسبب تعذُّر وصفه من قِبل |
default
void
|
testRunFailed(String errorMessage)
تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
الإبلاغ عن بدء عملية تنفيذ اختبار |
default
void
|
testRunStarted(String runName, int testCount)
الإبلاغ عن بدء عملية تنفيذ اختبار |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
الإبلاغ عن بدء عملية اختبار |
default
void
|
testRunStopped(long elapsedTime)
توقّف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب أحد المستخدِمين. |
default
void
|
testSkipped(TestDescription test, SkipReason reason)
يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً. |
default
void
|
testStarted(TestDescription test, long startTime)
بديل |
default
void
|
testStarted(TestDescription test)
تعمل على الإبلاغ عن بداية حالة اختبار فردية. |
الطرق العامة
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
يتم استدعاء هذه الوظيفة عندما يُبلغ الاختبار الذري عن أنها تفترض حالة خاطئة
المعلمات | |
---|---|
test |
TestDescription : يحدد الاختبار |
trace |
String : تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ |
تعذُّر اختبار الافتراض
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) من المقاييس التي تمّ قياسها |
testEnded
public void testEnded (TestDescription test,testMetrics)
تعمل هذه السياسة على الإبلاغ عن نهاية تنفيذ حالة اختبار فردية.
إذا لم يتمّ استدعاء testFailed(TestDescription, FailureDescription)
، يعني ذلك أنّ هذا الاختبار قد اجتاز. تُرجِع أيضًا أي مقاييس مفتاح/قيمة
قد تم إصدارها أثناء تنفيذ نموذج الاختبار.
المعلمات | |
---|---|
test |
TestDescription : يحدد الاختبار |
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 : تتبع تسلسل استدعاء الدوال البرمجية للفشل |
تم تجاهل الاختبار
public void testIgnored (TestDescription test)
يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة @org.junit.Ignore.
المعلمات | |
---|---|
test |
TestDescription : لتحديد الاختبار |
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 : رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل
الذي تم تنفيذه عدّة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد كلّ مرّة تتم فيها عملية
تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عدد
عمليات التشغيل 4 عمليات ضمن اسم التشغيل نفسه وأن تتراوح مَعلمة attemptNumber بين 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 عمليات تشغيل بشكل إجمالي
ضمن اسم runName نفسه، وأن يتراوح عدد المحاولات من 0 إلى 3. |
startTime |
long : وقت بدء التنفيذ، يتم قياسه من خلال System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
توقّف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب أحد المستخدِمين.
TODO: currently unused, consider removing
المعلمات | |
---|---|
elapsedTime |
long : الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية |
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() |
testStarted
public void testStarted (TestDescription test)
الإبلاغ عن بدء حالة اختبار فردية واجهة قديمة، يجب استخدام testStarted(com.android.tradefed.result.TestDescription)
كلما أمكن.
المعلمات | |
---|---|
test |
TestDescription : لتحديد الاختبار |