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()

تحصل على أوامر shell لتشغيلها بعد GTest.

getBeforeTestCmd()

الحصول على أوامر shell لتشغيلها قبل GTest

getExcludeFilters()

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

getFileExclusionFilterRegex()

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

getGTestFlags()

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

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()

يحصل على استخدام مخرجات xml gtest لنتائج الاختبار أم لا.

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 convertName(String gtestFlagName)
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... listeners)

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

abstract String loadFilter(String path)

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

void setRunDisabled(boolean runDisabled)

يمكنك ضبط ما إذا كان يجب أن يُجري GTest الاختبارات المتوقفة.

الحقول

FILTER_EXTENSION

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 ()

الطرق العامة

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

تُضيف ERROR(/Set) الفلاتر التي يجب استبعاد الاختبارات منها.

المعلمات
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

تُضيف ERROR(/Set) الفلاتر التي يجب تضمين الاختبارات فيها.

المعلمات
filters

addExcludeFilter

public void addExcludeFilter (String filter)

تُضيف فلترًا للاختبارات المطلوب استبعادها.

المعلمات
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

تُضيف فلترًا للاختبارات التي تريد تضمينها.

المعلمات
filter String

cleanFilter

public String cleanFilter (String filter)

المعلمات
filter String

المرتجعات
String

clearExcludeFilters

public void clearExcludeFilters ()

حذف جميع فلاتر الاستبعاد التي يتم تتبُّعها حاليًا

clearIncludeFilters

public void clearIncludeFilters ()

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

getAbi

public IAbi getAbi ()

المرتجعات
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

تحصل على أوامر shell لتشغيلها بعد GTest.

المرتجعات

getBeforeTestCmd

public  getBeforeTestCmd ()

الحصول على أوامر shell لتشغيلها قبل GTest

المرتجعات

getExcludeFilters

public  getExcludeFilters ()

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

المرتجعات

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

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

المرتجعات

getGTestFlags

public  getGTestFlags ()

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

المرتجعات

getIncludeFilters

public  getIncludeFilters ()

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

المرتجعات

getMaxTestTimeMs

public long getMaxTestTimeMs ()

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

المرتجعات
long

getModuleName

public String getModuleName ()

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

المرتجعات
String اسم وحدة الاختبار الأصلية المطلوب تشغيلها، أو قيمة فارغة في حال عدم ضبطها

getRunDisabledTests

public boolean getRunDisabledTests ()

الحصول على ما إذا كان يجب أن يُجري GTest اختبارات غير مفعّلة

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

getRuntimeHint

public long getRuntimeHint ()

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

المرتجعات
long

getShardCount

public int getShardCount ()

لعرض عدد الشرائح الحالي.

المرتجعات
int

getShardIndex

public int getShardIndex ()

تحصل على فهرس الشريحة لهذا الاختبار.

المرتجعات
int

getTestFilterKey

public String getTestFilterKey ()

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

المرتجعات
String

getTestModule

public String getTestModule ()

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

المرتجعات
String

isCollectTestsOnly

public boolean isCollectTestsOnly ()

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

المرتجعات
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

يحصل على استخدام مخرجات xml gtest لنتائج الاختبار أم لا.

المرتجعات
boolean

isSharded

public boolean isSharded ()

الحصول على علامة isSharded

المرتجعات
boolean

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

إشعار العنصر الرئيسي بتنفيذ الاختبار، حتى يمكن التعامل مع فلاتر التضمين/الإقصاء بشكل صحيح لمحاولات إعادة المحاولة

المعلمات
incompleteTestFound boolean

failedTests

setAbi

public void setAbi (IAbi abi)

المعلمات
abi IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

تحقِّق من استخدام IConfiguration.

المعلمات
configuration IConfiguration

setModuleName

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 إذا كان الاختبار غير قابل للتقسيم حاليًا

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

convertName

protected String convertName (String gtestFlagName)

المعلمات
gtestFlagName String

المرتجعات
String

createFlagFile

protected String createFlagFile (String filter)

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

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

erasePrependedFileName

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

getExceptionMessage

protected String getExceptionMessage (Exception e)

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

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

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

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

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

getGTestCmdLineWrapper

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")، وسيتمّ أخذ جميع "حالات الاختبار" في اختبار Google في الاعتبار.

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

عمليات الرمي
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

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

المعلمات
listeners ITestInvocationListener

المرتجعات
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

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

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

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

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

يمكنك ضبط ما إذا كان يجب أن يُجري GTest الاختبارات المتوقفة.

المعلمات
runDisabled boolean