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

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

קובע אם להשתמש בפלט 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)

מגדירים את מודול הבדיקה המקורי של 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

ערך קבוע: ".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

Constant Value: "--gtest_output=xml:%s"

Constructors ציבוריים

GTestBase

public GTestBase ()

‫methods ציבוריים

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

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

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

החזרות
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 שורת הפקודה של ה-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, או מחרוזת ריקה אם לא צוין אף מסנן
זריקות
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 מחרוזת סינון.
זריקות
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

הגדרה אם GTest צריך להריץ בדיקות מושבתות.

פרמטרים
runDisabled boolean