GTestBase

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

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

الفئة الأساسية لـ gTest

ملخّص

الثوابت

String FILTER_EXTENSION

String GTEST_FLAG_FILE

String GTEST_FLAG_FILTER

String GTEST_FLAG_LIST_TESTS

String GTEST_FLAG_PRINT_TIME

String GTEST_FLAG_RUN_DISABLED_TESTS

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

تُستخدَم هذه السمة لتحديد ما إذا كان سيتم استخدام مخرجات 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() توفّر أيضًا shardCount الذي تتم محاولة تنفيذه.

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

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 هي false.

abstract String loadFilter(String path)

تحديد طريقة فلترة get

void setRunDisabled(boolean runDisabled)

تحديد ما إذا كان يجب أن ينفّذ GTest الاختبارات التي تم إيقافها

الثوابت

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

Constant Value: ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

Constant Value: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

Constant Value: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

Constant Value: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

Constant Value: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Constant Value: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Constant Value: "--gtest_output=xml:%s"

الإنشاءات العامة

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

تُستخدَم لتحديد ما إذا كان سيتم استخدام مخرجات gtest xml لنتائج الاختبار أم لا.

المرتجعات
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() توفّر أيضًا shardCount الذي تتم محاولة تنفيذه. ويكون ذلك مفيدًا لبعض أدوات تشغيل الاختبار التي لا يمكنها اتخاذ قرار بشكل عشوائي في بعض الأحيان.

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

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

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

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

المعلمات
listeners ITestInvocationListener

المرتجعات
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

تحديد طريقة فلترة get

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

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

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

تحديد ما إذا كان يجب أن ينفّذ GTest الاختبارات التي تم إيقافها

المعلمات
runDisabled boolean