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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

LogcatOnFailureCollector

public class LogcatOnFailureCollector
extends BaseDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.LogcatOnFailureCollector

الفئات الفرعية المباشرة المعروفة

ModuleLogcatCollector

ModuleLogcatCollector إصدار أداة جمع logcat ولكن للوحدة.

أداة تجميع ستسجّل logcat عند تعذُّر حالة اختبار أو تشغيل اختبار. في حال تفعيل عملية الجمع التلقائي، سيتم جمع سجلّات المضيف على المستويات المحدّدة.

ملخّص

طُرق وضع التصميم العامة
`LogcatOnFailureCollector()`

الإجراءات العامة
`boolean`	`captureModuleLevel()`
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` دالة ردّ الاتصال عند انتهاء حالة الاختبار.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` دالة ردّ الاتصال عند فشل حالة اختبار.
`void`	`onTestModuleEnded()` تتيح تسجيل حدث انتهاء الوحدة.
`void`	`onTestModuleStarted()` يسمح بتسجيل حدث بدء الوحدة.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` دالة ردّ الاتصال عند انتهاء عملية تشغيل الاختبار.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` معاودة الاتصال لأحداث testRunFailed
`void`	`onTestRunStart(DeviceMetricData runData)` دالة ردّ الاتصال عند بدء تشغيل تجريبي.
`void`	`onTestRunStartBlocking()`
`void`	`onTestStart(DeviceMetricData testData)` يتم تنفيذ هذه الدالة عند بدء حالة اختبار.

طُرق محمية
`void`	`collectAndLog(String testName, int size, IMetricCollector.MetricCollectionLevel level)`

طُرق وضع التصميم العامة

LogcatOnFailureCollector

public LogcatOnFailureCollector ()

الإجراءات العامة

captureModuleLevel

public boolean captureModuleLevel ()

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

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

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

المعلَمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات حالة الاختبار سيكون الكائن نفسه كما كان خلال `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	‫`Map`: الخريطة الحالية للمقاييس التي تم تمريرها إلى `testEnded(TestDescription,Map)`

عمليات الطرح
`DeviceNotAvailableException`

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

دالة ردّ الاتصال عند فشل حالة اختبار.

المعلَمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات حالة الاختبار
`test`	`TestDescription`: `TestDescription` لإطار الاختبار قيد التقدّم

عمليات الطرح
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

تتيح تسجيل حدث انتهاء الوحدة.

عمليات الطرح
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

يسمح بتسجيل حدث بدء الوحدة.

عمليات الطرح
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

دالة ردّ الاتصال عند انتهاء عملية تشغيل الاختبار. يجب أن يكون هذا هو الوقت المناسب للتنظيف.

المعلَمات
`runData`	استبدِل `DeviceMetricData` بـ `DeviceMetricData` الذي يحتوي على بيانات عملية التشغيل. سيكون الكائن نفسه كما كان خلال `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	‫`Map`: الخريطة الحالية للمقاييس التي تم تمريرها إلى `testRunEnded(long,Map)`

عمليات الطرح
`DeviceNotAvailableException`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

معاودة الاتصال لأحداث testRunFailed

عمليات الطرح
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

دالة ردّ الاتصال عند بدء تشغيل تجريبي.

المعلَمات
`runData`	استبدِل `DeviceMetricData` بـ `DeviceMetricData` الذي يحتوي على بيانات عملية التشغيل.

onTestRunStartBlocking

public void onTestRunStartBlocking ()

عمليات الطرح
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

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

المعلَمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات حالة الاختبار

طُرق محمية

collectAndLog

protected void collectAndLog (String testName, 
                int size, 
                IMetricCollector.MetricCollectionLevel level)

المعلَمات
`testName`	`String`
`size`	`int`
`level`	`IMetricCollector.MetricCollectionLevel`

عمليات الطرح
`DeviceNotAvailableException`