ResultReporter

public class ResultReporter
extends Object implements IConfigurationReceiver, ILogSaverListener, ISupportGranularResults, ITestSummaryListener

java.lang.Object
   ↳ com.google.android.tradefed.result.teststorage.ResultReporter

ملخّص

الفئات المتداخلة

class ResultReporter.ListBuilder<T>

 

الثوابت

String DEFAULT_BUILDPROVIDER

String EXPERIMENTAL

String SYSTEM_CHECKER

String TRADEFED

الإنشاءات العامة

ResultReporter()

الطُرق العامة

void enableFilterProperty(boolean enableFilterProperty)
IConfiguration getConfiguration()
TestSummary getSummary()

تسمح هذه السمة لـ InvocationListener بعرض ملخّص.

void invocationEnded(long elapsedTime)

تشير إلى أنّ عملية الاستدعاء قد انتهت، سواء بنجاح أو بسبب بعض حالات الخطأ.

void invocationFailed(FailureDescription failure)

تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.

void invocationFailed(Throwable cause)

تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.

void invocationSkipped(SkipReason reason)

تسجيل أنّ عملية استدعاء تم تخطّيها

void invocationStarted(IInvocationContext context)

تسجّل هذه السمة بداية تنفيذ الاختبار.

void logAssociation(String dataName, LogFile log)

في بعض الحالات، يجب أن يكون السجلّ مرتبطًا بشكل كبير بحالات الاختبار، ولكن لا يمكن إجراء ذلك في معاودة الاتصال المباشرة testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).

void putEarlySummary( summaries)

تمرِّر هذه السمة ERROR(/List) من قيم TestSummary غير فارغة، وقد تكون هذه القيم قد تم عرضها من أي ITestInvocationListener تم إنشاؤه كجزء من الإعداد.

void setConfiguration(IConfiguration configuration)

يُدرِج IConfiguration المستخدَم.

void setLogSaver(ILogSaver logSaver)

اضبط ILogSaver للسماح للمنفِّذ بحفظ الملفات.

boolean supportGranularResults()

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

void testAssumptionFailure(TestDescription test, String trace)

يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح

void testAssumptionFailure(TestDescription test, FailureDescription failure)

يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح

void testEnded(TestDescription test, long endTime, testMetrics)

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

void testEnded(TestDescription test, metrics)

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

void testFailed(TestDescription test, FailureDescription failure)

تسجّل هذه السمة تعذُّر تنفيذ حالة اختبار فردية.

void testFailed(TestDescription test, String trace)

تسجّل هذه السمة تعذُّر تنفيذ حالة اختبار فردية.

void testIgnored(TestDescription test)

يتم استدعاؤها عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار يتم شرحها باستخدام org.junit.Ignore.

void testModuleEnded()

تسجّل هذه السمة نهاية عملية تنفيذ وحدة.

void testModuleStarted(IInvocationContext moduleContext)

تسجّل هذه السمة بداية تشغيل وحدة.

void testRunEnded(long elapsedTimeMillis, runMetrics)

تقارير نهاية عملية الاختبار

void testRunFailed(FailureDescription failure)

تعذّر إكمال تشغيل الاختبار التجريبي للتقارير بسبب حدوث خطأ موصوف في FailureDescription.

void testRunFailed(String errorMessage)

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

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 testSkipped(TestDescription test, SkipReason reason)

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

void testStarted(TestDescription test, long startTime)

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

void testStarted(TestDescription test)

تسجّل هذه السمة بداية حالة اختبار فردية.

الطُرق المحمية

ITestStorageClient createTestStorageClient(IInvocationContext context)
String getVersion()

الثوابت

DEFAULT_BUILDPROVIDER

public static final String DEFAULT_BUILDPROVIDER

القيمة الثابتة: "androidbuild"

تجريبية

public static final String EXPERIMENTAL

القيمة الثابتة: "experimental"

SYSTEM_CHECKER

public static final String SYSTEM_CHECKER

القيمة الثابتة: "system_checker"

TRADEFED

public static final String TRADEFED

Constant Value: "tradefed"

الإنشاءات العامة

ResultReporter

public ResultReporter ()

الطُرق العامة

enableFilterProperty

public void enableFilterProperty (boolean enableFilterProperty)

المعلمات
enableFilterProperty boolean

getConfiguration

public IConfiguration getConfiguration ()

المرتجعات
IConfiguration

getSummary

public TestSummary getSummary ()

تسمح هذه السمة لـ InvocationListener بعرض ملخّص.

المرتجعات
TestSummary تمثّل هذه السمة TestSummary تلخّص عملية التشغيل، أو قيمة فارغة.

invocationEnded

public void invocationEnded (long elapsedTime)

تشير إلى أنّ عملية الاستدعاء قد انتهت، سواء بنجاح أو بسبب بعض حالات الخطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

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

invocationFailed

public void invocationFailed (FailureDescription failure)

تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
failure FailureDescription: FailureDescription الذي يصف سبب تعذُّر التنفيذ

invocationFailed

public void invocationFailed (Throwable cause)

تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
cause ‫Throwable: سبب تعذُّر Throwable

invocationSkipped

public void invocationSkipped (SkipReason reason)

تسجيل أنّ عملية استدعاء تم تخطّيها

المعلمات
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

تسجّل هذه السمة بداية تنفيذ الاختبار.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation. على مقدّمي التقارير إلغاء هذه الطريقة لتفعيل إعداد التقارير على أجهزة متعددة.

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

logAssociation

public void logAssociation (String dataName, 
                LogFile log)

في بعض الحالات، يجب أن يكون السجلّ مرتبطًا بشكل كبير بحالات الاختبار، ولكن لا يمكن إجراء ذلك في معاودة الاتصال المباشرة testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). وبالتالي، يتيح هذا الإجراء الرجعي تقديم ارتباط قوي بشكل صريح.

المعلمات
dataName ‫String: اسم البيانات
log LogFile: LogFile الذي تم تسجيله من قبل ويجب ربطه بحالة الاختبار.

putEarlySummary

public void putEarlySummary ( summaries)

تمرِّر هذه السمة ERROR(/List) من قيم TestSummary غير فارغة، وقد تكون هذه القيم قد تم عرضها من أي ITestInvocationListener تم إنشاؤه كجزء من الإعداد. يتم إنشاء الملخّصات المبكرة بعد ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) ويمكن إكمالها في نهاية عملية الاستدعاء من خلال ERROR(/#putSummary(List)).

يتم استدعاء هذه الدالة قبل ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext)، وتحتوي على جميع الملخّصات من أدوات المعالجة التي تم ضبطها قبلها.

المعلمات
summaries : ERROR(/List) من قيم TestSummary غير الفارغة من ITestInvocationListener التي تشكّل جزءًا من الإعداد الحالي

setConfiguration

public void setConfiguration (IConfiguration configuration)

يُدرِج IConfiguration المستخدَم.

المعلمات
configuration IConfiguration

setLogSaver

public void setLogSaver (ILogSaver logSaver)

اضبط ILogSaver للسماح للمنفِّذ بحفظ الملفات.

المعلمات
logSaver ILogSaver: ILogSaver

supportGranularResults

public boolean supportGranularResults ()

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

المرتجعات
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح

المعلمات
test ‫TestDescription: تحدّد الاختبار
trace ‫String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح

المعلمات
test ‫TestDescription: تحدّد الاختبار
failure استبدِل FailureDescription بـ FailureDescription الذي يصف الخطأ وسياقه.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

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

المعلمات
test ‫TestDescription: تحدّد الاختبار
endTime ‫long: الوقت الذي انتهى فيه الاختبار، ويتم قياسه باستخدام System.currentTimeMillis()
testMetrics : ERROR(/Map) المقاييس التي تمّ إرسالها

testEnded

public void testEnded (TestDescription test, 
                 metrics)

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

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

المعلمات
test ‫TestDescription: تحدّد الاختبار
metrics : ERROR(/Map) المقاييس التي تمّ إرسالها

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

تسجّل هذه السمة تعذُّر تنفيذ حالة اختبار فردية.

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

المعلمات
test ‫TestDescription: تحدّد الاختبار
failure استبدِل FailureDescription بـ FailureDescription الذي يصف الخطأ وسياقه.

testFailed

public void testFailed (TestDescription test, 
                String trace)

تسجّل هذه السمة تعذُّر تنفيذ حالة اختبار فردية.

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

المعلمات
test ‫TestDescription: تحدّد الاختبار
trace ‫String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testIgnored

public void testIgnored (TestDescription test)

يتم استدعاؤها عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار يتم شرحها باستخدام org.junit.Ignore.

المعلمات
test ‫TestDescription: تحدّد الاختبار

testModuleEnded

public void testModuleEnded ()

تسجّل هذه السمة نهاية عملية تنفيذ وحدة.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

المعلمات
moduleContext IInvocationContext: تمثّل هذه السمة IInvocationContext الوحدة.

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

تقارير نهاية عملية الاختبار

المعلمات
elapsedTimeMillis ‫long: الجهاز أبلغ عن الوقت المنقضي بالمللي ثانية
runMetrics ‫: أزواج المفتاح/القيمة التي يتم إعداد تقارير عنها في نهاية عملية الاختبار

testRunFailed

public void testRunFailed (FailureDescription failure)

تعذّر إكمال تشغيل الاختبار التجريبي للتقارير بسبب حدوث خطأ موصوف في FailureDescription.

المعلمات
failure استبدِل FailureDescription بـ FailureDescription الذي يصف الخطأ وسياقه.

testRunFailed

public void testRunFailed (String errorMessage)

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

المعلمات
errorMessage String: String تصف سبب تعذُّر تنفيذ العملية.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

تسجيل بداية تشغيل الاختبار

المعلمات
runName ‫String: اسم عملية التشغيل الاختبارية
testCount ‫int: إجمالي عدد الاختبارات في عملية الاختبار
attemptNumber ‫int: رقم الطلب، الذي يحدّد المحاولات المختلفة لـ runName نفسه الذي يتم تنفيذه عدة مرات. يتم فهرسة attemptNumber بدءًا من 0، ويجب أن يزيد في كل مرة يتم فيها تنفيذ عملية جديدة. على سبيل المثال، إذا تمت إعادة محاولة اختبار دقيق 3 مرات، يجب أن يتم تنفيذه 4 مرات إجمالاً ضمن runName نفسه، ويجب أن يتراوح attemptNumber بين 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 نفسه الذي يتم تنفيذه عدة مرات. يتم فهرسة attemptNumber بدءًا من 0، ويجب أن يزيد في كل مرة يتم فيها تنفيذ عملية تشغيل جديدة. على سبيل المثال، إذا تمت إعادة محاولة اختبار دقيق 3 مرات، يجب أن يكون هناك 4 عمليات تشغيل إجمالية ضمن runName نفسه، ويجب أن يتراوح attemptNumber بين 0 و3.
startTime ‫long: الوقت الذي بدأ فيه التمرين، ويتم قياسه باستخدام System.currentTimeMillis()

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

المعلمات
test ‫TestDescription: تحدّد الاختبار
reason SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

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

المعلمات
test ‫TestDescription: تحدّد الاختبار
startTime long: الوقت الذي بدأت فيه التجربة، ويتم قياسه باستخدام System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test)

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

المعلمات
test ‫TestDescription: تحدّد الاختبار

الطُرق المحمية

createTestStorageClient

protected ITestStorageClient createTestStorageClient (IInvocationContext context)

المعلمات
context IInvocationContext

المرتجعات
ITestStorageClient

getVersion

protected String getVersion ()

المرتجعات
String