BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
   ↳ com.android.tradefed.device.metric.BaseDeviceMetricCollector

التنفيذ الأساسي لـ IMetricCollector الذي يتيح بدء عملية الجمع وإيقافها في onTestRunStart(DeviceMetricData) وonTestRunEnd(DeviceMetricData,Map)

ملخّص

الثوابت

String TEST_CASE_EXCLUDE_GROUP_OPTION

String TEST_CASE_INCLUDE_GROUP_OPTION

طُرق وضع التصميم العامة

BaseDeviceMetricCollector()

الإجراءات العامة

boolean doesModuleContainFailure()

تعرض القيمة "صحيح" إذا كانت الوحدة الحالية تحتوي على أي حالات اختبار أو عمليات اختبار غير ناجحة.

void enableDefaultMetricCollection()

تسمح هذه السمة لجامعي البيانات بتفعيل جمع بيانات المقاييس التلقائي.

void extraInit(IInvocationContext context, ITestInvocationListener listener)
IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel()
final List<IBuildInfo> getBuildInfos()

تعرض هذه الطريقة قائمة بمعلومات الإصدار المتوفّرة في عملية الاستدعاء.

final List<ITestDevice> getDevices()

تعرض هذه السمة قائمة بالأجهزة المتاحة في طلب الاستدعاء.

File getFileFromTestArtifacts(String fileName)

استرجِع الملف من عناصر الاختبار أو عناصر الوحدة وخزِّنه مؤقتًا في خريطة لعمليات الاستدعاء اللاحقة.

final ITestInvocationListener getInvocationListener()

تعرض هذه السمة ITestInvocationListener الأصلية التي نعيد توجيه النتائج إليها.

String getModuleName()
IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel()
final List<ITestDevice> getRealDevices()

تعرض هذه السمة جميع الأجهزة غير الوهمية من القائمة getDevices().

String getRunName()

تعرض هذه السمة اسم عملية الاختبار mRunName التي تؤدي إلى تشغيل أداة الجمع.

String getTestName()

تعرض هذه السمة اسم الاختبار mTestName الذي يؤدي إلى تشغيل أداة الجمع.

final ITestInvocationListener init(IInvocationContext context, 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)

أدوات معالجة أحداث الاستدعاء لإعادة التوجيه

boolean isDefaultMetricCollectionEnabled()

تُستخدَم لتحديد ما إذا كان الجامع يجمع المقاييس كجزء من عملية جمع المقاييس التلقائية.

final boolean isDisabled()

تعرِض هذه السمة القيمة True إذا كان العنصر بأكمله غير مفعّل (تخطّي كل من الإعداد والإزالة).

boolean isDisabledReceiver()

تحديد ما إذا كانت ميزة IDeviceActionReceiver غير مفعَّلة أم لا

final void logAssociation(String dataName, LogFile logFile)

لا تستخدِمها في تنفيذ أداة جمع المقاييس الداخلية.

void onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)

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

void onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

دالة ردّ الاتصال عند انتهاء حالة الاختبار.

void onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)

دالة ردّ الاتصال عند انتهاء حالة الاختبار.

void onTestFail(DeviceMetricData testData, TestDescription test)

دالة ردّ الاتصال عند فشل حالة اختبار.

void onTestModuleEnded()

تتيح تسجيل حدث انتهاء الوحدة.

void onTestModuleStarted()

يسمح بتسجيل حدث بدء الوحدة.

void onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)

دالة ردّ الاتصال عند انتهاء عملية تشغيل الاختبار.

void onTestRunFailed(DeviceMetricData testData, FailureDescription failure)

معاودة الاتصال لأحداث testRunFailed

void onTestRunStart(DeviceMetricData runData)

دالة ردّ الاتصال عند بدء تشغيل تجريبي.

void onTestStart(DeviceMetricData testData)

يتم تنفيذ هذه الدالة عند بدء حالة اختبار.

void rebootEnded(ITestDevice device)

تتلقّى إشعارًا عند انتهاء عملية إعادة التشغيل على الجهاز.

void rebootStarted(ITestDevice device)

تلقّي إشعار عند بدء إعادة التشغيل على الجهاز

void setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)

تضبط هذه السمة المستوى الذي يجب أن تجمع فيه أداة الجمع السجلات بغض النظر عن حالات الأعطال.

final void setDisable(boolean isDisabled)

يضبط ما إذا كان يجب إيقاف العنصر.

void setDisableReceiver(boolean isDisabled)

تحدّد ما إذا كان يجب إيقاف IDeviceActionReceiver.

final void setLogSaver(ILogSaver logSaver)

لا تستخدِمها في تنفيذ أداة جمع المقاييس الداخلية.

void setModuleContainsFailure()

تضبط هذه السمة ما إذا كانت الوحدة قد واجهت أي أخطاء (حالة الاختبار، التشغيل التجريبي).

void setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)

تضبط هذه السمة المستوى الذي يجب أن تجمع فيه أداة الجمع السجلات أثناء حدوث الأعطال.

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)

بديل testEnded(TestDescription,Map) حيث يمكننا تحديد وقت الانتهاء مباشرةً.

final void testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> 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)

تعرض هذه السمة بيانات السجلّ أو تصحيح الأخطاء المرتبطة بعملية استدعاء الاختبار.

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 testRunFailed(FailureDescription failure)

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

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)

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

final void testStarted(TestDescription test)

عمليات معاودة الاتصال المتعلقة بحالات الاختبار

الثوابت

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

القيمة الثابتة: "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

القيمة الثابتة: "test-case-include-group"

طُرق وضع التصميم العامة

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

الإجراءات العامة

doesModuleContainFailure

public boolean doesModuleContainFailure ()

تعرض القيمة "صحيح" إذا كانت الوحدة الحالية تحتوي على أي حالات اختبار أو عمليات اختبار غير ناجحة.

المرتجعات
boolean

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

تسمح هذه السمة لجامعي البيانات بتفعيل جمع بيانات المقاييس التلقائي. عند تفعيل جمع بيانات المقاييس التلقائي، يجب أن يجمع برنامج التجميع البيانات على مستوى التجميع المحدّد فقط.

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

المرتجعات
IMetricCollector.MetricCollectionLevel

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

تعرض هذه الطريقة قائمة بمعلومات الإصدار المتوفّرة في عملية الاستدعاء.

المرتجعات
List<IBuildInfo>

getDevices

public final List<ITestDevice> getDevices ()

تعرض هذه السمة قائمة بالأجهزة المتاحة في طلب الاستدعاء.

المرتجعات
List<ITestDevice>

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

استرجِع الملف من عناصر الاختبار أو عناصر الوحدة وخزِّنه مؤقتًا في خريطة لعمليات الاستدعاء اللاحقة.

المعلَمات
fileName String: اسم الملف الذي سيتم البحث عنه في العناصر.
المرتجعات
File ملف من العنصر التجريبي أو عنصر الوحدة تعرِض قيمة فارغة إذا لم يتم العثور على الملف.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

تعرض هذه السمة ITestInvocationListener الأصلية التي نعيد توجيه النتائج إليها.

المرتجعات
ITestInvocationListener

getModuleName

public String getModuleName ()

المرتجعات
String

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

المرتجعات
IMetricCollector.MetricCollectionLevel

getRealDevices

public final List<ITestDevice> getRealDevices ()

تعرض هذه السمة جميع الأجهزة غير الوهمية من القائمة getDevices().

المرتجعات
List<ITestDevice>

getRunName

public String getRunName ()

تعرض هذه السمة اسم عملية الاختبار mRunName التي تؤدي إلى تشغيل أداة الجمع.

المرتجعات
String ‫mRunName، وهو اسم عملية الاختبار الحالية.

getTestName

public String getTestName ()

تعرض هذه السمة اسم الاختبار mTestName الذي يؤدي إلى تشغيل أداة الجمع.

المرتجعات
String ‫mTestName، وهو اسم الاختبار الحالي.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

تهيئة أداة التجميع باستخدام السياق الحالي ومكان إعادة توجيه النتائج سيتم استدعاء هذه الدالة مرة واحدة فقط لكل مثيل، ومن المتوقّع أن يعدّل جامع البيانات سياقه الداخلي والمستمع. لن يتم استدعاء الدالة Init أثناء تشغيل الاختبار، بل سيتم استدعاؤها دائمًا قبل ذلك.

لا تتجاهل هذه الإعدادات إلا إذا كنت تعرف ما تفعله.

المعلَمات
context IInvocationContext: IInvocationContext الخاص بالاستدعاء قيد التنفيذ
listener ‫ITestInvocationListener: ITestInvocationListener حيث يتم عرض النتائج
المرتجعات
ITestInvocationListener المستمع الجديد الذي يغلف المستمع الأصلي
عمليات الطرح
DeviceNotAvailableException

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: معلومات حول طلب التنفيذ

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

تُستخدَم لتحديد ما إذا كان الجامع يجمع المقاييس كجزء من عملية جمع المقاييس التلقائية.

المرتجعات
boolean

isDisabled

public final boolean isDisabled ()

تعرِض هذه السمة القيمة True إذا كان العنصر بأكمله غير مفعّل (تخطّي كل من الإعداد والإزالة). ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

المرتجعات
boolean

isDisabledReceiver

public boolean isDisabledReceiver ()

تحديد ما إذا كانت ميزة IDeviceActionReceiver غير مفعَّلة أم لا

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

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

لا تستخدِمها في تنفيذ أداة جمع المقاييس الداخلية. هذه هي عملية إعادة التوجيه البحتة.

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

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

المعلَمات
testData DeviceMetricData: DeviceMetricData الذي يحتوي على بيانات حالة الاختبار
test TestDescription: TestDescription لإطار الاختبار قيد التقدّم
عمليات الطرح
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

دالة ردّ الاتصال عند انتهاء حالة الاختبار. يجب أن يكون هذا هو الوقت المناسب للتنظيف.

المعلَمات
testData DeviceMetricData: DeviceMetricData الذي يحتوي على بيانات حالة الاختبار سيكون الكائن نفسه كما كان خلال onTestStart(DeviceMetricData).
currentTestCaseMetrics ‫Map: الخريطة الحالية للمقاييس التي تم تمريرها إلى testEnded(TestDescription,Map)
عمليات الطرح
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

دالة ردّ الاتصال عند انتهاء حالة الاختبار. يجب أن يكون هذا هو الوقت المناسب للتنظيف.

المعلَمات
testData DeviceMetricData: DeviceMetricData الذي يحتوي على بيانات حالة الاختبار سيكون الكائن نفسه كما كان خلال onTestStart(DeviceMetricData).
currentTestCaseMetrics ‫Map: الخريطة الحالية للمقاييس التي تم تمريرها إلى testEnded(TestDescription,Map)
test TestDescription: TestDescription لإطار الاختبار قيد التقدّم
عمليات الطرح
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

دالة ردّ الاتصال عند فشل حالة اختبار.

المعلَمات
testData DeviceMetricData: DeviceMetricData الذي يحتوي على بيانات حالة الاختبار
test TestDescription: TestDescription لإطار الاختبار قيد التقدّم
عمليات الطرح
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

تتيح تسجيل حدث انتهاء الوحدة.

عمليات الطرح
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

يسمح بتسجيل حدث بدء الوحدة.

عمليات الطرح
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

دالة ردّ الاتصال عند انتهاء عملية تشغيل الاختبار. يجب أن يكون هذا هو الوقت المناسب للتنظيف.

المعلَمات
runData استبدِل DeviceMetricData بـ DeviceMetricData الذي يحتوي على بيانات عملية التشغيل. سيكون الكائن نفسه كما كان خلال onTestRunStart(DeviceMetricData).
currentRunMetrics ‫Map: الخريطة الحالية للمقاييس التي تم تمريرها إلى testRunEnded(long,Map)
عمليات الطرح
DeviceNotAvailableException

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

معاودة الاتصال لأحداث testRunFailed

عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

دالة ردّ الاتصال عند بدء تشغيل تجريبي.

المعلَمات
runData استبدِل DeviceMetricData بـ DeviceMetricData الذي يحتوي على بيانات عملية التشغيل.
عمليات الطرح
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

يتم تنفيذ هذه الدالة عند بدء حالة اختبار.

المعلَمات
testData DeviceMetricData: DeviceMetricData الذي يحتوي على بيانات حالة الاختبار
عمليات الطرح
DeviceNotAvailableException

rebootEnded

public void rebootEnded (ITestDevice device)

تتلقّى إشعارًا عند انتهاء عملية إعادة التشغيل على الجهاز.

ملاحظة: يجب على أجهزة الاستقبال تجنُّب إعادة التشغيل أثناء معاودة الاتصال هذه. وسيتم تجاهل أي محاولة لإعادة التشغيل.

المعلَمات
device ‫ITestDevice: ITestDevice حيث انتهت عملية إعادة التشغيل
عمليات الطرح
DeviceNotAvailableException

rebootStarted

public void rebootStarted (ITestDevice device)

تلقّي إشعار عند بدء إعادة التشغيل على الجهاز

ملاحظة: يجب على أجهزة الاستقبال تجنُّب إعادة التشغيل أثناء معاودة الاتصال هذه. وسيتم تجاهل أي محاولة لإعادة التشغيل.

المعلَمات
device ITestDevice: ITestDevice حيث بدأت عملية إعادة التشغيل
عمليات الطرح
DeviceNotAvailableException

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

تضبط هذه السمة المستوى الذي يجب أن تجمع فيه أداة الجمع السجلات بغض النظر عن حالات الأعطال.

سيؤدي مستوى NULL إلى عدم جمع البيانات.

المعلَمات
level IMetricCollector.MetricCollectionLevel: MetricCollectionLevel الذي سيتم فيه جمع السجلات.

setDisable

public final void setDisable (boolean isDisabled)

يضبط ما إذا كان يجب إيقاف العنصر. يعني الإيقاف أنّه يجب تخطّي كل من خطوات الإعداد والإزالة. يمكن استخدامها لجعل الكائن غير مفعّل تلقائيًا في الدالة الإنشائية التلقائية.

المعلَمات
isDisabled ‫boolean: الحالة التي يجب وضع العنصر فيها

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

تحدّد ما إذا كان يجب إيقاف IDeviceActionReceiver. يعني إيقافها أنّه لن يتم تسجيلها على الجهاز لتلقّي أحداث إجراءات الجهاز.

المعلَمات
isDisabled boolean

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

لا تستخدِمها في تنفيذ أداة جمع المقاييس الداخلية. هذه هي عملية إعادة التوجيه البحتة.

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

setModuleContainsFailure

public void setModuleContainsFailure ()

تضبط هذه السمة ما إذا كانت الوحدة قد واجهت أي أخطاء (حالة الاختبار، التشغيل التجريبي).

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

تضبط هذه السمة المستوى الذي يجب أن تجمع فيه أداة الجمع السجلات أثناء حدوث الأعطال.

سيؤدي مستوى NULL إلى عدم جمع البيانات.

المعلَمات
level IMetricCollector.MetricCollectionLevel: MetricCollectionLevel الذي سيتم فيه جمع السجلات.

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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

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

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

المعلَمات
test ‫TestDescription: تحدّد الاختبار
testMetrics HashMap: 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)

تعرض هذه السمة بيانات السجلّ أو تصحيح الأخطاء المرتبطة بعملية استدعاء الاختبار.

يجب الاتصال قبل ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

سيستدعي إطار عمل TradeFederation هذه الطريقة تلقائيًا، مع توفير سجلّ المضيف، وسجلّ logcat للجهاز إذا كان ذلك منطبقًا.

المعلَمات
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)

لا تستخدِمها في تنفيذ أداة جمع المقاييس الداخلية. هذه هي عملية إعادة التوجيه البحتة.

المعلَمات
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.

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: تحدّد الاختبار