TestRunResult
public
class
TestRunResult
extends Object
implements
ITestRunListener
| java.lang.Object | |
| ↳ | com.android.ddmlib.testrunner.TestRunResult |
تحتوي على نتائج من عملية اختبار واحدة.
الحفاظ على عدد دقيق للاختبارات وتتبُّع الاختبارات غير المكتملة
غير آمن للاستخدام المتزامن يجب استدعاء عمليات معاودة الاتصال test* بالترتيب
ملخّص
طُرق وضع التصميم العامة | |
|---|---|
TestRunResult()
أنشئ |
|
الإجراءات العامة | |
|---|---|
Set<TestIdentifier>
|
getCompletedTests()
تعرض هذه السمة مجموعة الاختبارات المكتملة. |
long
|
getElapsedTime()
تعرض هذه السمة الوقت المنقضي منذ بدء عملية التنفيذ الحالية. |
String
|
getName()
|
int
|
getNumAllFailedTests()
عرض إجمالي عدد الاختبارات التي تعذّر إجراؤها (تعذّر إجراؤها، تعذّر التحقّق من صحة الافتراض) |
int
|
getNumCompleteTests()
تعرض هذه السمة عدد الاختبارات المكتملة في عملية التشغيل هذه، أي التي تكون حالتها مختلفة عن "غير مكتملة". |
int
|
getNumTests()
تعرض هذه السمة عدد الاختبارات في عملية التشغيل هذه. |
int
|
getNumTestsInState(TestResult.TestStatus status)
تعرض هذه السمة عدد الاختبارات في حالة معيّنة لهذا التشغيل. |
String
|
getRunFailureMessage()
عرض رسالة الخطأ بشأن تعذّر تنفيذ العملية، |
Map<String, String>
|
getRunMetrics()
|
Map<TestIdentifier, TestResult>
|
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, Map<String, String> testMetrics)
تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية. |
void
|
testFailed(TestIdentifier test, String trace)
تعرض هذه السمة تعذُّر تنفيذ حالة اختبار فردية. |
void
|
testIgnored(TestIdentifier test)
يتم استدعاؤه عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار تمّت إضافة التعليق التوضيحي org.junit.Ignore إليها. |
void
|
testRunEnded(long elapsedTime, Map<String, String> runMetrics)
تقارير نهاية عملية الاختبار |
void
|
testRunFailed(String errorMessage)
تعذّر إكمال تشغيل اختبار التقارير بسبب حدوث خطأ فادح. |
void
|
testRunStarted(String runName, int testCount)
تسجّل هذه السمة بداية تشغيل تجريبي. |
void
|
testRunStopped(long elapsedTime)
تم إيقاف التشغيل التجريبي للتقارير قبل اكتماله بناءً على طلب المستخدم. |
void
|
testStarted(TestIdentifier test)
تسجّل هذه السمة بداية حالة اختبار فردية. |
طُرق وضع التصميم العامة
الإجراءات العامة
getCompletedTests
public Set<TestIdentifier> getCompletedTests ()
تعرض هذه السمة مجموعة الاختبارات المكتملة.
| المرتجعات | |
|---|---|
Set<TestIdentifier> |
|
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 Map<String, String> getRunMetrics ()
| المرتجعات | |
|---|---|
Map<String, String> |
Map لمقاييس التشغيل التجريبي للاختبار |
getTestResults
public Map<TestIdentifier, TestResult> getTestResults ()
تعرض هذه السمة خريطة لنتائج الاختبار.
| المرتجعات | |
|---|---|
Map<TestIdentifier, TestResult> |
|
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, Map<String, String> testMetrics)
تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.
إذا لم يتم استدعاء testFailed(TestIdentifier, String)، اجتازت هذه الحالة الاختبار. تعرض هذه السمة أيضًا أي مقاييس على شكل مفتاح/قيمة
ربما تم إصدارها أثناء تنفيذ حالة الاختبار.
| المعلَمات | |
|---|---|
test |
TestIdentifier: تحدّد الاختبار |
testMetrics |
Map: 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,
Map<String, String> runMetrics)تقارير نهاية عملية الاختبار
| المعلَمات | |
|---|---|
elapsedTime |
long: الوقت المنقضي الذي أبلغ عنه الجهاز، بالمللي ثانية |
runMetrics |
Map: 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: تحدّد الاختبار |