ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

الفئات الفرعية غير المباشرة المعروفة AggregatePostProcessor وAtraceCollector وAtraceRunMetricCollector وAveragePostProcessor وBaseDeviceMetricCollector وBasePostProcessor وBluetoothConnectionLatencyCollector وBluetoothConnectionStateCollector وBluetoothConnectionSuccessRatePostProcessor وBluetoothHciSnoopLogCollector وBugreportCollector وBugreportzOnFailureCollector وBugreportzOnTestCaseFailureCollector وClangCodeCoverageCollector وCodeCoverageCollector و80 عملية أخرى AggregatePostProcessor مجمّع مقاييس يقدّم الحدّ الأدنى والحدّ الأقصى والمتوسّط والتباين والانحراف المعياري والإجمالي والعدد والنسب المئوية اختياريًا للمقاييس الرقمية التي يتم جمعها أثناء عمليات تنفيذ الاختبار المتكرّرة، ويتعامل معها على أنّها أعداد مزدوجة.  AtraceCollector IMetricCollector التي تُجري عملية تتبُّع أثناء الاختبار وتجمع النتيجة وتُسجّلها في الطلب  AtraceRunMetricCollector يتم جمع عمليات التتبّع من جميع الدليل التجريبي ضمن الدليل المحدّد من الجهاز التجريبي، وتسجيل الدليل التجريبي ومعالجة ملفات التتبّع بعد تسجيلها ضمن الدليل التجريبي وتجميع المقاييس.  AveragePostProcessor تنفيذ وحدة معالجة ما بعد المعالجة التي تحسب متوسّط قائمة المقاييس  BaseDeviceMetricCollector التنفيذ الأساسي لـ IMetricCollector الذي يسمح ببدء عملية جمع البيانات وإيقافها في onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) وERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))  BasePostProcessor القاعدة IPostProcessor التي يجب أن تمتد إليها كل عملية تنفيذ  BluetoothConnectionLatencyCollector سيُرسِل أداة جمع البيانات إعدادات مقياس مدّة statsd المحدّدة مسبقًا إلى الأجهزة وسيجمع مدّة اتصال البلوتوث لكل ملف شخصي.  BluetoothConnectionStateCollector سيجمع هذا المجمّع مقاييس BluetoothConnectionStateChanged ويُسجّل حالة الاتصال رقمًا لكل ملف شخصي.  BluetoothConnectionSuccessRatePostProcessor تنفيذ المعالج اللاحق الذي يحسب معدّل النجاح لملف شخصي على البلوتوث استخدِم "metric-key-match" لتحديد المقاييس التي تحتوي على حالات اتصال البلوتوث في صفيف صعِد رقمي مثال [0، 1، 2، 3، 0، 1، 2، 3].  BluetoothHciSnoopLogCollector أداة جمع لتسجيل التطفل على واجهة وحدة تحكّم المضيف في بلوتوث على جهاز التحكّم في العينة وجمع السجلّ لكل اختبار  BugreportCollector ITestInvocationListener للمرور بدون معالجة تجمع تقارير الأخطاء عند حدوث أحداث قابلة للضبط ، ثم تستدعي ITestInvocationListener.testLog في عناصرها الفرعية بعد جمع كل تقرير أخطاء.  BugreportzOnFailureCollector جمع تقرير أخطاء عند تعذُّر اختبار حالة  BugreportzOnTestCaseFailureCollector جمع تقرير أخطاء عند تعذُّر تنفيذ حالة اختبار في إحدى عمليات التشغيل  ClangCodeCoverageCollector BaseDeviceMetricCollector الذي سيستخرج قياسات تغطية Clang من الجهاز ويُسجّلها كعناصر اختبار  CodeCoverageCollector BaseDeviceMetricCollector لسحب قياسات التغطية الأصلية من Java و من الجهاز وتسجيلها كعناصر اختبار  CollectingTestListener ITestInvocationListener ستجمع جميع نتائج الاختبار.  CommandStatusHandler معالِج يساعد في مراقبة حالة طلب الاستدعاء وتعديلها  ConditionFailureMonitor راقِب أيّ أخطاء من طلب التنفيذ.  ConsoleResultReporter أداة إعداد التقارير لطباعة نتائج الاختبار في وحدة التحكّم  CountTestCasesCollector احتساب عدد حالات الاختبار وإعداد تقارير عنها لـ IRemoteTest معيّن  CountingTestResultListener TestResultListener تتتبّع إجمالي عدد الاختبارات حسب TestStatus  DebugHostLogOnFailureCollector أداة جمع ستجمع السجلات من جهة المضيف وتسجّلها عند حدوث خطأ في نموذج الاختبار.  DeviceReleaseReporter مُرسِل إصدارات الأجهزة الذي يتعامل مع عملية التواصل مع الوالدَين بشأن الأجهزة التي سيتم إصدارها   DeviceTraceCollector أداة جمع البيانات التي ستبدأ عملية تتبُّع perfetto عند بدء عملية تشغيل الاختبار وستسجِّل ملف تتبُّع في النهاية.  DeviceUnavailableMonitor يحاول هذا المستمع تسجيل بيانات تحليل الأداء على مستوى نموذج الاختبار فقط.  EventsLoggerListener مستمع يسجِّل جميع الأحداث التي يتلقّاها في ملف  FileProtoResultReporter أداة Proto reporter التي تُفرِغ TestRecord في ملف  FilePullerDeviceMetricCollector BaseDeviceMetricCollector يستمع إلى مفتاح المقاييس الواردة من الجهاز ويسحبها كملف من الجهاز.  FilePullerLogCollector أداة تسجيل الملفات التي تم الإبلاغ عنها من جانب الجهاز  FilteredResultForwarder نوع من ResultForwarder لا يسمح إلا بتسجيل قائمة مسموح بها من TestDescription.  FormattedGeneratorReporter أداة إعداد التقارير التي تتيح إنشاء تقارير بتنسيق معيّن  GcovCodeCoverageCollector BaseDeviceMetricCollector الذي سيستخرج قياسات تغطية gcov من الجهاز ويُسجّلها كعناصر اختبار  GcovKernelCodeCoverageCollector BaseDeviceMetricCollector التي ستسحب قياسات تغطية ملف kernel باستخدام gcov من debugfs وخارج الجهاز، ثم تسجّلها أخيرًا كعناصر اختبار  GranularRetriableTestWrapper.StartEndCollector مساعد فئة لرصد بداية ونهاية التشغيل غير المتوفّرة  HostStatsdMetricCollector IMetricCollector تجمع مقاييس statsd من جهة المضيف باستخدام أوامر أداة statsd  ICommandScheduler.IScheduledInvocationListener أداة الاستماع لأحداث الاستدعاء عند اكتمال الاستدعاء  ILogSaverListener السماح لتطبيقات ITestInvocationListener بالاستماع إلى عمليات حفظ ملفات السجلّ  IMetricCollector ستتم إضافة هذه الواجهة كمزيّن عند إعداد تقارير نتائج الاختبارات من أجل جمع المقاييس المطابقة.  IPostProcessor معالجات ما بعد المعالجة هي عناصر في Trade Federation تهدف إلى السماح بمعالجة المقاييس والسجلات بعد الاختبارات وقبل إعداد تقارير النتائج.  IShardableListener ITestInvocationListener يمكن تقسيمه  ISupportGranularResults واجهة تحدّد ما إذا كان ITestInvocationListener يتيح تلقّي نتائج تحليل ملفّات تعريف الارتباط الدقيقة أم لا  ITestInvocationListener مستمع لنتائج الاختبار من طلب الاختبار  ITestSummaryListener واجهة تتيح لـ ITestInvocationListener تبادل بعض المعلومات المحدودة من خلال ملفّات المشروعات الملخّصة   InvocationProtoResultReporter أدوات إعداد التقارير لتخزين معلومات التخزين المؤقت على مستوى الطلب وقائمة الوحدات  InvocationToJUnitResultForwarder فئة تستمع إلى أحداث ITestInvocationListener وتعيد توجيهها إلى TestListener.  JarHostTest.HostTestListener مستمع الغلاف الذي يعيد توجيه جميع الأحداث باستثناء testRunStarted() وtestRunEnded() إلى المستمع المضمّن  JavaCodeCoverageCollector BaseDeviceMetricCollector التي ستسحب قياسات تغطية Java من الجهاز وتُسجّلها كعناصر اختبار  JsonHttpTestResultReporter أداة إعداد تقارير النتائج التي تُشفِّر نتائج مقاييس الاختبار وبيانات الفرع والجهاز إلى تنسيق JSON وتُرسِلها باستخدام POST إلى نقطة نهاية خدمة HTTP  LUCIResultReporter أداة إعداد تقارير النتائج التي تحفظ نتائج الاختبار التي تحتاجها ResultDB وLUCI بتنسيق JSON (go/result-sink) وتسجِّل موقع الملف في وحدة التحكّم  LastShardDetector عند تشغيل التجزئة المحلية، نريد أحيانًا تنفيذ بعض الإجراءات فقط عندما تصل الشريحة الأخيرة إلى invocationEnded(long).  LegacySubprocessResultsReporter تنفيذ مجمّد لبرنامج إعداد تقارير نتائج العملية الفرعية الذي من المفترض أن يظل متوافقًا مع الإصدارات السابقة من TF/CTS (مثل الإصدار 8 والإصدارات الأحدث)، على الرغم من التغييرات في الفئة العليا  LogSaverResultForwarder ResultForwarder لحفظ السجلات باستخدام أداة حفظ الملفات الشاملة  LogcatCrashResultForwarder مستمع خاص: في حال حدوث أخطاء (تعطُّل عملية أداة القياس)، سيحاول استخراج معلومات عن الأعطال من logcat وإضافتها إلى رسالة الخطأ المرتبطة بالاختبار.  LogcatOnFailureCollector أداة جمع ستسجِّل logcat وتُسجِّله عند تعذُّر اختبار حالة معيّنة.  LogcatTimingMetricCollector أداة جمع مقاييس تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء اختبار واحد أو عدّة اختبارات متكرّرة باستخدام أنماط التعبير العادي المحدّدة لتحليل إشارات البدء والنهاية لحدث من أسطر logcat  MetricFilePostProcessor تُستخدَم لتحميل ملف سجلّ المقاييس الذي تم جمعه أثناء مستوى الاختبار والتنفيذ.  MetricsXMLResultReporter يُسجِّل MetricsXMLResultReporter مقاييس الاختبار ومقاييس التشغيل في ملف XML في مجلد محدّد بالمَعلمة metrics-folder في مرحلة invocationEnded من الاختبار.  ModuleListener مستمع مرفق بكل IRemoteTest من كل وحدة من أجل جمع قائمة النتائج  ModuleLogcatCollector إصدار أداة جمع سجلّات logcat ولكن للوحدة.  ModuleProtoResultReporter أداة إعداد تقارير النتائج مخصّصة لإعداد تقارير عن النتائج على مستوى الوحدة فقط.  NameMangleListener مستمع وكيل لترجمة أسماء طريقة الاختبار والفئة والحزمة عند تسجيل النتائج  PassingTestFileReporter ITestInvocationListener لحفظ قائمة حالات الاختبار التي اجتازت الاختبار في ملف اختبار  PerfettoGenericPostProcessor وحدة معالجة لاحقة تعالج ملف proto لقياسات النص/الثنائية في perfetto إلى أزواج مفتاح/قيمة من خلال توسيع رسائل proto والحقول التي تحتوي على قيم سلاسل بشكل متكرر إلى أن يتم العثور على الحقل الذي يحتوي على قيمة رقمية.  PerfettoPullerMetricCollector التنفيذ الأساسي لـ FilePullerDeviceMetricCollector الذي يسمح بسحب ملفات perfetto من الجهاز وجمع المقاييس منه  PrettyTestEventLogger أداة تسجيل تتطابق مع الأحداث وتُسجّلها لتسهيل تصحيح الأخطاء  ProtoResultReporter ينشئ مُبلِّغ النتائج ملفًا بتنسيق TestRecord protobuf يحتوي على جميع النتائج.  PythonBinaryHostTest.PythonForwarder أداة إعادة توجيه النتائج لاستبدال اسم التشغيل باسم ثنائي  RebootReasonCollector أداة جمع تجمع عمليات إعادة تشغيل الجهاز أثناء إجراء الاختبار وتُبلغ عنها حسب السبب والعدد.  RemoteTestTimeOutEnforcer المستمعون الذين يسمحون بالتحقق من وقت تنفيذ إعداد اختبار معيّن وإخفاقه إذا تجاوز مهلة معيّنة  ReportPassedTests الإبلاغ في ملف عن الفلاتر المحتمَلة لاستبعاد الاختبار الذي تم اجتيازه  ResultAggregator إعادة توجيه خاصة تُجمِّع النتائج عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتخاذها   ResultAndLogForwarder أداة إعادة توجيه للنتائج وأحداث السجلّ  ResultDBReporter أداة إعداد تقارير النتائج التي تحمّل نتائج الاختبار إلى ResultDB  ResultForwarder ITestInvocationListener يعيد توجيه نتائج الاستدعاء إلى قائمة بالمستمعِين الآخرين.  RetryLogSaverResultForwarder مُعيد التوجيه الذي يتعامل أيضًا مع اجتياز المحاولة الحالية التي نحاول إجراؤها  RetryResultForwarder إضافة ResultForwarder يتم دفعها دائمًا إلى عدد محاولات معيّن.  RuntimeRestartCollector أداة جمع تجمع الطوابع الزمنية لعمليات إعادة التشغيل أثناء التشغيل (أعطال خادم النظام) أثناء تنفيذ الاختبار ، إن وجدت.  ScreenshotOnFailureCollector أداة جمع ستلتقط لقطة شاشة وتسجّلها عند تعذُّر تنفيذ حالة اختبار.  ShardListener ITestInvocationListener يجمع النتائج من شريحة طلب (المعروفة أيضًا باسم تقسيم طلب التشغيل على موارد متعددة بشكل متزامن)، ويعيد توجيهها إلى مستمع آخر  ShardMainResultForwarder ResultForwarder يجمع نتائج عمليات استدعاء الاختبار المجزّأة  ShowmapPullerMetricCollector التنفيذ الأساسي FilePullerDeviceMetricCollector الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منه  StatsdBeforeAfterGaugeMetricPostProcessor معالج لاحق يعالج مقاييس القياس التي يتم جمعها باستخدام أسلوب "قبل/بعد"، أي  StatsdEventMetricPostProcessor وحدة معالجة لاحقة تعالج مقاييس الأحداث في تقارير statsd إلى أزواج مفتاح/قيمة، باستخدام أدوات التنسيق المحدّدة في وحدة المعالجة  StatsdGenericPostProcessor وحدة معالجة لاحقة تعالج تقارير statsd الثنائية إلى أزواج مفتاح/قيمة من خلال توسيع التقرير كبنية شجرة  StreamProtoResultReporter تنفيذ ProtoResultReporter  SubprocessResultsReporter تنفيذ ITestInvocationListener ليتم تحديده كـ result_reporter وإعادة توجيه نتائج الاختبار وعمليات تشغيل الاختبار وطلبات تشغيل الاختبار من العملية الفرعية  SuiteResultReporter جمع نتائج الاختبار لطلب مجموعة كاملة وعرض النتائج النهائية  TestResultListener تبسيط واجهة برمجة التطبيقات ITestLifecycleListener للمنفِّذِين الذين لا يهتمون إلا بنتائج الاختبار الفردية   TestRunResultListener مستمع يسمح بقراءة حالة التشغيل النهائي للاختبار  TestTimeoutEnforcer المستمعون الذين يسمحون بالتحقّق من وقت تنفيذ حالة اختبار معيّنة وإخفاقها إذا تجاوزت مهلة معيّنة  TextResultReporter أداة إعداد تقارير نتائج الاختبار التي تعيد توجيه النتائج إلى طابعة النتائج النصية JUnit  TraceCmdCollector IMetricCollector تجمع عمليات التتبّع أثناء الاختبار باستخدام trace-cmd، وتُسجّلها في عملية الاستدعاء.  TradefedSandboxRunner.StubScheduledInvocationListener رمز مقتطف IScheduledInvocationListener لا يؤدي إلى أيّ إجراء.  XmlFormattedGeneratorReporter تنفيذ FormattedGeneratorReporter الذي يُنشئ تنسيقًا xml لنتائج المجموعة  XmlResultReporter يكتب نتائج JUnit في ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter في Ant.

---

تتلقّى إشعارات بالأحداث أثناء عمليات تشغيل اختبارات الأدوات.

تم وضع نموذج لها استنادًا إلى org.junit.runner.notification.RunListener

سيكون تسلسل المكالمات على النحو التالي:

• testRunStarted
• testStarted
• [testFailed]
• [testAssumptionFailure]
• [testIgnored]
• testEnded
• ....
• [testRunFailed]
• testRunEnded

ملخّص

الطرق العامة
default void	testAssumptionFailure(TestDescription test, String trace) يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.
default void	testAssumptionFailure(TestDescription test, FailureDescription failure) يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.
default void	testEnded(TestDescription test, long endTime, testMetrics) بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً.
default void	testEnded(TestDescription test, testMetrics) يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي.
default void	testFailed(TestDescription test, FailureDescription failure) الإبلاغ عن تعذُّر اختبار فردي
default void	testFailed(TestDescription test, String trace) الإبلاغ عن تعذُّر اختبار فردي
default void	testIgnored(TestDescription test) يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.
default void	testRunEnded(long elapsedTimeMillis, runMetrics) الإبلاغ عن نهاية عملية الاختبار
default void	testRunFailed(FailureDescription failure) تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ وصفه FailureDescription.
default void	testRunFailed(String errorMessage) تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح.
default void	testRunStarted(String runName, int testCount, int attemptNumber) الإبلاغ عن بدء عملية اختبار
default void	testRunStarted(String runName, int testCount) الإبلاغ عن بدء عملية اختبار
default void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) الإبلاغ عن بدء عملية اختبار
default void	testRunStopped(long elapsedTime) توقّف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب أحد المستخدِمين.
default void	testSkipped(TestDescription test, SkipReason reason) يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً.
default void	testStarted(TestDescription test, long startTime) بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار ، مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لإجراء قياس دقيق.
default void	testStarted(TestDescription test) الإبلاغ عن بدء حالة اختبار فردية

الطرق العامة

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.

المعلمات
test	TestDescription: لتحديد الاختبار
trace	String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.

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

testEnded

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

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

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

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

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

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

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

المعلمات
test	TestDescription: لتحديد الاختبار
trace	String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testIgnored

public void testIgnored (TestDescription test)

يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.

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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String errorMessage)

تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح.

المعلمات
errorMessage	String: String يصف سبب تعذُّر التنفيذ

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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

المعلمات
runName	String: اسم اختبار التنفيذ
testCount	int: إجمالي عدد الاختبارات في اختبار التنفيذ
attemptNumber	int: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدّة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد كلّ مرّة تتم فيها عملية تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عدد عمليات التشغيل 4 عمليات ضمن اسم التشغيل نفسه وأن تتراوح مَعلمة attemptNumber بين 0 و3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

المعلمات
runName	String: اسم اختبار التنفيذ
testCount	int: إجمالي عدد الاختبارات في اختبار التنفيذ

testRunStarted

public 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 void testRunStopped (long elapsedTime)

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

TODO: currently unused, consider removing

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً. سيتمّ إعادة إجراء هذه الاختبارات لمحاولة تنفيذها بشكلٍ سليم.

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

testStarted

public 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 void testStarted (TestDescription test)

الإبلاغ عن بدء حالة اختبار فردية واجهة قديمة، يجب استخدام testStarted(com.android.tradefed.result.TestDescription) كلما أمكن.

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