نتائج العملية الفرعية
public class SubprocessResultsReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Object | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
يتم تحديد تطبيق ITestInvocationListener
باعتباره result_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) في بعض الحالات ، يجب أن يكون السجل مرتبطًا بقوة بحالات الاختبار ، ولكن الفرصة للقيام بذلك في |
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) testEnded ( TestDescription testId, long endTime, metrics) بديل لـ |
void | testEnded ( TestDescription testId, metrics) 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) testRunEnded (long time, runMetrics) يبلغ عن نهاية التشغيل التجريبي. |
void | testRunFailed ( FailureDescription failure) فشل تشغيل اختبار التقارير في الإكمال بسبب فشل تم وصفه بواسطة |
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 | testStarted ( TestDescription testId, long startTime) بديل عن |
void | testStarted ( TestDescription testId) يُبلغ عن بداية حالة اختبار فردية. |
المنشأت العامة
نتائج العملية الفرعية
public SubprocessResultsReporter ()
الأساليب العامة
يغلق
public void close ()
getSummary
public TestSummary getSummary ()
يسمح لـ InvocationListener بإرجاع ملخص.
عائدات | |
---|---|
TestSummary | A TestSummary يلخص المدى ، أو لا شيء |
انتهى الدعاء
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 : معلومات حول الاستدعاء |
جمعية السجل
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 |
setOutputTestLog
public void setOutputTestLog (boolean outputTestLog)
يحدد ما إذا كان يجب علينا إخراج الاختبار الذي تم تسجيله أم لا.
حدود | |
---|---|
outputTestLog | boolean |
دعم النتائج الحبيبية
public boolean supportGranularResults ()
إرجاع صحيح إذا كان المراسل يدعم النتائج الدقيقة ، خطأ إذا كان العكس.
عائدات | |
---|---|
boolean |
testAssumptionFailure
public void testAssumptionFailure (TestDescription testId, String trace)
يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ
حدود | |
---|---|
testId | TestDescription : يحدد الاختبار |
trace | String : كومة تتبع الفشل |
testAssumptionFailure
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 : كومة تتبع الفشل |
test تم تجاهله
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))
سيقوم إطار عمل TradeFederation باستدعاء هذه الطريقة تلقائيًا ، مع توفير سجل المضيف وإذا أمكن ، تسجيل الجهاز.
حدود | |
---|---|
dataName | String : String اسم وصفي للبيانات. على سبيل المثال "device_logcat". ملاحظة قد لا يكون اسم dataName فريدًا لكل طلب. على سبيل المثال ، يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات |
dataType | LogDataType : LogDataType للبيانات |
dataStream | InputStreamSource : مصدر البيانات InputStreamSource . يجب على المنفذين استدعاء createInputStream لبدء قراءة البيانات ، والتأكد من إغلاق InputStream الناتج عند الانتهاء. يجب على المتصلين التأكد من أن مصدر البيانات يظل موجودًا ويمكن الوصول إليه حتى تكتمل طريقة testLog. |
انتهى الاختبار
public void testModuleEnded ()
تقارير نهاية تشغيل الوحدة النمطية.
testModule بدأ
public void testModuleStarted (IInvocationContext moduleContext)
تقارير بداية تشغيل وحدة نمطية. ترتبط رد الاتصال هذا بـ testModuleEnded()
وهي اختيارية في التسلسل. يتم استخدامه فقط أثناء الجري الذي يستخدم الوحدات النمطية: المتسابقون القائمون على الجناح.
حدود | |
---|---|
moduleContext | IInvocationContext : IInvocationContext للوحدة النمطية. |
انتهى الاختبار
public void testRunEnded (long time,runMetrics)
يبلغ عن نهاية التشغيل التجريبي. FIXME: لا يمكن أن يكون لدينا واجهتان لخريطة <> بنوع مختلف ، لذلك علينا استخدام HashMap هنا.
حدود | |
---|---|
time | long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (FailureDescription failure)
فشل تشغيل اختبار التقارير في الإكمال بسبب فشل تم وصفه بواسطة FailureDescription
.
حدود | |
---|---|
failure | FailureDescription : FailureDescription يصف الفشل وسياقه. |
testRunFailed
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 التي يتم تشغيلها عدة مرات. tryNumber هو 0 مفهرس ويجب أن يزداد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال ، تمت إعادة محاولة الاختبار المحبب 3 مرات ، ويجب أن يكون له 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 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 التي يتم تشغيلها عدة مرات. tryNumber هو 0 مفهرس ويجب أن يزداد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال ، تمت إعادة محاولة الاختبار المحبب 3 مرات ، ويجب أن يكون له 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3. |
startTime | long : الوقت الذي بدأ فيه التشغيل ، ويتم قياسه عبر System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long arg0)
تم إيقاف تشغيل اختبار التقارير قبل الإكمال بناءً على طلب المستخدم.
TODO: غير مستخدم حاليًا ، جرب الإزالة
حدود | |
---|---|
arg0 | long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية |
اختبار
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 : يحدد الاختبار |