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(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) المباشرة.

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 يمثّل البيانات التي تم جمعها أثناء تشغيل الاختبار الأخير

اختبارات getExpectedTest

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>

الحصول على ملفات غير مرتبطة

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

عرض نسخة من الخريطة تحتوي على كل الملف المسجّل غير المرتبط بإجراء اختباري أو وحدة معيّنة.

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

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

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

المرتجعات
int

getNumAllFailedTests

public int getNumAllFailedTests ()

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

المرتجعات
int

الحصول على NumTestsInState

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

الحصول على نتائج

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 لمحاولة معيّنة.

الحصول على علامات تشغيل TestRunNames

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)

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

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

المعلمات
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)

في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في عملية callback المباشرة testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.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, 
                 testMetrics)

بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بين السمتَين testStarted(com.android.tradefed.result.TestDescription, long) و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: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

تم تجاهل الاختبار

public void testIgnored (TestDescription test)

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

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

وحدة اختبار انتهت

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

نهاية تشغيل اختبار التقارير

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

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

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

تم بدء الاختبار

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