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

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

TestResultListener

public abstract class TestResultListener
extends Object implements ITestLifeCycleReceiver

java.lang.Object
↳	com.android.tradefed.result.TestResultListener

الفئات الفرعية المباشرة المعروفة

ConsoleResultReporter وCountingTestResultListener وPassingTestFileReporter

ConsoleResultReporter	أداة إعداد التقارير لطباعة نتائج الاختبار في وحدة التحكّم
CountingTestResultListener	`TestResultListener` تتتبّع إجمالي عدد الاختبارات حسب `TestStatus`
PassingTestFileReporter	`ITestInvocationListener` لحفظ قائمة حالات الاختبار التي اجتازت الاختبار في ملف اختبار

تبسيط واجهة برمجة التطبيقات ITestLifecycleListener للمنفِّذِين الذين لا يهتمون إلا بنتائج الاختبار الفردية

وهي تصفّل أحداث دورة الحياة المختلفة إلى طريقة testResult.

وهي ليست آمنة لتعدد المواضيع، وعلى وجه الخصوص، تفترض أنّه يتم تلقّي أحداث ITestLifecycleListener بالترتيب.

ملخّص

وظائف الإنشاء العامة
`TestResultListener()`

الطرق العامة
`final void`	`testAssumptionFailure(TestDescription test, String trace)` يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.
`final void`	`testEnded(TestDescription test, testMetrics)` يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي.
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)` بديل `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` حيث يمكننا تحديد وقت الانتهاء مباشرةً.
`final void`	`testFailed(TestDescription test, String trace)` الإبلاغ عن تعذُّر اختبار فردي
`final void`	`testIgnored(TestDescription test)` يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.
`abstract void`	`testResult(TestDescription test, TestResult result)`
`void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` الإبلاغ عن نهاية عملية الاختبار
`void`	`testSkipped(TestDescription test, SkipReason reason)` يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً.
`final void`	`testStarted(TestDescription test, long startTime)` بديل عن `testStarted(com.android.tradefed.result.TestDescription)` حيث نحدّد أيضًا وقت بدء الاختبار ، مع `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` لإجراء قياس دقيق.
`final void`	`testStarted(TestDescription test)` الإبلاغ عن بدء حالة اختبار فردية

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

TestResultListener

public TestResultListener ()

الطرق العامة

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

المعلمات
`test`	`TestDescription`: لتحديد الاختبار
`trace`	`String`: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي.

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

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

testEnded

public final 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)` من المقاييس التي تمّ قياسها

testFailed

public final void testFailed (TestDescription test, 
                String trace)

الإبلاغ عن تعذُّر اختبار فردي

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

المعلمات
`test`	`TestDescription`: لتحديد الاختبار
`trace`	`String`: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testIgnored

public final void testIgnored (TestDescription test)

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

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

testResult

public abstract void testResult (TestDescription test, 
                TestResult result)

المعلمات
`test`	`TestDescription`
`result`	`TestResult`

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

المعلمات
`elapsedTimeMillis`	‫`long`: الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية
`runMetrics`	: أزواج المفتاح/القيمة التي يتم الإبلاغ عنها في نهاية عملية الاختبار

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً. سيتمّ إعادة إجراء هذه الاختبارات لمحاولة الحصول على تنفيذ سليم.

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

testStarted

public final 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 final void testStarted (TestDescription test)

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

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