GTestBase

public abstract class GTestBase
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

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

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

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 createFlagFile(String filter)

יוצרים קובץ שמכיל את המסננים שישמשו דרך -gtest_flagfile כדי להימנע ממערכות הפעלה. מוגבלת בגודל הארגומנטים.

void erasePrependedFileName( filters, String filename)
String getAllGTestFlags(String path)

עוזר לקבל את כל הדגלים של GTest להעברה לפקודת המעטפת adb.

IConfiguration getConfiguration()

מחזירה את ההגדרות האישיות לבדיקה.

String getExceptionMessage(Exception e)

משקיעים כמיטב יכולתכם לאחזר הודעה תיאורית קצרה ומשמעותית עבור Exception

String getGTestCmdLine(String fullPath, String flags)

רכיב method כדי לבנות את פקודת gtest להרצה.

String getGTestCmdLineWrapper(String fullPath, String flags)

עוזר שמאפשר למחלקות נגזרות לארוז את פקודת gtest בכלי אחר (chroot, strace, gdb וכדומה).

String getGTestFilters(String path)

עוזר להפעיל את מסנן g-test של הבדיקה.

ITestInvocationListener getGTestListener(ITestInvocationListener listener)

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

abstract String loadFilter(String path)

הגדרה של שיטת סינון אחזור.

void setRunDisabled(boolean runDisabled)

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

שדות

מסנן_תוספים

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

addAllInclude filters

public void addAllIncludeFilters ( filters)

הוספת ERROR(/Set) המסננים של הבדיקות שרוצים לכלול.

פרמטרים
filters

הוספת מסנן להחרגה

public void addExcludeFilter (String filter)

הוספת מסנן של הבדיקות שלא ייכללו.

פרמטרים
filter String

addIncludeFilter (הוספת מסנן)

public void addIncludeFilter (String filter)

הוספת מסנן של הבדיקות שייכללו.

פרמטרים
filter String

cleanFilter

public String cleanFilter (String filter)

פרמטרים
filter String

החזרות
String

ניקוי החרגה מסננים

public void clearExcludeFilters ()

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

ניקוי פילטרים

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 אם לא מוגדר

בדיקות getRunDisabled

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

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

החזרות
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

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

החזרות
boolean

isSharded

public boolean isSharded ()

קבלת הסימון isSharded.

החזרות
boolean

הודעה לביצוע הבדיקה

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

שליחת הודעה להורה על ביצוע בדיקה, כדי שניתן יהיה לטפל כראוי במסנני ההכללה/החרגה לגבי הניסיונות החוזרים.

פרמטרים
incompleteTestFound boolean

failedTests

SetAbi

public void setAbi (IAbi abi)

פרמטרים
abi IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

המתג מפעיל או משבית את מצב איסוף הנתונים לבדיקה

הגדרה

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 אם הבדיקה לא ניתן לפיצול כרגע

שיטות מוגנות

createflagFile

protected String createFlagFile (String filter)

יוצרים קובץ שמכיל את המסננים שישמשו דרך -gtest_flagfile כדי להימנע ממערכות הפעלה. מוגבלת בגודל הארגומנטים.

פרמטרים
filter String: מחרוזת המסנן
החזרות
String הנתיב לקובץ שמכיל את המסנן.
קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

DeletePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

פרמטרים
filters

filename String

getAllGTestflags

protected String getAllGTestFlags (String path)

עוזר להעביר את כל דגלי GTest לפקודת המעטפת adb.

פרמטרים
path String: הנתיב המלא של הקובץ הבינארי במכשיר.
החזרות
String String של כל דגלי GTest שיש להעביר ל-GTest
קליעות
DeviceNotAvailableException

getConfiguration

protected IConfiguration getConfiguration ()

מחזירה את ההגדרות האישיות לבדיקה.

החזרות
IConfiguration הגדרה

getErrorMessage

protected String getExceptionMessage (Exception e)

משקיעים כמיטב יכולתכם לאחזר הודעה תיאורית קצרה ומשמעותית עבור Exception

פרמטרים
e Exception: Exception
החזרות
String הודעה קצרה

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

רכיב method כדי לבנות את פקודת 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 בדיקת 'מקרי בדיקה' נביא בחשבון את השינויים.

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

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

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

פרמטרים
listener ITestInvocationListener

החזרות
ITestInvocationListener

מסנן עומס

protected abstract String loadFilter (String path)

הגדרה של שיטת סינון אחזור.

חובה להטמיע מחלקה משנית כדי לקבל מסנן משלה.

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

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

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

פרמטרים
runDisabled boolean