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(Set<String> filters)

تضيف هذه السمة Set الفلاتر التي يجب استبعاد الاختبارات التي تتضمّنها.

void addAllIncludeFilters(Set<String> filters)

تضيف هذه السمة Set فلاتر الاختبارات التي سيتم تضمينها.

void addExcludeFilter(String filter)

تضيف هذه السمة فلترًا لتحديد الاختبارات التي يجب استبعادها.

void addIncludeFilter(String filter)

تضيف هذه السمة فلترًا لتحديد الاختبارات التي سيتم تضمينها.

String cleanFilter(String filter)
void clearExcludeFilters()

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

void clearIncludeFilters()

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

IAbi getAbi()
List<String> getAfterTestCmd()

يحصل على أوامر shell لتنفيذها بعد GTest.

List<String> getBeforeTestCmd()

يحصل على أوامر shell لتنفيذها قبل GTest.

Set<String> getExcludeFilters()

تعرِض هذه السمة عدد فلاتر الاستبعاد الحالية.Set

Set<String> getFileExclusionFilterRegex()

تعرض هذه السمة تعبيرًا عاديًا لاستبعاد ملفات معيّنة من التنفيذ.

List<String> getGTestFlags()

تعرض هذه السمة قيم العلامات الإضافية التي سيتم تمريرها إلى أمر shell الخاص بالاختبار الأصلي.

Set<String> getIncludeFilters()

تعرِض هذه السمة 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, Set<String> 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)

تضبط هذه السمة فهرس التقسيم لهذا الاختبار.

Collection<IRemoteTest> split(int shardCountHint)

نسخة بديلة من split() توفّر أيضًا shardCount الذي تتم محاولة تنفيذه.

طُرق محمية

String convertName(String gtestFlagName)
String createFlagFile(String filter)

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

void erasePrependedFileName(Set<String> 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 (Set<String> filters)

تضيف هذه السمة Set الفلاتر التي يجب استبعاد الاختبارات التي تتضمّنها.

المعلَمات
filters Set

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

تضيف هذه السمة Set فلاتر الاختبارات التي سيتم تضمينها.

المعلَمات
filters Set

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 List<String> getAfterTestCmd ()

يحصل على أوامر shell لتنفيذها بعد GTest.

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

getBeforeTestCmd

public List<String> getBeforeTestCmd ()

يحصل على أوامر shell لتنفيذها قبل GTest.

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

getExcludeFilters

public Set<String> getExcludeFilters ()

تعرِض هذه السمة عدد فلاتر الاستبعاد الحالية.Set

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

getFileExclusionFilterRegex

public Set<String> getFileExclusionFilterRegex ()

تعرض هذه السمة تعبيرًا عاديًا لاستبعاد ملفات معيّنة من التنفيذ.

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

getGTestFlags

public List<String> getGTestFlags ()

تعرض هذه السمة قيم العلامات الإضافية التي سيتم تمريرها إلى أمر shell الخاص بالاختبار الأصلي.

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

getIncludeFilters

public Set<String> getIncludeFilters ()

تعرِض هذه السمة Set فلاتر التضمين الحالية.

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

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, 
                Set<String> failedTests)

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

المعلَمات
incompleteTestFound boolean

failedTests Set

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 Collection<IRemoteTest> split (int shardCountHint)

نسخة بديلة من split() توفّر أيضًا shardCount الذي تتم محاولة تنفيذه. ويكون ذلك مفيدًا لبعض أدوات تشغيل الاختبار التي لا يمكنها اتخاذ قرار بشكل عشوائي في بعض الأحيان.

المعلَمات
shardCountHint int: عدد الأجزاء التي تمت محاولة إنشائها.
المرتجعات
Collection<IRemoteTest> مجموعة من الاختبارات الفرعية التي سيتم تنفيذها بشكل منفصل أو 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 (Set<String> filters, 
                String filename)

المعلَمات
filters Set

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 "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