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

أداة إعادة توجيه النتائج

public class ResultForwarder
extends Object implements ITestInvocationListener

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

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

FilteredResultforwarder وJarHostTest.HostTestListener وLogSaverResultfronter وLogcatCrashResultforwarder وPythonBinaryHostTest.Pythonforwarder وResultAndLogforwarder وrereResultResulter وShardMainResultResulterسياسة

FilteredResultforwarder	خيار `ResultForwarder` الذي يسمح فقط بقائمة مسموح بها يبلغ `TestDescription` تم الإبلاغ عنها.
JarHostTest.HostTestListener	أداة معالجة البرامج التي يعيد توجيه جميع الأحداث باستثناء testRunStarted() وtestRunEnded() إلى مستمع مضمَّن.
LogSaverResultforwarder	تكون هذه السمة `ResultForwarder` لحفظ السجلّات باستخدام ميزة "توفير الملفات العام".
LogcatCrashResultforwarder	مستمع خاص: عند حدوث إخفاقات (تعطل عملية الأدوات)، يحاول الاستخراج من Logcat عن العطل وتضيفه إلى رسالة الفشل المرتبطة بالاختبار.
PythonBinaryHostTest.Pythonforwarder	تعمل أداة إعادة توجيه النتائج على استبدال اسم عملية التشغيل بالاسم الثنائي.
ResultAndLogforwarder	أداة إعادة توجيه أحداث النتائج والسجلات
إعادة توجيه النتيجة	يشير ذلك المصطلح إلى إضافة للسمة `ResultForwarder` يتم إرسالها دائمًا إلى رقم محاولة معيّن.
ShardMainResultforwarder	تمثّل هذه السمة `ResultForwarder` يجمع بين نتائج استدعاءات الاختبار المقسّمة.
أداة تنفيذ مهلة الاختبار	أدوات معالجة الموسيقى التي تسمح بالتحقق من وقت تنفيذ حالة اختبار معينة وتفشل في حال استمرارها خلال مهلة محددة

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

GranularRetriableTestWrapper.StartEndCollector وRenameLogSaverResultforwarder

GranularRetriableTestWrapper.StartEndCollector	مساعد الصف لرصد بداية الجري ونهايته المفقودة
verifyLogSaverResultforwarder	مسؤول إعادة التوجيه الذي يتعامل أيضًا مع اجتياز المحاولة الحالية التي نحن بصددها.

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

ملخّص

شركة إنشاءات عامة
`ResultForwarder( listeners)` إنشاء `ResultForwarder`
`ResultForwarder(ITestInvocationListener... 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.تجاهل.
`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)` تحديد أدوات معالجة الأحداث بعد الإنشاء.

شركة إنشاءات عامة

أداة إعادة توجيه النتائج

public ResultForwarder ( listeners)

إنشاء ResultForwarder

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

أداة إعادة توجيه النتائج

public ResultForwarder (ITestInvocationListener... listeners)

الدالة الإنشائية المتغيرة للوسيطات في الدالة ResultForwarder.

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

منصات إنشاء محمية

أداة إعادة توجيه النتائج

protected ResultForwarder ()

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

الطرق العامة

الحصول على الملخص

public TestSummary getSummary ()

يسمح هذا الإذن لـ InvocationListener بعرض ملخص.

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

تم إنهاء الاستدعاء

public void invocationEnded (long elapsedTime)

البلاغات التي تفيد بإنهاء الاستدعاء، سواء بنجاح أو بسبب خطأ ما الشرط.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

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

تعذّر الاستدعاء

public void invocationFailed (FailureDescription failure)

تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

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

تعذّر الاستدعاء

public void invocationFailed (Throwable cause)

تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

المعلمات
`cause`	`Throwable`: السبب `Throwable` للتعذُّر

تم تخطّي الاستدعاء

public void invocationSkipped (SkipReason reason)

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

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

تم بدء الاستدعاء

public void invocationStarted (IInvocationContext context)

يبلِّغ عن بدء الاستدعاء للاختبار.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري. على المبلّغين إلغاء المشاركة هذه الطريقة لإتاحة إعداد تقارير عن أجهزة متعددة.

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

تعذُّر اختبار الافتراض

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

المعلمات
`test`	`TestDescription`: يحدد الاختبار
`trace`	`String`: تتبع تسلسل استدعاء الدوال البرمجية للفشل

تعذُّر اختبار الافتراض

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

المعلمات
`test`	`TestDescription`: يحدد الاختبار
`failure`	`FailureDescription`: `FailureDescription` يصف الخطأ وسياقه.

انتهى الاختبار

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)` من المقاييس المنبعثة

انتهى الاختبار

public void testEnded (TestDescription test, 
                 testMetrics)

تعمل هذه السياسة على الإبلاغ عن نهاية تنفيذ حالة اختبار فردية.

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

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

فشل الاختبار

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

المعلمات
`test`	`TestDescription`: يحدد الاختبار
`failure`	`FailureDescription`: `FailureDescription` يصف الخطأ وسياقه.

فشل الاختبار

public void testFailed (TestDescription test, 
                String trace)

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

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

المعلمات
`test`	`TestDescription`: يحدد الاختبار
`trace`	`String`: تتبع تسلسل استدعاء الدوال البرمجية للفشل

تم تجاهل الاختبار

public void testIgnored (TestDescription test)

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

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

testLog

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

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

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

سيستدعي إطار التجارة الفيدرالية هذه الطريقة تلقائيًا، مما يوفر سجل المضيف وأيضًا، Logcat.

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

وحدة اختبار انتهت

public void testModuleEnded ()

تقدم تقريرًا بنهاية تشغيل وحدة.

تم بدء الاختبار

public void testModuleStarted (IInvocationContext moduleContext)

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

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

اختبار RunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

نهاية تشغيل اختبار التقارير فيكس: لا يمكننا استخدام خريطتين<> وواجهات برمجة تطبيقات من نوع مختلف، لذلك ينبغي لنا استخدام HashMap هنا.

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

اختبار التشغيل فاشل

public void testRunFailed (FailureDescription failure)

تعذّر إكمال تشغيل اختبار التقارير بسبب تعذُّر وصفه من قِبل FailureDescription.

المعلمات
`failure`	`FailureDescription`: `FailureDescription` يصف الخطأ وسياقه.

اختبار التشغيل فاشل

public void testRunFailed (String errorMessage)

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

المعلمات
`errorMessage`	`String`: `String` يصف سبب تعذُّر التشغيل.

أمر testRunStarted

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

تبلّغ عن بدء إجراء اختبار.

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

testRunStopped

public void testRunStopped (long elapsedTime)

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

قائمة المهام: غير مستخدمة حاليًا، يمكنك إزالتها

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

تم تخطي الاختبار

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

تم بدء الاختبار

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()`

تم بدء الاختبار

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` الحقيقية لإعادة توجيه النتائج إليها