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

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

ConsoleResultReporter

public class ConsoleResultReporter
extends TestResultListener implements ILogSaverListener , ITestInvocationListener

java.lang.object
↳	com.android.tradefed.result.TestResultListener
	↳	com.android.tradefed.result.ConsoleResultReporter

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

هر آزمایش، هر مورد آزمایشی، و معیارهای آزمایش، گزارش‌های آزمایشی و مکان‌های فایل آزمایشی را چاپ می‌کند.

خلاصه

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

روش های عمومی
`void`	`invocationEnded (long elapsedTime)` گزارش می دهد که فراخوانی خاتمه یافته است، چه با موفقیت یا به دلیل برخی شرایط خطا.
`void`	`invocationStarted ( IInvocationContext context)` شروع فراخوانی آزمون را گزارش می دهد.
`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`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` هنگامی که گزارش تست ذخیره می شود، فراخوانی می شود.
`void`	`testResult ( TestDescription test, TestResult result)`
`void`	`testRunEnded (long elapsedTimeMillis, metrics)` `testRunEnded (long elapsedTimeMillis, metrics)` گزارش پایان اجرای آزمایشی
`void`	`testRunFailed ( FailureDescription failure)` اجرای آزمایشی گزارش‌ها به دلیل نقصی که توسط `FailureDescription` توصیف شده است، انجام نشد.
`void`	`testRunFailed (String errorMessage)` اجرای آزمایشی گزارش ها به دلیل یک خطای مهلک انجام نشد.
`void`	`testRunStarted (String runName, int testCount)` شروع اجرای آزمایشی را گزارش می دهد.

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

ConsoleResultReporter

public ConsoleResultReporter ()

روش های عمومی

فراخوان پایان یافت

public void invocationEnded (long elapsedTime)

گزارش می دهد که فراخوانی خاتمه یافته است، چه با موفقیت یا به دلیل برخی شرایط خطا.

به طور خودکار توسط چارچوب TradeFederation فراخوانی می شود.

پارامترها
`elapsedTime`	`long` : زمان سپری شده فراخوانی در ms

invocationStarted

public void invocationStarted (IInvocationContext context)

شروع فراخوانی آزمون را گزارش می دهد.

به طور خودکار توسط چارچوب TradeFederation فراخوانی می شود. گزارشگران باید این روش را نادیده بگیرند تا از گزارش دهی چند دستگاه پشتیبانی کنند.

پارامترها
`context`	`IInvocationContext` : اطلاعاتی در مورد فراخوانی

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` که قبلاً ثبت شده است و باید با پرونده آزمایشی مرتبط شود.

testLogSaved

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

هنگامی که گزارش تست ذخیره می شود، فراخوانی می شود.

باید به جای ITestInvocationListener.testLog(String, LogDataType, InputStreamSource) استفاده شود.

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

نتیجه تست

public void testResult (TestDescription test, 
                TestResult result)

پارامترها
`test`	`TestDescription`
`result`	`TestResult`

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 metrics)

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

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

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