جهاز استقبال ITestLifeCycleRecipient
public
interface
ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
يتلقى إشعارات الأحداث أثناء عمليات تشغيل اختبار قياس حالة التطبيق
نمط بعد org.junit.runner.notification.RunListener
سيكون تسلسل المكالمات كما يلي:
- أمر testRunStarted
- تم بدء الاختبار
- [تعذّر الاختبار]
- [testAssumptionFailure]
- [تم تجاهله]
- انتهى الاختبار
- ....
- [فشل اختبار التشغيل]
- اختبار RunEnded
ملخّص
الطرق العامة | |
---|---|
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.تجاهل. |
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)
تعمل على الإبلاغ عن بداية حالة اختبار فردية. |
الطرق العامة
تعذُّر اختبار الافتراض
public void testAssumptionFailure (TestDescription test, String trace)
يتم استدعاؤه عندما يُبلغ الاختبار الذري عن أنه يفترض شرطًا خاطئًا
المعلمات | |
---|---|
test |
TestDescription : يحدد الاختبار |
trace |
String : تتبع تسلسل استدعاء الدوال البرمجية للفشل |
تعذُّر اختبار الافتراض
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 testEnded (TestDescription test,testMetrics)
تعمل هذه السياسة على الإبلاغ عن نهاية تنفيذ حالة اختبار فردية.
إذا لم يتم استدعاء الدالة testFailed(TestDescription, FailureDescription)
، يعني ذلك أنّه تم اجتياز هذا الاختبار. يتم أيضًا عرض أي مفتاح/قيمة
المقاييس التي ربما تكون قد ظهرت أثناء تنفيذ حالة الاختبار.
المعلمات | |
---|---|
test |
TestDescription : يحدد الاختبار |
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 : تتبع تسلسل استدعاء الدوال البرمجية للفشل |
تم تجاهل الاختبار
public void testIgnored (TestDescription test)
يتم استدعاء هذا الإجراء عندما لا يتم إجراء الاختبار، وعادةً ما يكون هناك تعليق توضيحي لطريقة الاختبار org.junit.تجاهل.
المعلمات | |
---|---|
test |
TestDescription : يحدد الاختبار |
اختبار RunEnded
public void testRunEnded (long elapsedTimeMillis,runMetrics)
نهاية تشغيل اختبار التقارير فيكس: لا يمكننا استخدام خريطتين<> وواجهات برمجة تطبيقات من نوع مختلف، لذلك ينبغي لنا استخدام 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 : رقم الطلب، مع تحديد المحاولات المختلفة لعملية 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 نفسها
يتم تشغيلها عدة مرات. تكون محاولة الحساب مفهرسة بمقدار 0 ويجب أن تزيد في كل مرة
تشغيل جديد. مثلاً: تتم إعادة محاولة الاختبار بدقة 3 مرات، ومن المفترض أن يتضمن إجمالي 4 نقاط.
تحت نفس runName ، ويتراوح عدد المحاولة بين 0 و3. |
startTime |
long : وقت بدء الجري، ويتم قياسه من خلال System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
تم إيقاف تشغيل اختبار التقارير قبل اكتماله بسبب طلب من المستخدم.
قائمة المهام: غير مستخدمة حاليًا، يمكنك إزالتها
المعلمات | |
---|---|
elapsedTime |
long : الوقت المنقضي الذي تم الإبلاغ عنه للجهاز، بالمللي ثانية |
تم تخطي الاختبار
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() |
تم بدء الاختبار
public void testStarted (TestDescription test)
تعمل على الإبلاغ عن بداية حالة اختبار فردية. واجهة قديمة، ويجب استخدام testStarted(com.android.tradefed.result.TestDescription)
كلما أمكن ذلك.
المعلمات | |
---|---|
test |
TestDescription : يحدد الاختبار |