CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener

الفئات الفرعية المباشرة المعروفة ‫JsonHttpTestResultReporter وLUCIResultReporter وMetricsXMLResultReporter وModuleListener وReportPassedTests وResultAggregator وShardListener وSuiteResultReporter وXmlResultReporter JsonHttpTestResultReporter أداة إعداد تقارير النتائج التي ترمّز نتائج مقاييس الاختبار ومعلومات الفرع والجهاز إلى JSON وPOST إلى نقطة نهاية خدمة HTTP  LUCIResultReporter أداة إعداد تقارير النتائج التي تحفظ نتائج الاختبارات التي تحتاجها ResultDB وLUCI بتنسيق JSON (go/result-sink) وتسجّل موقع الملف في وحدة التحكّم.  MetricsXMLResultReporter تكتب أداة MetricsXMLResultReporter مقاييس الاختبار ومقاييس التشغيل في ملف XML في مجلد محدّد بواسطة المَعلمة metrics-folder في مرحلة invocationEnded من الاختبار.  ModuleListener يتم ربط أداة معالجة الأحداث بكل IRemoteTest في كل وحدة من أجل جمع قائمة النتائج.  ReportPassedTests الإبلاغ في ملف عن الفلاتر المحتملة لاستبعاد الاختبارات الناجحة  ResultAggregator برنامج إعادة توجيه خاص يجمع النتائج عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتّخاذها.  ShardListener ITestInvocationListener يجمع النتائج من جزء من عملية الاستدعاء (يُعرف أيضًا باسم تقسيم عملية الاستدعاء لتنفيذها على موارد متعددة بالتوازي)، ويعيد توجيهها إلى مستمع آخر.  SuiteResultReporter جمع نتائج الاختبارات لتنفيذ مجموعة اختبارات كاملة وإخراج النتائج النهائية  XmlResultReporter تكتب هذه السمة نتائج JUnit في ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter في Ant.

الفئات الفرعية غير المباشرة المعروفة FormattedGeneratorReporter، XmlFormattedGeneratorReporter FormattedGeneratorReporter أداة إعداد التقارير التي تتيح إنشاء التقارير بتنسيق معيّن  XmlFormattedGeneratorReporter تنفيذ FormattedGeneratorReporter الذي يحدد تنسيق نتائج الحزمة بتنسيق xml

---

ITestInvocationListener سيجمع كل نتائج الاختبار.

على الرغم من أنّ بنى البيانات المستخدَمة في هذا العنصر آمنة للاستخدام المتزامن، يجب استدعاء عمليات معاودة الاتصال ITestInvocationListener بالترتيب الصحيح.

ملخّص

الإنشاءات العامة
CollectingTestListener()

الطُرق العامة
IBuildInfo	getBuildInfo() تم إيقاف هذه الطريقة نهائيًا. الاعتماد على IBuildInfo من getInvocationContext()
TestRunResult	getCurrentRunResults() تعرض هذه السمة نتائج تشغيل الاختبار الحالي.
int	getExpectedTests() تعرض هذه السمة عدد الاختبارات المتوقّعة.
IInvocationContext	getInvocationContext() عرض سياق الاستدعاء الذي تمّ الإبلاغ عنه من خلال invocationStarted(com.android.tradefed.invoker.IInvocationContext)
	getMergedTestRunResults() عرض المجموعة المدمجة من النتائج لجميع عمليات التشغيل على مستوى المحاولات المختلفة
IInvocationContext	getModuleContextForRunResult(String testRunName) تعرض هذه السمة IInvocationContext الوحدة المرتبطة بالنتائج.
MultiMap<String, LogFile>	getModuleLogFiles() تعرض نسخة من الخريطة تحتوي على جميع الملفات المسجّلة المرتبطة بالوحدة.
MultiMap<String, LogFile>	getNonAssociatedLogFiles() تعرض هذه السمة نسخة من الخريطة تحتوي على جميع الملفات المسجّلة غير المرتبطة بتنفيذ اختبار أو وحدة.
int	getNumAllFailedTestRuns() تعرِض هذه السمة إجمالي عدد عمليات التشغيل التجريبي التي تعذّر إجراؤها.
int	getNumAllFailedTests() تعرِض هذه السمة إجمالي عدد الاختبارات التي لم يتم اجتيازها (لا يتم احتساب حالات عدم استيفاء الافتراضات).
int	getNumTestsInState(TestStatus status) تعرض هذه السمة عدد الاختبارات في الحالة المحدّدة لهذا التشغيل.
int	getNumTestsInState(TestResult.TestStatus ddmlibStatus) للتوافق مع نوع الحالة القديم
int	getNumTotalTests() تعرض هذه السمة إجمالي عدد الاختبارات المكتملة لجميع عمليات التشغيل.
IBuildInfo	getPrimaryBuildInfo() تعرض هذه السمة معلومات الإصدار الأساسية التي تم إرسالها من خلال invocationStarted(com.android.tradefed.invoker.IInvocationContext).
	getRunResults() تم إيقاف هذه الطريقة نهائيًا. استخدِم getMergedTestRunResults()
TestRunResult	getTestRunAtAttempt(String testRunName, int attempt) يُرجى إرجاع TestRunResult للحصول على محاولة واحدة.
int	getTestRunAttemptCount(String testRunName) تعرض هذه السمة عدد المحاولات لاسم تشغيل اختبار معيّن.
	getTestRunAttempts(String testRunName) تعرض هذه السمة جميع محاولات TestRunResult لتنفيذ اختبار معيّن.
	getTestRunForAttempts(int attempt) تعرض هذه الطريقة جميع نتائج محاولة معيّنة.
	getTestRunNames() عرض جميع أسماء جميع عمليات الاختبار
boolean	hasFailedTests() تعرض هذه السمة ما إذا كان الاستدعاء قد تضمّن أي اختبارات تعذّر إجراؤها أو لم يتم استيفاء أي افتراضات.
boolean	hasTestRunResultsForName(String testRunName) تعرض هذه السمة ما إذا كان لاسم تشغيل اختبار معيّن أي نتائج.
void	invocationEnded(long elapsedTime) تشير إلى أنّ عملية الاستدعاء قد انتهت، سواء بنجاح أو بسبب بعض حالات الخطأ.
void	invocationFailed(Throwable cause) تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.
void	invocationSkipped(SkipReason reason) تسجيل أنّ عملية استدعاء تم تخطّيها
void	invocationStarted(IInvocationContext context) تسجّل هذه السمة بداية تنفيذ الاختبار.
boolean	isDisabled() تعرِض القيمة True إذا كان العنصر بأكمله غير مفعّل (تخطّي كل من الإعداد والإزالة).
void	logAssociation(String dataName, LogFile logFile) في بعض الحالات، يجب أن يكون السجلّ مرتبطًا بشكل كبير بحالات الاختبار، ولكن لا يمكن إجراء ذلك في معاودة الاتصال المباشرة testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).
void	setBuildInfo(IBuildInfo buildInfo) تم إيقاف هذه الطريقة نهائيًا. لم يعُد ذلك ضروريًا لإجراء الاختبارات.
void	setDisable(boolean isDisabled) تضبط هذه الطريقة ما إذا كان يجب إيقاف العنصر.
void	setMergeStrategy(MergeStrategy strategy) تضبط هذه السمة MergeStrategy لاستخدامها عند دمج النتائج.
void	testAssumptionFailure(TestDescription test, String trace) يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح
void	testAssumptionFailure(TestDescription test, FailureDescription failure) يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح
void	testEnded(TestDescription test, long endTime, testMetrics) بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً.
void	testEnded(TestDescription test, testMetrics) تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.
void	testFailed(TestDescription test, FailureDescription failure) تسجّل هذه السمة تعذُّر تنفيذ حالة اختبار فردية.
void	testFailed(TestDescription test, String trace) تسجّل هذه السمة تعذُّر تنفيذ حالة اختبار فردية.
void	testIgnored(TestDescription test) يتم استدعاؤها عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار يتم شرحها باستخدام org.junit.Ignore.
void	testModuleEnded() تسجّل هذه السمة نهاية عملية تنفيذ وحدة.
void	testModuleStarted(IInvocationContext moduleContext) تسجّل هذه السمة بداية تشغيل وحدة.
void	testRunEnded(long elapsedTime, runMetrics) تقارير نهاية عملية الاختبار
void	testRunFailed(FailureDescription failure) تعذّر إكمال تشغيل الاختبار التجريبي للتقارير بسبب حدوث خطأ موصوف في FailureDescription.
void	testRunFailed(String errorMessage) تعذّر إكمال تشغيل الاختبار للتقارير بسبب حدوث خطأ فادح.
void	testRunStarted(String name, int numTests, int attemptNumber) تسجيل بداية تشغيل الاختبار
void	testRunStarted(String name, int numTests) تسجيل بداية تشغيل الاختبار
void	testRunStarted(String name, int numTests, int attemptNumber, long startTime) تسجيل بداية تشغيل الاختبار
void	testRunStopped(long elapsedTime) تم إيقاف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب المستخدم.
void	testSkipped(TestDescription test, SkipReason reason) يتم استدعاء هذا الإجراء عندما يتم تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً.
void	testStarted(TestDescription test, long startTime) بديل testStarted(com.android.tradefed.result.TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار، بالإضافة إلى ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) للحصول على قياس دقيق.
void	testStarted(TestDescription test) تسجّل هذه السمة بداية حالة اختبار فردية.

الطُرق المحمية
final void	clearModuleLogFiles() يسمح بتنظيف ملف الوحدة لتجنُّب الاحتفاظ به لفترة طويلة جدًا.
final void	clearResultsForName(String testRunName) تتيح محو نتائج عملية تنفيذ معيّنة.
final void	clearTestRunResults() تتيح هذه السمة محو جميع نتائج تشغيل الاختبار لتجنُّب الاحتفاظ بها لفترة طويلة جدًا.
void	setIsAggregrateMetrics(boolean aggregate) تبديل خيار "مقاييس مجمّعة"

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

CollectingTestListener

public CollectingTestListener ()

الطُرق العامة

getBuildInfo

public IBuildInfo getBuildInfo ()

تم إيقاف استخدام هذه الطريقة نهائيًا.
يمكنك الاعتماد على IBuildInfo من getInvocationContext().

تعرض هذه السمة معلومات الإصدار.

المرتجعات
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

تعرض هذه السمة نتائج تشغيل الاختبار الحالي.

يُرجى العِلم أنّ النتائج قد لا تكون مكتملة. يُنصح باختبار قيمة TestRunResult.isRunComplete() و/أو (@link TestRunResult#isRunFailure()} حسب الاقتضاء قبل معالجة النتائج.

المرتجعات
TestRunResult	TestRunResult الذي يمثّل البيانات التي تم جمعها أثناء آخر عملية اختبار

getExpectedTests

public int getExpectedTests ()

تعرض هذه السمة عدد الاختبارات المتوقّعة. قد يختلف عن getNumTotalTests() إذا لم يتم تنفيذ بعض الاختبارات.

المرتجعات
int

getInvocationContext

public IInvocationContext getInvocationContext ()

عرض سياق الاستدعاء الذي تمّ الإبلاغ عنه من خلال invocationStarted(com.android.tradefed.invoker.IInvocationContext)

المرتجعات
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

عرض المجموعة المدمجة من النتائج لجميع عمليات التشغيل على مستوى المحاولات المختلفة

إذا كانت هناك نتائج متعددة، يتم دمج كل عملية تشغيل للاختبار، مع استبدال نتائج الاختبارات السابقة بأحدث نتيجة اختبار. يتم ترتيب عمليات الاختبار حسب رقم المحاولة.

سيتم دمج مقاييس المحاولة نفسها استنادًا إلى الإعداد المفضّل الذي يحدّده aggregate-metrics. ستكون المقاييس النهائية هي مقاييس المحاولة الأخيرة.

المرتجعات

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

تعرض هذه السمة IInvocationContext الوحدة المرتبطة بالنتائج.

المعلمات
testRunName	String: الاسم الذي قدّمه {testRunStarted(String, int).

المرتجعات
IInvocationContext	تمثّل هذه السمة IInvocationContext الوحدة لاسم عملية اختبار معيّن null إذا لم تتوفر أي نتائج لهذا الاسم.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

تعرض نسخة من الخريطة تحتوي على جميع الملفات المسجّلة المرتبطة بالوحدة.

المرتجعات
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

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

المرتجعات
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

تعرِض هذه السمة إجمالي عدد عمليات التشغيل التجريبي التي تعذّر إجراؤها.

المرتجعات
int

getNumAllFailedTests

public int getNumAllFailedTests ()

تعرِض هذه السمة إجمالي عدد الاختبارات التي لم يتم اجتيازها (لا يتم احتساب حالات عدم استيفاء الافتراضات).

المرتجعات
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

تعرض هذه السمة عدد الاختبارات في الحالة المحدّدة لهذا التشغيل.

المعلمات
status	TestStatus

المرتجعات
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

للتوافق مع نوع الحالة القديم

المعلمات
ddmlibStatus	TestResult.TestStatus

المرتجعات
int

getNumTotalTests

public int getNumTotalTests ()

تعرض هذه السمة إجمالي عدد الاختبارات المكتملة لجميع عمليات التشغيل.

المرتجعات
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

تعرض هذه السمة معلومات الإصدار الأساسية التي تم إرسالها من خلال invocationStarted(com.android.tradefed.invoker.IInvocationContext). الإصدار الأساسي هو الإصدار الذي يعرضه أول موفّر إصدارات في الإعدادات النشطة. تعرِض قيمة فارغة إذا لم يتوفّر سياق (لم يتم إنشاء حالة اختبار).

المرتجعات
IBuildInfo

getRunResults

public  getRunResults ()

تم إيقاف استخدام هذه الطريقة نهائيًا.
استخدام getMergedTestRunResults()

تعرض هذه الطريقة نتائج جميع عمليات الاختبار.

المرتجعات

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

يُرجى إرجاع TestRunResult للحصول على محاولة واحدة.

المعلمات
testRunName	String: الاسم الذي قدّمه {testRunStarted(String, int).
attempt	int: معرّف المحاولة

المرتجعات
TestRunResult	تعرض هذه السمة TestRunResult للاسم ورقم تعريف المحاولة المحدّدين، أو null إذا لم يكن الاسم متوفّرًا.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

تعرض هذه السمة عدد المحاولات لاسم تشغيل اختبار معيّن.

المعلمات
testRunName	String: الاسم الذي قدّمه {testRunStarted(String, int).

المرتجعات
int

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

تعرض هذه السمة جميع محاولات TestRunResult لتنفيذ اختبار معيّن.

المعلمات
testRunName	‫String: الاسم الذي قدّمه {testRunStarted(String, int).

المرتجعات
	جميع TestRunResult لتنفيذ اختبار معيّن، مرتّبة حسب المحاولات

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

تعرض هذه الطريقة جميع نتائج محاولة معيّنة.

المعلمات
attempt	‫int: المحاولة التي نريد الحصول على نتائج لها.

المرتجعات
	جميع TestRunResult لمحاولة معيّنة

getTestRunNames

public  getTestRunNames ()

عرض جميع أسماء جميع عمليات تشغيل الاختبار

وقد تم تنفيذ عمليات الاختبار هذه عدة مرات بمحاولات مختلفة.

المرتجعات

hasFailedTests

public boolean hasFailedTests ()

تعرض هذه السمة ما إذا كان الاستدعاء قد تضمّن أي اختبارات تعذّر إجراؤها أو لم يتم استيفاء أي افتراضات.

المرتجعات
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

تعرض هذه السمة ما إذا كان لاسم تشغيل اختبار معيّن أي نتائج.

المعلمات
testRunName	String: الاسم الذي قدّمه {testRunStarted(String, int).

المرتجعات
boolean

invocationEnded

public void invocationEnded (long elapsedTime)

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

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

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

invocationFailed

public void invocationFailed (Throwable cause)

تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
cause	‫Throwable: سبب تعذُّر Throwable

invocationSkipped

public void invocationSkipped (SkipReason reason)

تسجيل أنّ عملية استدعاء تم تخطّيها

المعلمات
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

تسجّل هذه السمة بداية تنفيذ الاختبار.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation. على مقدّمي التقارير إلغاء هذه الطريقة لتفعيل إعداد التقارير على أجهزة متعددة.

المعلمات
context	‫IInvocationContext: معلومات حول الاستدعاء

isDisabled

public boolean isDisabled ()

تعرِض القيمة True إذا كان العنصر بأكمله غير مفعّل (تخطّي كل من الإعداد والإزالة). ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

المرتجعات
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات، يجب أن يكون السجلّ مرتبطًا بشكل كبير بحالات الاختبار، ولكن لا يمكن إجراء ذلك في معاودة الاتصال المباشرة testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). وبالتالي، يتيح هذا الإجراء الرجعي تقديم ارتباط قوي بشكل صريح.

المعلمات
dataName	‫String: اسم البيانات
logFile	LogFile: LogFile الذي تم تسجيله من قبل ويجب ربطه بحالة الاختبار.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

تم إيقاف استخدام هذه الطريقة نهائيًا.
لم يعُد ذلك ضروريًا للاختبار.

اضبط معلومات الإصدار. يجب استخدامها للاختبار فقط.

المعلمات
buildInfo	IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

تضبط هذه الطريقة ما إذا كان يجب إيقاف العنصر. يعني الإيقاف أنّه يجب تخطّي خطوات الإعداد والإزالة. يمكن استخدامها لجعل الكائن غير مفعّل تلقائيًا في الدالة الإنشائية التلقائية.

المعلمات
isDisabled	‫boolean: الحالة التي يجب وضع العنصر فيها

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

تضبط هذه السمة MergeStrategy لاستخدامها عند دمج النتائج.

المعلمات
strategy	MergeStrategy

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

testModuleEnded

public void testModuleEnded ()

تسجّل هذه السمة نهاية عملية تنفيذ وحدة.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

تسجّل هذه السمة بداية تشغيل وحدة. يرتبط هذا الإجراء بعودة الاتصال بـ testModuleEnded() وهو اختياري في التسلسل. يتم استخدامها فقط أثناء عملية تشغيل تستخدم وحدات: أدوات تشغيل مستندة إلى مجموعة الاختبارات.

المعلمات
moduleContext	IInvocationContext: تمثّل هذه السمة IInvocationContext الوحدة.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

المعلمات
elapsedTime	‫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 name, 
                int numTests, 
                int attemptNumber)

تسجيل بداية تشغيل الاختبار

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

testRunStarted

public void testRunStarted (String name, 
                int numTests)

تسجيل بداية تشغيل الاختبار

المعلمات
name	‫String: اسم عملية التشغيل الاختبارية
numTests	‫int: إجمالي عدد الاختبارات في عملية الاختبار

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

تسجيل بداية تشغيل الاختبار

المعلمات
name	‫String: اسم عملية التشغيل الاختبارية
numTests	‫int: إجمالي عدد الاختبارات في عملية الاختبار
attemptNumber	‫int: رقم الطلب، الذي يحدّد المحاولات المختلفة لـ runName نفسه الذي يتم تنفيذه عدة مرات. يتم فهرسة attemptNumber بدءًا من 0، ويجب أن يزيد في كل مرة يتم فيها تنفيذ عملية تشغيل جديدة. على سبيل المثال، إذا تمت إعادة محاولة اختبار دقيق 3 مرات، يجب أن يكون هناك 4 عمليات تشغيل إجمالية ضمن runName نفسه، ويجب أن يتراوح 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: تحدّد الاختبار

الطُرق المحمية

clearModuleLogFiles

protected final void clearModuleLogFiles ()

يسمح بتنظيف ملف الوحدة لتجنُّب الاحتفاظ به لفترة طويلة جدًا.

clearResultsForName

protected final void clearResultsForName (String testRunName)

تتيح محو نتائج عملية تنفيذ معيّنة. يجب استخدامها فقط في بعض الحالات، مثل مجمّع النتائج.

المعلمات
testRunName	String

clearTestRunResults

protected final void clearTestRunResults ()

تتيح هذه السمة محو جميع نتائج تشغيل الاختبار لتجنُّب الاحتفاظ بها لفترة طويلة جدًا.

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

تبديل خيار "مقاييس مجمّعة"

المعلمات
aggregate	boolean