TestRunResult

public class TestRunResult
extends Object

java.lang.Object
   ↳ com.android.tradefed.result.TestRunResult

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

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

غير آمن في مؤشر الترابط يجب استدعاء طلبات معاودة الاتصال test* بالترتيب

ملخّص

الحقول

public static final String ERROR_DIVIDER

وظائف الإنشاء العامة

TestRunResult()

أنشئ 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()

تعرِض هذه السمة وصف تعذُّر التشغيل، null، إذا لم يتعذّر التشغيل.

String getRunFailureMessage()

عرض رسالة الخطأ المتعلّقة بتعذُّر التشغيل، null إذا لم يتعذّر التشغيل

MultiMap<String, LogFile> getRunLoggedFiles()

عرض نسخة من الخريطة تحتوي على جميع الملفات المسجّلة المرتبطة بحالة الاختبار هذه

getRunMetrics()
getRunProtoMetrics()
long getStartTime()

تعرِض هذه السمة وقت بدء أولّ مكالمة testRunStart.

getTestResults()

لعرض خريطة لنتائج الاختبار

getTestsInState( statuses)

تحصل على مجموعة الاختبارات في حالات معيّنة.

getTestsResultsInState(TestStatus status)

تعرِض جميع TestResult في حالة معيّنة.

String getTextSummary()

عرض سلسلة تصف النتائج بطريقة سهلة على المستخدم

boolean hasFailedTests()
boolean isRunComplete()
boolean isRunFailure()
static TestRunResult merge( testRunResults)
static TestRunResult merge( testRunResults, MergeStrategy strategy)

دمج عدّة 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, testMetrics)
void testEnded(TestDescription test, testMetrics)
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, runMetrics)
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

وظائف الإنشاء العامة

TestRunResult

public TestRunResult ()

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

الطرق العامة

getCompletedTests

public  getCompletedTests ()

تحصل على مجموعة الاختبارات المكتملة.

المرتجعات

getElapsedTime

public long getElapsedTime ()

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

المرتجعات
long

getExpectedTestCount

public int getExpectedTestCount ()

تحصل على عدد حالات الاختبار التي تتوقّع أن تتضمّنها TestRunResult. قد يكون العدد الفعلي أقل من العدد المتوقّع بسبب الأعطال أثناء الاختبار. يشير هذا الاختلاف عادةً إلى تعذُّر تنفيذ الاختبار.

المرتجعات
int

getFailedTests

public  getFailedTests ()

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

المرتجعات

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

public  getPassedTests ()

تحصل على مجموعة الاختبارات التي تم اجتيازها.

المرتجعات

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

تعرِض هذه السمة وصف تعذُّر التشغيل، null، إذا لم يتعذّر التشغيل.

المرتجعات
FailureDescription

getRunFailureMessage

public String getRunFailureMessage ()

عرض رسالة الخطأ المتعلّقة بتعذُّر التشغيل، null إذا لم يتعذّر التشغيل

المرتجعات
String

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

عرض نسخة من الخريطة تحتوي على جميع الملفات المسجّلة المرتبطة بحالة الاختبار هذه

المرتجعات
MultiMap<String, LogFile>

getRunMetrics

public  getRunMetrics ()

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

getRunProtoMetrics

public  getRunProtoMetrics ()

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

getStartTime

public long getStartTime ()

تعرِض هذه السمة وقت بدء أولّ مكالمة testRunStart.

المرتجعات
long

getTestResults

public  getTestResults ()

لعرض خريطة لنتائج الاختبار.

المرتجعات

getTestsInState

public  getTestsInState ( statuses)

تحصل على مجموعة الاختبارات في حالات معيّنة.

المعلمات
statuses

المرتجعات

getTestsResultsInState

public  getTestsResultsInState (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

testIgnored

public void testIgnored (TestDescription test)

المعلمات
test TestDescription

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

testStarted

public void testStarted (TestDescription test)

المعلمات
test TestDescription