از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.

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

ModuleListener

public class ModuleListener
extends CollectingTestListener

java.lang.object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.ModuleListener

شنونده به هر IRemoteTest هر ماژول به منظور جمع آوری لیست نتایج متصل شده است.

خلاصه

سازندگان عمومی
`ModuleListener ( ITestInvocationListener listener, IInvocationContext moduleContext)` سازنده.

روش های عمومی
`boolean`	`hasLastAttemptFailed ()` آیا آخرین جلسه تلاش مجدد شنونده شکست خورده است یا خیر، برمی‌گرداند.
`void`	`logAssociation (String dataName, LogFile logFile)` در برخی موارد، log باید به شدت با موارد آزمایشی مرتبط باشد، اما این فرصت در `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` امکان پذیر نیست.
`void`	`setAttemptIsolation ( CurrentInvocation.IsolationGrade isolation)` تعیین می کند که آیا تلاش باید به عنوان مجزا گزارش شود یا نه.
`void`	`setCollectTestsOnly (boolean collectTestsOnly)` تعیین می کند که آیا فقط آزمایش ها را جمع آوری می کنیم یا نه.
`void`	`setMarkTestsSkipped (boolean skip)` اینکه آیا همه موارد آزمایشی نادیده گرفته شده علامت‌گذاری شود یا خیر.
`void`	`setTestMappingSources ( testMappingSources)` `setTestMappingSources ( testMappingSources)` منابع نقشه برداری آزمایشی را تنظیم می کند که در متریک ها درج می شوند.
`void`	`testAssumptionFailure ( TestDescription test, String trace)` زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود
`void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود
`void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` جایگزینی برای `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` که می‌توانیم زمان پایان را مستقیماً مشخص کنیم.
`void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` پایان اجرای یک مورد آزمایشی فردی را گزارش می کند.
`void`	`testFailed ( TestDescription test, FailureDescription failure)` گزارش شکست یک مورد آزمایشی فردی.
`void`	`testFailed ( TestDescription test, String trace)` گزارش شکست یک مورد آزمایشی فردی.
`void`	`testIgnored ( TestDescription test)` زمانی که آزمایشی اجرا نمی‌شود نامیده می‌شود، معمولاً به این دلیل که یک روش تست با org.junit.Ignore حاشیه‌نویسی می‌شود.
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` گزارش پایان اجرای آزمایشی
`void`	`testRunFailed ( FailureDescription failure)` اجرای آزمایشی گزارش‌ها به دلیل نقصی که توسط `FailureDescription` توصیف شده است، انجام نشد.
`void`	`testRunFailed (String errorMessage)` اجرای آزمایشی گزارش ها به دلیل یک خطای مهلک انجام نشد.
`void`	`testRunStarted (String name, int numTests, int attemptNumber)` شروع اجرای آزمایشی را گزارش می دهد.
`void`	`testRunStarted (String name, int numTests, int attemptNumber, long startTime)` شروع اجرای آزمایشی را گزارش می دهد.
`void`	`testSkipped ( TestDescription test, SkipReason reason)` زمانی فراخوانی می‌شود که آزمایشی نادیده گرفته می‌شود و به دلیلی که معمولاً انتظار نمی‌رود اجرا نمی‌شود.
`void`	`testStarted ( TestDescription test, long startTime)` جایگزینی برای `testStarted(com.android.tradefed.result.TestDescription)` که در آن زمان شروع آزمایش را نیز مشخص می کنیم، همراه با `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` برای اندازه گیری دقیق .

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

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

سازنده.

پارامترها
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

روش های عمومی

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

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

برمی گرداند
`boolean`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

در برخی موارد، log باید به شدت با موارد آزمایشی مرتبط باشد، اما این فرصت در testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) امکان پذیر نیست. بنابراین، این تماس برگشتی اجازه می دهد تا یک ارتباط قوی را به صراحت ارائه دهد.

پارامترها
`dataName`	`String` : نام داده ها
`logFile`	`LogFile` : `LogFile` که قبلاً ثبت شده است و باید با پرونده آزمایشی مرتبط شود.

setAttempIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

تعیین می کند که آیا تلاش باید به عنوان مجزا گزارش شود یا نه.

پارامترها
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

تعیین می کند که آیا فقط آزمایش ها را جمع آوری می کنیم یا نه.

پارامترها
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

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

پارامترها
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

منابع نقشه برداری آزمایشی را تنظیم می کند که در متریک ها درج می شوند.

پارامترها
`testMappingSources`

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

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

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

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

پارامترها
`test`	`TestDescription` : تست را مشخص می کند
`failure`	`FailureDescription` : `FailureDescription` که شکست و زمینه آن را توصیف می کند.

تست پایان یافت

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

جایگزینی برای ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) که می‌توانیم زمان پایان را مستقیماً مشخص کنیم. برای اندازه گیری دقیق، با testStarted(com.android.tradefed.result.TestDescription, long) ترکیب کنید.

پارامترها
`test`	`TestDescription` : تست را مشخص می کند
`endTime`	`long` : زمان پایان آزمایش، اندازه‌گیری شده از طریق `System.currentTimeMillis()`
`testMetrics`	: یک `ERROR(/Map)` از معیارهای منتشر شده

تست پایان یافت

public void testEnded (TestDescription test, 
                 testMetrics)

پایان اجرای یک مورد آزمایشی فردی را گزارش می کند.

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

پارامترها
`test`	`TestDescription` : تست را مشخص می کند
`testMetrics`	: یک `ERROR(/Map)` از معیارهای منتشر شده

تست شکست خورد

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` : ردپای شکست

تست نادیده گرفته شد

public void testIgnored (TestDescription test)

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

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

testLog

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

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

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

گزارش پایان اجرای آزمایشی

پارامترها
`elapsedTime`	`long` : دستگاه زمان سپری شده را بر حسب میلی ثانیه گزارش کرد
`runMetrics`	: جفت های کلید-مقدار در پایان اجرای آزمایشی گزارش می شوند

testRunFailed

public void testRunFailed (FailureDescription failure)

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

پارامترها
`failure`	`FailureDescription` : `FailureDescription` که شکست و زمینه آن را توصیف می کند.

testRunFailed

public void testRunFailed (String errorMessage)

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

پارامترها
`errorMessage`	`String` : `String` که دلیل شکست اجرا را توضیح می دهد.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

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

پارامترها
`name`	`String` : نام اجرای آزمایشی
`numTests`	`int` : تعداد کل تست ها در اجرای آزمایشی
`attemptNumber`	`int` : شماره سفارش، شناسایی تلاش‌های مختلف یک runName که چندین بار اجرا می‌شوند. تلاش Number با 0 ایندکس شده است و باید هر بار که اجرای جدیدی اتفاق می افتد افزایش یابد. به عنوان مثال، یک تست 3 بار به صورت دانه ای تکرار می شود، باید 4 اجرا در مجموع تحت همان runName داشته باشد و numberNumber از 0 تا 3 باشد.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

پارامترها
`name`	`String` : نام اجرای آزمایشی
`numTests`	`int` : تعداد کل تست ها در اجرای آزمایشی
`attemptNumber`	`int` : شماره سفارش، شناسایی تلاش‌های مختلف یک runName که چندین بار اجرا می‌شوند. تلاش Number با 0 ایندکس شده است و باید هر بار که اجرای جدیدی اتفاق می افتد افزایش یابد. به عنوان مثال، یک تست 3 بار به صورت دانه ای تکرار می شود، باید 4 اجرا در مجموع تحت همان runName داشته باشد و numberNumber از 0 تا 3 باشد.
`startTime`	`long` : زمان شروع اجرا، اندازه‌گیری شده از طریق `System.currentTimeMillis()`

تست رد شد

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

تست شروع شد

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