نتائج العملية الفرعية

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

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

الفئات الفرعية المباشرة المعروفة LegacySubprocessResultsReporter LegacySubprocessResultsReporter تنفيذ مجمّد لمراسل نتائج العملية الفرعية والذي يجب أن يظل متوافقًا مع الإصدارات السابقة من TF / CTS (على سبيل المثال 8+) ، على الرغم من التغييرات في فئته الفائقة.

---

يتم تحديد تطبيق 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) في بعض الحالات ، يجب أن يكون السجل مرتبطًا بقوة بحالات الاختبار ، ولكن الفرصة للقيام بذلك في 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) testEnded ( TestDescription testId, long endTime, metrics) بديل لـ ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرة.
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) فشل تشغيل اختبار التقارير في الإكمال بسبب فشل تم وصفه بواسطة 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	testStarted ( TestDescription testId, long startTime) بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدد أيضًا وقت بدء الاختبار ، جنبًا إلى جنب مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لقياس دقيق .
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". ملاحظة قد لا يكون اسم البيانات فريدًا لكل طلب. على سبيل المثال ، يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات
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 : يحدد الاختبار