تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مستمع شارد

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 .

الأساليب العامة

void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationStarted ( IInvocationContext context)

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

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) testRunEnded (long elapsedTime, runMetrics)

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

void testRunFailed ( FailureDescription failure)

فشل تشغيل اختبار التقارير في الإكمال بسبب فشل تم وصفه بواسطة FailureDescription .

void testRunFailed (String failureMessage)

تقارير فشل التشغيل الاختباري بسبب خطأ فادح.

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

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

المنشئون العامة

مستمع شارد

public ShardListener (ITestInvocationListener main)

قم بإنشاء ShardListener .

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

الأساليب العامة

انتهى الدعاء

public void invocationEnded (long elapsedTime)

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

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

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

الدعاء فشل

public void invocationFailed (FailureDescription failure)

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

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

المعلمات
failure FailureDescription : وصف FailureDescription في وصف سبب الفشل

الدعاء فشل

public void invocationFailed (Throwable cause)

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

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

المعلمات
cause Throwable : Throwable الفشل

بدأ الاحتجاج

public void invocationStarted (IInvocationContext context)

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

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

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

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

المعلمات
enableGranularResults boolean

دعم النتائج الحبيبية

public boolean supportGranularResults ()

إرجاع صحيح إذا كان المراسل يدعم النتائج التفصيلية ، خطأ إذا كان العكس.

عائدات
boolean

testLog

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

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

يجب استدعاء قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

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

المعلمات
dataName String : String اسم وصفي للبيانات. على سبيل المثال "device_logcat". ملاحظة قد لا يكون اسم البيانات فريدًا لكل طلب. على سبيل المثال ، يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات

dataType LogDataType : LogDataType للبيانات

dataStream InputStreamSource : مصدر البيانات InputStreamSource . يجب على المنفذين استدعاء createInputStream لبدء قراءة البيانات ، والتأكد من إغلاق InputStream الناتج عند الانتهاء. يجب على المتصلين التأكد من أن مصدر البيانات يظل موجودًا ويمكن الوصول إليه حتى تكتمل طريقة testLog.

testLog تم الحفظ

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

المعلمات
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

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

public void testModuleEnded ()

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

testModule بدأ

public void testModuleStarted (IInvocationContext moduleContext)

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

المعلمات
moduleContext IInvocationContext : IInvocationContext للوحدة النمطية.

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

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

runMetrics : تم الإبلاغ عن أزواج المفتاح والقيمة في نهاية تشغيل اختباري باستخدام Metric .

testRunFailed

public void testRunFailed (FailureDescription failure)

فشل تشغيل اختبار التقارير في الإكمال بسبب فشل تم وصفه بواسطة FailureDescription .

المعلمات
failure FailureDescription : FailureDescription يصف الفشل وسياقه.

testRunFailed

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 التي يتم تشغيلها عدة مرات. tryNumber هو 0 مفهرس ويجب أن يزداد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال ، تمت إعادة محاولة الاختبار المحبب 3 مرات ، يجب أن يكون له 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.

startTime long : الوقت الذي بدأ فيه التشغيل ، ويتم قياسه عبر System.currentTimeMillis()