اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

TestRunToTestInvocationForwarder

public class TestRunToTestInvocationForwarder
extends Object implements ITestRunListener

java.lang.Object
↳	com.android.tradefed.result.ddmlib.TestRunToTestInvocationForwarder

أداة إعادة التوجيه من ITestRunListener في ddmlib إلى ITestLifeCycleReceiver واجهة تضمن تحويل النتائج من واجهة ddmlib إلى واجهة Tradefed

ترتبط واجهة Ddmlib بإجراء اختبارات قياس الأداء.

ملخّص

الثوابت
`String`	`ERROR_MESSAGE_FORMAT`

طُرق وضع التصميم العامة
`TestRunToTestInvocationForwarder(ITestLifeCycleReceiver listener)`
`TestRunToTestInvocationForwarder(Collection<ITestLifeCycleReceiver> listeners)`

الإجراءات العامة
`void`	`testAssumptionFailure(TestIdentifier testId, String trace)` يتم استدعاء هذا الإجراء عندما يشير اختبار أساسي إلى أنّه يفترض شرطًا غير صحيح.
`void`	`testEnded(TestIdentifier testId, Map<String, String> testMetrics)` يُبلغ عن نهاية تنفيذ حالة اختبار فردية.
`void`	`testFailed(TestIdentifier testId, String trace)` يُبلغ عن تعذُّر حالة اختبار فردية.
`void`	`testIgnored(TestIdentifier testId)` يتم استدعاء هذا الإجراء عندما لا يتم إجراء اختبار، وعادةً لأنّ طريقة الاختبار تم وضع تعليق توضيحي لها باستخدام org.junit.Ignore.
`void`	`testRunEnded(long elapsedTime, Map<String, String> runMetrics)` يُبلغ عن نهاية تشغيل الاختبار.
`void`	`testRunFailed(String failure)` يُبلغ عن تعذُّر إكمال تشغيل الاختبار بسبب حدوث خطأ فادح.
`void`	`testRunStarted(String runName, int testCount)` يُبلغ عن بدء تشغيل الاختبار.
`void`	`testRunStopped(long elapsedTime)` يُبلغ عن إيقاف تشغيل الاختبار قبل إكماله بسبب طلب من المستخدم.
`void`	`testStarted(TestIdentifier testId)` يُبلغ عن بدء حالة اختبار فردية.

الثوابت

ERROR_MESSAGE_FORMAT

public static final String ERROR_MESSAGE_FORMAT

Constant Value: "Runner reported an invalid method '%s' (%s). Something went wrong, Skipping its reporting."

طُرق وضع التصميم العامة

TestRunToTestInvocationForwarder

public TestRunToTestInvocationForwarder (ITestLifeCycleReceiver listener)

المعلَمات
`listener`	`ITestLifeCycleReceiver`

TestRunToTestInvocationForwarder

public TestRunToTestInvocationForwarder (Collection<ITestLifeCycleReceiver> listeners)

المعلَمات
`listeners`	`Collection`

الإجراءات العامة

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier testId, 
                String trace)

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

المعلَمات
`testId`	`TestIdentifier`: يحدّد الاختبار
`trace`	`String`: تتبُّع تسلسل استدعاء الدوال البرمجية للتعطُّل

testEnded

public void testEnded (TestIdentifier testId, 
                Map<String, String> testMetrics)

يُبلغ عن نهاية تنفيذ حالة اختبار فردية.

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

المعلَمات

testId

TestIdentifier: يحدّد الاختبار

testMetrics

Map: ‏Map للمقاييس التي تم إصدارها أثناء تنفيذ حالة الاختبار من خلال android.app.Instrumentation#sendStatus يتم الاحتفاظ بترتيب الإدراج ما لم يتم إصدار مفتاح نفسه عدة مرات. يُرجى العِلم أنّه يتم فلترة المفاتيح العادية المحدّدة في IInstrumentationResultParser.StatusKeys من هذا العنصر `Map`. قد تضيف Ddmlib مقاييس اختبار إضافية محدّدة في IInstrumentationResultParser.StatusKeys.

testFailed

public void testFailed (TestIdentifier testId, 
                String trace)

يُبلغ عن تعذُّر حالة اختبار فردية.

سيتم استدعاء هذا الإجراء بين testStarted وtestEnded.

المعلَمات
`testId`	`TestIdentifier`: يحدّد الاختبار
`trace`	`String`: تتبُّع تسلسل استدعاء الدوال البرمجية للتعطُّل

testIgnored

public void testIgnored (TestIdentifier testId)

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

المعلَمات
`testId`	`TestIdentifier`: يحدّد الاختبار

testRunEnded

public void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

يُبلغ عن نهاية تشغيل الاختبار.

المعلَمات

elapsedTime

long: الوقت المنقضي الذي أبلغ عنه الجهاز، بالملّي ثانية

runMetrics

Map: ‏Map للمقاييس التي تم إصدارها أثناء تنفيذ حالة الاختبار من خلال android.app.Instrumentation#addResults. يتم الاحتفاظ بترتيب الإدراج ما لم يتم إصدار مفتاح نفسه عدة مرات. يُرجى العِلم أنّه يتم فلترة المفاتيح العادية المحدّدة في IInstrumentationResultParser.StatusKeys من هذا العنصر `Map`. قد تضيف Ddmlib مقاييس اختبار إضافية محدّدة في IInstrumentationResultParser.StatusKeys.

testRunFailed

public void testRunFailed (String failure)

يُبلغ عن تعذُّر إكمال تشغيل الاختبار بسبب حدوث خطأ فادح.

المعلَمات
`failure`	`String`: `String` يصف سبب تعذُّر تشغيل الاختبار

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

يُبلغ عن بدء تشغيل الاختبار.

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

testRunStopped

public void testRunStopped (long elapsedTime)

يُبلغ عن إيقاف تشغيل الاختبار قبل إكماله بسبب طلب من المستخدم.

المعلَمات
`elapsedTime`	`long`: الوقت المنقضي الذي أبلغ عنه الجهاز، بالملّي ثانية

testStarted

public void testStarted (TestIdentifier testId)

يُبلغ عن بدء حالة اختبار فردية.

المعلَمات
`testId`	`TestIdentifier`: يحدّد الاختبار