ModuleResultsAndMetricsForwarder

public class ModuleResultsAndMetricsForwarder
extends ResultAndLogForwarder

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.ResultAndLogForwarder
		↳	com.android.tradefed.result.ModuleResultsAndMetricsForwarder

---

هي امتداد لـ ResultAndLogForwarder يضيف مقاييس إضافية ذات صلة بالوحدة إلى نتائج الاختبار.

ملخّص

الإنشاءات العامة
ModuleResultsAndMetricsForwarder(ITestInvocationListener... listeners)

الطُرق العامة
void	setAttemptIsolation(CurrentInvocation.IsolationGrade isolation) تضبط هذه السمة ما إذا كان يجب الإبلاغ عن المحاولة على أنّها معزولة أم لا.
void	setMarkTestsSkipped(boolean skip) تحديد ما إذا كان سيتم وضع علامة "تم تخطّيها" على جميع حالات الاختبار أم لا
void	setModuleId(String moduleId)
void	setTestMappingSources( testMappingSources) تضبط مصادر ربط الاختبارات التي سيتم إدراجها في المقاييس.
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	testRunEnded(long elapsedTimeMillis, runMetrics) تقارير نهاية عملية الاختبار
void	testRunFailed(FailureDescription failure) تعذّر إكمال تشغيل الاختبار التجريبي للتقارير بسبب حدوث خطأ موصوف في FailureDescription.
void	testRunFailed(String errorMessage) تعذّر إكمال تشغيل الاختبار للتقارير بسبب حدوث خطأ فادح.
void	testRunStarted(String runName, int testCount, int attemptNumber) تسجيل بداية تشغيل الاختبار
void	testRunStarted(String runName, int testCount, 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)) للحصول على قياس دقيق.
void	testStarted(TestDescription test) تسجّل هذه السمة بداية حالة اختبار فردية.

الشركات المصنِّعة العامة

ModuleResultsAndMetricsForwarder

public ModuleResultsAndMetricsForwarder (ITestInvocationListener... listeners)

المعلمات
listeners	ITestInvocationListener

الطُرق العامة

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

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

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

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

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

المعلمات
skip	boolean

setModuleId

public void setModuleId (String moduleId)

المعلمات
moduleId	String

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

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

المعلمات
testMappingSources

testEnded

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) المقاييس التي تمّ إرسالها

testEnded

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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

تقارير نهاية عملية الاختبار

المعلمات
elapsedTimeMillis	‫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 runName, 
                int testCount, 
                int attemptNumber)

تسجّل هذه السمة بداية تشغيل الاختبار.

المعلمات
runName	‫String: اسم عملية التشغيل الاختبارية
testCount	‫int: إجمالي عدد الاختبارات في عملية الاختبار
attemptNumber	‫int: رقم الطلب، الذي يحدّد المحاولات المختلفة لـ runName نفسه الذي يتم تنفيذه عدة مرات. يتم فهرسة attemptNumber بدءًا من 0، ويجب أن يزيد في كل مرة يتم فيها تنفيذ عملية جديدة. على سبيل المثال، إذا تمت إعادة محاولة اختبار دقيق 3 مرات، يجب أن يتم تنفيذه 4 مرات إجمالاً ضمن runName نفسه، ويجب أن يتراوح attemptNumber بين 0 و3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

تسجّل هذه السمة بداية تشغيل الاختبار.

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

testStarted

public void testStarted (TestDescription test)

تسجّل هذه السمة بداية حالة اختبار فردية. واجهة قديمة، يجب استخدام testStarted(com.android.tradefed.result.TestDescription) كلما أمكن ذلك.

المعلمات
test	‫TestDescription: تحدّد الاختبار