com.GTestBase

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

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

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

void addAllIncludeFilters ( filters) 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 ()

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

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) 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 createFlagFile (String filter)

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

void erasePrependedFileName ( filters, String filename) 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.

ITestInvocationListener getGTestListener ( ITestInvocationListener listener)

إرجاع 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

المقاولين العامة

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

قم بحذف كافة عوامل تصفية التضمين التي يتم تتبعها حاليًا.

com.getAbi

public IAbi getAbi ()

عائدات
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

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

عائدات

getBeforeTestCmd

public  getBeforeTestCmd ()

الحصول على أمر (أوامر) Shell ليتم تشغيلها قبل GTest.

عائدات

getExcludeFilters

public  getExcludeFilters ()

إرجاع ERROR(/Set) لمرشحات الاستبعاد.

عائدات

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

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

عائدات

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

com.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 إذا لم يكن الاختبار قابلاً للتجزئة حاليًا

الأساليب المحمية

createFlagFile

protected String createFlagFile (String filter)

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

حدود
filter String : سلسلة التصفية

عائدات
String المسار إلى الملف الذي يحتوي على عامل التصفية.

رميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

مسح اسم الملف المسبق

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 تكوين I

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 للتشغيل للاختبار

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

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

حدود
fullPath String

flags String

عائدات
String

getGTestFilters

protected String getGTestFilters (String path)

مساعد في تشغيل مرشح الاختبار g.

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

حدود
path String : المسار الكامل للثنائي على الجهاز.

عائدات
String علامة التصفية الكاملة لتمريرها إلى اختبار g، أو سلسلة فارغة إذا لم يتم تحديد أي منها

رميات
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

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

حدود
listener ITestInvocationListener

عائدات
ITestInvocationListener

LoadFilter

protected abstract String loadFilter (String path)

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

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

حدود
path String : المسار الكامل لملف الفلتر.

عائدات
String سلسلة التصفية.

رميات
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

قم بتعيين ما إذا كان يجب على GTest تشغيل الاختبارات المعطلة.

حدود
runDisabled boolean