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

وحدة الاستماع

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)` المباشر لا يمكن معاودة الاتصال.
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` تحدد ما إذا كان يجب الإبلاغ عن المحاولة كمحاولة معزولة أم لا.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` تحدّد ما إذا كنا نجمع الاختبارات فقط أم لا.
`void`	`setMarkTestsSkipped(boolean skip)` تحديد ما إذا كان سيتم وضع علامة على جميع حالات الاختبار التي تم تخطّيها
`void`	`setTestMappingSources( testMappingSources)` إعداد مصادر ربط الاختبار التي سيتم إدراجها في المقاييس.
`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.تجاهل.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`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, int attemptNumber, long startTime)` تبلّغ عن بدء إجراء اختبار.
`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))`، للحصول على قياس دقيق.

شركة إنشاءات عامة

وحدة الاستماع

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

المنشئ.

المعلمات
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

الطرق العامة

لديها آخر محاولة فاشلة

public boolean hasLastAttemptFailed ()

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

المرتجعات
`boolean`

مؤسسة Log Association

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` الذي تم تسجيله سابقًا والذي يجب ربطه حالة الاختبار.

عزل المجموعة

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

تحدد ما إذا كان يجب الإبلاغ عن المحاولة كمحاولة معزولة أم لا.

المعلمات
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

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

المعلمات
`collectTestsOnly`	`boolean`

تم تخطي setMarkTests

public void setMarkTestsSkipped (boolean skip)

تحديد ما إذا كان سيتم وضع علامة على جميع حالات الاختبار التي تم تخطّيها

المعلمات
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

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

المعلمات
`testMappingSources`

تعذُّر اختبار الافتراض

public void testAssumptionFailure (TestDescription test, 
                String trace)

يتم استدعاؤه عندما يُبلغ الاختبار الذري عن أنه يفترض شرطًا خاطئًا

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

تعذُّر اختبار الافتراض

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`: تتبع تسلسل استدعاء الدوال البرمجية للفشل

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

public void testIgnored (TestDescription test)

يتم استدعاء هذا الإجراء عندما لا يتم إجراء الاختبار، وعادةً ما يكون هناك تعليق توضيحي لطريقة الاختبار org.junit.تجاهل.

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

testLog

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

المعلمات
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

تم حفظ سجلّ الاختبار

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

المعلمات
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

اختبار RunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

نهاية تشغيل اختبار التقارير فيكس: لا يمكننا استخدام خريطتين<> وواجهات برمجة تطبيقات من نوع مختلف، لذلك ينبغي لنا استخدام 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`: رقم الطلب، مع تحديد المحاولات المختلفة لعملية runName نفسها يتم تشغيلها عدة مرات. تكون المحاولة رقم 0 مفهرسة ويجب أن تزيد في كل مرة. عملية تشغيل جديدة. مثلاً: تمّت إعادة المحاولة 3 مرّات بدقة أكبر، ويجب أن يتضمّن إجمالي 4 اختبارات. تحت نفس runName ، ويكون الناتج من 0 إلى 3.

أمر testRunStarted

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

تبلّغ عن بدء إجراء اختبار.

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

تم تخطي الاختبار

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