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

ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.invoker.ShardListener

إنّ ITestInvocationListener الذي يجمع النتائج من جزء الاستدعاء (المعروف أيضًا باسم تقسيم الاستدعاء ليتم تشغيله على عدة موارد بالتوازي) وإعادة توجيهها إلى موارد أخرى المستمع.

ملخّص

شركة إنشاءات عامة
`ShardListener(ITestInvocationListener main)` إنشاء `ShardListener`

الطرق العامة
	`getUnderlyingResultReporter()`
`void`	`invocationEnded(long elapsedTime)` البلاغات التي تفيد بإنهاء الاستدعاء، سواء بنجاح أو بسبب خطأ ما الشرط.
`void`	`invocationFailed(FailureDescription failure)` تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.
`void`	`invocationFailed(Throwable cause)` تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.
`void`	`invocationSkipped(SkipReason reason)` يتم الإبلاغ عن استدعاء على أنّه تم تخطّيه.
`void`	`invocationStarted(IInvocationContext context)` يبلِّغ عن بدء الاستدعاء للاختبار.
`void`	`logAssociation(String dataName, LogFile logFile)` في بعض الحالات، يجب أن يكون السجل مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، إلا أن فرصة إجراء لذلك في `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` المباشر لا يمكن معاودة الاتصال.
`void`	`setSupportGranularResults(boolean enableGranularResults)`
`boolean`	`supportGranularResults()` عرض "صحيح" إذا كان المبلِّغ يدعم النتائج الدقيقة، أو يعرض "خطأ" في الحالات الأخرى.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` يتم توفير السجلّ المرتبط أو بيانات تصحيح الأخطاء من استدعاء الاختبار.
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testModuleEnded()` تقدم تقريرًا بنهاية تشغيل وحدة.
`void`	`testModuleStarted(IInvocationContext moduleContext)` تبلغ عن بداية وحدة قيد التشغيل.
`void`	`testRunEnded(long elapsedTime, runMetrics)` نهاية تشغيل اختبار التقارير
`void`	`testRunFailed(FailureDescription failure)` تعذّر إكمال تشغيل اختبار التقارير بسبب تعذُّر وصفه من قِبل `FailureDescription`.
`void`	`testRunFailed(String failureMessage)` تعذّر إكمال عملية اختبار التقارير بسبب خطأ فادح.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` تبلّغ عن بدء إجراء اختبار.

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

ShardListener

public ShardListener (ITestInvocationListener main)

إنشاء ShardListener

المعلمات
`main`	`ITestInvocationListener`: `ITestInvocationListener` النتائج التي يجب إعادة توجيه النتائج إليها لمنع مع `ShardListener` أخرى، ستتم مزامنة هذا الكائن على `main` عند إعادة توجيه النتائج. وسيتم إرسال النتائج فقط بعد يكتمل جزء الاستدعاء.

الطرق العامة

getunderlyingResultReporter

public  getUnderlyingResultReporter ()

المرتجعات

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

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`: معلومات عن الاستدعاء

مؤسسة Log Association

public void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات، يجب أن يكون السجل مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، إلا أن فرصة إجراء لذلك في testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) المباشر لا يمكن معاودة الاتصال. وبالتالي، تسمح معاودة الاتصال هذه بتوفير ارتباط قوي بشكل صريح.

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

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

المعلمات
`enableGranularResults`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

عرض "صحيح" إذا كان المبلِّغ يدعم النتائج الدقيقة، أو يعرض "خطأ" في الحالات الأخرى.

المرتجعات
`boolean`

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 testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

المعلمات
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

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

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 failureMessage)

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

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

أمر testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

المعلمات
`name`	`String`: اسم إجراء الاختبار
`numTests`	`int`: إجمالي عدد الاختبارات أثناء إجراء الاختبار
`attemptNumber`	`int`: رقم الطلب، مع تحديد المحاولات المختلفة لعملية runName نفسها يتم تشغيلها عدة مرات. تكون محاولة الحساب مفهرسة بمقدار 0 ويجب أن تزيد في كل مرة تشغيل جديد. مثلاً: تتم إعادة محاولة الاختبار بدقة 3 مرات، ومن المفترض أن يتضمن إجمالي 4 نقاط. تحت نفس runName ، ويتراوح عدد المحاولة بين 0 و3.
`startTime`	`long`: وقت بدء الجري، ويتم قياسه من خلال `System.currentTimeMillis()`