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

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

XmlTestRunListener

public class XmlTestRunListener
extends Object implements ITestRunListener

شیء جاوا
↳	com.android.ddmlib.testunner.XmlTestRunListener

نتایج JUnit را در فایل‌های XML با فرمتی سازگار با XMLJUnitResultFormatter مربوط به Ant می‌نویسد.

در هر اجرای تست، یک فایل XML جداگانه ایجاد می‌کند.

همچنین ببینید:

https://svn.jenkins-ci.org/trunk/hudson/dtkit/dtkit-format/dtkit-junit-model/src/main/resources/com/thalesgroup/dtkit/junit/model/xsd/junit-4.xsd

خلاصه

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

روش‌های عمومی
`void`	`addSystemError (String systemError)` پیام خطای سیستم را اضافه کنید.
`TestRunResult`	`getRunResult ()` `TestRunResult` را برمی‌گرداند
`String`	`getSystemError ()` پیام خطای سیستم را برای نوشتن در فایل XML در عنصر "system-err" برمی‌گرداند.
`void`	`setHostName (String hostName)`
`void`	`setReportDir (File file)` فایل گزارش مورد استفاده را تنظیم می‌کند.
`void`	`testAssumptionFailure ( TestIdentifier test, String trace)` زمانی فراخوانی می‌شود که یک آزمایش اتمی، شرطی را نادرست فرض کند.
`void`	`testEnded ( TestIdentifier test, testMetrics)` پایان اجرای یک مورد آزمایشی (test case) را گزارش می‌دهد.
`void`	`testFailed ( TestIdentifier test, String trace)` گزارش شکست یک مورد آزمایشی منفرد را می‌دهد.
`void`	`testIgnored ( TestIdentifier test)` زمانی فراخوانی می‌شود که یک تست اجرا نخواهد شد، عموماً به این دلیل که یک متد تست با org.junit.Ignore حاشیه‌نویسی شده است.
`void`	`testRunEnded (long elapsedTime, runMetrics)` پایان اجرای آزمایش را گزارش می‌دهد.
`void`	`testRunFailed (String errorMessage)` گزارش‌ها حاکی از آن است که اجرای آزمایشی به دلیل یک خطای مهلک با شکست مواجه شده است.
`void`	`testRunStarted (String runName, int numTests)` شروع یک آزمایش را گزارش می‌دهد.
`void`	`testRunStopped (long elapsedTime)` گزارش می‌دهد که اجرای آزمایشی به دلیل درخواست کاربر قبل از تکمیل متوقف شده است.
`void`	`testStarted ( TestIdentifier test)` شروع یک مورد آزمایشی (test case) منفرد را گزارش می‌دهد.

روش‌های محافظت‌شده
	`getPropertiesAttributes ()` ویژگی‌های ویژگی‌ها را به عنوان جفت‌های کلید-مقدار دریافت کنید تا در گزارش آزمون گنجانده شوند.
`File`	`getResultFile (File reportDir)` یک `ERROR(/File)` ایجاد می‌کند که گزارش در آن ایجاد خواهد شد.
`String`	`getTestName ( TestIdentifier testId)`
`String`	`getTestSuiteName ()`

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

XmlTestRunListener

public XmlTestRunListener ()

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

خطای سیستمی اضافه

public void addSystemError (String systemError)

پیام خطای سیستم را اضافه کنید.

پارامترها
`systemError`	`String`

دریافت نتیجه اجرای مجدد

public TestRunResult getRunResult ()

TestRunResult را برمی‌گرداند

بازگشت‌ها
`TestRunResult`	نتایج اجرای آزمایش.

دریافت خطای سیستم

public String getSystemError ()

پیام خطای سیستم را برای نوشتن در فایل XML در عنصر "system-err" برمی‌گرداند. اگر این یک رشته خالی برگرداند، عنصر ایجاد نمی‌شود.

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

تنظیم نام میزبان

public void setHostName (String hostName)

پارامترها
`hostName`	`String`

تنظیم گزارش دایرکتوری

public void setReportDir (File file)

فایل گزارش مورد استفاده را تنظیم می‌کند.

پارامترها
`file`	`File`

آزمون فرض شکست

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

زمانی فراخوانی می‌شود که یک آزمایش اتمی، شرطی را نادرست فرض کند.

پارامترها
`test`	`TestIdentifier` : تست را شناسایی می‌کند.
`trace`	`String` : ردپای پشته از خرابی

آزمون پایان یافت

public void testEnded (TestIdentifier test, 
                 testMetrics)

پایان اجرای یک مورد آزمایشی (test case) را گزارش می‌دهد.

اگر testFailed(TestIdentifier, String) فراخوانی نشده باشد، این تست با موفقیت انجام شده است. همچنین هر معیار کلید/مقداری را که ممکن است در طول اجرای مورد تست منتشر شده باشد، برمی‌گرداند.

پارامترها

test

TestIdentifier : تست را شناسایی می‌کند.

testMetrics

: یک ERROR(/Map) از معیارهای منتشر شده در طول اجرای مورد آزمایشی توسط android.app.Instrumentation#sendStatus . ترتیب درج حفظ می‌شود مگر اینکه یک کلید مشابه را چندین بار منتشر کنید. توجه داشته باشید که کلیدهای استاندارد تعریف شده در IInstrumentationResultParser.StatusKeys از این Map فیلتر می‌شوند. Ddmlib ممکن است معیارهای آزمایشی اضافی تعریف شده در IInstrumentationResultParser.StatusKeys را اضافه کند.

تست ناموفق

public void testFailed (TestIdentifier test, 
                String trace)

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

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

پارامترها
`test`	`TestIdentifier` : تست را شناسایی می‌کند.
`trace`	`String` : ردپای پشته از خرابی

آزمون نادیده گرفته شد

public void testIgnored (TestIdentifier test)

زمانی فراخوانی می‌شود که یک تست اجرا نخواهد شد، عموماً به این دلیل که یک متد تست با org.junit.Ignore حاشیه‌نویسی شده است.

پارامترها
`test`	`TestIdentifier` : تست را شناسایی می‌کند.

تست اجرا شده

public void testRunEnded (long elapsedTime, 
                 runMetrics)

پایان اجرای آزمایش را گزارش می‌دهد.

پارامترها

elapsedTime

long : زمان سپری شده گزارش شده توسط دستگاه، بر حسب میلی ثانیه

runMetrics

: یک ERROR(/Map) از معیارهای منتشر شده در طول اجرای مورد آزمایشی توسط android.app.Instrumentation#addResults . ترتیب درج حفظ می‌شود مگر اینکه یک کلید مشابه را چندین بار منتشر کنید. توجه داشته باشید که کلیدهای استاندارد تعریف شده در IInstrumentationResultParser.StatusKeys از این Map فیلتر می‌شوند. Ddmlib ممکن است معیارهای آزمایشی اضافی تعریف شده در IInstrumentationResultParser.StatusKeys را اضافه کند.

تست اجرا ناموفق

public void testRunFailed (String errorMessage)

گزارش‌ها حاکی از آن است که اجرای آزمایشی به دلیل یک خطای مهلک با شکست مواجه شده است.

پارامترها
`errorMessage`	`String` : `String` دلیل عدم موفقیت در اجرا را توصیف می‌کند.

تست شروع شد

public void testRunStarted (String runName, 
                int numTests)

شروع یک آزمایش را گزارش می‌دهد.

پارامترها
`runName`	`String` : نام اجرای آزمایشی
`numTests`	`int` : تعداد کل تست‌ها در اجرای تست

testRunStopped

public void testRunStopped (long elapsedTime)

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

پارامترها
`elapsedTime`	`long` : زمان سپری شده گزارش شده توسط دستگاه، بر حسب میلی ثانیه

تست شروع شد

public void testStarted (TestIdentifier test)

شروع یک مورد آزمایشی (test case) منفرد را گزارش می‌دهد.

پارامترها
`test`	`TestIdentifier` : تست را شناسایی می‌کند.

روش‌های محافظت‌شده

ویژگی‌های getProperties

protected  getPropertiesAttributes ()

ویژگی‌های ویژگی‌ها را به عنوان جفت‌های کلید-مقدار دریافت کنید تا در گزارش آزمون گنجانده شوند.

بازگشت‌ها

دریافت فایل نتیجه

protected File getResultFile (File reportDir)

یک ERROR(/File) ایجاد می‌کند که گزارش در آن ایجاد خواهد شد.

پارامترها
`reportDir`	`File` : دایرکتوری ریشه گزارش.

بازگشت‌ها
`File`	یک فایل

پرتاب‌ها
	استثنای IO

نام آزمون را دریافت کنید

protected String getTestName (TestIdentifier testId)

پارامترها
`testId`	`TestIdentifier`

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

نام مجموعه آزمون را دریافت کنید

protected String getTestSuiteName ()

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