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)

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

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(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). وبالتالي، يتيح هذا الإجراء الرجعي تقديم ارتباط قوي بشكل صريح.

المعلمات
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: رقم الطلب، الذي يحدّد المحاولات المختلفة لـ 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(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

clearTestRunResults

protected final void clearTestRunResults ()

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

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

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

المعلمات
aggregate boolean