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

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

LogcatCrashResultForwarder

public class LogcatCrashResultForwarder
extends ResultForwarder

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.LogcatCrashResultForwarder

مستمع خاص: في حال حدوث أخطاء (تعطُّل عملية أداة القياس)، سيحاول استخراج معلومات عن الأعطال من logcat وإضافتها إلى رسالة الخطأ المرتبطة بالاختبار.

ملخّص

الثوابت
`int`	`MAX_NUMBER_CRASH`

الحقول
`public static final String`	`ERROR_MESSAGE` رسالة خطأ خاصة من أداة القياس عند حدوث خطأ من جهة الجهاز
`public static final String`	`INCOMPLETE_MESSAGE`
`public static final String`	`SYSTEM_CRASH_MESSAGE`
`public static final`	`TIMEOUT_MESSAGES`

وظائف الإنشاء العامة
`LogcatCrashResultForwarder(ITestDevice device, ITestInvocationListener... listeners)`

الطرق العامة
`ITestDevice`	`getDevice()`
`void`	`setPackageName(String packageName)`
`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`	`testRunEnded(long elapsedTime, runMetrics)` الإبلاغ عن نهاية عملية الاختبار
`void`	`testRunFailed(FailureDescription error)` تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ وصفه `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح.
`void`	`testStarted(TestDescription test, long startTime)` بديل عن `testStarted(com.android.tradefed.result.TestDescription)` حيث نحدّد أيضًا وقت بدء الاختبار ، مع `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` لإجراء قياس دقيق.

الثوابت

MAX_NUMBER_CRASH

public static final int MAX_NUMBER_CRASH

القيمة الثابتة: 3 (0x00000003)

الحقول

خطأ_MESSAGE

public static final String ERROR_MESSAGE

رسالة خطأ خاصة من أداة القياس عند حدوث خطأ من جهة الجهاز

INCOMPLETE_MESSAGE

public static final String INCOMPLETE_MESSAGE

SYSTEM_CRASH_MESSAGE

public static final String SYSTEM_CRASH_MESSAGE

عدد الرسائل القصيرة SMS

public static final  TIMEOUT_MESSAGES

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

LogcatCrashResultForwarder

public LogcatCrashResultForwarder (ITestDevice device, 
                ITestInvocationListener... listeners)

المعلمات
`device`	`ITestDevice`
`listeners`	`ITestInvocationListener`

الطرق العامة

getDevice

public ITestDevice getDevice ()

المرتجعات
`ITestDevice`

setPackageName

public void setPackageName (String packageName)

المعلمات
`packageName`	`String`

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بين السمتَين testStarted(com.android.tradefed.result.TestDescription, long) و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` لوصف الخطأ وسياقه

فشل الاختبار

public void testFailed (TestDescription test, 
                String trace)

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

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

testRunFailed

public void testRunFailed (FailureDescription error)

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

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

testRunFailed

public void testRunFailed (String errorMessage)

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

المعلمات
`errorMessage`	`String`: `String` يوضّح سبب تعذُّر التنفيذ

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