از سال ۲۰۲۶، برای همسو شدن با مدل توسعه پایدار ترانک و تضمین پایداری پلتفرم برای اکوسیستم، کد منبع را در سه‌ماهه دوم و چهارم در AOSP منتشر خواهیم کرد. برای ساخت و مشارکت در AOSP، android-latest-release استفاده کنید. شاخه مانیفست android-latest-release همیشه به جدیدترین نسخه منتشر شده در AOSP ارجاع می‌دهد. برای اطلاعات بیشتر، به تغییرات در AOSP مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

گردآورنده لاگ‌کت‌آن‌فایلور

public class LogcatOnFailureCollector
extends BaseDeviceMetricCollector

شیء جاوا
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.LogcatOnFailureCollector

زیرکلاس‌های مستقیم شناخته‌شده

ماژول‌لاگ‌کت‌کلکتور

ماژول‌لاگ‌کت‌کلکتور نسخه‌ای از جمع‌کننده‌ی logcat اما برای ماژول.

گردآورنده‌ای که در صورت عدم موفقیت یک مورد آزمایشی یا اجرای آزمایشی، یک logcat را ضبط و ثبت می‌کند. اگر جمع‌آوری پیش‌فرض فعال باشد، گزارش‌های میزبان را در سطوح مشخص‌شده جمع‌آوری می‌کند.

خلاصه

سازندگان عمومی
`LogcatOnFailureCollector ()`

روش‌های عمومی
`boolean`	`captureModuleLevel ()`
`void`	`onTestEnd ( DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` فراخوانی مجدد (callback) پس از پایان یک مورد آزمایشی (test case).
`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)`

سازندگان عمومی

گردآورنده لاگ‌کت‌آن‌فایلور

public LogcatOnFailureCollector ()

روش‌های عمومی

سطح ماژول را ضبط کنید

public boolean captureModuleLevel ()

بازگشت‌ها
`boolean`

پایان آزمون

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`

onTestModuleEnd شده

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`

شروع آزمون

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`