BasePostProcessor
public
abstract
class
BasePostProcessor
extends Object
implements
IConfigurationReceiver,
IPostProcessor
| java.lang.Object | |
| ↳ | com.android.tradefed.postprocessor.BasePostProcessor |
الفئة الأساسية IPostProcessor التي يجب أن يوسّعها كل تنفيذ. تأكَّد من استدعاء طرق المعالجة اللاحقة قبل أدوات إعداد التقارير الخاصة بالنتيجة النهائية.
ملخّص
طُرق وضع التصميم العامة | |
|---|---|
BasePostProcessor()
|
|
الإجراءات العامة | |
|---|---|
IConfiguration
|
getConfiguration()
|
final
ITestInvocationListener
|
init(ITestInvocationListener listener)
خطوة الإعداد المسبق للمعالج اللاحق. |
final
void
|
invocationEnded(long elapsedTime)
تعرض هذه السمة ما إذا تم إنهاء عملية الاستدعاء بنجاح أو بسبب حدوث خطأ. |
final
void
|
invocationFailed(FailureDescription failure)
تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ. |
final
void
|
invocationFailed(Throwable cause)
تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ. |
void
|
invocationSkipped(SkipReason reason)
تسجيل حالة استدعاء على أنّه تم تخطّيه |
final
void
|
invocationStarted(IInvocationContext context)
أدوات معالجة أحداث الاستدعاء لإعادة التوجيه |
final
boolean
|
isDisabled()
تعرِض هذه السمة القيمة True إذا كان العنصر بأكمله غير مفعّل (تخطّي كل من الإعداد والإزالة). |
final
void
|
logAssociation(String dataName, LogFile logFile)
في بعض الحالات، يجب أن يكون السجلّ مرتبطًا بشكل كبير بحالات الاختبار، ولكن لا يمكن إجراء ذلك في معاودة الاتصال المباشرة تعديل ربط السجلّ بالاختبار |
Map<String, MetricMeasurement.Metric.Builder>
|
processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, Map<TestDescription, Map<String, LogFile>> allTestLogs)
نفِّذ هذه الطريقة لتجميع المقاييس والسجلات في جميع الاختبارات. |
abstract
Map<String, MetricMeasurement.Metric.Builder>
|
processRunMetricsAndLogs(HashMap<String, MetricMeasurement.Metric> rawMetrics, Map<String, LogFile> runLogs)
نفِّذ هذه الطريقة لإنشاء مجموعة من المقاييس الجديدة من المقاييس والسجلات الحالية. |
Map<String, MetricMeasurement.Metric.Builder>
|
processTestMetricsAndLogs(TestDescription testDescription, HashMap<String, MetricMeasurement.Metric> testMetrics, Map<String, LogFile> testLogs)
نفِّذ هذه الطريقة لمعالجة المقاييس والسجلّات من كل اختبار بعد انتهائه. |
void
|
setConfiguration(IConfiguration configuration)
يُدرِج |
final
void
|
setLogSaver(ILogSaver logSaver)
اضبط |
void
|
setUp()
يمكنك إلغاء هذه الطريقة في معالجات ما بعد النشر الفرعية لتهيئة الاختبار قبل تنفيذه. |
final
void
|
testAssumptionFailure(TestDescription test, String trace)
يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح |
final
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح |
final
void
|
testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
بديل |
final
void
|
testEnded(TestDescription test, Map<String, String> testMetrics)
تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية. |
final
void
|
testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)
تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية. |
final
void
|
testEnded(TestDescription test, long endTime, Map<String, String> testMetrics)
بديل |
final
void
|
testFailed(TestDescription test, FailureDescription failure)
تعرض هذه السمة تعذُّر تنفيذ حالة اختبار فردية. |
final
void
|
testFailed(TestDescription test, String trace)
تعرض هذه السمة تعذُّر تنفيذ حالة اختبار فردية. |
final
void
|
testIgnored(TestDescription test)
يتم استدعاؤه عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار تمّت إضافة التعليق التوضيحي org.junit.Ignore إليها. |
final
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
استخدِم هذه الطريقة لتسجيل ملف من تنفيذ PostProcessor. |
final
void
|
testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
يتم استدعاء هذه الطريقة عند حفظ سجلّ الاختبار. |
final
void
|
testModuleEnded()
تسجّل هذه السمة نهاية عملية تنفيذ وحدة. |
final
void
|
testModuleStarted(IInvocationContext moduleContext)
تسجّل هذه السمة بداية تشغيل وحدة. |
final
void
|
testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)
تقارير نهاية عملية الاختبار |
final
void
|
testRunEnded(long elapsedTime, Map<String, String> runMetrics)
تقارير نهاية عملية الاختبار |
final
void
|
testRunFailed(FailureDescription failure)
تعذّر إكمال تشغيل اختبار التقارير بسبب حدوث خطأ موصوف في |
final
void
|
testRunFailed(String errorMessage)
تعذّر إكمال تشغيل اختبار التقارير بسبب حدوث خطأ فادح. |
final
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
تسجّل هذه السمة بداية تشغيل تجريبي. |
final
void
|
testRunStarted(String runName, int testCount)
عمليات معاودة الاتصال أثناء التشغيل التجريبي |
final
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
تسجّل هذه السمة بداية تشغيل تجريبي. |
final
void
|
testRunStopped(long elapsedTime)
تم إيقاف التشغيل التجريبي للتقارير قبل اكتماله بناءً على طلب المستخدم. |
final
void
|
testSkipped(TestDescription test, SkipReason reason)
يتم استدعاء هذه الطريقة عندما يتم تخطّي اختبار ولم يتم تنفيذه لسبب غير متوقّع عادةً. |
final
void
|
testStarted(TestDescription test, long startTime)
بديل |
final
void
|
testStarted(TestDescription test)
عمليات معاودة الاتصال المتعلقة بحالات الاختبار |
طُرق محمية | |
|---|---|
void
|
cleanUp()
|
MetricMeasurement.DataType
|
getMetricType()
يمكنك إلغاء هذه الطريقة لتغيير نوع المقياس إذا لزم الأمر. |
String
|
getRunName()
|
final
String
|
getStackTrace()
|
final
boolean
|
isTestFailed()
|
طُرق وضع التصميم العامة
BasePostProcessor
public BasePostProcessor ()
الإجراءات العامة
init
public final ITestInvocationListener init (ITestInvocationListener listener)
خطوة الإعداد المسبق للمعالج اللاحق. يجب أن يتم استدعاؤها قبل أي من عمليات معاودة الاتصال الخاصة بالاختبارات.
| المعلَمات | |
|---|---|
listener |
ITestInvocationListener |
| المرتجعات | |
|---|---|
ITestInvocationListener |
|
invocationEnded
public final void invocationEnded (long elapsedTime)
تعرض هذه السمة ما إذا تم إنهاء عملية الاستدعاء بنجاح أو بسبب حدوث خطأ.
سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation.
| المعلَمات | |
|---|---|
elapsedTime |
long: الوقت المنقضي لتنفيذ الاستدعاء بالملّي ثانية |
invocationFailed
public final void invocationFailed (FailureDescription failure)
تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.
سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation.
| المعلَمات | |
|---|---|
failure |
FailureDescription: FailureDescription الذي يصف سبب التعذُّر |
invocationFailed
public final void invocationFailed (Throwable cause)
تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.
سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation.
| المعلَمات | |
|---|---|
cause |
Throwable: سبب الخطأ Throwable |
invocationSkipped
public void invocationSkipped (SkipReason reason)
تسجيل حالة استدعاء على أنّه تم تخطّيه
| المعلَمات | |
|---|---|
reason |
SkipReason |
invocationStarted
public final void invocationStarted (IInvocationContext context)
أدوات معالجة أحداث الاستدعاء لإعادة التوجيه
| المعلَمات | |
|---|---|
context |
IInvocationContext: معلومات حول طلب التنفيذ |
isDisabled
public final boolean isDisabled ()
تعرِض هذه السمة القيمة True إذا كان العنصر بأكمله غير مفعّل (تخطّي كل من الإعداد والإزالة). ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.
| المرتجعات | |
|---|---|
boolean |
|
logAssociation
public final void logAssociation (String dataName,
LogFile logFile)في بعض الحالات، يجب أن يكون السجلّ مرتبطًا بشكل كبير بحالات الاختبار، ولكن لا يمكن إجراء ذلك في معاودة الاتصال المباشرة testLogSaved(String,LogDataType,InputStreamSource,LogFile). وبالتالي، يتيح هذا الإجراء الرجعي توفير ارتباط قوي بشكل صريح.
تعديل ربط السجلّ بالاختبار إذا تم استدعاء هذه الطريقة أثناء إجراء اختبار، سيكون السجلّ تابعًا للاختبار، وإلا سيكون سجلّ تنفيذ.
| المعلَمات | |
|---|---|
dataName |
String: اسم البيانات |
logFile |
LogFile: LogFile الذي تم تسجيله من قبل ويجب ربطه بحالة الاختبار. |
processAllTestMetricsAndLogs
public Map<String, MetricMeasurement.Metric.Builder> processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics,
Map<TestDescription, Map<String, LogFile>> allTestLogs)نفِّذ هذه الطريقة لتجميع المقاييس والسجلات في جميع الاختبارات. سيتم تسجيل المقاييس الناتجة عن هذه الطريقة على أنّها مقاييس تشغيل. يجب عرض المقاييس التي تم إنشاؤها حديثًا فقط، مع اسم مفتاح فريد (لا يُسمح بتعارض مع المفاتيح الحالية).
| المعلَمات | |
|---|---|
allTestMetrics |
ListMultimap: HashMultimap يخزّن المقاييس من كل اختبار مجمّعة حسب أسماء المقاييس. |
allTestLogs |
Map: خريطة تخزّن خريطة كل اختبار لملفات السجلّات التي يتمّ ربطها بأسماء البيانات،
باستخدام TestDescription لكل اختبار كمفاتيح. |
| المرتجعات | |
|---|---|
Map<String, MetricMeasurement.Metric.Builder> |
مجموعة المقاييس التي تم إنشاؤها حديثًا من جميع مقاييس الاختبار |
processRunMetricsAndLogs
public abstract Map<String, MetricMeasurement.Metric.Builder> processRunMetricsAndLogs (HashMap<String, MetricMeasurement.Metric> rawMetrics,
Map<String, LogFile> runLogs)نفِّذ هذه الطريقة لإنشاء مجموعة من المقاييس الجديدة من المقاييس والسجلات الحالية. يجب عرض المقاييس التي تم إنشاؤها حديثًا فقط، مع اسم مفتاح فريد (لا يُسمح بتعارض مع المفاتيح الحالية).
| المعلَمات | |
|---|---|
rawMetrics |
HashMap: مجموعة المقاييس الأولية المتاحة للتجربة |
runLogs |
Map: مجموعة ملفات السجلّ الخاصة بتشغيل الاختبار |
| المرتجعات | |
|---|---|
Map<String, MetricMeasurement.Metric.Builder> |
مجموعة المقاييس التي تم إنشاؤها حديثًا من مقاييس التشغيل |
processTestMetricsAndLogs
public Map<String, MetricMeasurement.Metric.Builder> processTestMetricsAndLogs (TestDescription testDescription, HashMap<String, MetricMeasurement.Metric> testMetrics, Map<String, LogFile> testLogs)
نفِّذ هذه الطريقة لمعالجة المقاييس والسجلّات من كل اختبار بعد انتهائه. يجب عرض المقاييس التي تم إنشاؤها حديثًا فقط، مع اسم مفتاح فريد (لا يُسمح بتعارض مع المفاتيح الحالية).
| المعلَمات | |
|---|---|
testDescription |
TestDescription: عنصر TestDescription الذي يصف الاختبار |
testMetrics |
HashMap: مجموعة المقاييس من الاختبار |
testLogs |
Map: مجموعة الملفات التي تم تسجيلها أثناء الاختبار |
| المرتجعات | |
|---|---|
Map<String, MetricMeasurement.Metric.Builder> |
مجموعة المقاييس التي تم إنشاؤها حديثًا من مقاييس الاختبار |
setConfiguration
public void setConfiguration (IConfiguration configuration)
يُدرِج IConfiguration المستخدَم.
| المعلَمات | |
|---|---|
configuration |
IConfiguration |
setLogSaver
public final void setLogSaver (ILogSaver logSaver)
اضبط ILogSaver للسماح للمنفِّذ بحفظ الملفات.
| المعلَمات | |
|---|---|
logSaver |
ILogSaver: ILogSaver |
setUp
public void setUp ()
يمكنك إلغاء هذه الطريقة في معالجات ما بعد النشر الفرعية لتهيئة الاختبار قبل تنفيذه.
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, String trace)
يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
trace |
String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
failure |
FailureDescription: FailureDescription يصف الخطأ وسياقه. |
testEnded
public final void testEnded (TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
بديل testEnded(TestDescription,Map) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بينها وبين testStarted(TestDescription,long) للحصول على قياس دقيق.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
endTime |
long: الوقت الذي انتهى فيه الاختبار، ويتم قياسه باستخدام System.currentTimeMillis() |
testMetrics |
HashMap: Map للمقاييس التي تمّ إرسالها |
testEnded
public final void testEnded (TestDescription test, Map<String, String> testMetrics)
تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.
إذا لم يتم استدعاء testFailed(TestDescription, FailureDescription)، اجتازت هذه الحالة الاختبار. تعرض هذه السمة أيضًا أي مقاييس على شكل مفتاح/قيمة
ربما تم إصدارها أثناء تنفيذ حالة الاختبار.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
testMetrics |
Map: Map للمقاييس التي تمّ إرسالها |
testEnded
public final void testEnded (TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)
تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.
إذا لم يتم استدعاء testFailed(TestDescription, FailureDescription)، اجتازت هذه الحالة الاختبار. تعرض هذه السمة أيضًا أي مقاييس على شكل مفتاح/قيمة
ربما تم إصدارها أثناء تنفيذ حالة الاختبار.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
testMetrics |
HashMap: Map للمقاييس التي تمّ إرسالها |
testEnded
public final void testEnded (TestDescription test, long endTime, Map<String, String> testMetrics)
بديل testEnded(TestDescription,Map) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بينها وبين testStarted(TestDescription,long) للحصول على قياس دقيق.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
endTime |
long: الوقت الذي انتهى فيه الاختبار، ويتم قياسه باستخدام System.currentTimeMillis() |
testMetrics |
Map: Map للمقاييس التي تمّ إرسالها |
testFailed
public final void testFailed (TestDescription test, FailureDescription failure)
تعرض هذه السمة تعذُّر تنفيذ حالة اختبار فردية.
سيتم استدعاؤها بين testStarted وtestEnded.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
failure |
FailureDescription: FailureDescription يصف الخطأ وسياقه. |
testFailed
public final void testFailed (TestDescription test, String trace)
تعرض هذه السمة تعذُّر تنفيذ حالة اختبار فردية.
سيتم استدعاؤها بين testStarted وtestEnded.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
trace |
String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ |
testIgnored
public final void testIgnored (TestDescription test)
يتم استدعاؤه عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار تمّت إضافة التعليق التوضيحي org.junit.Ignore إليها.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
testLog
public final void testLog (String dataName,
LogDataType dataType,
InputStreamSource dataStream)استخدِم هذه الطريقة لتسجيل ملف من تنفيذ PostProcessor.
| المعلَمات | |
|---|---|
dataName |
String: اسم وصفي String للبيانات، مثل "device_logcat". ملاحظة
قد لا يكون dataName فريدًا لكل استدعاء، أي يجب أن يتمكّن المنفّذون من التعامل مع
عمليات استدعاء متعددة باستخدام dataName نفسه. |
dataType |
LogDataType: LogDataType الخاص بالبيانات |
dataStream |
InputStreamSource: InputStreamSource الخاص بالبيانات على المنفّذين استدعاء createInputStream لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند الانتهاء. على المتصلين التأكّد من أنّ مصدر البيانات يظل متاحًا ويمكن الوصول إليه إلى أن تكتمل طريقة testLog. |
testLogSaved
public final void testLogSaved (String dataName,
LogDataType dataType,
InputStreamSource dataStream,
LogFile logFile)يتم استدعاء هذه الطريقة عند حفظ سجلّ الاختبار.
يجب استخدامها بدلاً من ITestInvocationListener.testLog(String,LogDataType,InputStreamSource).
| المعلَمات | |
|---|---|
dataName |
String: اسم وصفي String للبيانات، مثل "device_logcat". ملاحظة
قد لا يكون dataName فريدًا لكل استدعاء، أي يجب أن يتمكّن المنفّذون من التعامل مع
عمليات استدعاء متعددة باستخدام dataName نفسه. |
dataType |
LogDataType: LogDataType الخاص بالبيانات |
dataStream |
InputStreamSource: InputStreamSource الخاص بالبيانات على المنفّذين استدعاء createInputStream لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند الانتهاء. |
logFile |
LogFile: LogFile الذي يحتوي على البيانات الوصفية للملف المحفوظ |
testModuleEnded
public final void testModuleEnded ()
تسجّل هذه السمة نهاية عملية تنفيذ وحدة.
testModuleStarted
public final void testModuleStarted (IInvocationContext moduleContext)
تسجّل هذه السمة بداية تشغيل وحدة. يرتبط هذا الإجراء الاحتياطي بـ testModuleEnded() وهو اختياري في التسلسل. يتم استخدامها فقط أثناء عملية تشغيل تستخدم وحدات: أدوات التشغيل المستندة إلى الحزمة.
| المعلَمات | |
|---|---|
moduleContext |
IInvocationContext: IInvocationContext الخاص بالوحدة |
testRunEnded
public final void testRunEnded (long elapsedTime,
HashMap<String, MetricMeasurement.Metric> runMetrics)تقارير نهاية عملية الاختبار FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.
| المعلَمات | |
|---|---|
elapsedTime |
long: الوقت المنقضي الذي أبلغ عنه الجهاز، بالمللي ثانية |
runMetrics |
HashMap: أزواج المفتاح/القيمة التي يتمّ تسجيلها في نهاية عملية الاختبار باستخدام Metric. |
testRunEnded
public final void testRunEnded (long elapsedTime,
Map<String, String> runMetrics)تقارير نهاية عملية الاختبار
| المعلَمات | |
|---|---|
elapsedTime |
long: الوقت المنقضي الذي أبلغ عنه الجهاز، بالمللي ثانية |
runMetrics |
Map: أزواج المفتاح/القيمة التي يتم إعداد تقارير عنها في نهاية عملية الاختبار |
testRunFailed
public final void testRunFailed (FailureDescription failure)
تعذّر إكمال تشغيل اختبار التقارير بسبب حدوث خطأ موصوف في FailureDescription.
| المعلَمات | |
|---|---|
failure |
FailureDescription: FailureDescription يصف الخطأ وسياقه. |
testRunFailed
public final void testRunFailed (String errorMessage)
تعذّر إكمال تشغيل اختبار التقارير بسبب حدوث خطأ فادح.
| المعلَمات | |
|---|---|
errorMessage |
String: String تصف سبب تعذُّر تنفيذ عملية التشغيل. |
testRunStarted
public final 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 final void testRunStarted (String runName,
int testCount)عمليات معاودة الاتصال أثناء التشغيل التجريبي
| المعلَمات | |
|---|---|
runName |
String: اسم عملية التشغيل التجريبي |
testCount |
int: إجمالي عدد الاختبارات في عملية التشغيل التجريبي |
testRunStarted
public final 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() |
testRunStopped
public final void testRunStopped (long elapsedTime)
تم إيقاف التشغيل التجريبي للتقارير قبل اكتماله بناءً على طلب المستخدم.
TODO: currently unused, consider removing
| المعلَمات | |
|---|---|
elapsedTime |
long: الوقت المنقضي الذي أبلغ عنه الجهاز، بالمللي ثانية |
testSkipped
public final void testSkipped (TestDescription test, SkipReason reason)
يتم استدعاء هذه الطريقة عندما يتم تخطّي اختبار ولم يتم تنفيذه لسبب غير متوقّع عادةً. ستتم إعادة محاولة إجراء هذه الاختبارات للحصول على تنفيذ سليم.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
reason |
SkipReason: SkipReason |
testStarted
public final void testStarted (TestDescription test, long startTime)
بديل testStarted(TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار، بالإضافة إلى testEnded(TestDescription,long,Map) للحصول على قياس دقيق.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
startTime |
long: الوقت الذي بدأت فيه التجربة، ويتم قياسه باستخدام System.currentTimeMillis() |
testStarted
public final void testStarted (TestDescription test)
عمليات معاودة الاتصال المتعلقة بحالات الاختبار
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
طُرق محمية
cleanUp
protected void cleanUp ()
getMetricType
protected MetricMeasurement.DataType getMetricType ()
يمكنك إلغاء هذه الطريقة لتغيير نوع المقياس إذا لزم الأمر. يتم ضبط المقياس التلقائي على النوع المعالَج.
| المرتجعات | |
|---|---|
MetricMeasurement.DataType |
|
getRunName
protected String getRunName ()
| المرتجعات | |
|---|---|
String |
|
getStackTrace
protected final String getStackTrace ()
| المرتجعات | |
|---|---|
String |
|
isTestFailed
protected final boolean isTestFailed ()
| المرتجعات | |
|---|---|
boolean |
|