اعتبارًا من عام 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.

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,LogDataType,InputStreamSource,LogFile)`.
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` تضبط هذه السمة ما إذا كان يجب الإبلاغ عن المحاولة على أنّها معزولة أم لا.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` تحدّد هذه السمة ما إذا كنا نجمع الاختبارات فقط.
`void`	`setMarkTestsSkipped(boolean skip)` تحديد ما إذا كان سيتم وضع علامة "تم تخطّيها" على جميع حالات الاختبار أم لا
`void`	`setTestMappingSources(List<String> testMappingSources)` تضبط مصادر ربط الاختبارات التي سيتم إدراجها في المقاييس.
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`void`	`testAssumptionFailure(TestDescription test, String trace)` يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` بديل `testEnded(TestDescription,Map)` حيث يمكننا تحديد وقت الانتهاء مباشرةً.
`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, HashMap<String, MetricMeasurement.Metric> 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(TestDescription)` حيث نحدّد أيضًا وقت بدء الاختبار، بالإضافة إلى `testEnded(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,LogDataType,InputStreamSource,LogFile). وبالتالي، يتيح هذا الإجراء الرجعي توفير ارتباط قوي بشكل صريح.

المعلَمات
`dataName`	‫`String`: اسم البيانات
`logFile`	`LogFile`: `LogFile` الذي تم تسجيله من قبل ويجب ربطه بحالة الاختبار.

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

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

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

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

تحدّد هذه السمة ما إذا كنا نجمع الاختبارات فقط.

المعلَمات
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

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

المعلَمات
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources (List<String> testMappingSources)

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

المعلَمات
`testMappingSources`	`List`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

المعلَمات
`useModuleResultsForwarder`	`boolean`

testAssumptionFailure

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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

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

المعلَمات
`test`	‫`TestDescription`: تحدّد الاختبار
`testMetrics`	`HashMap`: `Map` للمقاييس التي تمّ إرسالها

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

بديل testEnded(TestDescription,Map) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بينها وبين testStarted(TestDescription,long) للحصول على قياس دقيق.

المعلَمات
`test`	‫`TestDescription`: تحدّد الاختبار
`endTime`	‫`long`: الوقت الذي انتهى فيه الاختبار، ويتم قياسه باستخدام `System.currentTimeMillis()`
`testMetrics`	`HashMap`: `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`: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testIgnored

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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

تقارير نهاية عملية الاختبار FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

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

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`: رقم الطلب، الذي يحدّد المحاولات المختلفة لـ runName نفسه الذي يتم تنفيذه عدة مرات. يتم فهرسة attemptNumber بدءًا من 0، ويجب أن يزيد في كل مرة يتم فيها تنفيذ عملية جديدة. على سبيل المثال، إذا تمت إعادة محاولة اختبار دقيق 3 مرات، يجب أن يتم تنفيذه 4 مرات إجمالاً ضمن runName نفسه، ويجب أن يتراوح attemptNumber بين 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 مرات إجمالاً ضمن runName نفسه، ويجب أن يتراوح 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(TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار، بالإضافة إلى testEnded(TestDescription,long,Map) للحصول على قياس دقيق.

المعلَمات
`test`	‫`TestDescription`: تحدّد الاختبار
`startTime`	‫`long`: الوقت الذي بدأت فيه التجربة، ويتم قياسه باستخدام `System.currentTimeMillis()`