TestRunResult

public class TestRunResult
extends Object

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

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

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

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

ملخّص

الثوابت

String ERROR_DIVIDER

طُرق وضع التصميم العامة

TestRunResult()

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

الإجراءات العامة

void addTestResult(TestDescription test, TestResult testResult)
Set<TestDescription> getCompletedTests()

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

long getElapsedTime()

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

int getExpectedTestCount()

تعرض هذه السمة عدد حالات الاختبار التي من المتوقّع أن تتضمّنها TestRunResult.

Set<TestDescription> getFailedTests()

تعرض هذه السمة مجموعة الاختبارات التي تعذّر إجراؤها.

String getName()
int getNumAllFailedTests()

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

int getNumCompleteTests()

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

int getNumTests()

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

int getNumTestsInState(TestStatus status)

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

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

للتوافق مع الحالة القديمة

Set<TestDescription> getPassedTests()

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

FailureDescription getRunFailureDescription()

تعرِض هذه السمة وصفًا لخطأ التشغيل، أو null إذا لم يحدث خطأ في التشغيل.

String getRunFailureMessage()

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

MultiMap<String, LogFile> getRunLoggedFiles()

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

Map<String, String> getRunMetrics()
HashMap<String, MetricMeasurement.Metric> getRunProtoMetrics()
long getStartTime()

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

Map<TestDescription, TestResult> getTestEntriesInState(Collection<TestStatus> statuses)

تعرض هذه الطريقة مجموعة الاختبارات بالحالات المحدّدة.

Map<TestDescription, TestResult> getTestResults()

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

Set<TestDescription> getTestsInState(List<TestStatus> statuses)

تعرض هذه الطريقة مجموعة الاختبارات بالحالات المحدّدة.

List<TestResult> getTestsResultsInState(TestStatus status)

تعرض هذه السمة جميع TestResult في ولاية معيّنة.

String getTextSummary()

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

boolean hasFailedTests()
boolean isRunComplete()
boolean isRunFailure()
static TestRunResult merge(List<TestRunResult> testRunResults)
static TestRunResult merge(List<TestRunResult> 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, HashMap<String, MetricMeasurement.Metric> testMetrics)
void testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> 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, HashMap<String, MetricMeasurement.Metric> runMetrics)

واجهة جديدة تستخدم مقاييس proto الجديدة

void testRunEnded(long elapsedTime, Map<String, String> 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

Constant Value: " ====Next Error==== "

طُرق وضع التصميم العامة

TestRunResult

public TestRunResult ()

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

الإجراءات العامة

addTestResult

public void addTestResult (TestDescription test, 
                TestResult testResult)

المعلَمات
test TestDescription

testResult TestResult

getCompletedTests

public Set<TestDescription> getCompletedTests ()

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

المرتجعات
Set<TestDescription>

getElapsedTime

public long getElapsedTime ()

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

المرتجعات
long

getExpectedTestCount

public int getExpectedTestCount ()

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

المرتجعات
int

getFailedTests

public Set<TestDescription> getFailedTests ()

تعرض هذه السمة مجموعة الاختبارات التي تعذّر إجراؤها.

المرتجعات
Set<TestDescription>

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(TestStatus) كبديل.

المعلَمات
ddmlibStatus TestResult.TestStatus

المرتجعات
int

getPassedTests

public Set<TestDescription> getPassedTests ()

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

المرتجعات
Set<TestDescription>

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

تعرِض هذه السمة وصفًا لخطأ التشغيل، أو null إذا لم يحدث خطأ في التشغيل.

المرتجعات
FailureDescription

getRunFailureMessage

public String getRunFailureMessage ()

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

المرتجعات
String

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

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

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

getRunMetrics

public Map<String, String> getRunMetrics ()

المرتجعات
Map<String, String> Map لمقاييس التشغيل التجريبي

getRunProtoMetrics

public HashMap<String, MetricMeasurement.Metric> getRunProtoMetrics ()

المرتجعات
HashMap<String, MetricMeasurement.Metric> a Map of the test run metrics with the new proto format.

getStartTime

public long getStartTime ()

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

المرتجعات
long

getTestEntriesInState

public Map<TestDescription, TestResult> getTestEntriesInState (Collection<TestStatus> statuses)

تعرض هذه الطريقة مجموعة الاختبارات بالحالات المحدّدة.

المعلَمات
statuses Collection

المرتجعات
Map<TestDescription, TestResult>

getTestResults

public Map<TestDescription, TestResult> getTestResults ()

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

المرتجعات
Map<TestDescription, TestResult>

getTestsInState

public Set<TestDescription> getTestsInState (List<TestStatus> statuses)

تعرض هذه الطريقة مجموعة الاختبارات بالحالات المحدّدة.

المعلَمات
statuses List

المرتجعات
Set<TestDescription>

getTestsResultsInState

public List<TestResult> getTestsResultsInState (TestStatus status)

تعرض هذه السمة جميع TestResult في ولاية معيّنة.

المعلَمات
status TestStatus

المرتجعات
List<TestResult>

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 (List<TestRunResult> testRunResults)

المعلَمات
testRunResults List

المرتجعات
TestRunResult

يُرجى الاطّلاع أيضًا على:

دمج

public static TestRunResult merge (List<TestRunResult> testRunResults, 
                MergeStrategy strategy)

دمج نتائج TestRunResults متعددة لها اسم TestRunName نفسه إذا ظهرت حالة اختبار في عدة نتائج TestRunResults ولكن بنتائج مختلفة (على سبيل المثال، يتم تشغيل boottest-device ثلاث مرات مع النتيجة FAIL-FAIL-PASS)، فإننا ندمج جميع عمليات تتبُّع تسلسل استدعاء الدوال البرمجية من عمليات التشغيل التي تعذّر إجراؤها ونثق في نتيجة التشغيل النهائية للحالة والمقاييس وملفات السجلّ ووقت البدء/الانتهاء.

المعلَمات
testRunResults List: قائمة بـ 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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

المعلَمات
test TestDescription

endTime long

testMetrics HashMap

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

المعلَمات
test TestDescription

testMetrics HashMap

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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

واجهة جديدة تستخدم مقاييس proto الجديدة

المعلَمات
elapsedTime long

runMetrics HashMap

testRunEnded

public void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

المعلَمات
elapsedTime long

runMetrics Map

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