BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector , IDeviceActionReceiver

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) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)

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

void onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)

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

void onTestFail ( DeviceMetricData testData, TestDescription test)

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

void onTestModuleEnded ()

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

void onTestModuleStarted ()

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

void onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) 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) testEnded ( TestDescription test, long endTime, testMetrics)

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

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

إرجاع قائمة معلومات البناء المتوفرة في الاستدعاء.

عائدات

com.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، اسم التشغيل الاختباري الحالي.

فيه

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

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

حدود
context IInvocationContext : IInvocationContext للاستدعاء الجاري.

listener ITestInvocationListener : ITestInvocationListener مكان وضع النتائج.

عائدات
ITestInvocationListener المستمع الجديد يغلف المستمع الأصلي.

رميات
DeviceNotAvailableException

انتهت الدعوة

public final void invocationEnded (long elapsedTime)

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

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

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

فشل الاستدعاء

public final void invocationFailed (FailureDescription failure)

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

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

حدود
failure FailureDescription : FailureDescription الذي يصف سبب الفشل

فشل الاستدعاء

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

معطل

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

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

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 الذي يصف الفشل وسياقه.

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

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 : تتبع مكدس الفشل

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 قد لا يكون فريدًا لكل استدعاء. أي يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات

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 قد لا يكون فريدًا لكل استدعاء. أي يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات

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)

تقارير نهاية التشغيل التجريبي. إصلاح: لا يمكن أن يكون لدينا واجهتان Map<> بنوع مختلف، لذا يتعين علينا استخدام 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 : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 0 ويجب أن يتزايد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال، تتم إعادة محاولة الاختبار 3 مرات، ويجب أن يحتوي على 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 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 : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 0 ويجب أن يتزايد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال، تتم إعادة محاولة الاختبار 3 مرات، ويجب أن يحتوي على 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.

startTime long : الوقت الذي بدأ فيه التشغيل، ويتم قياسه عبر System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

توقف التشغيل التجريبي للتقارير قبل اكتماله بناءً على طلب المستخدم.

TODO: غير مستخدم حاليًا، فكر في الإزالة

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