SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

تنفيذ ITestInvocationListener الذي سيتم تحديده على هيئة results_reporter وإعادة التوجيه من والمعالجة الفرعية لنتائج الاختبارات وعمليات الاختبار والاستدعاءات التجريبية.

ملخّص

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

SubprocessResultsReporter()

الطرق العامة

void close()

TestSummary getSummary()

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

void invocationEnded(long elapsedTime)

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

void invocationFailed(FailureDescription failure)

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

void invocationFailed(Throwable cause)

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

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 printEvent(String key, Object event)

مساعد لطباعة مفتاح الحدث ثم كائن json.

void setOutputTestLog(boolean outputTestLog)

تحدد ما إذا كان يجب علينا إخراج الاختبار الذي تم تسجيله أم لا.

boolean supportGranularResults()

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

void testAssumptionFailure(TestDescription testId, String trace)

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

void testAssumptionFailure(TestDescription testId, FailureDescription failure)

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

void testEnded(TestDescription testId, long endTime, metrics)

بديل عن ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً.

void testEnded(TestDescription testId, metrics)

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

void testFailed(TestDescription testId, FailureDescription failure)

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

void testFailed(TestDescription testId, String reason)

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

void testIgnored(TestDescription testId)

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

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

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

void testModuleEnded()

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

void testModuleStarted(IInvocationContext moduleContext)

تبلغ عن بداية وحدة قيد التشغيل.

void testRunEnded(long time, runMetrics)

نهاية تشغيل اختبار التقارير

void testRunFailed(FailureDescription failure)

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

void testRunFailed(String reason)

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

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

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

void testSkipped(TestDescription testId, SkipReason reason)

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

void testStarted(TestDescription testId, long startTime)

بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدد أيضًا وقت إجراء الاختبار تم البدء، إلى جانب ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))، للحصول على قياس دقيق.

void testStarted(TestDescription testId)

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

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

SubprocessResultsReporter

public SubprocessResultsReporter ()

الطرق العامة

إغلاق

public void close ()

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

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 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 الذي تم تسجيله سابقًا والذي يجب ربطه حالة الاختبار.

printEvent

public void printEvent (String key, 
                Object event)

مساعد لطباعة مفتاح الحدث ثم كائن json.

المعلمات
key String

event Object

تعيين OutputTestLog

public void setOutputTestLog (boolean outputTestLog)

تحدد ما إذا كان يجب علينا إخراج الاختبار الذي تم تسجيله أم لا.

المعلمات
outputTestLog boolean

supportGranularResults

public boolean supportGranularResults ()

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

المرتجعات
boolean

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

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

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

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

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

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

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

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

المعلمات
testId TestDescription: يحدد الاختبار
endTime long: وقت انتهاء الاختبار، ويتم قياسه من خلال System.currentTimeMillis()
metrics : ERROR(/Map) من المقاييس المنبعثة

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

public void testEnded (TestDescription testId, 
                 metrics)

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

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

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

فشل الاختبار

public void testFailed (TestDescription testId, 
                FailureDescription failure)

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

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

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

فشل الاختبار

public void testFailed (TestDescription testId, 
                String reason)

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

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

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

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

public void testIgnored (TestDescription testId)

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

المعلمات
testId 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 time, 
                 runMetrics)

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

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

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

public void testRunFailed (FailureDescription failure)

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

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

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

public void testRunFailed (String reason)

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

المعلمات
reason 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 arg0)

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

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

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

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

public void testSkipped (TestDescription testId, 
                SkipReason reason)

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

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

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

public void testStarted (TestDescription testId, 
                long startTime)

بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدد أيضًا وقت إجراء الاختبار تم البدء، إلى جانب ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))، للحصول على قياس دقيق.

المعلمات
testId TestDescription: يحدد الاختبار
startTime long: وقت بدء الاختبار، ويتم قياسه من خلال System.currentTimeMillis()

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

public void testStarted (TestDescription testId)

تعمل على الإبلاغ عن بداية حالة اختبار فردية. واجهة قديمة، ويجب استخدام testStarted(com.android.tradefed.result.TestDescription) كلما أمكن ذلك.

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