GTestBase

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

شیء جاوا
↳ 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 ()

دستور(های) شل را برای اجرا پس از GTest دریافت می‌کند.

getBeforeTestCmd ()

دستور(های) شل را برای اجرا قبل از GTest دریافت می‌کند.

getExcludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای مستثنی شده را برمی‌گرداند.

getFileExclusionFilterRegex ()

برای جلوگیری از اجرای فایل‌های خاص، از regex استفاده می‌کند.

getGTestFlags ()

مقادیر پرچم اضافی را برای ارسال به فرمان پوسته تست بومی دریافت می‌کند.

getIncludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای include شده را برمی‌گرداند.

long getMaxTestTimeMs ()

حداکثر زمان لازم برای اجرای یک تست gt را دریافت می‌کند.

String getModuleName ()

ماژول تست بومی اندروید را برای اجرا آماده کنید.

boolean getRunDisabledTests ()

دریافت کنید که آیا GTest باید تست‌های غیرفعال را اجرا کند یا خیر.

long getRuntimeHint ()

زمان اجرای مورد انتظار تست را بر حسب میلی ثانیه برگردانید.

int getShardCount ()

تعداد خرده ریزهای فعلی را برمی‌گرداند.

int getShardIndex ()

شاخص shard این تست را دریافت می‌کند.

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)

ماژول تست بومی اندروید را برای اجرا تنظیم کنید.

void setShardCount (int shardCount)

تعداد خرده ریزهای این آزمون را تنظیم می‌کند.

void setShardIndex (int shardIndex)

شاخص shard این آزمون را تنظیم می‌کند.

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.

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)

متد دریافت فیلتر را تعریف کنید.

void setRunDisabled (boolean runDisabled)

تنظیم کنید که آیا GTest باید تست‌های غیرفعال را اجرا کند یا خیر.

ثابت‌ها

افزونه فیلتر 

protected static final String FILTER_EXTENSION

مقدار ثابت: ".filter"

فایل پرچم تست GTEST 

protected static final String GTEST_FLAG_FILE

مقدار ثابت: "--gtest_flagfile"

فیلتر پرچم GTEST 

protected static final String GTEST_FLAG_FILTER

مقدار ثابت: "--gtest_filter"

GTEST_FLAG_LIST_TESTS 

protected static final String GTEST_FLAG_LIST_TESTS

مقدار ثابت: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME 

protected static final String GTEST_FLAG_PRINT_TIME

مقدار ثابت: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS 

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

مقدار ثابت: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT 

protected static final String GTEST_XML_OUTPUT

مقدار ثابت: "--gtest_output=xml:%s"

سازندگان عمومی

GTestBase 

public GTestBase ()

روش‌های عمومی

فیلترهای addAllExclude 

public void addAllExcludeFilters ( filters)

ERROR(/Set) فیلترهایی را که تست‌هایشان باید حذف شوند، اضافه می‌کند.

پارامترها
filters

فیلترهای addAllInclude 

public void addAllIncludeFilters ( filters)

ERROR(/Set) فیلترهایی که تست‌هایشان باید لحاظ شوند را اضافه می‌کند.

پارامترها
filters

فیلتر addExclude 

public void addExcludeFilter (String filter)

فیلتری اضافه می‌کند که کدام تست‌ها باید حذف شوند.

پارامترها
filter String

فیلتر addInclude 

public void addIncludeFilter (String filter)

فیلتری اضافه می‌کند که کدام تست‌ها باید لحاظ شوند.

پارامترها
filter String

فیلتر تمیز 

public String cleanFilter (String filter)

پارامترها
filter String

بازگشت‌ها
String

فیلترهای clearExclude 

public void clearExcludeFilters ()

تمام فیلترهای حذف‌شده‌ای که در حال حاضر ردیابی می‌شوند را حذف کنید.

فیلترهای clearInclude 

public void clearIncludeFilters ()

تمام فیلترهای موجود که در حال حاضر ردیابی می‌شوند را حذف کنید.

دریافت ابی 

public IAbi getAbi ()

بازگشت‌ها
IAbi

getAfterTestCmd 

public  getAfterTestCmd ()

دستور(های) شل را برای اجرا پس از GTest دریافت می‌کند.

بازگشت‌ها

getBeforeTestCmd 

public  getBeforeTestCmd ()

دستور(های) شل را برای اجرا قبل از GTest دریافت می‌کند.

بازگشت‌ها

فیلترهای getExclude 

public  getExcludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای مستثنی شده را برمی‌گرداند.

بازگشت‌ها

getFileExclusionFilterRegex 

public  getFileExclusionFilterRegex ()

برای جلوگیری از اجرای فایل‌های خاص، از regex استفاده می‌کند.

بازگشت‌ها

پرچم‌های تست دریافت کنید 

public  getGTestFlags ()

مقادیر پرچم اضافی را برای ارسال به فرمان پوسته تست بومی دریافت می‌کند.

بازگشت‌ها

فیلترهای getInclude 

public  getIncludeFilters ()

مقدار ERROR(/Set) فعلی فیلترهای include شده را برمی‌گرداند.

بازگشت‌ها

getMaxTestTimeMs 

public long getMaxTestTimeMs ()

حداکثر زمان لازم برای اجرای یک تست gt را دریافت می‌کند.

بازگشت‌ها
long

دریافت نام ماژول 

public String getModuleName ()

ماژول تست بومی اندروید را برای اجرا آماده کنید.

بازگشت‌ها
String نام ماژول تست بومی برای اجرا، یا در صورت عدم تنظیم، null

getRunDisabledTests 

public boolean getRunDisabledTests ()

دریافت کنید که آیا GTest باید تست‌های غیرفعال را اجرا کند یا خیر.

بازگشت‌ها
boolean اگر تست‌های غیرفعال باید اجرا شوند، مقدار True و در غیر این صورت مقدار False برمی‌گرداند.

getRuntimeHint 

public long getRuntimeHint ()

زمان اجرای مورد انتظار تست را بر حسب میلی‌ثانیه برمی‌گرداند. این زمان برای بارگذاری تعادل اجرای تکه‌تکه شده استفاده می‌شود.

بازگشت‌ها
long

getShardCount 

public int getShardCount ()

تعداد خرده ریزهای فعلی را برمی‌گرداند.

بازگشت‌ها
int

دریافت شاخص 

public int getShardIndex ()

شاخص shard این تست را دریافت می‌کند.

بازگشت‌ها
int

کلید تست فیلتر را دریافت کنید 

public String getTestFilterKey ()

کلید فیلتر تست را دریافت می‌کند.

بازگشت‌ها
String

ماژول getTest 

public String getTestModule ()

نام ماژول را دریافت می‌کند.

بازگشت‌ها
String

فقط تست‌های جمع‌آوری‌شده 

public boolean isCollectTestsOnly ()

فقط فایل باینری تست را فراخوانی می‌کند تا لیستی از موارد تست قابل اجرا را جمع‌آوری کند یا خیر.

بازگشت‌ها
boolean

خروجی isEnableXml 

public boolean isEnableXmlOutput ()

خروجی gtest xml را برای نتایج تست دریافت می‌کند یا خیر.

بازگشت‌ها
boolean

ای‌شارد 

public boolean isSharded ()

پرچم isSharded را دریافت می‌کند.

بازگشت‌ها
boolean

اعلان اجرای تست 

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

اجرای تست را به والد اطلاع دهید، تا فیلترهای شمول/عدم شمول برای تلاش‌های مجدد به درستی مدیریت شوند.

پارامترها
incompleteTestFound boolean

failedTests

ست ابی 

public void setAbi (IAbi abi)

پارامترها
abi IAbi

فقط تست‌های جمع‌آوری‌شده 

public void setCollectTestsOnly (boolean shouldCollectTest)

حالت جمع‌آوری تست را فعال یا غیرفعال می‌کند

پیکربندی set 

public void setConfiguration (IConfiguration configuration)

IConfiguration مورد استفاده را تزریق می‌کند.

پارامترها
configuration IConfiguration

نام ماژول را تنظیم کنید 

public void setModuleName (String moduleName)

ماژول تست بومی اندروید را برای اجرا تنظیم کنید.

پارامترها
moduleName String : نام ماژول تست بومی برای اجرا

setShardCount 

public void setShardCount (int shardCount)

تعداد خرده ریزهای این آزمون را تنظیم می‌کند.

پارامترها
shardCount int

setShardIndex 

public void setShardIndex (int shardIndex)

شاخص shard این آزمون را تنظیم می‌کند.

پارامترها
shardIndex int

تقسیم شده 

public  split (int shardCountHint)

نسخه جایگزین split() که shardCount مورد نظر برای اجرا را نیز ارائه می‌دهد. این برای برخی از اجراکنندگان تست که گاهی اوقات نمی‌توانند به طور دلخواه تصمیم بگیرند، مفید است.

پارامترها
shardCountHint int : تعداد تکه‌های تلاش‌شده.

بازگشت‌ها
مجموعه‌ای از زیرآزمون‌ها که باید جداگانه اجرا شوند یا اگر آزمون در حال حاضر قابل تقسیم‌بندی نیست، null

روش‌های محافظت‌شده

نام تبدیل 

protected String convertName (String gtestFlagName)

پارامترها
gtestFlagName String

بازگشت‌ها
String

ایجاد فایل پرچم 

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

دریافت همه پرچم‌های تست GT 

protected String getAllGTestFlags (String path)

کمکی برای دریافت تمام پرچم‌های GTest جهت ارسال به دستور پوسته adb.

پارامترها
path String : مسیر کامل فایل باینری روی دستگاه.

بازگشت‌ها
String String تمام پرچم‌های GTest که باید به GTest ارسال شوند

پرتاب‌ها
DeviceNotAvailableException

دریافت پیکربندی 

protected IConfiguration getConfiguration ()

پیکربندی آزمایشی را برمی‌گرداند.

بازگشت‌ها
IConfiguration پیکربندی ICON

دریافت پیام استثنا 

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

دریافتGTestCmdLineWrapper 

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

کمکی که به کلاس‌های مشتق‌شده اجازه می‌دهد دستور gtest را تحت ابزار دیگری (chroot، strace، gdb و موارد مشابه) قرار دهند.

پارامترها
fullPath String

flags String

بازگشت‌ها
String

فیلترهای getGTest 

protected String getGTestFilters (String path)

کمکی برای دریافت فیلتر g-test مربوط به تست جهت اجرا.

توجه داشته باشید که فیلترها فقط روی نام تابع فیلتر می‌شوند (مثلاً: Google Test "Test")؛ همه "موارد تست" گوگل در نظر گرفته خواهند شد.

پارامترها
path String : مسیر کامل فایل باینری روی دستگاه.

بازگشت‌ها
String پرچم فیلتر کامل برای ارسال به g-test، یا یک رشته خالی در صورتی که هیچ رشته‌ای مشخص نشده باشد

پرتاب‌ها
DeviceNotAvailableException

دریافتGTestListener 

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

GTestListener را برمی‌گرداند که اطلاعات اشکال‌زدایی اضافی، مانند تشخیص و گزارش تست‌های تکراری در صورت نادرست بودن mDisabledDuplicateCheck، را ارائه می‌دهد. در غیر این صورت، شنونده‌ی ارسالی را برمی‌گرداند.

پارامترها
listeners ITestInvocationListener

بازگشت‌ها
ITestInvocationListener

فیلتر بار 

protected abstract String loadFilter (String path)

متد دریافت فیلتر را تعریف کنید.

زیرکلاس باید نحوه دریافت فیلتر خودش را پیاده‌سازی کند.

پارامترها
path String : مسیر کامل فایل فیلتر.

بازگشت‌ها
String رشته فیلتر.

پرتاب‌ها
DeviceNotAvailableException

تنظیم اجرای غیرفعال 

protected void setRunDisabled (boolean runDisabled)

تنظیم کنید که آیا GTest باید تست‌های غیرفعال را اجرا کند یا خیر.

پارامترها
runDisabled boolean