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

اسم الوحدة

public String getModuleName ()

المرتجعات
String

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

public final  getRealDevices ()

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

المرتجعات

getRunName

public String getRunName ()

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

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

إعداد

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

لا تلغي الإعدادات إلا إذا كنت متأكدًا من أنّك تعرف ما تفعله.

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

invocationEnded

public final void invocationEnded (long elapsedTime)

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

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

المعلمات
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 عرض true إذا كان غير مفعّل، وfalse في الحالات الأخرى

ارتباط لوغاريتمي

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

فاشل OnTestRunFound

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: الحالة التي يجب وضع العنصر فيها

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

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: تتبع تسلسل استدعاء الدوال البرمجية للفشل

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

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) و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) من المقاييس التي تمّ قياسها

testFailed

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: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

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 لوصف الخطأ وسياقه

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

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: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدة مرات. تكون المحاولة الأولى مفهرسة بمقدار 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: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدة مرات. يتمّ ترقيم مَعلمة 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: يحدد الاختبار