اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

GranularRetriableTestWrapper.StartEndCollector

public class GranularRetriableTestWrapper.StartEndCollector
extends ResultAndLogForwarder

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.ResultAndLogForwarder
		↳	com.android.tradefed.testtype.suite.GranularRetriableTestWrapper.StartEndCollector

فئة مساعدة لرصد حالات عدم توفّر وقتَي بدء التشغيل وإنهائه

ملخّص

الحقول
`public TestDescription`	`mCurrentTest`
`public boolean`	`mRunEndedReported`
`public boolean`	`mRunStartReported`
`public boolean`	`mTestInProgress`

الطُرق العامة
`void`	`testEnded(TestDescription test, testMetrics)` تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` بديل `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` حيث يمكننا تحديد وقت الانتهاء مباشرةً.
`void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` تقارير نهاية عملية الاختبار
`void`	`testRunStarted(String runName, int testCount)` تسجيل بداية تشغيل الاختبار
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` تسجيل بداية تشغيل الاختبار
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` تسجيل بداية تشغيل الاختبار
`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)` تسجّل هذه السمة بداية حالة اختبار فردية.

الحقول

mCurrentTest

public TestDescription mCurrentTest

mRunEndedReported

public boolean mRunEndedReported

mRunStartReported

public boolean mRunStartReported

mTestInProgress

public boolean mTestInProgress

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

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

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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

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

testRunStarted

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

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

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

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