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

ModuleListener

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.ModuleListener

يتم إرفاق المستمع بكل IRemoteTest لكل وحدة من أجل جمع قائمة النتائج.

ملخص

المقاولين العامة
`ModuleListener ( ITestInvocationListener listener, IInvocationContext moduleContext)` البناء.

الأساليب العامة
`boolean`	`hasLastAttemptFailed ()` إرجاع ما إذا كانت جلسة إعادة المحاولة الأخيرة للمستمع قد فشلت أم لا.
`void`	`logAssociation (String dataName, LogFile logFile)` في بعض الحالات، يجب أن يرتبط السجل بقوة بحالات الاختبار، ولكن تكون الفرصة متاحة للقيام بذلك من خلال `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` رد الاتصال `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` غير ممكن.
`void`	`setAttemptIsolation ( CurrentInvocation.IsolationGrade isolation)` يضبط ما إذا كان يجب الإبلاغ عن المحاولة على أنها معزولة أم لا.
`void`	`setCollectTestsOnly (boolean collectTestsOnly)` يحدد ما إذا كنا نقوم بجمع الاختبارات فقط أم لا.
`void`	`setMarkTestsSkipped (boolean skip)` ما إذا كان سيتم تخطي كافة حالات الاختبار أم لا.
`void`	`setTestMappingSources ( testMappingSources)` `setTestMappingSources ( testMappingSources)` يضبط مصادر تعيين الاختبار التي سيتم إدراجها في المقاييس.
`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)` بديل لـ `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` حيث يمكننا تحديد وقت الانتهاء مباشرة.
`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)` يتم استدعاؤه عندما لا يتم تشغيل الاختبار، وذلك بشكل عام بسبب إضافة تعليقات توضيحية لطريقة الاختبار باستخدام org.junit.Ignore.
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testRunEnded (long elapsedTime, runMetrics)` `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, int attemptNumber, long startTime)` يُعلن عن بداية التشغيل التجريبي.
`void`	`testStarted ( TestDescription test, long startTime)` بديل لـ `testStarted(com.android.tradefed.result.TestDescription)` حيث نحدد أيضًا وقت بدء الاختبار، بالإضافة إلى `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` لقياس دقيق .

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

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

البناء.

حدود
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

الأساليب العامة

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

إرجاع ما إذا كانت جلسة إعادة المحاولة الأخيرة للمستمع قد فشلت أم لا.

عائدات
`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) رد الاتصال testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) غير ممكن. وبالتالي، يسمح رد الاتصال هذا بتوفير ارتباط قوي بشكل صريح.

حدود
`dataName`	`String` : اسم البيانات
`logFile`	`LogFile` : `LogFile` الذي تم تسجيله من قبل ويجب أن يرتبط بحالة الاختبار.

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

يضبط ما إذا كان يجب الإبلاغ عن المحاولة على أنها معزولة أم لا.

حدود
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

يحدد ما إذا كنا نقوم بجمع الاختبارات فقط أم لا.

حدود
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

ما إذا كان سيتم تخطي كافة حالات الاختبار أم لا.

حدود
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

يضبط مصادر تعيين الاختبار التي سيتم إدراجها في المقاييس.

حدود
`testMappingSources`

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` الذي يصف الفشل وسياقه.

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

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)` للمقاييس المنبعثة

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

public void testEnded (TestDescription test, 
                 testMetrics)

يُبلغ عن نهاية تنفيذ حالة اختبار فردية.

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

حدود
`test`	`TestDescription` : يحدد الاختبار
`testMetrics`	: `ERROR(/Map)` للمقاييس المنبعثة

فشل الاختبار

public void testFailed (TestDescription test, 
                FailureDescription failure)

الإبلاغ عن فشل حالة اختبار فردية.

سيتم استدعاؤه بين testStarted وtestEnded.

حدود
`test`	`TestDescription` : يحدد الاختبار
`failure`	`FailureDescription` : `FailureDescription` الذي يصف الفشل وسياقه.

فشل الاختبار

public void testFailed (TestDescription test, 
                String trace)

الإبلاغ عن فشل حالة اختبار فردية.

سيتم استدعاؤه بين testStarted وtestEnded.

حدود
`test`	`TestDescription` : يحدد الاختبار
`trace`	`String` : تتبع مكدس الفشل

testIgnored

public void testIgnored (TestDescription test)

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

حدود
`test`	`TestDescription` : يحدد الاختبار

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

حدود
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

حدود
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

تقارير نهاية التشغيل التجريبي. إصلاح: لا يمكن أن يكون لدينا واجهتان Map<> بنوع مختلف، لذا يتعين علينا استخدام HashMap هنا.

حدود
`elapsedTime`	`long` : أبلغ الجهاز عن الوقت المنقضي، بالمللي ثانية
`runMetrics`	: أزواج القيمة الرئيسية التي تم الإبلاغ عنها في نهاية التشغيل التجريبي باستخدام `Metric` .

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

public void testRunFailed (FailureDescription failure)

فشل تشغيل اختبار التقارير في الاكتمال بسبب الفشل الموصوف بواسطة FailureDescription .

حدود
`failure`	`FailureDescription` : `FailureDescription` الذي يصف الفشل وسياقه.

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

public void testRunFailed (String errorMessage)

فشل تشغيل اختبار التقارير بسبب حدوث خطأ فادح.

حدود
`errorMessage`	`String` : `String` تصف سبب فشل التشغيل.

testRunStarted

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

يُعلن عن بداية التشغيل التجريبي.

حدود
`name`	`String` : اسم التشغيل التجريبي
`numTests`	`int` : العدد الإجمالي للاختبارات في التشغيل التجريبي
`attemptNumber`	`int` : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 0 ويجب أن يتزايد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال، تتم إعادة محاولة الاختبار 3 مرات، ويجب أن يحتوي على 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.

testRunStarted

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

يُعلن عن بداية التشغيل التجريبي.

حدود
`name`	`String` : اسم التشغيل التجريبي
`numTests`	`int` : العدد الإجمالي للاختبارات في التشغيل التجريبي
`attemptNumber`	`int` : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 0 ويجب أن يتزايد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال، تتم إعادة محاولة الاختبار 3 مرات، ويجب أن يحتوي على 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.
`startTime`	`long` : الوقت الذي بدأ فيه التشغيل، ويتم قياسه عبر `System.currentTimeMillis()`

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