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) يضيف |
void | addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) يضيف |
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 () إرجاع | |
getFileExclusionFilterRegex () يحصل على regex لاستبعاد ملفات معينة من التنفيذ. | |
getGTestFlags () يحصل على قيم إشارة إضافية لتمريرها إلى أمر shell الخاص بالاختبار الأصلي. | |
getIncludeFilters () إرجاع | |
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) يقوم بإدخال |
void | setModuleName (String moduleName) قم بتعيين وحدة اختبار Android الأصلية للتشغيل. |
void | setShardCount (int shardCount) يضبط عدد الأجزاء لهذا الاختبار. |
void | setShardIndex (int shardIndex) يضبط مؤشر الجزء لهذا الاختبار. |
split (int shardCountHint) إصدار بديل من |
الأساليب المحمية | |
---|---|
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) بذل قصارى جهدك لمحاولة استرداد رسالة وصفية قصيرة ذات معنى |
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 ()
قم بحذف كافة عوامل تصفية التضمين التي يتم تتبعها حاليًا.
getAfterTestCmd
publicgetAfterTestCmd ()
الحصول على أمر (أوامر) shell ليتم تشغيلها بعد GTest.
عائدات | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
الحصول على أمر (أوامر) Shell ليتم تشغيلها قبل GTest.
عائدات | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
يحصل على regex لاستبعاد ملفات معينة من التنفيذ.
عائدات | |
---|---|
getGTestFlags
publicgetGTestFlags ()
يحصل على قيم إشارة إضافية لتمريرها إلى أمر shell الخاص بالاختبار الأصلي.
عائدات | |
---|---|
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 |
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 |
ينقسم
publicsplit (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 |