اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

ResultAggregator

public class ResultAggregator
extends CollectingTestListener

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

إعادة توجيه خاصة تُجمِّع النتائج عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتخاذها

ملخّص

وظائف الإنشاء العامة
`ResultAggregator( listeners, RetryStrategy strategy)`

الطرق العامة
`void`	`cleanEventsFiles()`
`final void`	`forwardAggregatedInvocationLogs()` إعادة توجيه جميع سجلات مستوى الطلب إلى أدوات إعداد تقارير النتائج التي لا تتيح نتائج مناقشة مفصّلة
`void`	`invocationEnded(long elapsedTime)` تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.
`void`	`invocationFailed(FailureDescription failure)`
`void`	`invocationFailed(Throwable cause)` الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ
`void`	`invocationSkipped(SkipReason reason)` الإبلاغ عن طلب استدعاء كطلب تم تخطّيه
`void`	`invocationStarted(IInvocationContext context)` الإبلاغ عن بدء استدعاء الاختبار
`void`	`logAssociation(String dataName, LogFile logFile)` في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` callback المباشر.
`void`	`setLogSaver(ILogSaver logSaver)`
`void`	`setUpdatedReporting(boolean updatedReporting)` لضبط إعدادات إعداد التقارير الجديدة
`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`	`testFailed(TestDescription test, FailureDescription failure)` الإبلاغ عن تعذُّر اختبار فردي
`void`	`testFailed(TestDescription test, String trace)` الإبلاغ عن تعذُّر اختبار فردي
`void`	`testIgnored(TestDescription test)` يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`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 testCount, int attemptNumber, long startTime)` الإبلاغ عن بدء عملية تنفيذ اختبار
`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))` لإجراء قياس دقيق.

الطرق المحمية
`File[]`	`getEventsLogs()`

وظائف الإنشاء العامة

ResultAggregator

public ResultAggregator ( listeners, 
                RetryStrategy strategy)

المعلمات
`listeners`
`strategy`	`RetryStrategy`

الطرق العامة

cleanEventsFiles

public void cleanEventsFiles ()

forwardAggregatedInvocationLogs

public final void forwardAggregatedInvocationLogs ()

إعادة توجيه جميع سجلات مستوى الطلب إلى أدوات إعداد تقارير النتائج التي لا تتيح نتائج مناقشة مفصّلة

invocationEnded

public void invocationEnded (long elapsedTime)

تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.

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

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

invocationFailed

public void invocationFailed (FailureDescription failure)

المعلمات
`failure`	`FailureDescription`

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

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) callback المباشر. وبالتالي، يسمح هذا المرجع العكسي بتوفير ارتباط قوي بشكل صريح.

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

setLogSaver

public void setLogSaver (ILogSaver logSaver)

المعلمات
`logSaver`	`ILogSaver`

setUpdatedReporting

public void setUpdatedReporting (boolean updatedReporting)

لضبط إعدادات إعداد التقارير الجديدة

المعلمات
`updatedReporting`	`boolean`

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

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

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

المعلمات
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

المعلمات
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

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 testCount, 
                int attemptNumber, 
                long startTime)

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

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

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

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

getEventsLogs

protected File[] getEventsLogs ()

المرتجعات
`File[]`