CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

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

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

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

ملخّص

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

CollectingTestListener()

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

IBuildInfo getBuildInfo()

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

TestRunResult getCurrentRunResults()

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

int getExpectedTests()

تعرض هذه السمة عدد الاختبارات المتوقّعة.

IInvocationContext getInvocationContext()

عرض سياق الاستدعاء الذي تمّ الإبلاغ عنه من خلال invocationStarted(IInvocationContext)

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

Collection<TestRunResult> getRunResults()

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

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

أرجِع TestRunResult للحصول على محاولة واحدة.

int getTestRunAttemptCount(String testRunName)

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

List<TestRunResult> getTestRunAttempts(String testRunName)

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

List<TestRunResult> getTestRunForAttempts(int attempt)

تعرض هذه الطريقة جميع نتائج محاولة معيّنة.

Collection<String> 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,LogDataType,InputStreamSource,LogFile).

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

بديل testEnded(TestDescription,Map) حيث يمكننا تحديد وقت الانتهاء مباشرةً.

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)

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

void testModuleEnded()

تسجّل هذه السمة نهاية عملية تنفيذ وحدة.

void testModuleStarted(IInvocationContext moduleContext)

تسجّل هذه السمة بداية تشغيل وحدة.

void testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> 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(TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار، بالإضافة إلى testEnded(TestDescription,long,Map) للحصول على قياس دقيق.

void testStarted(TestDescription test)

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

طُرق محمية

final void clearModuleLogFiles()

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

final void clearResultsForName(String testRunName)

تتيح محو نتائج عملية تنفيذ معيّنة.

final void clearTestRunResults()

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

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(IInvocationContext)

المرتجعات
IInvocationContext

getMergedTestRunResults

public List<TestRunResult> getMergedTestRunResults ()

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

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

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

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

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(IInvocationContext) الإصدار الأساسي هو الإصدار الذي يعرضه أول موفّر إصدارات في الإعدادات النشطة. تعرِض قيمة فارغة إذا لم يتوفّر سياق (لم يتم إنشاء حالة اختبار).

المرتجعات
IBuildInfo

getRunResults

public Collection<TestRunResult> getRunResults ()

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

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

المرتجعات
Collection<TestRunResult>

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 List<TestRunResult> getTestRunAttempts (String testRunName)

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

المعلَمات
testRunName ‫String: الاسم الذي قدّمه {testRunStarted(String,int).
المرتجعات
List<TestRunResult> جميع TestRunResult لتنفيذ اختبار معيّن، مرتّبة حسب المحاولات

getTestRunForAttempts

public List<TestRunResult> getTestRunForAttempts (int attempt)

تعرض هذه الطريقة جميع نتائج محاولة معيّنة.

المعلَمات
attempt int: المحاولة التي نريد الحصول على نتائج لها.
المرتجعات
List<TestRunResult> جميع TestRunResult لمحاولة معيّنة

getTestRunNames

public Collection<String> getTestRunNames ()

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

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

المرتجعات
Collection<String>

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,LogDataType,InputStreamSource,LogFile). وبالتالي، يتيح هذا الإجراء الرجعي توفير ارتباط قوي بشكل صريح.

المعلَمات
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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

بديل testEnded(TestDescription,Map) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بينها وبين testStarted(TestDescription,long) للحصول على قياس دقيق.

المعلَمات
test ‫TestDescription: تحدّد الاختبار
endTime ‫long: الوقت الذي انتهى فيه الاختبار، ويتم قياسه باستخدام System.currentTimeMillis()
testMetrics HashMap: Map للمقاييس التي تمّ إرسالها

testEnded

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

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

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

المعلَمات
test ‫TestDescription: تحدّد الاختبار
testMetrics HashMap: 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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

تقارير نهاية عملية الاختبار FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

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

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: رقم الطلب، الذي يحدّد المحاولات المختلفة لـ runName نفسه الذي يتم تنفيذه عدة مرات. يتم فهرسة attemptNumber بدءًا من 0، ويجب أن يزيد في كل مرة يتم فيها تنفيذ عملية جديدة. على سبيل المثال، إذا تمت إعادة محاولة اختبار دقيق 3 مرات، يجب أن يتم تنفيذه 4 مرات إجمالاً ضمن runName نفسه، ويجب أن يتراوح 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: رقم الطلب، الذي يحدّد المحاولات المختلفة لـ runName نفسه الذي يتم تنفيذه عدة مرات. يتم فهرسة attemptNumber بدءًا من 0، ويجب أن يزيد في كل مرة يتم فيها تنفيذ عملية تشغيل جديدة. على سبيل المثال، إذا تمت إعادة محاولة اختبار دقيق 3 مرات، يجب أن يتم تنفيذه 4 مرات إجمالاً ضمن runName نفسه، ويجب أن يتراوح 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(TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار، بالإضافة إلى testEnded(TestDescription,long,Map) للحصول على قياس دقيق.

المعلَمات
test ‫TestDescription: تحدّد الاختبار
startTime ‫long: الوقت الذي بدأت فيه التجربة، ويتم قياسه باستخدام System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test)

تسجّل هذه السمة بداية حالة اختبار فردية. واجهة قديمة، يجب استخدام testStarted(TestDescription) كلما أمكن ذلك.

المعلَمات
test ‫TestDescription: تحدّد الاختبار

طُرق محمية

clearModuleLogFiles

protected final void clearModuleLogFiles ()

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

clearResultsForName

protected final void clearResultsForName (String testRunName)

تتيح محو نتائج عملية تنفيذ معيّنة. يجب استخدامها فقط في بعض الحالات، مثل مجمّع النتائج.

المعلَمات
testRunName String

clearTestRunResults

protected final void clearTestRunResults ()

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

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

تفعيل خيار "مقاييس مجمّعة"

المعلَمات
aggregate boolean