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 () מקבל פקודות מעטפת להפעלה לאחר GTest. | |
getBeforeTestCmd () מקבל פקודות מעטפת להפעלה לפני GTest. | |
getExcludeFilters () מחזירה את | |
getFileExclusionFilterRegex () מקבל ביטוי רגיל כדי לא לכלול קבצים מסוימים מביצוע. | |
getGTestFlags () מקבל ערכי דגל נוספים שיעבירו לפקודת המעטפת של הבדיקה המקורית. | |
getIncludeFilters () מחזירה את | |
long | getMaxTestTimeMs () מקבל את הזמן המקסימלי להפעלת gtest. |
String | getModuleName () קבל את מודול הבדיקה המקורי של אנדרואיד להפעלה. |
boolean | getRunDisabledTests () קבל אם GTest צריך להריץ בדיקות מושבתות. |
long | getRuntimeHint () החזר את זמן הריצה הצפוי של הבדיקה באלפיות שניות. |
int | getShardCount () מחזירה את ספירת הרסיסים הנוכחית. |
int | getShardIndex () מקבל את מדד הרסיסים של בדיקה זו. |
String | getTestFilterKey () מקבל מפתח מסנן בדיקה. |
String | getTestModule () מקבל שם מודול. |
boolean | isCollectTestsOnly () מקבל רק להפעיל את הבינארי הבדיקה כדי לאסוף רשימה של מקרי בדיקה רלוונטיים או לא. |
boolean | isEnableXmlOutput () מקבל שימוש בפלט gtest xml לתוצאות בדיקה או לא. |
boolean | isSharded () מקבל את דגל isSharded. |
void | setAbi ( IAbi abi) |
void | setCollectTestsOnly (boolean shouldCollectTest) מפעיל או משבית מצב איסוף בדיקות |
void | setConfiguration ( IConfiguration configuration) מזריק את |
void | setModuleName (String moduleName) הגדר את מודול הבדיקה המקורי של אנדרואיד להפעלה. |
void | setShardCount (int shardCount) מגדיר את ספירת הרסיסים של בדיקה זו. |
void | setShardIndex (int shardIndex) מגדיר את אינדקס הרסיסים של בדיקה זו. |
split (int shardCountHint) גרסה חלופית של |
שיטות מוגנות | |
---|---|
String | createFlagFile (String filter) צור קובץ המכיל את המסננים שישמשו דרך --gtest_flagfile כדי למנוע כל מגבלה של מערכת ההפעלה בגודל args. |
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-test של הבדיקה. |
ITestInvocationListener | getGTestListener ( ITestInvocationListener listener) מחזיר את ה- |
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
בנאים ציבוריים
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 ()
מקבל פקודות מעטפת להפעלה לאחר GTest.
החזרות | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
מקבל פקודות מעטפת להפעלה לפני GTest.
החזרות | |
---|---|
getExcludeFilters
publicgetExcludeFilters ()
מחזירה את ERROR(/Set)
הנוכחי של מסנני אי הכללה.
החזרות | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
מקבל ביטוי רגיל כדי לא לכלול קבצים מסוימים מביצוע.
החזרות | |
---|---|
getGTestFlags
publicgetGTestFlags ()
מקבל ערכי דגל נוספים שיעבירו לפקודת המעטפת של הבדיקה המקורית.
החזרות | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
מקבל את הזמן המקסימלי להפעלת gtest.
החזרות | |
---|---|
long |
getModuleName
public String getModuleName ()
קבל את מודול הבדיקה המקורי של אנדרואיד להפעלה.
החזרות | |
---|---|
String | השם של מודול הבדיקה המקורי להפעלה, או null אם לא הוגדר |
getRunDisabledTests
public boolean getRunDisabledTests ()
קבל אם GTest צריך להריץ בדיקות מושבתות.
החזרות | |
---|---|
boolean | נכון אם יש להפעיל בדיקות מושבתות, שקר אחרת |
getRuntimeHint
public long getRuntimeHint ()
החזר את זמן הריצה הצפוי של הבדיקה באלפיות שניות. הזמן מנוצל לביצוע הטעינה של ה-Sharded Balance
החזרות | |
---|---|
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 |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
מפעיל או משבית מצב איסוף בדיקות
setConfiguration
public void setConfiguration (IConfiguration configuration)
מזריק את IConfiguration
בשימוש.
פרמטרים | |
---|---|
configuration | IConfiguration |
setModuleName
public void setModuleName (String moduleName)
הגדר את מודול הבדיקה המקורי של אנדרואיד להפעלה.
פרמטרים | |
---|---|
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 כדי למנוע כל מגבלה של מערכת ההפעלה בגודל args.
פרמטרים | |
---|---|
filter | String : מחרוזת המסנן |
החזרות | |
---|---|
String | הנתיב לקובץ המכיל את המסנן. |
זורק | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
מחקPrependedFileName
protected void erasePrependedFileName (filters, String filename)
פרמטרים | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
עוזר לגרום לכל דגלי ה-GTest לעבור לפקודת ה-adb shell.
פרמטרים | |
---|---|
path | String : הנתיב המלא של הקובץ הבינארי במכשיר. |
החזרות | |
---|---|
String | ה- ERROR(/String) של כל דגלי ה-GTest שאמורים לעבור ל-GTest |
זורק | |
---|---|
DeviceNotAvailableException |
getConfiguration
protected IConfiguration getConfiguration ()
מחזיר את תצורת הבדיקה.
החזרות | |
---|---|
IConfiguration | IConfiguration |
getExceptionMessage
protected String getExceptionMessage (Exception e)
נסה ככל האפשר לאחזר הודעה תיאורית קצרה ומשמעותית עבור ERROR(/Exception)
פרמטרים | |
---|---|
e | Exception : ה- ERROR(/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 ייחשבו.
פרמטרים | |
---|---|
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 |