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

מקבל פקודות מעטפת להפעלה לאחר GTest.

getBeforeTestCmd ()

מקבל פקודות מעטפת להפעלה לפני GTest.

getExcludeFilters ()

מחזירה את ה- ERROR(/Set) הנוכחי של מסנני אי הכללה.

getFileExclusionFilterRegex ()

מקבל ביטוי רגיל כדי לא לכלול קבצים מסוימים מביצוע.

getGTestFlags ()

מקבל ערכי דגל נוספים שיעבירו לפקודת המעטפת של הבדיקה המקורית.

getIncludeFilters ()

מחזירה את ה- ERROR(/Set) הנוכחי של מסנני כלול.

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)

מזריק את IConfiguration בשימוש.

void setModuleName (String moduleName)

הגדר את מודול הבדיקה המקורי של אנדרואיד להפעלה.

void setShardCount (int shardCount)

מגדיר את ספירת הרסיסים של בדיקה זו.

void setShardIndex (int shardIndex)

מגדיר את אינדקס הרסיסים של בדיקה זו.

split (int shardCountHint)

גרסה חלופית של split() המספקת גם את ה-shardCount שמנסה להפעיל.

שיטות מוגנות

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)

נסה כמיטב יכולתו לאחזר הודעה תיאורית קצרה ומשמעותית עבור 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 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

בנאים ציבוריים

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

מחק את כל מסנני הכלול שהמעקב אחריהם מתבצע כעת.

getAbi

public IAbi getAbi ()

החזרות
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

מקבל פקודות מעטפת להפעלה לאחר GTest.

החזרות

getBeforeTestCmd

public  getBeforeTestCmd ()

מקבל פקודות מעטפת להפעלה לפני GTest.

החזרות

getExcludeFilters

public  getExcludeFilters ()

מחזירה את ה- ERROR(/Set) הנוכחי של מסנני אי הכללה.

החזרות

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

מקבל ביטוי רגיל כדי לא לכלול קבצים מסוימים מביצוע.

החזרות

getGTestFlags

public  getGTestFlags ()

מקבל ערכי דגל נוספים שיעבירו לפקודת המעטפת של הבדיקה המקורית.

החזרות

getIncludeFilters

public  getIncludeFilters ()

מחזירה את ה- ERROR(/Set) הנוכחי של מסנני כלול.

החזרות

getMaxTestTimeMs

public long getMaxTestTimeMs ()

מקבל את הזמן המקסימלי להפעלת gtest.

החזרות
long

getModuleName

public String getModuleName ()

קבל את מודול הבדיקה המקורי של אנדרואיד להפעלה.

החזרות
String השם של מודול הבדיקה המקורי להפעלה, או null אם לא הוגדר

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

isSharded

public boolean isSharded ()

מקבל את דגל isSharded.

החזרות
boolean

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)

הגדר את מודול הבדיקה המקורי של אנדרואיד להפעלה.

פרמטרים
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 כדי למנוע כל מגבלה של מערכת ההפעלה בגודל args.

פרמטרים
filter String : מחרוזת המסנן

החזרות
String הנתיב לקובץ המכיל את המסנן.

זורק
DeviceNotAvailableException

מחקPrependedFileName

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 הודעה קצרה

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