گزارشگر نتایج فرعی
public class SubprocessResultsReporter
extends Object
implements ILogSaverListener , ISupportGranularResults , ITestInvocationListener
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 باید به شدت با موارد آزمایشی مرتبط باشد، اما این فرصت در |
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) جایگزینی برای |
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) اجرای آزمایشی گزارشها به دلیل نقصی که توسط |
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) جایگزینی برای |
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)
گزارش پایان اجرای آزمایشی
پارامترها | |
---|---|
time | long : دستگاه زمان سپری شده را بر حسب میلی ثانیه گزارش کرد |
runMetrics |
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 : تست را مشخص می کند |