نتيجة 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 ()

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

المرتجعات

الحصول على وقت المنقضي

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) من مقاييس تشغيل الاختبار بالتنسيق الأوّلي الجديد.

getStartTime

public long getStartTime ()

تعرض وقت بدء استدعاء testRunStart الأول.

المرتجعات
long

getTestResults

public  getTestResults ()

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

المرتجعات

الحصول على TestsInState

public  getTestsInState ( statuses)

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

المعلمات
statuses

المرتجعات

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

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

المعلمات
status	TestStatus

المرتجعات

getTextSummary

public String getTextSummary ()

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

المرتجعات
String

حالات إخفاق الاختبار

public boolean hasFailedTests ()

المرتجعات
boolean	true إذا كان تنفيذ الاختبار قد تضمّن أي اختبارات تعذّر إكمالها أو بها أخطاء

isRunComplete

public boolean isRunComplete ()

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

isRunFailure

public boolean isRunFailure ()

المرتجعات
boolean	true إذا تعذّر إجراء الاختبار.

دمج

public static TestRunResult merge ( testRunResults)

المعلمات
testRunResults

المرتجعات
TestRunResult

راجِع أيضًا:

• ERROR(/#merge(List, MergeStrategy))

دمج

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

تعذُّر اختبار الافتراض

public void testAssumptionFailure (TestDescription test, 
                String trace)

المعلمات
test	TestDescription
trace	String

تعذُّر اختبار الافتراض

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

اختبار التشغيل فاشل

public void testRunFailed (FailureDescription failureDescription)

المعلمات
failureDescription	FailureDescription

اختبار التشغيل فاشل

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

تم تخطي الاختبار

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