InstrumentationProtoResultParser

public class InstrumentationProtoResultParser
extends Object implements IInstrumentationResultParser

java.lang.object
↳ com.android.tradefed.result.ddmlib.InstrumentationProtoResultParser

نتایج «حالت خروجی protoStd» آزمایش ابزار دقیق اجرا شده از پوسته را تجزیه می کند و نتایج را به ITestRunListener اطلاع می دهد.

فرمان ابزار Am با گزینه "-m" وضعیت اجرای آزمایش را در قالب پروتوباف باینری به صورت تدریجی خروجی می دهد. پیام پروتوباف خروجی InstrumentationData.Session است که دارای دو فیلد است: 1) یک فیلد تکراری InstrumentationData.TestStatus ، 2) InstrumentationData.SessionStatus . دستور am instrument پیام وضعیت تست را قبل/بعد از اجرای هر تست خروجی می دهد. addOutput(byte, int, int) با آرگومان data فراخوانی می شود که یک بایت سریالی از TestStatus (es) است. هنگامی که تمام تست ها انجام شد، دستور در نهایت SessionStatus خروجی می دهد.

برای تعریف کامل پروتوباف به https://cs.android.com/android/platform/superproject/+/master:frameworks/base/cmds/am/proto/instrumentation_data.proto مراجعه کنید.

InstrumentationProtoResultParser یک ماشین حالت است و حالت‌ها در ERROR(InstrumentationProtoResultParserState/com.android.tradefed.result.ddmlib.InstrumentationProtoResultParser.InstrumentationProtoResultParserState InstrumentationProtoResultParserState) تعریف می‌شوند. حالت با ERROR(/com.android.tradefed.result.ddmlib.InstrumentationProtoResultParser.InstrumentationProtoResultParserState#NOT_STARTED) شروع می شود. هنگامی که اولین وضعیت آزمایشی را می‌بیند، به ERROR(InstrumentationProtoResultParserState.RUNNING/com.android.tradefed.result.ddmlib.InstrumentationProtoResultParser.InstrumentationProtoResultParserState#RUNNING InstrumentationProtoResultParserState.RUNNING) . اگر همه آزمایش‌ها انجام ERROR(/com.android.tradefed.result.ddmlib.InstrumentationProtoResultParser.InstrumentationProtoResultParserState#FINISHED) یا ERROR(/com.android.tradefed.result.ddmlib.InstrumentationProtoResultParser.InstrumentationProtoResultParserState#CANCELLED) اگر با فراخوانی cancel() درخواست شود.

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

خلاصه

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

InstrumentationProtoResultParser (String runName, listeners)

InstrumentationProtoResultParser را می سازد.

روش های عمومی

void addOutput (byte[] data, int offset, int length)

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

void cancel ()
void flush ()
void handleTestRunFailed (String errorMsg)
boolean isCancelled ()

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

InstrumentationProtoResultParser 

public InstrumentationProtoResultParser (String runName, 
                 listeners)

InstrumentationProtoResultParser را می سازد.

پارامترها
runName String : نام اجرای آزمایشی برای ارائه به ITestRunListener.testRunStarted

listeners : از نتایج آزمون در حین انجام آزمایش مطلع می شود

روش های عمومی

addOutput 

public void addOutput (byte[] data, 
                int offset, 
                int length)

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

پارامترها
data byte : یک داده سریالی از پیام InstrumentationData.Session . اگر data یک تکه ناقص باشند، به یک بافر داخلی اضافه می شوند و در تماس بعدی addOutput(byte, int, int) پردازش می شوند.

offset int : افست داده های جدید ذخیره شده در data

length int : بایت های یک داده جدید در data که باید پردازش شوند.

لغو 

public void cancel ()

فلاش 

public void flush ()

handleTestRunFailed 

public void handleTestRunFailed (String errorMsg)

پارامترها
errorMsg String

لغو شده است 

public boolean isCancelled ()

برمی گرداند
boolean