اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

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

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`	`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)` الإبلاغ عن بدء عملية اختبار
`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`

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

الإبلاغ عن بدء عملية اختبار

المعلمات
`runName`	`String`: اسم اختبار التنفيذ
`testCount`	`int`: إجمالي عدد الاختبارات في اختبار التنفيذ

testRunStarted

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

الإبلاغ عن بدء عملية اختبار

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