CollectingTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

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(TestResult.TestStatus status)

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

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

void logAssociation(String dataName, LogFile logFile)

void setBuildInfo(IBuildInfo buildInfo)

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

void setMergeStrategy(MergeStrategy strategy)

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

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 testModuleEnded()
void testModuleStarted(IInvocationContext moduleContext)
void testRunEnded(long elapsedTime, runMetrics)

void testRunFailed(FailureDescription failure)

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 testStarted(TestDescription test, long startTime)

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 (TestResult.TestStatus status)

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

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

المعلمات
elapsedTime long

invocationFailed

public void invocationFailed (Throwable cause)

المعلمات
cause Throwable

invocationStarted

public void invocationStarted (IInvocationContext context)

المعلمات
context IInvocationContext

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

المعلمات
dataName String

logFile LogFile

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

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

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

المعلمات
buildInfo IBuildInfo

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

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

testModuleEnded

public void testModuleEnded ()

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

المعلمات
moduleContext IInvocationContext

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

المعلمات
elapsedTime long

runMetrics

testRunFailed

public void testRunFailed (FailureDescription failure)

المعلمات
failure FailureDescription

testRunFailed

public void testRunFailed (String errorMessage)

المعلمات
errorMessage String

testRunStarted

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

المعلمات
name String

numTests int

attemptNumber int

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

startTime long

testRunStopped

public void testRunStopped (long elapsedTime)

المعلمات
elapsedTime long

testStarted

public void testStarted (TestDescription test, 
                long startTime)

المعلمات
test TestDescription

startTime long

testStarted

public void testStarted (TestDescription test)

المعلمات
test TestDescription

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

clearModuleLogFiles

protected final void clearModuleLogFiles ()

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

clearResultsForName

protected final void clearResultsForName (String testRunName)

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

المعلمات
testRunName String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

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

المعلمات
aggregate boolean