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

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

getBeforeTestCmd()

אחזור פקודות מעטפת להרצה לפני 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()

הפונקציה מפעילה רק את קובץ ה-binary של הבדיקה כדי לאסוף רשימה של תרחישי הבדיקה הרלוונטיים או לא.

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() שמספקת גם את הערך של shardCount שרוצים להריץ.

שיטות מוגנות

String convertName(String gtestFlagName)
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 הוא false.

abstract String loadFilter(String path)

מגדירים את שיטת הסינון של ה-get.

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

מריצים את מודול הבדיקה המקורי ל-Android.

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

getRunDisabledTests

public boolean getRunDisabledTests ()

קבלת החלטה אם GTest יפעל בדיקות מושבתות.

החזרות
boolean True אם צריך להריץ בדיקות מושבתות, False אחרת

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

הפונקציה מפעילה רק את קובץ ה-binary של הבדיקה כדי לאסוף רשימה של תרחישי הבדיקה הרלוונטיים או לא.

החזרות
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

הפונקציה קובעת אם להשתמש בפלט xml של gtest לתוצאות הבדיקה או לא.

החזרות
boolean

isSharded

public boolean isSharded ()

אחזור הדגל isSharded.

החזרות
boolean

notifyTestExecution

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() שמספקת גם את הערך של shardCount שרוצים להריץ. האפשרות הזו שימושית לחלק מכלי הבדיקה שלא יכולים לקבל החלטות באופן שרירותי לפעמים.

פרמטרים
shardCountHint int: מספר הניסיונות ליצירת שבר.
החזרות
אוסף של בדיקות משנה שיופעלו בנפרד, או null אם אי אפשר לפצל את הבדיקה כרגע

שיטות מוגנות

convertName

protected String convertName (String gtestFlagName)

פרמטרים
gtestFlagName String

החזרות
String

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

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

שיטה מסייעת ליצירת הפקודה gtest להרצה.

פרמטרים
fullPath String: הנתיב המוחלט במערכת הקבצים לקובץ הבינארי של gtest במכשיר
flags String: דגלי ביצוע של gtest
החזרות
String שורת הפקודה של המעטפת להרצה של 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 Test יילקחו בחשבון.

פרמטרים
path String: הנתיב המלא של הקובץ הבינארי במכשיר.
החזרות
String הדגל המלא של המסנן שיעבור ל-g-test, או מחרוזת ריקה אם לא צוין אף דגל
זריקות
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

הפונקציה מחזירה את GTestListener שמספק מידע נוסף על ניפוי באגים, כמו זיהוי של בדיקות כפולות ודיווח עליהן אם הערך של mDisabledDuplicateCheck הוא false. אחרת, הפונקציה מחזירה את המאזין שהוענק לה.

פרמטרים
listeners ITestInvocationListener

החזרות
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

מגדירים את שיטת הסינון של ה-get.

במחלקת המשנה צריך להטמיע את האופן שבו מקבלים את המסנן שלה.

פרמטרים
path String: הנתיב המלא של קובץ המסנן.
החזרות
String מחרוזת סינון.
זריקות
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

הגדרה של האפשרות להריץ בדיקות מושבתות ב-GTest.

פרמטרים
runDisabled boolean