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

TestFailureListener

public class TestFailureListener
extends Object implements ITestInvocationListener

java.lang.object
↳	com.android.tradefed.testtype.suite.TestFailureListener

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

خلاصه

سازندگان عمومی
`TestFailureListener ( devices, boolean bugReportOnFailure, boolean rebootOnFailure)` `TestFailureListener ( devices, boolean bugReportOnFailure, boolean rebootOnFailure)`

روش های عمومی
`void`	`applyModuleConfiguration (boolean bugreportOnFailure)` اجازه می دهد تا تنظیمات فراخوانی ضبط در صورت شکست توسط پیکربندی های خاص ماژول لغو شود.
`void`	`join ()` برای اطمینان از پایان یافتن آنها، به همه رشته‌های logcat بپیوندید.
`void`	`setLogger ( ITestLogger logger)` محل ذخیره گزارش‌ها را تعیین می‌کند.
`void`	`testFailed ( TestDescription test, String trace)` گزارش شکست یک مورد آزمایشی فردی.
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` گزارش مربوطه یا داده های اشکال زدایی را از فراخوانی آزمایشی ارائه می دهد.
`void`	`testLogForward (String dataName, LogDataType dataType, InputStreamSource dataStream)` گزارش را به لاگر فوروارد کنید، این کار را از طریق بازخوانی #testLog انجام ندهید، زیرا اگر TestFailureListener بخشی از زنجیره است، منجر به یک حلقه بی نهایت می شود.

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

TestFailureListener

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

پارامترها
`devices`
`bugReportOnFailure`	`boolean`
`rebootOnFailure`	`boolean`

روش های عمومی

applicationModuleConfiguration

public void applyModuleConfiguration (boolean bugreportOnFailure)

اجازه می دهد تا تنظیمات فراخوانی ضبط در صورت شکست توسط پیکربندی های خاص ماژول لغو شود.

پارامترها
`bugreportOnFailure`	`boolean` : درست برای ثبت یک گزارش اشکال در شکست تست. در غیر این صورت نادرست است.

ملحق شدن

public void join ()

برای اطمینان از پایان یافتن آنها، به همه رشته‌های logcat بپیوندید.

setLogger

public void setLogger (ITestLogger logger)

محل ذخیره گزارش‌ها را تعیین می‌کند.

پارامترها
`logger`	`ITestLogger`

تست شکست خورد

public void testFailed (TestDescription test, 
                String trace)

گزارش شکست یک مورد آزمایشی فردی.

بین testStarted و testEnded فراخوانی خواهد شد.

پارامترها
`test`	`TestDescription` : تست را مشخص می کند
`trace`	`String` : ردپای شکست

testLog

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

گزارش مربوطه یا داده های اشکال زدایی را از فراخوانی آزمایشی ارائه می دهد.

باید قبل از ERROR(/ITestInvocationListener#invocationFailed(Throwable)) یا ERROR(/ITestInvocationListener#invocationEnded(long)) فراخوانی شود

چارچوب TradeFederation به طور خودکار این روش را فراخوانی می‌کند و گزارش میزبان و در صورت وجود، logcat دستگاه را ارائه می‌کند.

پارامترها
`dataName`	`String` : نام توصیفی `String` از داده ها. به عنوان مثال "device_logcat". توجه داشته باشید dataName ممکن است در هر فراخوان منحصر به فرد نباشد. به عنوان مثال، پیاده‌کننده‌ها باید بتوانند چندین تماس را با یک dataName مدیریت کنند
`dataType`	`LogDataType` : `LogDataType` داده ها
`dataStream`	`InputStreamSource` : `InputStreamSource` داده ها. پیاده‌کننده‌ها باید createInputStream را برای شروع خواندن داده‌ها فراخوانی کنند و از بسته شدن InputStream حاصل پس از تکمیل اطمینان حاصل کنند. تماس‌گیرندگان باید اطمینان حاصل کنند که منبع داده‌ها تا زمانی که روش testLog کامل نشود، موجود و قابل دسترسی است.

testLogForward

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

گزارش را به لاگر فوروارد کنید، این کار را از طریق بازخوانی #testLog انجام ندهید، زیرا اگر TestFailureListener بخشی از زنجیره است، منجر به یک حلقه بی نهایت می شود.

پارامترها
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`