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

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

ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

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

FilteredResultForwarder وJarHostTest.HostTestListener وLogSaverResultForwarder وLogcatCrashResultForwarder وPythonBinaryHostTest.PythonForwarder وResultAndLogForwarder وRetryResultForwarder وShardMainResultForwarder وTestTimeoutEnforcer

FilteredResultForwarder	نوع من `ResultForwarder` لا يسمح إلا بتسجيل قائمة مسموح بها من `TestDescription`.
JarHostTest.HostTestListener	مستمع الغلاف الذي يعيد توجيه جميع الأحداث باستثناء testRunStarted() وtestRunEnded() إلى المستمع المضمّن
LogSaverResultForwarder	`ResultForwarder` لحفظ السجلات باستخدام أداة حفظ الملفات الشاملة
LogcatCrashResultForwarder	مستمع خاص: في حال حدوث أخطاء (تعطُّل عملية أداة القياس)، سيحاول استخراج معلومات عن الأعطال من logcat وإضافتها إلى رسالة الخطأ المرتبطة بالاختبار.
PythonBinaryHostTest.PythonForwarder	أداة إعادة توجيه النتائج لاستبدال اسم التشغيل باسم ثنائي
ResultAndLogForwarder	أداة إعادة توجيه للنتائج وأحداث السجلّ
RetryResultForwarder	إضافة `ResultForwarder` يتم دفعها دائمًا إلى عدد محاولات معيّن.
ShardMainResultForwarder	`ResultForwarder` يجمع نتائج عمليات استدعاء الاختبار المجزّأ
TestTimeoutEnforcer	المستمعون الذين يسمحون بالتحقّق من وقت تنفيذ حالة اختبار معيّنة وإفشالها إذا تجاوزت مهلة معيّنة

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

GranularRetriableTestWrapper.StartEndCollector، RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	مساعد فئة لرصد بداية ونهاية التشغيل غير المتوفّرة
RetryLogSaverResultForwarder	مُرسِل يتعامل أيضًا مع اجتياز المحاولة الحالية التي نحاول إجراؤها

ITestInvocationListener يعيد توجيه نتائج الاستدعاء إلى قائمة بالمستمعِين الآخرين

ملخّص

وظائف الإنشاء العامة
`ResultForwarder(ITestInvocationListener... listeners)` دالة إنشاء وسيطة متغيّرة بديلة `ResultForwarder`
`ResultForwarder( listeners)` أنشئ `ResultForwarder`.

وظائف الإنشاء المحمية
`ResultForwarder()` أنشئ `ResultForwarder` مع إعداد أداة الاستماع المؤجّلة.

الطرق العامة
`TestSummary`	`getSummary()` يسمح لـ InvocationListener بإرجاع ملخّص.
`void`	`invocationEnded(long elapsedTime)` تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.
`void`	`invocationFailed(FailureDescription failure)` الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ
`void`	`invocationFailed(Throwable cause)` الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ
`void`	`invocationSkipped(SkipReason reason)` الإبلاغ عن طلب استدعاء كطلب تم تخطّيه
`void`	`invocationStarted(IInvocationContext context)` الإبلاغ عن بدء استدعاء الاختبار
`void`	`testAssumptionFailure(TestDescription test, String trace)` يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.
`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`	`testIgnored(TestDescription test)` يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` يوفّر بيانات السجلّ أو تصحيح الأخطاء المرتبطة من طلب الاختبار.
`void`	`testModuleEnded()` الإبلاغ عن نهاية تشغيل وحدة
`void`	`testModuleStarted(IInvocationContext moduleContext)` الإبلاغ عن بدء تشغيل وحدة
`void`	`testRunEnded(long elapsedTime, 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`	`testRunStopped(long elapsedTime)` توقّف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب أحد المستخدِمين.
`void`	`testSkipped(TestDescription test, SkipReason reason)` يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً.
`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)` الإبلاغ عن بدء حالة اختبار فردية

الطرق المحمية
	`getListeners()` الحصول على قائمة المستمعين
`void`	`setListeners(ITestInvocationListener... listeners)` اضبط المستمعين بعد الإنشاء.
`void`	`setListeners( listeners)` اضبط المستمعين بعد الإنشاء.

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

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

دالة إنشاء وسيطة متغيّرة بديلة ResultForwarder

المعلمات
`listeners`	`ITestInvocationListener`: عناوين `ITestInvocationListener` الفعلية لإعادة توجيه النتائج إليها

ResultForwarder

public ResultForwarder ( listeners)

أنشئ ResultForwarder.

المعلمات
`listeners`	: عناوين `ITestInvocationListener` الفعلية لإعادة توجيه النتائج إليها

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

ResultForwarder

protected ResultForwarder ()

أنشئ ResultForwarder مع إعداد أداة الاستماع المؤجّلة. مخصّص للاستخدام فقط من قِبل الفئات الفرعية.

الطرق العامة

getSummary

public TestSummary getSummary ()

يسمح لـ InvocationListener بإرجاع ملخّص.

المرتجعات
`TestSummary`	`TestSummary` تلخيص عملية التنفيذ أو قيمة فارغة

invocationEnded

public void invocationEnded (long elapsedTime)

تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
`elapsedTime`	‫`long`: الوقت المنقضي منذ بدء الطلب بالملي ثانية

invocationFailed

public void invocationFailed (FailureDescription failure)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
`failure`	`FailureDescription`: `FailureDescription` الذي يصف سبب تعذُّر التنفيذ

invocationFailed

public void invocationFailed (Throwable cause)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
`cause`	`Throwable`: `Throwable` سبب الخطأ

invocationSkipped

public void invocationSkipped (SkipReason reason)

الإبلاغ عن طلب استدعاء كطلب تم تخطّيه

المعلمات
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

الإبلاغ عن بدء استدعاء الاختبار

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation. على مُرسِلي البلاغات إلغاء هذه الطريقة لتفعيل إعداد تقارير عن أجهزة متعددة.

المعلمات
`context`	`IInvocationContext`: معلومات عن الاستدعاء

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

testIgnored

public void testIgnored (TestDescription test)

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

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

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

يوفّر بيانات السجلّ أو تصحيح الأخطاء المرتبطة من طلب الاختبار.

يجب الاتصال به قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

سيستدعي إطار عمل TradeFederation هذه الطريقة تلقائيًا، ما يؤدي إلى توفير سجلّ المضيف وسجلّ logcat للجهاز، إن أمكن.

المعلمات
`dataName`	`String`: اسم `String` وصفي للبيانات، مثل "device_logcat". ملاحظة: قد لا يكون dataName فريدًا لكلّ طلب. أي أنّه يجب أن يتمكّن مُنفّذو الإجراء من التعامل مع عدة طلبات باستخدام dataName نفسه.
`dataType`	`LogDataType`: `LogDataType` البيانات
`dataStream`	`InputStreamSource`: `InputStreamSource` البيانات على مُنفِّذي الإجراء استدعاء createInputStream لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند اكتمال العملية. على المُتصلين التأكّد من بقاء مصدر البيانات متوفّرًا وقابلاً للوصول إليه إلى أن تكتمل طريقة testLog.

testModuleEnded

public void testModuleEnded ()

الإبلاغ عن نهاية تشغيل وحدة

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

الإبلاغ عن بدء تشغيل وحدة يرتبط هذا المرجع الداعم بـ testModuleEnded() وهو اختياري في التسلسل. ولا يتم استخدامه إلا أثناء عملية تشغيل تستخدِم وحدات: برامج التشغيل المستندة إلى المجموعة.

المعلمات
`moduleContext`	`IInvocationContext`: `IInvocationContext` الوحدة

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

المعلمات
`elapsedTime`	‫`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()`

testRunStopped

public void testRunStopped (long elapsedTime)

توقّف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب أحد المستخدِمين.

TODO: currently unused, consider removing

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

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`: لتحديد الاختبار

الطرق المحمية

getListeners

protected  getListeners ()

الحصول على قائمة المستمعين مخصّص للاستخدام من قِبل الفئات الفرعية فقط.

المرتجعات
	قائمة `ITestInvocationListener`

setListeners

protected void setListeners (ITestInvocationListener... listeners)

اضبط المستمعين بعد الإنشاء. مخصّص للاستخدام من قِبل الفئات الفرعية فقط.

المعلمات
`listeners`	`ITestInvocationListener`: عناوين `ITestInvocationListener` الفعلية لإعادة توجيه النتائج إليها

setListeners

protected void setListeners ( listeners)

اضبط المستمعين بعد الإنشاء. مخصّص للاستخدام من قِبل الفئات الفرعية فقط.

المعلمات
`listeners`	: عناوين `ITestInvocationListener` الفعلية لإعادة توجيه النتائج إليها