گزارشگر نتایج فرعی

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

java.lang.object
↳ com.android.tradefed.result.SubprocessResultsReporter

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

خلاصه

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

SubprocessResultsReporter ()

روش های عمومی

void close ()

TestSummary getSummary ()

به InvocationListener اجازه می دهد خلاصه ای را برگرداند.

void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

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 printEvent (String key, Object event)

کمک کننده برای چاپ کلید رویداد و سپس شی json.

void setOutputTestLog (boolean outputTestLog)

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

boolean supportGranularResults ()

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

void testAssumptionFailure ( TestDescription testId, String trace)

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

void testAssumptionFailure ( TestDescription testId, FailureDescription failure)

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

void testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics)

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

void testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics)

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

void testFailed ( TestDescription testId, FailureDescription failure)

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

void testFailed ( TestDescription testId, String reason)

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

void testIgnored ( TestDescription testId)

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

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

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

void testModuleEnded ()

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

void testModuleStarted ( IInvocationContext moduleContext)

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

void testRunEnded (long time, runMetrics) testRunEnded (long time, runMetrics)

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

void testRunFailed ( FailureDescription failure)

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

void testRunFailed (String reason)

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

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

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

void testRunStarted (String runName, int testCount)

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

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

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

void testRunStopped (long arg0)

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

void testSkipped ( TestDescription testId, SkipReason reason)

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

void testStarted ( TestDescription testId, long startTime)

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

void testStarted ( TestDescription testId)

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

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

گزارشگر نتایج فرعی

public SubprocessResultsReporter ()

روش های عمومی

بستن

public void close ()

دریافت خلاصه

public TestSummary getSummary ()

به InvocationListener اجازه می دهد خلاصه ای را برگرداند.

برمی گرداند
TestSummary یک TestSummary که اجرا یا null را خلاصه می کند

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

public 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 شکست

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

printEvent

public void printEvent (String key, 
                Object event)

کمک کننده برای چاپ کلید رویداد و سپس شی json.

مولفه های
key String

event Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

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

مولفه های
outputTestLog boolean

supportGranular Results

public boolean supportGranularResults ()

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

برمی گرداند
boolean

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

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

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

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

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

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

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

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

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

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

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

endTime long : زمان پایان آزمایش، اندازه‌گیری شده از طریق System.currentTimeMillis()

metrics : یک ERROR(/Map) از معیارهای منتشر شده

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

public void testEnded (TestDescription testId, 
                 metrics)

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

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

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

metrics : یک ERROR(/Map) از معیارهای منتشر شده

تست شکست خورد

public void testFailed (TestDescription testId, 
                FailureDescription failure)

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

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

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

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

تست شکست خورد

public void testFailed (TestDescription testId, 
                String reason)

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

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

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

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

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

public void testIgnored (TestDescription testId)

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

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

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 کامل نشود، موجود و قابل دسترسی است.

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long time, 
                 runMetrics)

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

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

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String reason)

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

مولفه های
reason 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 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()

testRunStopped

public void testRunStopped (long arg0)

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

TODO: در حال حاضر استفاده نشده است، حذف را در نظر بگیرید

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

تست رد شد

public void testSkipped (TestDescription testId, 
                SkipReason reason)

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

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

reason SkipReason : SkipReason

تست شروع شد

public void testStarted (TestDescription testId, 
                long startTime)

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

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

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

تست شروع شد

public void testStarted (TestDescription testId)

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

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