GTestBase

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

java.lang.Object
↳	com.android.tradefed.testtype.GTestBase

תת-כיתות ישירות ידועות GTest, ‏ HostGTest GTest בדיקה שמריצה חבילת בדיקה מקורית במכשיר נתון.  HostGTest בדיקה שמריצה חבילת בדיקה מקורית.

תת-כיתות עקיפות ידועות ArtGTest ArtGTest

---

המחלקה הבסיסית של 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() הפונקציה מקבלת שימוש בפלט 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 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 שמספק מידע נוסף על תוצאות ניפוי הבאגים, למשל זיהוי בדיקות כפולות ודיווח עליהן אם mDisabled YouTubeCheck לא נכון.
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 ()

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

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

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

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

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

שיטות מוגנות

createFlagFile

protected String createFlagFile (String filter)

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

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

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

זריקות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
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

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 Test יילקחו בחשבון.

פרמטרים
path	String: הנתיב המלא של הקובץ הבינארי במכשיר.

החזרות
String	דגל המסנן המלא להעביר למבחן g, או מחרוזת ריקה אם לא צוין

זריקות
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