تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

com.collectingTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

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

الفئات الفرعية المباشرة المعروفة

JsonHttpTestResultReporter ، MetricsXMLResultReporter ، ModuleListener ، ReportPassedTests ، ResultAggregator ، ShardListener ، SuiteResultReporter ، XmlResultReporter

JsonHttpTestResultReporter	مُبلغ نتائج يقوم بتشفير نتائج مقاييس الاختبار وفرعها ومعلومات الجهاز إلى JSON وPOST إلى نقطة نهاية خدمة HTTP
MetricsXMLResultReporter	يقوم MetricsXMLResultReporter بكتابة مقاييس الاختبار وتشغيل المقاييس إلى ملف XML في مجلد محدد بواسطة معلمة مجلد المقاييس في مرحلة الاستدعاء المنتهية للاختبار.
ModuleListener	يتم إرفاق المستمع بكل `IRemoteTest` لكل وحدة من أجل جمع قائمة النتائج.
تقرير الاختبارات الناجحة	قم بالإبلاغ في ملف عن المرشحات المحتملة لاستبعاد الاختبار الذي تم اجتيازه.
مجمع النتائج	معيد توجيه خاص يقوم بتجميع النتائج عند الحاجة، بناءً على استراتيجية إعادة المحاولة التي تم اتخاذها.
ShardListener	`ITestInvocationListener` الذي يجمع النتائج من جزء الاستدعاء (المعروف أيضًا باسم تقسيم الاستدعاء للتشغيل على موارد متعددة بالتوازي)، ويعيد توجيهها إلى مستمع آخر.
تقرير نتائج سويت	جمع نتائج الاختبار لاستدعاء مجموعة كاملة وإخراج النتائج النهائية.
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 (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)` `testEnded (TestDescription test, long endTime, testMetrics)`
`void`	`testEnded (TestDescription test, testMetrics)` `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)` `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)` قم بتبديل خيار "المقاييس المجمعة".

المقاولين العامة

com.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`

انتهت الدعوة

public void invocationEnded (long elapsedTime)

حدود
`elapsedTime`	`long`

فشل الاستدعاء

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`

انتهى الاختبار

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

حدود
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

انتهى الاختبار

public void testEnded (TestDescription test, 
                 testMetrics)

حدود
`test`	`TestDescription`
`testMetrics`

فشل الاختبار

public void testFailed (TestDescription test, 
                FailureDescription failure)

حدود
`test`	`TestDescription`
`failure`	`FailureDescription`

فشل الاختبار

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`

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

public void testRunFailed (FailureDescription failure)

حدود
`failure`	`FailureDescription`

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

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`