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

ملخّص

الثوابت

String TEST_CASE_EXCLUDE_GROUP_OPTION

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 التي تؤدي إلى تشغيل أداة الجمع.

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)

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

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-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

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

الإنشاءات العامة

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، وهو اسم عملية الاختبار الحالية.

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

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: رقم الطلب، الذي يحدّد المحاولات المختلفة لـ 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(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: تحدّد الاختبار