GTestResultParser

public class GTestResultParser
extends MultiLineReceiver

java.lang.Object
com.android.ddmlib.MultiLineReceiver
  com.android.tradefed.testtype.GTestResultParser


يحلّل نتائج "وضع الإخراج الأولي" للاختبارات الأصلية التي تستخدم GTest والتي يتم تشغيلها من Shell، ويُعلم ITestInvocationListener بالنتائج.

في ما يلي مثال على تنسيق الإخراج المتوقّع:

 Messages before the start test run marker [==========] Running 15 tests from 1 test case.
 [----------] Global test environment set-up.
 [----------] 15 tests from MessageTest
 [ RUN      ] MessageTest.DefaultConstructor
 [       OK ] MessageTest.DefaultConstructor (1 ms)
 [ RUN      ] MessageTest.CopyConstructor
 external/gtest/test/gtest-message_test.cc:67: Failure
 Value of: 5
 Expected: 2
 external/gtest/test/gtest-message_test.cc:68: Failure
 Value of: 1 == 1
 Actual: true
 Expected: false
 [  FAILED  ] MessageTest.CopyConstructor (2 ms)
  ...
 [ RUN      ] MessageTest.DoesNotTakeUpMuchStackSpace
 [       OK ] MessageTest.DoesNotTakeUpMuchStackSpace (0 ms)
 [----------] 15 tests from MessageTest (26 ms total)

 [----------] Global test environment tear-down
 [==========] 15 tests from 1 test case ran. (26 ms total)
 [  PASSED  ] 6 tests.
 [  FAILED  ] 9 tests, listed below:
 [  FAILED  ] MessageTest.CopyConstructor
 [  FAILED  ] MessageTest.ConstructsFromCString
 [  FAILED  ] MessageTest.StreamsCString
 [  FAILED  ] MessageTest.StreamsNullCString
 [  FAILED  ] MessageTest.StreamsString
 [  FAILED  ] MessageTest.StreamsStringWithEmbeddedNUL
 [  FAILED  ] MessageTest.StreamsNULChar
 [  FAILED  ] MessageTest.StreamsInt
 [  FAILED  ] MessageTest.StreamsBasicIoManip
 9 FAILED TESTS
 

يتم استخدام العلامات التالية للإشارة إلى أحداث معيّنة:

 [==========]: the first occurrence indicates a new run started, including the number of tests
                  to be expected in this run
 [ RUN      ]: indicates a new test has started to run; a series of zero or more lines may
                  follow a test start, and will be captured in case of a test failure or error
 [       OK ]: the preceding test has completed successfully, optionally including the time it
                  took to run (in ms)
 [  FAILED  ]: the preceding test has failed, optionally including the time it took to run (in ms)
 [==========]: the preceding test run has completed, optionally including the time it took to run
                  (in ms)
 
يتم تجاهل جميع الأسطر الأخرى.

ملخّص

طُرق وضع التصميم العامة

GTestResultParser(String testRunName, ITestInvocationListener listener)

ينشئ GTestResultParser لمستمع واحد.

GTestResultParser(String testRunName, ITestInvocationListener listener, boolean allowRustTestName)

ينشئ GTestResultParser لمستمع واحد.

GTestResultParser(String testRunName, Collection<ITestInvocationListener> listeners)

ينشئ GTestResultParser.

GTestResultParser(String testRunName, Collection<ITestInvocationListener> listeners, boolean allowRustTestName)

ينشئ GTestResultParser.

الإجراءات العامة

void cancel()

يطلب إلغاء تشغيل الاختبار.

void done()

يتم استدعاؤه من قِبل العنصر الرئيسي عند اكتمال جلسة adb.

Set<String> getFailedTests()

تعرِض قائمة بالاختبارات التي تعذّر إجراؤها أثناء تشغيل الاختبار الحالي.

boolean getPrependFileName()
boolean isCancelled()

تعرِض القيمة "صحيح" إذا تم إلغاء تشغيل الاختبار.

boolean isTestRunIncomplete()

ما إذا كان تشغيل الاختبار غير مكتمل أم لا

void processNewLines(String[] lines)

يتم استدعاؤه عندما يتلقّى العملية البعيدة أسطرًا جديدة.

void setPrependFileName(boolean prepend)

الإجراءات المحمية

boolean isUnexpectedTestFound()

يتم عرضه لاختبار الوحدة.

طُرق وضع التصميم العامة

GTestResultParser

public GTestResultParser (String testRunName, 
                ITestInvocationListener listener)

ينشئ GTestResultParser لمستمع واحد.

المعلَمات
testRunName String: اسم تشغيل الاختبار الذي سيتم تقديمه إلى ITestInvocationListener.testRunStarted(String,int)

listener ITestInvocationListener: يتم إعلامه بنتائج الاختبارات أثناء تنفيذها

GTestResultParser

public GTestResultParser (String testRunName, 
                ITestInvocationListener listener, 
                boolean allowRustTestName)

ينشئ GTestResultParser لمستمع واحد.

المعلَمات
testRunName String: اسم تشغيل الاختبار الذي سيتم تقديمه إلى ITestInvocationListener.testRunStarted(String,int)

listener ITestInvocationListener: يتم إعلامه بنتائج الاختبارات أثناء تنفيذها

allowRustTestName boolean: السماح بأسماء الاختبارات التي لا تتّبع النمط المفصول بنقطة ('.')

GTestResultParser

public GTestResultParser (String testRunName, 
                Collection<ITestInvocationListener> listeners)

ينشئ GTestResultParser.

المعلَمات
testRunName String: اسم تشغيل الاختبار الذي سيتم تقديمه إلى ITestInvocationListener.testRunStarted(String,int)

listeners Collection: يتم إعلامه بنتائج الاختبارات أثناء تنفيذها

GTestResultParser

public GTestResultParser (String testRunName, 
                Collection<ITestInvocationListener> listeners, 
                boolean allowRustTestName)

ينشئ GTestResultParser.

المعلَمات
testRunName String: اسم تشغيل الاختبار الذي سيتم تقديمه إلى ITestInvocationListener.testRunStarted(String,int)

listeners Collection: يتم إعلامه بنتائج الاختبارات أثناء تنفيذها

allowRustTestName boolean: السماح بأسماء الاختبارات التي لا تتّبع نمط الفصل "::"

الإجراءات العامة

cancel

public void cancel ()

يطلب إلغاء تشغيل الاختبار.

done

public void done ()

يتم استدعاؤه من قِبل العنصر الرئيسي عند اكتمال جلسة adb.

getFailedTests

public Set<String> getFailedTests ()

تعرِض قائمة بالاختبارات التي تعذّر إجراؤها أثناء تشغيل الاختبار الحالي.

المرتجعات
Set<String>

getPrependFileName

public boolean getPrependFileName ()

المرتجعات
boolean

isCancelled

public boolean isCancelled ()

تعرِض القيمة "صحيح" إذا تم إلغاء تشغيل الاختبار.

المرتجعات
boolean

راجِع أيضًا:

isTestRunIncomplete

public boolean isTestRunIncomplete ()

ما إذا كان تشغيل الاختبار غير مكتمل أم لا

المرتجعات
boolean تعرِض القيمة "صحيح" إذا كان تشغيل الاختبار غير مكتمل بسبب مشاكل في التحليل أو الأعطال.

processNewLines

public void processNewLines (String[] lines)

يتم استدعاؤه عندما يتلقّى العملية البعيدة أسطرًا جديدة.

يُضمن أن تكون الأسطر مكتملة عند تقديمها إلى هذا الإجراء.

المعلَمات
lines String: الصفيف الذي يحتوي على الأسطر الجديدة

setPrependFileName

public void setPrependFileName (boolean prepend)

المعلَمات
prepend boolean

الإجراءات المحمية

isUnexpectedTestFound

protected boolean isUnexpectedTestFound ()

يتم عرضه لاختبار الوحدة.

المرتجعات
boolean