تجزیه‌گر نتایج ابزار دقیق

public class InstrumentationResultParser
extends MultiLineReceiver implements IInstrumentationResultParser

شیء جاوا
↳ com.android.ddmlib.MultiLineReceiver
↳ com.android.tradefed.result.ddmlib.InstrumentationResultParser

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

خروجی زیر را انتظار دارد:

اگر هنگام تلاش برای اجرای تست‌ها خطای مهلک رخ داد:

 INSTRUMENTATION_STATUS: Error=error Message
 INSTRUMENTATION_FAILED:

یا

 INSTRUMENTATION_RESULT: shortMsg=error Message

در غیر این صورت، انتظار می‌رود مجموعه‌ای از نتایج تست نمایش داده شود که هر کدام شامل مجموعه‌ای از جفت‌های وضعیت کلید/مقدار هستند که با کد وضعیت start(1)/pass(0)/fail(-2)/error(-1) از هم جدا شده‌اند. در پایان اجرای تست، انتظار می‌رود زمان سپری شده تست بر حسب ثانیه نمایش داده شود.

برای مثال:

 INSTRUMENTATION_STATUS_CODE: 1
 INSTRUMENTATION_STATUS: class=com.foo.FooTest
 INSTRUMENTATION_STATUS: test=testFoo
 INSTRUMENTATION_STATUS: numtests=2
 INSTRUMENTATION_STATUS: stack=com.foo.FooTest#testFoo:312
    com.foo.X
 INSTRUMENTATION_STATUS_CODE: -2
 ...

 Time: X

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

به جای آن InstrumentationProtoResultParser استفاده کنید. تجزیه‌گر مبتنی بر proto اطلاعات اضافی مانند پیام logcat را دارد.

خلاصه

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

InstrumentationResultParser (String runName, listeners)

تجزیه‌کننده‌ی نتایج ابزار دقیق (InstrumentationResultParser) را ایجاد می‌کند.

روش‌های عمومی

void cancel ()

درخواست لغو اجرای آزمایشی را دارد.

void done ()

وقتی جلسه adb کامل شد، توسط والد فراخوانی می‌شود.

void handleTestRunFailed (String errorMsg)

این متد زمانی فراخوانی می‌شود که دستور "am instrument" با یک استثنا از کار بیفتد.

boolean isCancelled ()

اگر اجرای تست لغو شود، مقدار true را برمی‌گرداند.

void processNewLines (String[] lines)

خروجی تست ابزار دقیق از پوسته را پردازش می‌کند.

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

تجزیه‌گر نتایج ابزار دقیق 

public InstrumentationResultParser (String runName, 
                 listeners)

تجزیه‌کننده‌ی نتایج ابزار دقیق (InstrumentationResultParser) را ایجاد می‌کند.

پارامترها
runName String : نام اجرای آزمایشی که باید به ITestRunListener.testRunStarted(String, int) ارائه شود.

listeners : همزمان با اجرای تست‌ها، از نتایج تست مطلع می‌شود

روش‌های عمومی

لغو 

public void cancel ()

درخواست لغو اجرای آزمایشی را دارد.

انجام شده 

public void done ()

وقتی جلسه adb کامل شد، توسط والد فراخوانی می‌شود.

handleTestRunFailed 

public void handleTestRunFailed (String errorMsg)

این متد زمانی فراخوانی می‌شود که دستور "am instrument" با یک استثنا از کار بیفتد. به همه شنوندگان ثبت شده باید اطلاع داده شود که دستور ITestRunListener.testRunFailed و به دنبال آن ITestRunListener.testRunEnded(long, ) می‌شوند. ITestRunListener.testRunEnded(long, ) اگر خرابی در حین اجرای تست رخ دهد.

پارامترها
errorMsg String

لغو شد 

public boolean isCancelled ()

اگر اجرای تست لغو شود، مقدار true را برمی‌گرداند.

بازگشت‌ها
boolean برای لغو اجرای دستور، true را وارد کنید.

همچنین ببینید:

پردازش‌های جدید 

public void processNewLines (String[] lines)

خروجی تست ابزار دقیق از پوسته را پردازش می‌کند.

پارامترها
lines String : آرایه‌ای که شامل خطوط جدید است.

همچنین ببینید: