أداة GTestBase

public abstract class GTestBase
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

java.lang.Object
↳ com.android.tradefed.testtype.GTestBase

الفئة الأساسية من gTest

ملخّص

الحقول

protected static final String FILTER_EXTENSION

protected static final String GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_XML_OUTPUT

شركة إنشاءات عامة

GTestBase()

الطرق العامة

void addAllExcludeFilters( filters)

تتم إضافة ERROR(/Set) لفلاتر الاختبارات المطلوب استبعادها.

void addAllIncludeFilters( filters)

تتم إضافة ERROR(/Set) لفلاتر الاختبارات المطلوب تضمينها.

void addExcludeFilter(String filter)

يضيف فلترًا للاختبارات التي تريد استبعادها.

void addIncludeFilter(String filter)

إضافة فلتر للاختبارات المراد تضمينها

String cleanFilter(String filter)
void clearExcludeFilters()

احذف جميع فلاتر الاستثناء التي يتم تتبُّعها حاليًا.

void clearIncludeFilters()

احذف جميع فلاتر التضمين التي يتم تتبّعها حاليًا.

IAbi getAbi()
getAfterTestCmd()

الحصول على أمر(أوامر) واجهة المستخدم لتنفيذه بعد GTest.

getBeforeTestCmd()

الحصول على أمر(أوامر) واجهة المستخدم لتنفيذه قبل GTest.

getExcludeFilters()

تعرض ERROR(/Set) الحالية من فلاتر الاستبعاد.

getFileExclusionFilterRegex()

تحصل على تعبير عادي لاستبعاد تنفيذ ملفات معيّنة.

getGTestFlags()

للحصول على قيم علامات إضافية يتم تمريرها إلى أمر واجهة مستخدم الاختبار الأصلي.

getIncludeFilters()

تعرض قيمة ERROR(/Set) الحالية من فلاتر التضمين.

long getMaxTestTimeMs()

الحصول على الحد الأقصى للوقت اللازم لتشغيل gtest.

String getModuleName()

ثبِّت وحدة الاختبار الأصلي من Android لتشغيلها.

boolean getRunDisabledTests()

معرفة ما إذا كان يجب على GTest إجراء اختبارات غير مفعّلة.

long getRuntimeHint()

عرض بيئة التشغيل المتوقّعة للاختبار في مللي ثانية.

int getShardCount()

لعرض عدد الأجزاء الحالي.

int getShardIndex()

الحصول على فهرس الجزء لهذا الاختبار.

String getTestFilterKey()

الحصول على مفتاح الفلتر التجريبي

String getTestModule()

للحصول على اسم الوحدة.

boolean isCollectTestsOnly()

يؤدي هذا إلى استدعاء البرنامج الثنائي للاختبار فقط لجمع قائمة بحالات الاختبار السارية أو لا.

boolean isEnableXmlOutput()

يؤدي إلى استخدام إخراج gtest xml لنتائج الاختبار أو عدم استخدامه.

boolean isSharded()

يحصل على علامة isSharded.

void notifyTestExecution(boolean incompleteTestFound, failedTests)

إعلام الأصل بتنفيذ الاختبار، بحيث يمكن التعامل مع فلاتر التضمين/الاستبعاد بشكل صحيح لمحاولات إعادة المحاولة.

void setAbi(IAbi abi)
void setCollectTestsOnly(boolean shouldCollectTest)

تفعيل وضع جمع الاختبارات أو إيقافه

void setConfiguration(IConfiguration configuration)

إدخال IConfiguration قيد الاستخدام.

void setModuleName(String moduleName)

اضبط وحدة الاختبار الأصلي لنظام التشغيل Android للتشغيل.

void setShardCount(int shardCount)

لتعيين عدد الأجزاء لهذا الاختبار.

void setShardIndex(int shardIndex)

تعيين فهرس الجزء لهذا الاختبار.

split(int shardCountHint)

إصدار بديل من split() يوفر أيضًا عدد الأجزاء التي تتم محاولة تنفيذها لتشغيله.

الطرق المحمية

String createFlagFile(String filter)

أنشئ ملفًا يحتوي على الفلاتر التي سيتم استخدامها عبر --gtest_flagfile لتجنب أي نظام تشغيل. محدود في حجم الوسيطات.

void erasePrependedFileName( filters, String filename)
String getAllGTestFlags(String path)

مساعد لتمرير جميع علامات GTest في أمر adb Shell.

IConfiguration getConfiguration()

تعرض إعدادات الاختبار.

String getExceptionMessage(Exception e)

ابذل قصارى جهدك للعثور على رسالة وصفية قصيرة ذات مغزى Exception

String getGTestCmdLine(String fullPath, String flags)

طريقة مساعدة لإنشاء أمر gtest لتشغيله.

String getGTestCmdLineWrapper(String fullPath, String flags)

مساعد يسمح للفئات المشتقة بالتفاف الأمر gtest ضمن أداة أخرى (chroot، وstrace وgdb وما شابه ذلك).

String getGTestFilters(String path)

المساعدة في تشغيل فلتر g-test للاختبار

ITestInvocationListener getGTestListener(ITestInvocationListener listener)

عرض GTestListener الذي يقدم معلومات إضافية حول تصحيح الأخطاء، مثل عمليات الاكتشاف تُبلغ عن اختبارات مكرّرة إذا كانت قيمة mDisabledDuplicateCheck خطأ.

abstract String loadFilter(String path)

حدِّد طريقة الحصول على الفلتر.

void setRunDisabled(boolean runDisabled)

تحديد ما إذا كان يجب على GTest إجراء اختبارات غير مفعّلة.

الحقول

الإضافة "فلترة"

protected static final String FILTER_EXTENSION

ملف GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

GTEST_FLAG_Print_TIME

protected static final String GTEST_FLAG_PRINT_TIME

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

شركة إنشاءات عامة

أداة GTestBase

public GTestBase ()

الطرق العامة

إضافة فلاتر استبعاد الكل

public void addAllExcludeFilters ( filters)

تتم إضافة ERROR(/Set) لفلاتر الاختبارات المطلوب استبعادها.

المعلمات
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

تتم إضافة ERROR(/Set) لفلاتر الاختبارات المطلوب تضمينها.

المعلمات
filters

إضافة فلتر

public void addExcludeFilter (String filter)

يضيف فلترًا للاختبارات التي تريد استبعادها.

المعلمات
filter String

إضافة فلتر

public void addIncludeFilter (String filter)

إضافة فلتر للاختبارات المراد تضمينها

المعلمات
filter String

تنظيف الفلتر

public String cleanFilter (String filter)

المعلمات
filter String

المرتجعات
String

محو الفلاتر

public void clearExcludeFilters ()

احذف جميع فلاتر الاستثناء التي يتم تتبُّعها حاليًا.

محو الفلاتر

public void clearIncludeFilters ()

احذف جميع فلاتر التضمين التي يتم تتبّعها حاليًا.

جيت آبي

public IAbi getAbi ()

المرتجعات
IAbi

getafterTestCmd

public  getAfterTestCmd ()

الحصول على أمر(أوامر) واجهة المستخدم لتنفيذه بعد GTest.

المرتجعات

getBeforeTestCmd

public  getBeforeTestCmd ()

الحصول على أمر(أوامر) واجهة المستخدم لتنفيذه قبل GTest.

المرتجعات

الحصول على فلاتر مستبعدة

public  getExcludeFilters ()

تعرض ERROR(/Set) الحالية من فلاتر الاستبعاد.

المرتجعات

الحصول على استبعاد فلتر Regex

public  getFileExclusionFilterRegex ()

تحصل على تعبير عادي لاستبعاد تنفيذ ملفات معيّنة.

المرتجعات

getGTestFlags

public  getGTestFlags ()

للحصول على قيم علامات إضافية يتم تمريرها إلى أمر واجهة مستخدم الاختبار الأصلي.

المرتجعات

الحصول على فلاتر

public  getIncludeFilters ()

تعرض قيمة ERROR(/Set) الحالية من فلاتر التضمين.

المرتجعات

الحصول على MaxTestTimeMs

public long getMaxTestTimeMs ()

الحصول على الحد الأقصى للوقت اللازم لتشغيل gtest.

المرتجعات
long

اسم الوحدة

public String getModuleName ()

ثبِّت وحدة الاختبار الأصلي من Android لتشغيلها.

المرتجعات
String اسم وحدة الاختبار الأصلية لتشغيلها، أو خالية إذا لم يتم تعيينها

getRunDisabledTests

public boolean getRunDisabledTests ()

معرفة ما إذا كان يجب على GTest إجراء اختبارات غير مفعّلة.

المرتجعات
boolean صحيح إذا كان يجب إجراء الاختبارات غير المفعّلة، وخطأ في الحالات الأخرى

الحصول على تلميح وقت التشغيل

public long getRuntimeHint ()

عرض بيئة التشغيل المتوقّعة للاختبار في مللي ثانية. يتم استخدام الوقت لتحميل التنفيذ المجزأ للتوازن.

المرتجعات
long

عدد getShardCount

public int getShardCount ()

لعرض عدد الأجزاء الحالي.

المرتجعات
int

مؤشر getShardIndex

public int getShardIndex ()

الحصول على فهرس الجزء لهذا الاختبار.

المرتجعات
int

الحصول على مفتاح الفلتر

public String getTestFilterKey ()

الحصول على مفتاح الفلتر التجريبي

المرتجعات
String

الحصول على وحدة اختبار

public String getTestModule ()

للحصول على اسم الوحدة.

المرتجعات
String

يتم جمع الاختبار فقط

public boolean isCollectTestsOnly ()

يؤدي هذا إلى استدعاء البرنامج الثنائي للاختبار فقط لجمع قائمة بحالات الاختبار السارية أو لا.

المرتجعات
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

يؤدي إلى استخدام إخراج gtest xml لنتائج الاختبار أو عدم استخدامه.

المرتجعات
boolean

يتم تقسيمه

public boolean isSharded ()

يحصل على علامة isSharded.

المرتجعات
boolean

إشعار TestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

إعلام الأصل بالتنفيذ الاختباري حتى يمكن معالجة فلاتر التضمين/الاستبعاد بشكل صحيح لمحاولات إعادة المحاولة.

المعلمات
incompleteTestFound boolean

failedTests

ضبط آبي

public void setAbi (IAbi abi)

المعلمات
abi IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

تفعيل وضع جمع الاختبارات أو إيقافه

ضبط الإعدادات

public void setConfiguration (IConfiguration configuration)

إدخال IConfiguration قيد الاستخدام.

المعلمات
configuration IConfiguration

اسم الوحدة

public void setModuleName (String moduleName)

اضبط وحدة الاختبار الأصلي لنظام التشغيل Android للتشغيل.

المعلمات
moduleName String: اسم وحدة الاختبار الأصلية المطلوب تشغيلها

عدد setShardCount

public void setShardCount (int shardCount)

لتعيين عدد الأجزاء لهذا الاختبار.

المعلمات
shardCount int

مؤشر setShardIndex

public void setShardIndex (int shardIndex)

تعيين فهرس الجزء لهذا الاختبار.

المعلمات
shardIndex int

تقسيم

public  split (int shardCountHint)

إصدار بديل من split() يوفر أيضًا عدد الأجزاء التي تتم محاولة تنفيذها لتشغيله. وهذا مفيد لبعض برامج تشغيل الاختبار التي لا يمكنها اتخاذ قرار عشوائي في بعض الأحيان.

المعلمات
shardCountHint int: عدد الأجزاء التي تمت محاولة إجرائها.
المرتجعات
مجموعة من الاختبارات الفرعية التي سيتم تنفيذها بشكل منفصل أو null إذا كان الاختبار غير قابل للتجزئة حاليًا

الطرق المحمية

createflagFile.

protected String createFlagFile (String filter)

أنشئ ملفًا يحتوي على الفلاتر التي سيتم استخدامها عبر --gtest_flagfile لتجنب أي نظام تشغيل. محدود في حجم الوسيطات.

المعلمات
filter String: سلسلة الفلتر
المرتجعات
String المسار إلى الملف الذي يحتوي على الفلتر.
الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

محو PrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

المعلمات
filters

filename String

getAllGTestFlags

protected String getAllGTestFlags (String path)

مساعد لتمرير جميع علامات GTest في أمر adb Shell.

المعلمات
path String: المسار الكامل للبرنامج الثنائي على الجهاز.
المرتجعات
String String من جميع علامات GTest التي يجب تمريرها إلى GTest
الرميات
DeviceNotAvailableException

getConfiguration

protected IConfiguration getConfiguration ()

تعرض إعدادات الاختبار.

المرتجعات
IConfiguration تهيئة IConfiguration

الحصول على رسالة استثناء

protected String getExceptionMessage (Exception e)

ابذل قصارى جهدك للعثور على رسالة وصفية قصيرة ذات مغزى Exception

المعلمات
e Exception: Exception
المرتجعات
String رِسَالَة قَصِيرَة

الحصول على GTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

طريقة مساعدة لإنشاء أمر gtest لتشغيله.

المعلمات
fullPath String: مسار نظام الملفات المطلق إلى برنامج gtest الثنائي على الجهاز
flags String: علامات تنفيذ gtest
المرتجعات
String سطر أوامر shell لتشغيله لـ gtest

الحصول على GTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

مساعد يسمح للفئات المشتقة بالتفاف الأمر gtest ضمن أداة أخرى (chroot، وstrace وgdb وما شابه ذلك).

المعلمات
fullPath String

flags String

المرتجعات
String

getGTestFilters

protected String getGTestFilters (String path)

المساعدة في تشغيل فلتر g-test للاختبار

تجدر الإشارة إلى أنّ الفلاتر تعمل على اسم الدالة فقط (على سبيل المثال: Google Test "Test" (اختبار). كل Google اختبار "حالات الاختبار" موضع النظر.

المعلمات
path String: المسار الكامل للبرنامج الثنائي على الجهاز.
المرتجعات
String علامة الفلتر بالكامل لتمريرها إلى اختبار g، أو سلسلة فارغة إذا لم يتم محددة
الرميات
DeviceNotAvailableException

الحصول على GTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

عرض GTestListener الذي يقدم معلومات إضافية حول تصحيح الأخطاء، مثل عمليات الاكتشاف تُبلغ عن اختبارات مكرّرة إذا كانت قيمة mDisabledDuplicateCheck خطأ. بخلاف ذلك، يتم إرجاع البيانات التي تم تمريرها المستمع.

المعلمات
listener ITestInvocationListener

المرتجعات
ITestInvocationListener

فلتر تحميل

protected abstract String loadFilter (String path)

حدِّد طريقة الحصول على الفلتر.

يجب أن تنفذ الفئة الفرعية كيفية الحصول على فلترها الخاص.

المعلمات
path String: المسار الكامل لملف الفلتر.
المرتجعات
String سلسلة التصفية.
الرميات
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

تحديد ما إذا كان يجب على GTest إجراء اختبارات غير مفعّلة.

المعلمات
runDisabled boolean