تقرير نتائج العمليات الفرعية
public class SubprocessResultsReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Object | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
ينفذ ITestInvocationListener
ليتم تحديده كنتيجة_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.Ignore. |
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 | 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 للفشل |
invocationStarted
public void invocationStarted (IInvocationContext context)
تقارير بداية استدعاء الاختبار.
سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation. يحتاج المراسلون إلى تجاوز هذه الطريقة لدعم التقارير على أجهزة متعددة.
حدود | |
---|---|
context | IInvocationContext : معلومات حول الاستدعاء |
logAssociation
public void logAssociation (String dataName, LogFile logFile)
في بعض الحالات، يجب أن يرتبط السجل بقوة بحالات الاختبار، ولكن تكون الفرصة متاحة للقيام بذلك من خلال testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.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 |
supportGranularResults
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 : تتبع مكدس الفشل |
testIgnored
public void testIgnored (TestDescription testId)
يتم استدعاؤه عندما لا يتم تشغيل الاختبار، وذلك بشكل عام بسبب إضافة تعليقات توضيحية لطريقة الاختبار باستخدام org.junit.Ignore.
حدود | |
---|---|
testId | TestDescription : يحدد الاختبار |
testLog
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
يوفر السجل المرتبط أو بيانات التصحيح من استدعاء الاختبار.
يجب الاتصال به قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable))
أو ERROR(/ITestInvocationListener#invocationEnded(long))
سيقوم إطار عمل TradeFederation تلقائيًا باستدعاء هذه الطريقة، مما يوفر سجل المضيف وlogcat للجهاز، إن أمكن.
حدود | |
---|---|
dataName | String : اسم وصفي String البيانات. على سبيل المثال "device_logcat". لاحظ أن dataName قد لا يكون فريدًا لكل استدعاء. أي يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات |
dataType | LogDataType : LogDataType للبيانات |
dataStream | InputStreamSource : InputStreamSource للبيانات. يجب على المنفذين استدعاء createInputStream لبدء قراءة البيانات، والتأكد من إغلاق InputStream الناتج عند اكتماله. يجب على المتصلين التأكد من أن مصدر البيانات يظل موجودًا ويمكن الوصول إليه حتى تكتمل طريقة testLog. |
testModuleEnded
public void testModuleEnded ()
تقارير نهاية تشغيل الوحدة النمطية.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
يُبلغ عن بداية تشغيل الوحدة النمطية. يرتبط رد الاتصال هذا بـ testModuleEnded()
وهو اختياري في التسلسل. يتم استخدامه فقط أثناء التشغيل الذي يستخدم الوحدات النمطية: العدائين المعتمدين على المجموعة.
حدود | |
---|---|
moduleContext | IInvocationContext : IInvocationContext للوحدة. |
testRunEnded
public void testRunEnded (long time,runMetrics)
تقارير نهاية التشغيل التجريبي. إصلاح: لا يمكن أن يكون لدينا واجهتان Map<> بنوع مختلف، لذا يتعين علينا استخدام 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 : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 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 : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 0 ويجب أن يتزايد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال، تتم إعادة محاولة الاختبار 3 مرات، ويجب أن يحتوي على 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3. |
startTime | long : الوقت الذي بدأ فيه التشغيل، ويتم قياسه عبر System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long arg0)
توقف التشغيل التجريبي للتقارير قبل اكتماله بناءً على طلب المستخدم.
TODO: غير مستخدم حاليًا، فكر في الإزالة
حدود | |
---|---|
arg0 | long : أبلغ الجهاز عن الوقت المنقضي، بالمللي ثانية |
testStarted
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() |
testStarted
public void testStarted (TestDescription testId)
تقارير بداية حالة اختبار فردية. الواجهة الأقدم، يجب أن تستخدم testStarted(com.android.tradefed.result.TestDescription)
كلما أمكن ذلك.
حدود | |
---|---|
testId | TestDescription : يحدد الاختبار |