GTestBase
public
abstract
class
GTestBase
extends Object
implements
IAbiReceiver,
IConfigurationReceiver,
IRemoteTest,
IRuntimeHintProvider,
IShardableTest,
ITestCollector,
ITestFilterReceiver
| java.lang.Object | |
| ↳ | 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
|
Constructors ציבוריים | |
|---|---|
GTestBase()
|
|
methods ציבוריים | |
|---|---|
void
|
addAllExcludeFilters(Set<String> filters)
הוספת |
void
|
addAllIncludeFilters(Set<String> filters)
הוספה של |
void
|
addExcludeFilter(String filter)
הוספת מסנן להחרגת בדיקות מסוימות. |
void
|
addIncludeFilter(String filter)
הוספת מסנן של הבדיקות שרוצים לכלול. |
String
|
cleanFilter(String filter)
|
void
|
clearExcludeFilters()
מחיקה של כל מסנני ההחרגה שנמצאים כרגע במעקב. |
void
|
clearIncludeFilters()
מחיקה של כל מסנני ההכללה שנמצאים כרגע במעקב. |
IAbi
|
getAbi()
|
List<String>
|
getAfterTestCmd()
מקבל פקודות shell להרצה אחרי GTest. |
List<String>
|
getBeforeTestCmd()
מקבל פקודות shell להרצה לפני GTest. |
Set<String>
|
getExcludeFilters()
הפונקציה מחזירה את הערך הנוכחי |
Set<String>
|
getFileExclusionFilterRegex()
מקבל ביטוי רגולרי כדי לא לכלול קבצים מסוימים בהרצה. |
List<String>
|
getGTestFlags()
מקבל ערכי דגלים נוספים להעברה לפקודת השל של הבדיקה המקורית. |
Set<String>
|
getIncludeFilters()
הפונקציה מחזירה את |
long
|
getMaxTestTimeMs()
מחזירה את הזמן המקסימלי להרצת gtest. |
String
|
getModuleName()
מפעילים את מודול הבדיקה המקורי של Android. |
boolean
|
getRunDisabledTests()
קבלת מידע על כך ש-GTest צריך להריץ בדיקות מושבתות. |
long
|
getRuntimeHint()
הפונקציה מחזירה את זמן הריצה הצפוי של הבדיקה באלפיות השנייה. |
int
|
getShardCount()
הפונקציה מחזירה את מספר הרסיסים הנוכחי. |
int
|
getShardIndex()
מחזירה את אינדקס הרסיס של הבדיקה הזו. |
String
|
getTestFilterKey()
מקבל את מפתח המסנן של הבדיקה. |
String
|
getTestModule()
מקבל את שם המודול. |
boolean
|
isCollectTestsOnly()
האם להפעיל רק את קובץ ה-binary של הבדיקה כדי לאסוף רשימה של תרחישי בדיקה רלוונטיים או לא. |
boolean
|
isEnableXmlOutput()
האם לקבל פלט gtest xml לתוצאות הבדיקה. |
boolean
|
isSharded()
מחזירה את הסימון isSharded. |
void
|
notifyTestExecution(boolean incompleteTestFound, Set<String> failedTests)
הודעה להורה על ביצוע הבדיקה, כדי שאפשר יהיה לטפל במסנני הכללה/החרגה בצורה נכונה בניסיונות החוזרים. |
void
|
setAbi(IAbi abi)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
המתג מפעיל או משבית את מצב איסוף הבדיקות |
void
|
setConfiguration(IConfiguration configuration)
הוספת ה- |
void
|
setModuleName(String moduleName)
מגדירים את מודול הבדיקה המותאמת של Android להפעלה. |
void
|
setShardCount(int shardCount)
מגדיר את מספר הרסיסים של הבדיקה הזו. |
void
|
setShardIndex(int shardIndex)
הגדרת אינדקס הרסיס של הבדיקה הזו. |
Collection<IRemoteTest>
|
split(int shardCountHint)
גרסה חלופית של |
שיטות מוגנות | |
|---|---|
String
|
convertName(String gtestFlagName)
|
String
|
createFlagFile(String filter)
כדי להימנע ממגבלות של מערכת ההפעלה על גודל הארגומנטים, יוצרים קובץ שמכיל את המסננים שישמשו באמצעות --gtest_flagfile. |
void
|
erasePrependedFileName(Set<String> 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... listeners)
מחזירה את GTestListener שמספק מידע נוסף על ניפוי באגים, כמו זיהוי ובדיקה של בדיקות כפולות אם mDisabledDuplicateCheck הוא false. |
abstract
String
|
loadFilter(String path)
מגדירים את שיטת הסינון get. |
void
|
setRunDisabled(boolean runDisabled)
הגדרה של הפעלת בדיקות מושבתות ב-GTest. |
ערכים קבועים
FILTER_EXTENSION
protected static final String FILTER_EXTENSION
ערך קבוע: ".filter"
GTEST_FLAG_FILE
protected static final String GTEST_FLAG_FILE
ערך קבוע: "--gtest_flagfile"
GTEST_FLAG_FILTER
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"
constructors ציבוריים
GTestBase
public GTestBase ()
methods ציבוריים
addAllExcludeFilters
public void addAllExcludeFilters (Set<String> filters)
הוספת Set של מסננים של בדיקות להחרגה.
| פרמטרים | |
|---|---|
filters |
Set |
addAllIncludeFilters
public void addAllIncludeFilters (Set<String> filters)
הוספה של Set של פילטרים של בדיקות שרוצים לכלול.
| פרמטרים | |
|---|---|
filters |
Set |
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
public List<String> getAfterTestCmd ()
מחזירה פקודות shell להרצה אחרי GTest.
| החזרות | |
|---|---|
List<String> |
|
getBeforeTestCmd
public List<String> getBeforeTestCmd ()
מקבל פקודות מעטפת להרצה לפני GTest.
| החזרות | |
|---|---|
List<String> |
|
getExcludeFilters
public Set<String> getExcludeFilters ()
הפונקציה מחזירה את הערך הנוכחי Set של מסנני החרגה.
| החזרות | |
|---|---|
Set<String> |
|
getFileExclusionFilterRegex
public Set<String> getFileExclusionFilterRegex ()
מקבל ביטוי רגולרי כדי לא לכלול קבצים מסוימים בהרצה.
| החזרות | |
|---|---|
Set<String> |
|
getGTestFlags
public List<String> getGTestFlags ()
מקבל ערכי דגלים נוספים להעברה לפקודת השל של הבדיקה המקורית.
| החזרות | |
|---|---|
List<String> |
|
getIncludeFilters
public Set<String> getIncludeFilters ()
הפונקציה מחזירה את Set הנוכחי של מסנני הכללה.
| החזרות | |
|---|---|
Set<String> |
|
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 ()
האם לקבל פלט gtest xml לתוצאות הבדיקה.
| החזרות | |
|---|---|
boolean |
|
isSharded
public boolean isSharded ()
מחזירה את הסימון isSharded.
| החזרות | |
|---|---|
boolean |
|
notifyTestExecution
public void notifyTestExecution (boolean incompleteTestFound,
Set<String> failedTests)הודעה להורה על הרצת הבדיקה, כדי שאפשר יהיה לטפל במסנני ההכללה/ההחרגה בצורה נכונה בניסיונות החוזרים.
| פרמטרים | |
|---|---|
incompleteTestFound |
boolean |
failedTests |
Set |
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 Collection<IRemoteTest> split (int shardCountHint)
גרסה חלופית של split() שמספקת גם את shardCount שמנסים להפעיל. האפשרות הזו שימושית עבור חלק מכלי ההרצה של בדיקות שלא יכולים להחליט באופן שרירותי לפעמים.
| פרמטרים | |
|---|---|
shardCountHint |
int: מספר הרסיסים שהמערכת ניסתה ליצור. |
| החזרות | |
|---|---|
Collection<IRemoteTest> |
אוסף של בדיקות משנה שצריך להריץ בנפרד או null אם אי אפשר לפצל את הבדיקה כרגע |
שיטות מוגנות
convertName
protected String convertName (String gtestFlagName)
| פרמטרים | |
|---|---|
gtestFlagName |
String |
| החזרות | |
|---|---|
String |
|
createFlagFile
protected String createFlagFile (String filter)
כדי להימנע ממגבלות של מערכת ההפעלה על גודל הארגומנטים, יוצרים קובץ שמכיל את המסננים שישמשו באמצעות --gtest_flagfile.
| פרמטרים | |
|---|---|
filter |
String: מחרוזת המסנן |
| החזרות | |
|---|---|
String |
הנתיב לקובץ שמכיל את המסנן. |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
erasePrependedFileName
protected void erasePrependedFileName (Set<String> filters,
String filename)| פרמטרים | |
|---|---|
filters |
Set |
filename |
String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
כלי עזר לקבלת כל הדגלים של GTest כדי להעביר אותם לפקודה של adb shell.
| פרמטרים | |
|---|---|
path |
String: הנתיב המלא של הקובץ הבינארי במכשיר. |
| החזרות | |
|---|---|
String |
String של כל הדגלים של GTest שצריך להעביר ל-GTest |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
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 Test 'Test Cases' ייחשבו.
| פרמטרים | |
|---|---|
path |
String: הנתיב המלא של הקובץ הבינארי במכשיר. |
| החזרות | |
|---|---|
String |
דגל הסינון המלא שמועבר אל g-test, או מחרוזת ריקה אם לא צוין אף אחד |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
DeviceNotAvailableException |
|
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)
מחזירה את GTestListener שמספק מידע נוסף על ניפוי באגים, כמו זיהוי ובדיקה של בדיקות כפולות אם mDisabledDuplicateCheck הוא false. אחרת, הפונקציה מחזירה את listener שהועבר.
| פרמטרים | |
|---|---|
listeners |
ITestInvocationListener |
| החזרות | |
|---|---|
ITestInvocationListener |
|
loadFilter
protected abstract String loadFilter (String path)
מגדירים את שיטת הסינון get.
במחלקה המשנית צריך להטמיע את האופן שבו מקבלים את המסנן שלה.
| פרמטרים | |
|---|---|
path |
String: הנתיב המלא של קובץ המסנן. |
| החזרות | |
|---|---|
String |
מחרוזת סינון. |
| הקפצת הודעות שגיאה (throw) | |
|---|---|
DeviceNotAvailableException |
|
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
הגדרה אם GTest צריך להריץ בדיקות מושבתות.
| פרמטרים | |
|---|---|
runDisabled |
boolean |