ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

java.lang.object
↳ com.android.tradefed.result.proto.ProtoResultReporter

گزارشگر نتیجه یک پروتوباف TestRecord با تمام نتایج داخل آن می‌سازد. باید برای رسیدگی به کارهایی که باید با پروتو نهایی در processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord) انجام شود گسترش داده شود.

خلاصه

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

ProtoResultReporter ()

روش های عمومی

final void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationSkipped ( SkipReason reason)

یک فراخوان را به عنوان نادیده گرفته شده گزارش می دهد

final void invocationStarted ( IInvocationContext context)

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

final 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 processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

از رکورد فراخوانی برای ارسال یک به یک تمام لاگ های نهایی فراخوان استفاده کنید.

void processFinalProto (TestRecordProto.TestRecord finalRecord)

رسیدگی به پروتو نهایی با همه نتایج.

void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

رسیدگی به پروتوی رکورد آزمون فراخوانی جزئی پس از وقوع invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

رسیدگی به پرونده پرونده آزمایشی نهایی شده پس از ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) رخ داد.

void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

پس از انجام testStarted(com.android.tradefed.result.TestDescription, long) پروتوی ثبت پرونده آزمایشی جزئی انجام شد.

void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

مدیریت پروتو رکورد ماژول نهایی پس از testModuleEnded() رخ داد.

void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

پس از انجام testModuleStarted(com.android.tradefed.invoker.IInvocationContext) پروتو رکورد ماژول جزئی انجام شد.

void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

مدیریت پروتو رکورد اجرای نهایی پس از ERROR(/#testRunEnded(long,HashMap)) رخ داد.

void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

مدیریت پروتو رکورد اجرای آزمایشی جزئی پس از اجرای testRunStarted(String, int) .

void setGranularResults (boolean granularResults)
void setInlineRecordOfChildren (boolean inline)
boolean supportGranularResults ()

اگر گزارشگر از نتایج گرانول پشتیبانی کند درست است، در غیر این صورت نادرست است.

final void testAssumptionFailure ( TestDescription test, String trace)

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

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

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

final 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)

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

final void testFailed ( TestDescription test, FailureDescription failure)

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

final void testFailed ( TestDescription test, String trace)

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

final void testIgnored ( TestDescription test)

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

final void testModuleEnded ()

پایان اجرای یک ماژول را گزارش می دهد.

final void testModuleStarted ( IInvocationContext moduleContext)

شروع یک ماژول در حال اجرا را گزارش می دهد.

final void testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics)

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

final void testRunFailed ( FailureDescription failure)

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

final void testRunFailed (String errorMessage)

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

void testRunStarted (String runName, int testCount, int attemptNumber)

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

final void testRunStarted (String runName, int testCount)

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

void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)

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

final void testSkipped ( TestDescription test, SkipReason reason)

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

final void testStarted ( TestDescription test, long startTime)

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

final void testStarted ( TestDescription test)

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

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

TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

یک مرجع فرزند برای یک ماژول ایجاد می کند.

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

ProtoResultReporter

public ProtoResultReporter ()

روش های عمومی

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

public final void invocationEnded (long elapsedTime)

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

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

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

فراخوان ناموفق بود

public void invocationFailed (FailureDescription failure)

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

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

مولفه های
failure FailureDescription : FailureDescription که علت خرابی را توصیف می کند

فراخوان ناموفق بود

public void invocationFailed (Throwable cause)

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

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

مولفه های
cause Throwable : علت Throwable شکست

فراخوان نادیده گرفته شد

public void invocationSkipped (SkipReason reason)

یک فراخوان را به عنوان نادیده گرفته شده گزارش می دهد

مولفه های
reason SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

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

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

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

logAssociation

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

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

از رکورد فراخوانی برای ارسال یک به یک تمام لاگ های نهایی فراخوان استفاده کنید.

مولفه های
invocationLogs TestRecordProto.TestRecord : پروتوی نهایی که فراخوانی را نشان می دهد.

processFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

رسیدگی به پروتو نهایی با همه نتایج.

مولفه های
finalRecord TestRecordProto.TestRecord : پروتو نهایی شده با تمام نتایج فراخوانی.

processStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

رسیدگی به پروتوی رکورد آزمون فراخوانی جزئی پس از وقوع invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

مولفه های
invocationStartRecord TestRecordProto.TestRecord : پروتوی جزئی که پس از invocationStart پر شده است.

invocationContext IInvocationContext : فراخوان IInvocationContext .

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

رسیدگی به پرونده پرونده آزمایشی نهایی شده پس از ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) رخ داد.

مولفه های
testCaseRecord TestRecordProto.TestRecord : پروتو نهایی شده که یک مورد آزمایشی را نشان می دهد.

processTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

پس از انجام testStarted(com.android.tradefed.result.TestDescription, long) پروتوی ثبت پرونده آزمایشی جزئی انجام شد.

مولفه های
testCaseStartedRecord TestRecordProto.TestRecord : پروتوی جزئی که نمونه آزمایشی را نشان می دهد.

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

مدیریت پروتو رکورد ماژول نهایی پس از testModuleEnded() رخ داد.

مولفه های
moduleRecord TestRecordProto.TestRecord : پروتو نهایی که نشان دهنده ماژول است.

processTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

پس از انجام testModuleStarted(com.android.tradefed.invoker.IInvocationContext) پروتو رکورد ماژول جزئی انجام شد.

مولفه های
moduleStartRecord TestRecordProto.TestRecord : پروتوی جزئی که ماژول را نشان می دهد.

processTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

مدیریت پروتو رکورد اجرای نهایی پس از ERROR(/#testRunEnded(long,HashMap)) رخ داد.

مولفه های
runRecord TestRecordProto.TestRecord : پروتو نهایی که اجرا را نشان می دهد.

moduleInProgress boolean : آیا یک ماژول در حال پیشرفت است یا خیر.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

مدیریت پروتو رکورد اجرای آزمایشی جزئی پس از اجرای testRunStarted(String, int) .

مولفه های
runStartedRecord TestRecordProto.TestRecord : پروتوی جزئی که اجرا را نشان می دهد.

setGranular Results

public void setGranularResults (boolean granularResults)

مولفه های
granularResults boolean

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

مولفه های
inline boolean

supportGranular Results

public boolean supportGranularResults ()

اگر گزارشگر از نتایج گرانول پشتیبانی کند درست است، در غیر این صورت نادرست است.

برمی گرداند
boolean

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

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

مولفه های
test TestDescription : تست را مشخص می کند

trace String : ردپای شکست

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

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

مولفه های
test TestDescription : تست را مشخص می کند

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

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

public final 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 final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

مولفه های
test TestDescription : تست را مشخص می کند

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

تست شکست خورد

public final void testFailed (TestDescription test, 
                String trace)

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

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

مولفه های
test TestDescription : تست را مشخص می کند

trace String : ردپای شکست

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

public final void testIgnored (TestDescription test)

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

مولفه های
test TestDescription : تست را مشخص می کند

testModuleEnded

public final void testModuleEnded ()

پایان اجرای یک ماژول را گزارش می دهد.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

شروع یک ماژول در حال اجرا را گزارش می دهد. این فراخوانی با testModuleEnded() مرتبط است و در دنباله اختیاری است. این فقط در طول اجرا استفاده می شود که از ماژول ها استفاده می کند: دونده های مبتنی بر مجموعه.

مولفه های
moduleContext IInvocationContext : IInvocationContext ماژول.

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

گزارش پایان اجرای آزمایشی FIXME: ما نمی توانیم دو رابط Map<> با نوع متفاوت داشته باشیم، بنابراین باید از HashMap در اینجا استفاده کنیم.

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

runMetrics : جفت های کلید-مقدار در پایان اجرای آزمایشی با Metric گزارش شده است.

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public final void testRunFailed (String errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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

مولفه های
runName String : نام اجرای آزمایشی

testCount int : تعداد کل تست ها در اجرای آزمایشی

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

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

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

مولفه های
runName String : نام اجرای آزمایشی

testCount int : تعداد کل تست ها در اجرای آزمایشی

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

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

مولفه های
runName String : نام اجرای آزمایشی

testCount int : تعداد کل تست ها در اجرای آزمایشی

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

startTime long : زمان شروع اجرا، اندازه‌گیری شده از طریق System.currentTimeMillis()

تست رد شد

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

مولفه های
test TestDescription : تست را مشخص می کند

reason SkipReason : SkipReason

تست شروع شد

public final 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()

تست شروع شد

public final void testStarted (TestDescription test)

شروع یک مورد آزمایشی فردی را گزارش می دهد. رابط قدیمی‌تر، باید در صورت امکان testStarted(com.android.tradefed.result.TestDescription) استفاده کند.

مولفه های
test TestDescription : تست را مشخص می کند

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

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

یک مرجع فرزند برای یک ماژول ایجاد می کند.

مولفه های
record TestRecordProto.TestRecord

برمی گرداند
TestRecordProto.ChildReference