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) المباشرة.
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.ignore.
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)) لإجراء قياس دقيق.

وظائف الإنشاء العامة

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

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

setAttemptIsolation

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: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

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

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: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

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

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)

نهاية تشغيل اختبار التقارير

المعلمات
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: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدة مرات. تكون المحاولة الأولى مفهرسة بمقدار 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 نفسها التي يتم تنفيذها عدة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد في كلّ مرّة يتمّ فيها تنفيذ عملية تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عمليات التشغيل التي تمّ إجراؤها 4 مرّات ضمن اسم التشغيل نفسه، ويجب أن تتراوح مَعلمة attemptNumber بين 0 و3.
startTime	long: وقت بدء التنفيذ، يتم قياسه من خلال System.currentTimeMillis()

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