أداة BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

التنفيذ الأساسي لآلية IMetricCollector التي تسمح ببدء جمع البيانات وإيقافها في onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) وERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))

ملخّص

الحقول

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

شركة إنشاءات عامة

BaseDeviceMetricCollector()

الطرق العامة

void extraInit(IInvocationContext context, ITestInvocationListener listener)
final getBuildInfos()

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

final getDevices()

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

File getFileFromTestArtifacts(String fileName)

استرداد الملف من عناصر الاختبار أو عناصر الوحدة وذاكرة التخزين المؤقت في خريطة للطلبات اللاحقة.

final ITestInvocationListener getInvocationListener()

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

String getModuleName()
final getRealDevices()

عرض جميع الأجهزة غير البديلة من قائمة getDevices().

String getRunName()

تعرض اسم إجراء الاختبار mRunName الذي يشغِّل أداة التجميع.

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)

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

final boolean isDisabled()

تعرض True إذا كان الكائن بالكامل غير مفعّل (تخطي الإعداد والتقسيم).

boolean isDisabledReceiver()

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

final void logAssociation(String dataName, LogFile logFile)

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

void onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)

معاودة الاتصال عند إخفاق حالة الاختبار مع فشل الافتراض.

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)

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

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)

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

void onTestFail(DeviceMetricData testData, TestDescription test)

معاودة الاتصال عند تعذُّر حالة الاختبار.

void onTestModuleEnded()

يسمح بالتقاط حدث انتهى الوحدة.

void onTestModuleStarted()

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

void onTestRunEnd(DeviceMetricData runData, currentRunMetrics)

إمكانية معاودة الاتصال عند انتهاء عملية اختبار.

void onTestRunFailed(DeviceMetricData testData, FailureDescription failure)

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

void onTestRunStart(DeviceMetricData runData)

يتم معاودة الاتصال عند بدء إجراء اختبار.

void onTestStart(DeviceMetricData testData)

معاودة الاتصال عند بدء حالة اختبار.

void rebootEnded(ITestDevice device)

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

void rebootStarted(ITestDevice device)

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

final void setDisable(boolean isDisabled)

لضبط ما إذا كان يجب إيقاف الكائن.

void setDisableReceiver(boolean isDisabled)

تحدِّد هذه السياسة ما إذا كان يجب إيقاف IDeviceActionReceiver.

final void setLogSaver(ILogSaver logSaver)

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

final void testAssumptionFailure(TestDescription test, String trace)

يتم استدعاء هذه الوظيفة عندما يُبلغ الاختبار الذري عن أنها تفترض حالة خاطئة

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

يتم استدعاء هذه الوظيفة عندما يُبلغ الاختبار الذري عن أنها تفترض حالة خاطئة

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

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

final void testEnded(TestDescription test, testMetrics)

تعمل هذه السياسة على الإبلاغ عن نهاية تنفيذ حالة اختبار فردية.

final void testFailed(TestDescription test, FailureDescription failure)

الإبلاغ عن تعذُّر حالة اختبار فردية

final void testFailed(TestDescription test, String trace)

الإبلاغ عن تعذُّر حالة اختبار فردية

final void testIgnored(TestDescription test)

يتم استدعاء هذا الإجراء عندما لا يتم إجراء الاختبار، وعادةً ما يكون هناك تعليق توضيحي لطريقة الاختبار org.junit.تجاهل.

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, 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(com.android.tradefed.result.TestDescription) حيث نحدد أيضًا وقت إجراء الاختبار تم البدء، إلى جانب ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))، للحصول على قياس دقيق.

final void testStarted(TestDescription test)

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

الحقول

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

شركة إنشاءات عامة

أداة BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

الطرق العامة

إكسسوار إنت

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

الحصول على معلومات الإصدار

public final  getBuildInfos ()

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

المرتجعات

الحصول على أجهزة

public final  getDevices ()

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

المرتجعات

GetFileFromTest Artifacts

public File getFileFromTestArtifacts (String fileName)

استرداد الملف من عناصر الاختبار أو عناصر الوحدة وذاكرة التخزين المؤقت في خريطة للطلبات اللاحقة.

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

أمر getInvocationListener

public final ITestInvocationListener getInvocationListener ()

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

المرتجعات
ITestInvocationListener

اسم الوحدة

public String getModuleName ()

المرتجعات
String

الحصول على أجهزة حقيقية

public final  getRealDevices ()

عرض جميع الأجهزة غير البديلة من قائمة getDevices().

المرتجعات

الحصول على RunName

public String getRunName ()

تعرض اسم إجراء الاختبار mRunName الذي يشغِّل أداة التجميع.

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

إعداد

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

لا تنفِّذ هذا الإجراء ما لم تكن تعرف ما تفعله.

المعلمات
context IInvocationContext: السمة IInvocationContext للاستدعاء قيد التقدّم.
listener ITestInvocationListener: ITestInvocationListener حيث يتم عرض النتائج
المرتجعات
ITestInvocationListener المستمع الجديد ينهي الاستماع الأصلي.
الرميات
DeviceNotAvailableException

تم إنهاء الاستدعاء

public final void invocationEnded (long elapsedTime)

البلاغات التي تفيد بإنهاء الاستدعاء، سواء بنجاح أو بسبب خطأ ما الشرط.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

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

تعذّر الاستدعاء

public final void invocationFailed (FailureDescription failure)

تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

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

تعذّر الاستدعاء

public final void invocationFailed (Throwable cause)

تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

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

تم تخطّي الاستدعاء

public void invocationSkipped (SkipReason reason)

يتم الإبلاغ عن استدعاء على أنّه تم تخطّيه.

المعلمات
reason SkipReason

تم بدء الاستدعاء

public final void invocationStarted (IInvocationContext context)

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

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

تم إيقاف

public final boolean isDisabled ()

تعرض True إذا كان الكائن بالكامل غير مفعّل (تخطي الإعداد والتقسيم). خطأ في الحالات الأخرى.

المرتجعات
boolean

جهاز استقبال isDisabled

public boolean isDisabledReceiver ()

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

المرتجعات
boolean تُرجع true إذا تم إيقافها، أو false في الحالات الأخرى.

مؤسسة Log Association

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, 
                 currentTestCaseMetrics, 
                TestDescription test)

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

المعلمات
testData DeviceMetricData: السمة DeviceMetricData التي تحتفظ ببيانات حالة الاختبار. ستكون العنصر نفسه الذي تم رصده أثناء onTestStart(com.android.tradefed.device.metric.DeviceMetricData).
currentTestCaseMetrics : الخريطة الحالية للمقاييس التي تم تمريرها إلى ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)).
test TestDescription: الحالة TestDescription لحالة الاختبار قيد التقدّم.
الرميات
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

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

المعلمات
testData DeviceMetricData: السمة DeviceMetricData التي تحتفظ ببيانات حالة الاختبار. ستكون العنصر نفسه الذي تم رصده أثناء onTestStart(com.android.tradefed.device.metric.DeviceMetricData).
currentTestCaseMetrics : الخريطة الحالية للمقاييس التي تم تمريرها إلى ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)).
الرميات
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

معاودة الاتصال عند تعذُّر حالة الاختبار.

المعلمات
testData DeviceMetricData: السمة DeviceMetricData التي تحتفظ ببيانات حالة الاختبار.
test TestDescription: الحالة TestDescription لحالة الاختبار قيد التقدّم.
الرميات
DeviceNotAvailableException

onTestUnitEnded

public void onTestModuleEnded ()

يسمح بالتقاط حدث انتهى الوحدة.

الرميات
DeviceNotAvailableException

تم بدء onTestModule

public void onTestModuleStarted ()

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

الرميات
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

المعلمات
runData DeviceMetricData: العمود "DeviceMetricData" الذي يحتفظ بالبيانات للجري. ستكون مماثلة كائن كما هو أثناء onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData).
currentRunMetrics : الخريطة الحالية للمقاييس التي تم تمريرها إلى ERROR(/#testRunEnded(long,Map)).
الرميات
DeviceNotAvailableException

تعذُّر تشغيل العملية بنجاح

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

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

الرميات
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

انتهت إعادة التشغيل

public void rebootEnded (ITestDevice device)

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

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

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

تم بدء إعادة التشغيل

public void rebootStarted (ITestDevice device)

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

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

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

ضبط إيقاف

public final void setDisable (boolean isDisabled)

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

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

جهاز استقبال البيانات

public void setDisableReceiver (boolean isDisabled)

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

المعلمات
isDisabled boolean

ملف setLogSaver

public final void setLogSaver (ILogSaver logSaver)

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

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

تعذُّر اختبار الافتراض

public final void testAssumptionFailure (TestDescription test, 
                String trace)

يتم استدعاء هذه الوظيفة عندما يُبلغ الاختبار الذري عن أنها تفترض حالة خاطئة

المعلمات
test TestDescription: يحدد الاختبار
trace String: تتبع تسلسل استدعاء الدوال البرمجية للفشل

تعذُّر اختبار الافتراض

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

يتم استدعاء هذه الوظيفة عندما يُبلغ الاختبار الذري عن أنها تفترض حالة خاطئة

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

انتهى الاختبار

public final 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) من المقاييس المنبعثة

انتهى الاختبار

public final void testEnded (TestDescription test, 
                 testMetrics)

تعمل هذه السياسة على الإبلاغ عن نهاية تنفيذ حالة اختبار فردية.

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

المعلمات
test TestDescription: يحدد الاختبار
testMetrics : ERROR(/Map) من المقاييس المنبعثة

فشل الاختبار

public final void testFailed (TestDescription test, 
                FailureDescription failure)

الإبلاغ عن تعذُّر حالة اختبار فردية

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

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

فشل الاختبار

public final void testFailed (TestDescription test, 
                String trace)

الإبلاغ عن تعذُّر حالة اختبار فردية

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

المعلمات
test TestDescription: يحدد الاختبار
trace String: تتبع تسلسل استدعاء الدوال البرمجية للفشل

تم تجاهل الاختبار

public final void testIgnored (TestDescription test)

يتم استدعاء هذا الإجراء عندما لا يتم إجراء الاختبار، وعادةً ما يكون هناك تعليق توضيحي لطريقة الاختبار org.junit.تجاهل.

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

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

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

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

سوف يستدعي إطار التجارة الفيدرالية هذه الطريقة تلقائيًا، مما يوفر سجل المضيف وأيضًا، Logcat.

المعلمات
dataName String: اسم String وصفي للبيانات. مثلاً: "device_logcat". ملاحظة قد لا يكون dataName فريدًا في كل استدعاء. أي أنّ القائمين على التنفيذ يجب أن يكونوا قادرين على التعامل مكالمات متعددة باستخدام dataName نفسها
dataType LogDataType: LogDataType للبيانات
dataStream InputStreamSource: InputStreamSource للبيانات. يجب على الجهات التنفيذية استدعاء createInputStream لبدء قراءة البيانات، والتأكد من إغلاق EnterStream عند الاكتمال. على المتصلين التأكّد من بقاء مصدر البيانات. موجودة ويمكن الوصول إليها حتى تكتمل طريقة testLog.

تم حفظ سجلّ الاختبار

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 لبدء قراءة البيانات، والتأكد من إغلاق EnterStream عند الاكتمال.
logFile LogFile: LogFile الذي يحتوي على البيانات الوصفية للملف المحفوظ.

وحدة اختبار انتهت

public final void testModuleEnded ()

تقدم تقريرًا بنهاية تشغيل وحدة.

تم بدء الاختبار

public final void testModuleStarted (IInvocationContext moduleContext)

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

المعلمات
moduleContext IInvocationContext: السمة IInvocationContext في الوحدة

اختبار RunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

نهاية تشغيل اختبار التقارير فيكس: لا يمكننا استخدام خريطتين<> وواجهات برمجة تطبيقات من نوع مختلف، لذلك ينبغي لنا استخدام HashMap هنا.

المعلمات
elapsedTime long: الوقت المنقضي الذي تم الإبلاغ عنه للجهاز، بالمللي ثانية
runMetrics : يتم الإبلاغ عن أزواج المفتاح/القيمة في نهاية عملية اختبار باستخدام Metric.

اختبار التشغيل فاشل

public final void testRunFailed (FailureDescription failure)

تعذّر إكمال تشغيل اختبار التقارير بسبب تعذُّر وصفه من قِبل FailureDescription.

المعلمات
failure FailureDescription: FailureDescription يصف الخطأ وسياقه.

اختبار التشغيل فاشل

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

testRunStopped

public final void testRunStopped (long elapsedTime)

تم إيقاف تشغيل اختبار التقارير قبل اكتماله بسبب طلب من المستخدم.

قائمة المهام: غير مستخدمة حاليًا، يمكنك إزالتها

المعلمات
elapsedTime long: الوقت المنقضي الذي تم الإبلاغ عنه للجهاز، بالمللي ثانية

تم تخطي الاختبار

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

تم بدء الاختبار

public final 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()

تم بدء الاختبار

public final void testStarted (TestDescription test)

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

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