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

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

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 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 الاختبارات المتوقفة.

الحقول

الإضافة "فلترة"

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

إضافة فلتر

public void addExcludeFilter (String filter)

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

المعلمات
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

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

المعلمات
filter String

فلتر نظيف

public String cleanFilter (String filter)

المعلمات
filter String

المرتجعات
String

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

getAbi

public IAbi getAbi ()

المرتجعات
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

الحصول على أمر(أوامر) واجهة المستخدم لتنفيذه بعد GTest.

المرتجعات

getBeforeTestCmd

public  getBeforeTestCmd ()

الحصول على أمر(أوامر) واجهة المستخدم لتنفيذه قبل GTest.

المرتجعات

getExcludeFilters

public  getExcludeFilters ()

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

المرتجعات

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

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

المرتجعات

getGTestFlags

public  getGTestFlags ()

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

المرتجعات

getIncludeFilters

public  getIncludeFilters ()

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

المرتجعات

getMaxTestTimeMs

public long getMaxTestTimeMs ()

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

المرتجعات
long

اسم الوحدة

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

إشعار TestExecution

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

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

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 رسالة قصيرة

الحصول على GTestCmdLine

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

الحصول على GTestListener

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