TestRunResult

public class TestRunResult
extends Object implements ITestRunListener

java.lang.Object
   ↳ com.android.ddmlib.testrunner.TestRunResult

تحتوي على نتائج من عملية اختبار واحدة.

يحتفظ بعدد دقيق من الاختبارات ويتتبّع الاختبارات غير المكتملة.

غير آمن للاستخدام المتزامن يجب استدعاء عمليات معاودة الاتصال test* بالترتيب

ملخّص

الإنشاءات العامة

TestRunResult()

أنشئTestRunResult فارغًا.

الطُرق العامة

getCompletedTests()

تعرض هذه السمة مجموعة الاختبارات المكتملة.

long getElapsedTime()

تعرض هذه السمة الوقت المنقضي الحالي للتنفيذ.

String getName()
int getNumAllFailedTests()

عرض إجمالي عدد الاختبارات التي تعذّر إجراؤها (تعذّر إجراؤها، تعذّر التحقّق من صحة الافتراض)

int getNumCompleteTests()

تعرض هذه السمة عدد الاختبارات المكتملة في عملية التشغيل هذه، أي الاختبارات التي تكون حالتها مختلفة عن "غير مكتملة".

int getNumTests()

تعرض هذه السمة عدد الاختبارات في عملية التشغيل هذه.

int getNumTestsInState(TestResult.TestStatus status)

تعرض هذه الطريقة عدد الاختبارات في حالة معيّنة لهذا التشغيل.

String getRunFailureMessage()

عرض رسالة الخطأ بشأن تعذّر تنفيذ العملية، null إذا لم يتعذّر تنفيذها

getRunMetrics()
getTestResults()

تعرض هذه السمة خريطة بنتائج الاختبار.

String getTextSummary()

تعرض هذه السمة سلسلة سهلة الاستخدام تصف النتائج.

boolean hasFailedTests()
boolean isRunComplete()
boolean isRunFailure()
void setAggregateMetrics(boolean metricAggregation)
void setRunComplete(boolean runComplete)
void testAssumptionFailure(TestIdentifier test, String trace)

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

void testEnded(TestIdentifier test, testMetrics)

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

void testFailed(TestIdentifier test, String trace)

تسجّل هذه السمة تعذُّر تنفيذ حالة اختبار فردية.

void testIgnored(TestIdentifier test)

يتم استدعاؤها عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار يتم شرحها باستخدام org.junit.Ignore.

void testRunEnded(long elapsedTime, runMetrics)

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

void testRunFailed(String errorMessage)

تعذّر إكمال تشغيل الاختبار للتقارير بسبب حدوث خطأ فادح.

void testRunStarted(String runName, int testCount)

تسجيل بداية تشغيل الاختبار

void testRunStopped(long elapsedTime)

تم إيقاف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب المستخدم.

void testStarted(TestIdentifier test)

تسجّل هذه السمة بداية حالة اختبار فردية.

الإنشاءات العامة

TestRunResult

public TestRunResult ()

أنشئTestRunResult فارغًا.

الطُرق العامة

getCompletedTests

public  getCompletedTests ()

تعرض هذه السمة مجموعة الاختبارات المكتملة.

المرتجعات

getElapsedTime

public long getElapsedTime ()

تعرض هذه السمة الوقت المنقضي الحالي للتنفيذ.

المرتجعات
long

getName

public String getName ()

المرتجعات
String اسم عملية الاختبار

getNumAllFailedTests

public int getNumAllFailedTests ()

عرض إجمالي عدد الاختبارات التي تعذّر إجراؤها (تعذّر إجراؤها، تعذّر التحقّق من صحة الافتراض)

المرتجعات
int

getNumCompleteTests

public int getNumCompleteTests ()

تعرض هذه السمة عدد الاختبارات المكتملة في عملية التشغيل هذه، أي الاختبارات التي تكون حالتها مختلفة عن "غير مكتملة".

المرتجعات
int

getNumTests

public int getNumTests ()

تعرض هذه السمة عدد الاختبارات في عملية التشغيل هذه.

المرتجعات
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

تعرض هذه الطريقة عدد الاختبارات في حالة معيّنة لهذا التشغيل.

المعلمات
status TestResult.TestStatus

المرتجعات
int

getRunFailureMessage

public String getRunFailureMessage ()

عرض رسالة الخطأ بشأن تعذّر تنفيذ العملية، null إذا لم يتعذّر تنفيذها

المرتجعات
String

getRunMetrics

public  getRunMetrics ()

المرتجعات
ERROR(/Map) من مقاييس تشغيل الاختبار

getTestResults

public  getTestResults ()

تعرض هذه السمة خريطة بنتائج الاختبار.

المرتجعات

getTextSummary

public String getTextSummary ()

تعرض هذه السمة سلسلة سهلة الاستخدام تصف النتائج.

المرتجعات
String

hasFailedTests

public boolean hasFailedTests ()

المرتجعات
boolean ‫true إذا كان هناك أي اختبارات غير ناجحة أو بها أخطاء في عملية الاختبار.

isRunComplete

public boolean isRunComplete ()

المرتجعات
boolean ‫true إذا انتهى تشغيل الاختبار

isRunFailure

public boolean isRunFailure ()

المرتجعات
boolean ‫true في حال تعذّر إجراء الاختبار

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

المعلمات
metricAggregation boolean

setRunComplete

public void setRunComplete (boolean runComplete)

المعلمات
runComplete boolean

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

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

testEnded

public void testEnded (TestIdentifier test, 
                 testMetrics)

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

إذا لم يتم استدعاء testFailed(TestIdentifier, String)، تكون هذه الحالة قد اجتازت الاختبار. تعرض هذه السمة أيضًا أي مقاييس على شكل مفتاح/قيمة ربما تم إصدارها أثناء تنفيذ حالة الاختبار.

المعلمات
test ‫TestIdentifier: تحدّد الاختبار
testMetrics ‫: ERROR(/Map) من المقاييس التي يتم إرسالها أثناء تنفيذ حالة الاختبار بواسطة android.app.Instrumentation#sendStatus يتم الاحتفاظ بترتيب الإدخال ما لم يتم إصدار المفتاح نفسه عدة مرات. يُرجى العِلم أنّه يتم استبعاد المفاتيح العادية المحدّدة في IInstrumentationResultParser.StatusKeys من هذه الخريطة. قد تضيف Ddmlib مقاييس اختبار إضافية محدّدة في IInstrumentationResultParser.StatusKeys.

testFailed

public void testFailed (TestIdentifier test, 
                String trace)

تسجّل هذه السمة تعذُّر تنفيذ حالة اختبار فردية.

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

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

testIgnored

public void testIgnored (TestIdentifier test)

يتم استدعاؤها عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار يتم شرحها باستخدام org.junit.Ignore.

المعلمات
test ‫TestIdentifier: تحدّد الاختبار

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

المعلمات
elapsedTime ‫long: الجهاز أبلغ عن الوقت المنقضي بالمللي ثانية
runMetrics ‫: ERROR(/Map) من المقاييس التي يتم إرسالها أثناء تنفيذ حالة الاختبار بواسطة android.app.Instrumentation#addResults يتم الاحتفاظ بترتيب الإدخال ما لم يتم إصدار المفتاح نفسه عدة مرات. يُرجى العِلم أنّه يتم استبعاد المفاتيح العادية المحدّدة في IInstrumentationResultParser.StatusKeys من هذه الخريطة. قد تضيف Ddmlib مقاييس اختبار إضافية محدّدة في IInstrumentationResultParser.StatusKeys.

testRunFailed

public void testRunFailed (String errorMessage)

تعذّر إكمال تشغيل الاختبار للتقارير بسبب حدوث خطأ فادح.

المعلمات
errorMessage String: String تصف سبب تعذُّر تنفيذ العملية.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

تسجيل بداية تشغيل الاختبار

المعلمات
runName ‫String: اسم عملية التشغيل الاختبارية
testCount ‫int: إجمالي عدد الاختبارات في عملية الاختبار

testRunStopped

public void testRunStopped (long elapsedTime)

تم إيقاف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب المستخدم.

المعلمات
elapsedTime ‫long: الجهاز أبلغ عن الوقت المنقضي بالمللي ثانية

testStarted

public void testStarted (TestIdentifier test)

تسجّل هذه السمة بداية حالة اختبار فردية.

المعلمات
test ‫TestIdentifier: تحدّد الاختبار