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)

ردّ اتصال لأحداث testRunFailed

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.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, 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 ()

الطرق العامة

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

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

getBuildInfos

public final  getBuildInfos ()

عرض قائمة معلومات الإصدار المتاحة في الطلب

المرتجعات

getDevices

public final  getDevices ()

عرض قائمة الأجهزة المتاحة في الطلب

المرتجعات

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

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

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

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

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

المرتجعات
ITestInvocationListener

getModuleName

public String getModuleName ()

المرتجعات
String

getRealDevices

public final  getRealDevices ()

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

المرتجعات

getRunName

public String getRunName ()

تعرِض هذه السمة اسم عملية تنفيذ الاختبار mRunName التي تبدأ عملية جمع البيانات.

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

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: معلومات عن الاستدعاء

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, 
                 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

onTestModuleEnded

public void onTestModuleEnded ()

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

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

onTestModuleStarted

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

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

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

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, 
                 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 final void testEnded (TestDescription test, 
                 testMetrics)

يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي.

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

المعلمات
test TestDescription: لتحديد الاختبار
testMetrics : ERROR(/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)) أو 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, 
                 runMetrics)

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

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

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: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدّة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد كلّ مرّة تتم فيها عملية تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عدد عمليات التشغيل 4 عمليات ضمن اسم التشغيل نفسه وأن تتراوح مَعلمة 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: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدّة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد كلّ مرّة يتمّ فيها تنفيذ عملية تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عمليات التشغيل التي تمّ إجراؤها 4 مرّات ضمن اسم التشغيل نفسه، ويجب أن تتراوح مَعلمة 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(com.android.tradefed.result.TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار ، مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لإجراء قياس دقيق.

المعلمات
test TestDescription: لتحديد الاختبار
startTime long: وقت بدء الاختبار، يتم قياسه من خلال System.currentTimeMillis()

testStarted

public final void testStarted (TestDescription test)

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

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