CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

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

الفئات الفرعية المباشرة المعروفة JsonHttpTestResultReporter وLUCIResultReporter وMetricsXMLResultReporter وModuleListener وReportPassedTests وResultAggregator وShardListener وSuiteResultReporter وXmlResultReporter JsonHttpTestResultReporter أداة إعداد تقارير النتائج التي تُشفِّر نتائج مقاييس الاختبار وبيانات الفرع والجهاز إلى تنسيق JSON وتُرسِلها باستخدام POST إلى نقطة نهاية خدمة HTTP  LUCIResultReporter أداة إعداد تقارير النتائج التي تحفظ نتائج الاختبار التي تحتاجها ResultDB وLUCI بتنسيق JSON (go/result-sink) وتسجِّل موقع الملف في وحدة التحكّم  MetricsXMLResultReporter يُسجِّل MetricsXMLResultReporter مقاييس الاختبار ومقاييس التشغيل في ملف XML في مجلد محدّد بالمَعلمة metrics-folder في مرحلة invocationEnded من الاختبار.  ModuleListener مستمع مرفق بكل IRemoteTest من كل وحدة من أجل جمع قائمة النتائج  ReportPassedTests الإبلاغ في ملف عن الفلاتر المحتمَلة لاستبعاد الاختبار الذي تم اجتيازه  ResultAggregator إعادة توجيه خاصة تُجمِّع النتائج عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتخاذها   ShardListener ITestInvocationListener يجمع النتائج من شريحة طلب (المعروفة أيضًا باسم تقسيم طلب التشغيل على موارد متعددة بشكل متزامن)، ويعيد توجيهها إلى مستمع آخر  SuiteResultReporter جمع نتائج الاختبار لطلب مجموعة كاملة وعرض النتائج النهائية  XmlResultReporter يكتب نتائج JUnit في ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter في Ant.

الفئات الفرعية غير المباشرة المعروفة FormattedGeneratorReporter وXmlFormattedGeneratorReporter FormattedGeneratorReporter أداة إعداد التقارير التي تتيح إنشاء تقارير بتنسيق معيّن  XmlFormattedGeneratorReporter تنفيذ FormattedGeneratorReporter الذي يُنشئ تنسيق xml لنتائج المجموعة.

---

ITestInvocationListener ستجمع جميع نتائج الاختبار.

على الرغم من أنّ بنى البيانات المستخدَمة في هذا العنصر آمنة من حيث مؤشرات الترابط، يجب استدعاء وظائف الاستدعاء ITestInvocationListener بالترتيب الصحيح.

ملخّص

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

الطرق العامة
IBuildInfo	getBuildInfo() تم إيقاف هذه الطريقة نهائيًا. الاعتماد على IBuildInfo من getInvocationContext()
TestRunResult	getCurrentRunResults() تحصل على نتائج عملية الاختبار الحالية.
int	getExpectedTests() لعرض عدد الاختبارات المتوقّعة.
IInvocationContext	getInvocationContext() عرض سياق الاستدعاء الذي تم الإبلاغ عنه من خلال invocationStarted(com.android.tradefed.invoker.IInvocationContext)
	getMergedTestRunResults() عرض مجموعة النتائج المدمجة لجميع عمليات التشغيل على مستوى محاولات مختلفة
IInvocationContext	getModuleContextForRunResult(String testRunName) تعرِض هذه السمة IInvocationContext الوحدة المرتبطة بالنتائج.
MultiMap<String, LogFile>	getModuleLogFiles() عرض نسخة من الخريطة تحتوي على جميع الملفات المسجّلة المرتبطة بالوحدة
MultiMap<String, LogFile>	getNonAssociatedLogFiles() عرض نسخة من الخريطة تحتوي على جميع الملفات المسجّلة غير المرتبطة بتشغيل اختبار أو ملف برمجي
int	getNumAllFailedTestRuns() عرض إجمالي عدد عمليات تنفيذ الاختبار في حالة تعذُّر
int	getNumAllFailedTests() تعرِض هذه الدالة إجمالي عدد الاختبارات في حالة تعذُّر (فقط الاختبارات التي تعذّر إجراؤها، ولا يتم احتساب أخطاء الافتراض).
int	getNumTestsInState(TestStatus status) لعرض عدد الاختبارات في الحالة المحدّدة لهذه الجولة.
int	getNumTestsInState(TestResult.TestStatus ddmlibStatus) للتوافق مع نوع الحالة الأقدم
int	getNumTotalTests() لعرض إجمالي عدد الاختبارات المكتملة لجميع عمليات التشغيل.
IBuildInfo	getPrimaryBuildInfo() عرض معلومات الإصدار الأساسية التي تم الإبلاغ عنها من خلال invocationStarted(com.android.tradefed.invoker.IInvocationContext)
	getRunResults() تم إيقاف هذه الطريقة نهائيًا. استخدِم getMergedTestRunResults().
TestRunResult	getTestRunAtAttempt(String testRunName, int attempt) أعِد عرض الرمز TestRunResult لإجراء محاولة واحدة.
int	getTestRunAttemptCount(String testRunName) لعرض عدد المحاولات لاسم جولة اختبار معيّن.
	getTestRunAttempts(String testRunName) تحصل على جميع محاولات TestRunResult لعملية اختبار معيّنة.
	getTestRunForAttempts(int attempt) تحصل على جميع النتائج لمحاولة معيّنة.
	getTestRunNames() عرض جميع الأسماء لجميع عمليات تنفيذ الاختبار
boolean	hasFailedTests() تشير إلى ما إذا كان قد تم إجراء أي اختبارات تعذّر إكمالها أو تعذّر إثبات صحتها.
boolean	hasTestRunResultsForName(String testRunName) لعرض ما إذا كان اسم جولة اختبار معيّن يتضمّن أي نتائج.
void	invocationEnded(long elapsedTime) تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.
void	invocationFailed(Throwable cause) الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ
void	invocationSkipped(SkipReason reason) الإبلاغ عن طلب استدعاء كطلب تم تخطّيه
void	invocationStarted(IInvocationContext context) الإبلاغ عن بدء استدعاء الاختبار
boolean	isDisabled() تعرِض True إذا كان العنصر بأكمله غير مفعَّل (يتم تخطّي كلّ من الإعداد والتفكيك).
void	logAssociation(String dataName, LogFile logFile) في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callback المباشر.
void	setBuildInfo(IBuildInfo buildInfo) تم إيقاف هذه الطريقة نهائيًا. لم تعُد هذه الخطوة ضرورية للاختبار.
void	setDisable(boolean isDisabled) لتحديد ما إذا كان يجب إيقاف العنصر
void	setMergeStrategy(MergeStrategy strategy) لضبط MergeStrategy المراد استخدامه عند دمج النتائج
void	testAssumptionFailure(TestDescription test, String trace) يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.
void	testAssumptionFailure(TestDescription test, FailureDescription failure) يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.
void	testEnded(TestDescription test, long endTime, testMetrics) بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً.
void	testEnded(TestDescription test, testMetrics) يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي.
void	testFailed(TestDescription test, FailureDescription failure) الإبلاغ عن تعذُّر اختبار فردي
void	testFailed(TestDescription test, String trace) الإبلاغ عن تعذُّر اختبار فردي
void	testIgnored(TestDescription test) يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.
void	testModuleEnded() الإبلاغ عن نهاية تشغيل وحدة
void	testModuleStarted(IInvocationContext moduleContext) الإبلاغ عن بدء تشغيل وحدة
void	testRunEnded(long elapsedTime, runMetrics) الإبلاغ عن نهاية عملية الاختبار
void	testRunFailed(FailureDescription failure) تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ وصفه FailureDescription.
void	testRunFailed(String errorMessage) تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح.
void	testRunStarted(String name, int numTests, int attemptNumber) الإبلاغ عن بدء عملية تنفيذ اختبار
void	testRunStarted(String name, int numTests) الإبلاغ عن بدء عملية تنفيذ اختبار
void	testRunStarted(String name, int numTests, int attemptNumber, long startTime) الإبلاغ عن بدء عملية تنفيذ اختبار
void	testRunStopped(long elapsedTime) توقّف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب أحد المستخدِمين.
void	testSkipped(TestDescription test, SkipReason reason) يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً.
void	testStarted(TestDescription test, long startTime) بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار ، مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لإجراء قياس دقيق.
void	testStarted(TestDescription test) الإبلاغ عن بدء حالة اختبار فردية

الطرق المحمية
final void	clearModuleLogFiles() يسمح هذا الخيار بتنظيف ملف الوحدة لتجنُّب الاحتفاظ به لفترة طويلة جدًا.
final void	clearResultsForName(String testRunName) يسمح بمحو النتائج لاسم تشغيل معيّن.
void	setIsAggregrateMetrics(boolean aggregate) تفعيل خيار "المقاييس المجمّعة" أو إيقافه

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

CollectingTestListener

public CollectingTestListener ()

الطرق العامة

getBuildInfo

public IBuildInfo getBuildInfo ()

تم إيقاف هذه الطريقة نهائيًا.
يمكنك الاعتماد على IBuildInfo من getInvocationContext().

لعرض معلومات الإصدار.

المرتجعات
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

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

يُرجى العِلم أنّ النتائج قد لا تكون كاملة. يُنصح باختبار قيمة TestRunResult.isRunComplete() و/أو (@link TestRunResult#isRunFailure()} حسب الاقتضاء قبل معالجة النتائج.

المرتجعات
TestRunResult	TestRunResult التي تمثّل البيانات التي تم جمعها أثناء تشغيل الاختبار الأخير

getExpectedTests

public int getExpectedTests ()

لعرض عدد الاختبارات المتوقّعة. قد يختلف عن getNumTotalTests() إذا لم يتم إجراء بعض الاختبارات.

المرتجعات
int

getInvocationContext

public IInvocationContext getInvocationContext ()

عرض سياق الاستدعاء الذي تم الإبلاغ عنه من خلال invocationStarted(com.android.tradefed.invoker.IInvocationContext)

المرتجعات
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

عرض مجموعة النتائج المدمجة لجميع عمليات التشغيل على مستوى محاولات مختلفة

إذا كانت هناك نتائج متعدّدة، يتم دمج كلّ عملية تشغيل اختبار، مع إلغاء نتيجة الاختبار الأخيرة لنتائج الاختبار من عمليات التشغيل السابقة. يتم ترتيب عمليات التشغيل الاختبارية حسب رقم المحاولة.

سيتم دمج مقاييس المحاولة نفسها استنادًا إلى الإعدادات المفضّلة التي حدّدها aggregate-metrics. وستكون المقاييس النهائية هي مقاييس المحاولة الأخيرة.

المرتجعات

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

تعرِض هذه السمة IInvocationContext الوحدة المرتبطة بالنتائج.

المعلمات
testRunName	String: الاسم الذي حدّده {testRunStarted(String, int).

المرتجعات
IInvocationContext	IInvocationContext للوحدة لاسم مسار اختبار معيّن null إذا لم تكن هناك نتائج لهذا الاسم.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

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

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

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

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

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

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

عرض إجمالي عدد عمليات تنفيذ الاختبار في حالة تعذُّر

المرتجعات
int

getNumAllFailedTests

public int getNumAllFailedTests ()

تعرِض هذه الدالة إجمالي عدد الاختبارات في حالة تعذُّر (فقط الاختبارات التي تعذّر إجراؤها، ولا يتم احتساب أخطاء الافتراض).

المرتجعات
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

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

المعلمات
status	TestStatus

المرتجعات
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

للتوافق مع نوع الحالة الأقدم

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

المرتجعات
int

getNumTotalTests

public int getNumTotalTests ()

لعرض إجمالي عدد الاختبارات المكتملة لجميع عمليات التشغيل.

المرتجعات
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

عرض معلومات الإصدار الأساسية التي تم الإبلاغ عنها من خلال invocationStarted(com.android.tradefed.invoker.IInvocationContext) الإصدار الأساسي هو الإصدار الذي يعرضه موفِّر الإصدار الأول للإعدادات التي يتم تشغيلها. تعرِض قيمة فارغة إذا لم يكن هناك سياق (لا يتوفّر إصدار لحالة الاختبار).

المرتجعات
IBuildInfo

getRunResults

public  getRunResults ()

تم إيقاف هذه الطريقة نهائيًا.
استخدِم getMergedTestRunResults().

عرض نتائج جميع عمليات تنفيذ الاختبار

المرتجعات

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

أعِد عرض الرمز TestRunResult لإجراء محاولة واحدة.

المعلمات
testRunName	String: الاسم الذي حدّده {testRunStarted(String, int).
attempt	‫int: معرّف المحاولة

المرتجعات
TestRunResult	TestRunResult للاسم المحدّد ورقم تعريف المحاولة أو null إذا لم يكن متوفّرًا

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

لعرض عدد المحاولات لاسم جولة اختبار معيّن.

المعلمات
testRunName	String: الاسم الذي حدّده {testRunStarted(String, int).

المرتجعات
int

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

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

المعلمات
testRunName	String: الاسم الذي حدّده {testRunStarted(String, int).

المرتجعات
	جميع TestRunResult لإجراء اختبار معيّن، مرتبة حسب المحاولات

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

تحصل على جميع النتائج لمحاولة معيّنة.

المعلمات
attempt	‫int: المحاولة التي نريد الحصول على نتائج لها.

المرتجعات
	كل TestRunResult لمحاولة معيّنة.

getTestRunNames

public  getTestRunNames ()

عرض جميع الأسماء لجميع عمليات تنفيذ الاختبار

قد تكون عمليات تنفيذ الاختبار هذه قد تم إجراؤها عدة مرات بمحاولات مختلفة.

المرتجعات

hasFailedTests

public boolean hasFailedTests ()

تشير إلى ما إذا كان قد تم إجراء أي اختبارات تعذّر إكمالها أو تعذّر إثبات صحتها.

المرتجعات
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

لعرض ما إذا كان اسم جولة اختبار معيّن يتضمّن أي نتائج.

المعلمات
testRunName	String: الاسم الذي حدّده {testRunStarted(String, int).

المرتجعات
boolean

invocationEnded

public void invocationEnded (long elapsedTime)

تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
elapsedTime	‫long: الوقت المنقضي منذ بدء الطلب بالملي ثانية

invocationFailed

public void invocationFailed (Throwable cause)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
cause	Throwable: Throwable سبب الخطأ

invocationSkipped

public void invocationSkipped (SkipReason reason)

الإبلاغ عن طلب استدعاء كطلب تم تخطّيه

المعلمات
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

الإبلاغ عن بدء استدعاء الاختبار

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation. على مُرسِلي البلاغات إلغاء هذه الطريقة لتفعيل إعداد تقارير عن أجهزة متعددة.

المعلمات
context	IInvocationContext: معلومات عن الاستدعاء

isDisabled

public boolean isDisabled ()

تعرِض True إذا كان العنصر بأكمله غير مفعَّل (يتم تخطّي كلّ من الإعداد والتفكيك). خطأ بخلاف ذلك.

المرتجعات
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callback المباشر. وبالتالي، يسمح هذا المرجع العكسي بتوفير ارتباط قوي بشكل صريح.

المعلمات
dataName	String: اسم البيانات
logFile	LogFile: LogFile الذي تم تسجيله من قبل ويجب أن يكون مرتبطًا بحالة الاختبار

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

تم إيقاف هذه الطريقة نهائيًا.
لم تعُد هذه الخطوة ضرورية للاختبار.

اضبط معلومات الإصدار. يجب عدم استخدامها إلا لأغراض الاختبار.

المعلمات
buildInfo	IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

لتحديد ما إذا كان يجب إيقاف العنصر يعني "غير مفعّل" أنّه يجب تخطّي كل من خطوات الإعداد والإزالة. يمكن استخدامها لإيقاف كائن تلقائيًا في الدالة الإنشائية الافتراضية.

المعلمات
isDisabled	‫boolean: الحالة التي يجب وضع العنصر فيها

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

لضبط MergeStrategy المراد استخدامه عند دمج النتائج

المعلمات
strategy	MergeStrategy

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.

المعلمات
test	TestDescription: لتحديد الاختبار
trace	String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.

المعلمات
test	TestDescription: لتحديد الاختبار
failure	FailureDescription: FailureDescription لوصف الخطأ وسياقه

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بين testStarted(com.android.tradefed.result.TestDescription, long) لقياس الأداء بدقة.

المعلمات
test	TestDescription: لتحديد الاختبار
endTime	‫long: وقت انتهاء الاختبار، يتم قياسه من خلال System.currentTimeMillis()
testMetrics	: ERROR(/Map) من المقاييس التي تمّ قياسها

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي.

إذا لم يتمّ استدعاء testFailed(TestDescription, FailureDescription)، يعني ذلك أنّ هذا الاختبار قد اجتاز. ويعرض أيضًا أي مقاييس مفتاح/قيمة قد تم إصدارها أثناء تنفيذ نموذج الاختبار.

المعلمات
test	TestDescription: لتحديد الاختبار
testMetrics	: ERROR(/Map) من المقاييس التي تمّ قياسها

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

الإبلاغ عن تعذُّر اختبار فردي

سيتمّ استدعاؤه بين testStarted وtestEnded.

المعلمات
test	TestDescription: لتحديد الاختبار
failure	FailureDescription: FailureDescription لوصف الخطأ وسياقه

testFailed

public void testFailed (TestDescription test, 
                String trace)

الإبلاغ عن تعذُّر اختبار فردي

سيتمّ استدعاؤه بين testStarted وtestEnded.

المعلمات
test	TestDescription: لتحديد الاختبار
trace	String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testIgnored

public void testIgnored (TestDescription test)

يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.

المعلمات
test	TestDescription: لتحديد الاختبار

testModuleEnded

public void testModuleEnded ()

الإبلاغ عن نهاية تشغيل وحدة

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

الإبلاغ عن بدء تشغيل وحدة يرتبط هذا المرجع الداعم بـ testModuleEnded() وهو اختياري في التسلسل. ولا يتم استخدامه إلا أثناء عملية تشغيل تستخدِم وحدات: برامج التشغيل المستندة إلى المجموعة.

المعلمات
moduleContext	IInvocationContext: IInvocationContext الوحدة

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

الإبلاغ عن نهاية عملية الاختبار

المعلمات
elapsedTime	‫long: الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية
runMetrics	: أزواج المفتاح/القيمة التي يتم الإبلاغ عنها في نهاية عملية الاختبار

testRunFailed

public void testRunFailed (FailureDescription failure)

تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ وصفه FailureDescription.

المعلمات
failure	FailureDescription: FailureDescription لوصف الخطأ وسياقه

testRunFailed

public void testRunFailed (String errorMessage)

تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح.

المعلمات
errorMessage	String: String يصف سبب تعذُّر التنفيذ

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

الإبلاغ عن بدء عملية تنفيذ اختبار

المعلمات
name	String: اسم اختبار التنفيذ
numTests	int: إجمالي عدد الاختبارات في اختبار التنفيذ
attemptNumber	int: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدّة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد كلّ مرّة تتم فيها عملية تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عدد عمليات التشغيل 4 عمليات ضمن اسم التشغيل نفسه وأن تتراوح مَعلمة attemptNumber بين 0 و3.

testRunStarted

public void testRunStarted (String name, 
                int numTests)

الإبلاغ عن بدء عملية تنفيذ اختبار

المعلمات
name	String: اسم اختبار التنفيذ
numTests	int: إجمالي عدد الاختبارات في اختبار التنفيذ

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

الإبلاغ عن بدء عملية تنفيذ اختبار

المعلمات
name	String: اسم اختبار التنفيذ
numTests	int: إجمالي عدد الاختبارات في اختبار التنفيذ
attemptNumber	int: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدّة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد كلّ مرّة يتمّ فيها تنفيذ عملية تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عمليات التشغيل التي تمّ إجراؤها 4 مرّات ضمن اسم التشغيل نفسه، ويجب أن تتراوح مَعلمة attemptNumber بين 0 و3.
startTime	long: وقت بدء التنفيذ، يتم قياسه من خلال System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

توقّف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب أحد المستخدِمين.

TODO: currently unused, consider removing

المعلمات
elapsedTime	‫long: الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً. سيتمّ إعادة إجراء هذه الاختبارات لمحاولة الحصول على تنفيذ سليم.

المعلمات
test	TestDescription: لتحديد الاختبار
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار ، مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لإجراء قياس دقيق.

المعلمات
test	TestDescription: لتحديد الاختبار
startTime	long: وقت بدء الاختبار، يتم قياسه من خلال System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test)

الإبلاغ عن بدء حالة اختبار فردية واجهة قديمة، يجب استخدام testStarted(com.android.tradefed.result.TestDescription) كلما أمكن.

المعلمات
test	TestDescription: لتحديد الاختبار

الطرق المحمية

clearModuleLogFiles

protected final void clearModuleLogFiles ()

يسمح هذا الخيار بتنظيف ملف الوحدة لتجنُّب الاحتفاظ به لفترة طويلة جدًا.

clearResultsForName

protected final void clearResultsForName (String testRunName)

يسمح بمحو النتائج لاسم تشغيل معيّن. يجب عدم استخدامها إلا في بعض الحالات، مثل مجمّع النتائج.

المعلمات
testRunName	String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

تفعيل خيار "المقاييس المجمّعة" أو إيقافه

المعلمات
aggregate	boolean