TestRunResult
public
class
TestRunResult
extends Object
java.lang.Object | |
↳ | com.android.tradefed.result.TestRunResult |
يحتوي على نتائج من عملية اختبار واحدة.
الحفاظ على عدد دقيق من الاختبارات وتتبُّع الاختبارات غير المكتملة
غير آمن في مؤشر الترابط يجب استدعاء طلبات معاودة الاتصال test* بالترتيب
ملخّص
الحقول | |
---|---|
public
static
final
String |
ERROR_DIVIDER
|
وظائف الإنشاء العامة | |
---|---|
TestRunResult()
أنشئ |
الطرق العامة | |
---|---|
|
getCompletedTests()
تحصل على مجموعة الاختبارات المكتملة. |
long
|
getElapsedTime()
عرض الوقت المنقضي في عملية التنفيذ الحالية |
int
|
getExpectedTestCount()
تحصل على عدد حالات الاختبار التي تتوقّع أن تتضمّنها TestRunResult. |
|
getFailedTests()
تحصل على مجموعة الاختبارات غير الناجحة. |
String
|
getName()
|
int
|
getNumAllFailedTests()
عرض إجمالي عدد الاختبارات في حالة تعذُّر (تعذُّر، تعذُّر الافتراض) |
int
|
getNumCompleteTests()
تحصل على عدد الاختبارات المكتملة في هذه الجولة، أي التي تكون حالتها != غير مكتملة. |
int
|
getNumTests()
تحصل على عدد الاختبارات في هذه الجولة. |
int
|
getNumTestsInState(TestStatus status)
تحصل على عدد الاختبارات في حالة معيّنة لهذا الإجراء. |
int
|
getNumTestsInState(TestResult.TestStatus ddmlibStatus)
للتوافق مع الحالة القديمة. |
|
getPassedTests()
تحصل على مجموعة الاختبارات التي تم اجتيازها. |
FailureDescription
|
getRunFailureDescription()
تعرِض هذه السمة وصف تعذُّر التشغيل، |
String
|
getRunFailureMessage()
عرض رسالة الخطأ المتعلّقة بتعذُّر التشغيل، |
MultiMap<String, LogFile>
|
getRunLoggedFiles()
عرض نسخة من الخريطة تحتوي على جميع الملفات المسجّلة المرتبطة بحالة الاختبار هذه |
|
getRunMetrics()
|
|
getRunProtoMetrics()
|
long
|
getStartTime()
تعرِض هذه السمة وقت بدء أولّ مكالمة testRunStart. |
|
getTestResults()
لعرض خريطة لنتائج الاختبار |
|
getTestsInState(
تحصل على مجموعة الاختبارات في حالات معيّنة. |
|
getTestsResultsInState(TestStatus status)
تعرِض جميع |
String
|
getTextSummary()
عرض سلسلة تصف النتائج بطريقة سهلة على المستخدم |
boolean
|
hasFailedTests()
|
boolean
|
isRunComplete()
|
boolean
|
isRunFailure()
|
static
TestRunResult
|
merge(
|
static
TestRunResult
|
merge(
دمج عدّة TestRunResults لنفس testRunName |
void
|
resetRunFailure()
إعادة ضبط حالة تعذُّر التنفيذ |
void
|
setAggregateMetrics(boolean metricAggregation)
|
void
|
setRunComplete(boolean runComplete)
|
void
|
testAssumptionFailure(TestDescription test, String trace)
|
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
|
void
|
testEnded(TestDescription test, long endTime,
|
void
|
testEnded(TestDescription test,
|
void
|
testFailed(TestDescription test, FailureDescription failure)
|
void
|
testFailed(TestDescription test, String trace)
|
void
|
testIgnored(TestDescription test)
|
void
|
testLogSaved(String dataName, LogFile logFile)
يتم تخزين معلومات حول الملف الذي يتم تسجيله وربطها بحالة الاختبار أو عملية تنفيذ الاختبار الجارية. |
void
|
testRunEnded(long elapsedTime,
|
void
|
testRunFailed(FailureDescription failureDescription)
|
void
|
testRunFailed(String errorMessage)
|
void
|
testRunStarted(String runName, int testCount, long startTime)
إشعار ببدء عملية اختبار |
void
|
testRunStarted(String runName, int testCount)
إشعار ببدء عملية اختبار |
void
|
testRunStopped(long elapsedTime)
|
void
|
testSkipped(TestDescription test, SkipReason reason)
|
void
|
testStarted(TestDescription test, long startTime)
|
void
|
testStarted(TestDescription test)
|
الحقول
ERROR_DIVIDER
public static final String ERROR_DIVIDER
وظائف الإنشاء العامة
الطرق العامة
getCompletedTests
publicgetCompletedTests ()
تحصل على مجموعة الاختبارات المكتملة.
المرتجعات | |
---|---|
|
getElapsedTime
public long getElapsedTime ()
عرض الوقت المنقضي في عملية التنفيذ الحالية
المرتجعات | |
---|---|
long |
getExpectedTestCount
public int getExpectedTestCount ()
تحصل على عدد حالات الاختبار التي تتوقّع أن تتضمّنها TestRunResult. قد يكون العدد الفعلي أقل من العدد المتوقّع بسبب الأعطال أثناء الاختبار. يشير هذا الاختلاف عادةً إلى تعذُّر تنفيذ الاختبار.
المرتجعات | |
---|---|
int |
getFailedTests
publicgetFailedTests ()
تحصل على مجموعة الاختبارات غير الناجحة.
المرتجعات | |
---|---|
|
getName
public String getName ()
المرتجعات | |
---|---|
String |
اسم اختبار التنفيذ |
getNumAllFailedTests
public int getNumAllFailedTests ()
عرض إجمالي عدد الاختبارات في حالة تعذُّر (تعذُّر، تعذُّر الافتراض)
المرتجعات | |
---|---|
int |
getNumCompleteTests
public int getNumCompleteTests ()
تحصل على عدد الاختبارات المكتملة في هذه الجولة، أي التي تكون حالتها "غير مكتملة".
المرتجعات | |
---|---|
int |
getNumTests
public int getNumTests ()
تحصل على عدد الاختبارات في هذه الجولة.
المرتجعات | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestStatus status)
تحصل على عدد الاختبارات في حالة معيّنة لهذا الإجراء.
المعلمات | |
---|---|
status |
TestStatus |
المرتجعات | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)
للتوافق مع الحالة القديمة. استخدِم getNumTestsInState(com.android.tradefed.result.TestStatus)
بدلاً من ذلك.
المعلمات | |
---|---|
ddmlibStatus |
TestResult.TestStatus |
المرتجعات | |
---|---|
int |
getPassedTests
publicgetPassedTests ()
تحصل على مجموعة الاختبارات التي تم اجتيازها.
المرتجعات | |
---|---|
|
getRunFailureDescription
public FailureDescription getRunFailureDescription ()
تعرِض هذه السمة وصف تعذُّر التشغيل، null
، إذا لم يتعذّر التشغيل.
المرتجعات | |
---|---|
FailureDescription |
getRunFailureMessage
public String getRunFailureMessage ()
عرض رسالة الخطأ المتعلّقة بتعذُّر التشغيل، null
إذا لم يتعذّر التشغيل
المرتجعات | |
---|---|
String |
getRunLoggedFiles
public MultiMap<String, LogFile> getRunLoggedFiles ()
عرض نسخة من الخريطة تحتوي على جميع الملفات المسجّلة المرتبطة بحالة الاختبار هذه
المرتجعات | |
---|---|
MultiMap<String, LogFile> |
getRunProtoMetrics
publicgetRunProtoMetrics ()
المرتجعات | |
---|---|
|
ERROR(/Map) من مقاييس الاختبار باستخدام تنسيق proto الجديد |
getStartTime
public long getStartTime ()
تعرِض هذه السمة وقت بدء أولّ مكالمة testRunStart.
المرتجعات | |
---|---|
long |
getTestResults
publicgetTestResults ()
لعرض خريطة لنتائج الاختبار.
المرتجعات | |
---|---|
|
getTestsInState
publicgetTestsInState ( statuses)
تحصل على مجموعة الاختبارات في حالات معيّنة.
المعلمات | |
---|---|
statuses |
|
المرتجعات | |
---|---|
|
getTestsResultsInState
publicgetTestsResultsInState (TestStatus status)
تعرِض جميع TestResult
في حالة معيّنة.
المعلمات | |
---|---|
status |
TestStatus |
المرتجعات | |
---|---|
|
getTextSummary
public String getTextSummary ()
عرض سلسلة تصف النتائج بطريقة سهلة على المستخدم
المرتجعات | |
---|---|
String |
hasFailedTests
public boolean hasFailedTests ()
المرتجعات | |
---|---|
boolean |
true إذا كان تنفيذ الاختبار قد تضمّن أي اختبارات تعذّر إكمالها أو بها أخطاء |
isRunComplete
public boolean isRunComplete ()
المرتجعات | |
---|---|
boolean |
true إذا انتهى تشغيل الاختبار |
isRunFailure
public boolean isRunFailure ()
المرتجعات | |
---|---|
boolean |
true في حال تعذّر إجراء الاختبار |
دمج
public static TestRunResult merge (testRunResults)
المعلمات | |
---|---|
testRunResults |
|
المرتجعات | |
---|---|
TestRunResult |
راجِع أيضًا:
دمج
public static TestRunResult merge (testRunResults, MergeStrategy strategy)
دمج عدّة TestRunResults لنفس testRunName إذا ظهر اختبار حالة في عدة TestRunResults ولكنّه يعرض نتائج مختلفة (مثلاً، يتم تشغيل "boottest-device" ثلاث مرات مع النتيجة FAIL-FAIL-PASS)، نربط جميع عمليات تتبُّع تسلسل استدعاء الدوال البرمجية من عمليات التشغيل التي تعذّر إكمالها ونثق في نتيجة المحاولة الأخيرة للتشغيل من أجل الحالة والمقاييس وملفات السجلّ ووقت البدء/الانتهاء.
المعلمات | |
---|---|
testRunResults |
: قائمة بـ TestRunResult المطلوب دمجها |
strategy |
MergeStrategy : استراتيجية الدمج المتّبعة لدمج النتائج |
المرتجعات | |
---|---|
TestRunResult |
نتيجة TestRunResult النهائية التي تحتوي على البيانات المدمجة من نتائج TestRunResults |
resetRunFailure
public void resetRunFailure ()
إعادة ضبط حالة تعذُّر التنفيذ
قد يكون من الضروري أحيانًا إعادة ضبط حالة تعذُّر التشغيل عند إعادة المحاولة. يجب إجراء ذلك بعناية لتجنُّب محو خطأ حقيقي.
setAggregateMetrics
public void setAggregateMetrics (boolean metricAggregation)
المعلمات | |
---|---|
metricAggregation |
boolean |
setRunComplete
public void setRunComplete (boolean runComplete)
المعلمات | |
---|---|
runComplete |
boolean |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
المعلمات | |
---|---|
test |
TestDescription |
trace |
String |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
المعلمات | |
---|---|
test |
TestDescription |
failure |
FailureDescription |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
المعلمات | |
---|---|
test |
TestDescription |
endTime |
long |
testMetrics |
|
testEnded
public void testEnded (TestDescription test,testMetrics)
المعلمات | |
---|---|
test |
TestDescription |
testMetrics |
|
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
المعلمات | |
---|---|
test |
TestDescription |
failure |
FailureDescription |
testFailed
public void testFailed (TestDescription test, String trace)
المعلمات | |
---|---|
test |
TestDescription |
trace |
String |
testLogSaved
public void testLogSaved (String dataName, LogFile logFile)
يتم تخزين معلومات حول الملف الذي يتم تسجيله وربطها بحالة الاختبار أو عملية تنفيذ الاختبار الجارية.
المعلمات | |
---|---|
dataName |
String : الاسم الذي يشير إلى البيانات |
logFile |
LogFile : عنصر LogFile الذي يمثّل مكان حفظ العنصر و
معلومات عنه |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
المعلمات | |
---|---|
elapsedTime |
long |
runMetrics |
|
testRunFailed
public void testRunFailed (FailureDescription failureDescription)
المعلمات | |
---|---|
failureDescription |
FailureDescription |
testRunFailed
public void testRunFailed (String errorMessage)
المعلمات | |
---|---|
errorMessage |
String |
testRunStarted
public void testRunStarted (String runName, int testCount, long startTime)
إشعار ببدء عملية اختبار
المعلمات | |
---|---|
runName |
String : الاسم المرتبط بتنفيذ الاختبار لأغراض التتبّع |
testCount |
int : عدد حالات الاختبار المتوقّعة المرتبطة بتنفيذ الاختبار. |
startTime |
long |
testRunStarted
public void testRunStarted (String runName, int testCount)
إشعار ببدء عملية اختبار
المعلمات | |
---|---|
runName |
String : الاسم المرتبط بتنفيذ الاختبار لأغراض التتبّع |
testCount |
int : عدد حالات الاختبار المتوقّعة المرتبطة بتنفيذ الاختبار. |
testRunStopped
public void testRunStopped (long elapsedTime)
المعلمات | |
---|---|
elapsedTime |
long |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
المعلمات | |
---|---|
test |
TestDescription |
reason |
SkipReason |
testStarted
public void testStarted (TestDescription test, long startTime)
المعلمات | |
---|---|
test |
TestDescription |
startTime |
long |