ExecutableBaseTest

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

java.lang.Object
↳	com.android.tradefed.testtype.binary.ExecutableBaseTest

מחלקות משנה ישירות ידועות ExecutableHostTest, ExecutableTargetTest ExecutableHostTest כלי להרצת בדיקות של קובץ הפעלה שפועל במארח.  ExecutableTargetTest כלי להרצת בדיקות של קובץ הפעלה שפועל ביעד.

מחלקות משנה לא ישירות מוכרות ‫KUnitModuleTest, ‏ KernelTargetTest KUnitModuleTest כלי להרצת בדיקות להרצת מודולי בדיקה של KUnit במכשיר.  KernelTargetTest כלי להרצת בדיקות של קובץ הפעלה שפועל ביעד ולניתוח התוצאה של בדיקת הליבה.

---

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

סיכום

ערכים קבועים
String	NO_BINARY_ERROR

‫Constructors ציבוריים
ExecutableBaseTest()

‫methods ציבוריים
void	addAllExcludeFilters(Set<String> filters) הוספת Set של מסננים של בדיקות להחרגה.
void	addAllIncludeFilters(Set<String> filters) הוספה של Set של פילטרים של בדיקות שרוצים לכלול.
void	addExcludeFilter(String filter) הוספת מסנן להחרגת בדיקות מסוימות.
void	addIncludeFilter(String filter) הוספת מסנן של הבדיקות שרוצים לכלול.
void	clearExcludeFilters() מחיקה של כל מסנני ההחרגה שנמצאים כרגע במעקב.
void	clearIncludeFilters() מחיקה של כל מסנני ההכללה שנמצאים כרגע במעקב.
abstract String	findBinary(String binary) מחפשים את הקובץ הבינארי כדי להריץ אותו.
IAbi	getAbi()
boolean	getCollectTestsOnly()
Set<String>	getExcludeFilters() הפונקציה מחזירה את הערך הנוכחי Set של מסנני החרגה.
Set<String>	getIncludeFilters() הפונקציה מחזירה את Set הנוכחי של מסנני הכללה.
final long	getRuntimeHint() הפונקציה מחזירה את זמן הריצה הצפוי של הבדיקה באלפיות השנייה.
Set<String>	reportDependencies()
void	run(TestInformation testInfo, ITestInvocationListener listener) מריץ את הבדיקות ומדווח על התוצאה למאזין.
abstract void	runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description) להריץ בפועל את הקובץ הבינארי בנתיב שצוין.
final void	setAbi(IAbi abi)
final void	setCollectTestsOnly(boolean shouldCollectTest) המתג מפעיל או משבית את מצב איסוף הבדיקות
void	setConfiguration(IConfiguration configuration) הוספת ה-IConfiguration שנמצא בשימוש.
FailureDescription	shouldAbortRun(TestDescription description) בודקים אם צריך לסיים את ה-testRun מוקדם.
final Collection<IRemoteTest>	split(int shardHint) גרסה חלופית של split() שמספקת גם את shardCount שמנסים להפעיל.

שיטות מוגנות
boolean	doesRunBinaryGenerateTestResults()
boolean	doesRunBinaryGenerateTestRuns()
Map<String, String>	getAllTestCommands() כדי לשמור על עקביות, צריך להמיר את mBinaryPaths ל-mTestCommands.
IConfiguration	getConfiguration() מחזירה את הגדרות הבדיקה.
TestDescription[]	getFilterDescriptions(Map<String, String> testCommands)
String	getModuleId(IInvocationContext context)
long	getTimeoutPerBinaryMs()
boolean	isTestFailed(String testName)

ערכים קבועים

NO_BINARY_ERROR

public static final String NO_BINARY_ERROR

ערך קבוע: "Binary %s does not exist."

‫constructors ציבוריים

ExecutableBaseTest

public ExecutableBaseTest ()

‫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

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

findBinary

public abstract String findBinary (String binary)

מחפשים את הקובץ הבינארי כדי להריץ אותו.

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

החזרות
String	הנתיב לקובץ הבינארי, או null אם הוא לא נמצא.

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException

getAbi

public IAbi getAbi ()

החזרות
IAbi

getCollectTestsOnly

public boolean getCollectTestsOnly ()

החזרות
boolean

getExcludeFilters

public Set<String> getExcludeFilters ()

הפונקציה מחזירה את הערך הנוכחי Set של מסנני החרגה.

החזרות
Set<String>

getIncludeFilters

public Set<String> getIncludeFilters ()

הפונקציה מחזירה את Set הנוכחי של מסנני הכללה.

החזרות
Set<String>

getRuntimeHint

public final long getRuntimeHint ()

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

החזרות
long

reportDependencies

public Set<String> reportDependencies ()

החזרות
Set<String>

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

מריץ את הבדיקות ומדווח על התוצאה למאזין.

פרמטרים
testInfo	‫TestInformation: אובייקט TestInformation שמכיל מידע שימושי להרצת בדיקות.
listener	‫ITestInvocationListener: ITestInvocationListener תוצאות הבדיקה

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException

runBinary

public abstract void runBinary (String binaryPath, 
                ITestInvocationListener listener, 
                TestDescription description)

להריץ בפועל את הקובץ הבינארי בנתיב שצוין.

פרמטרים
binaryPath	‫String: הנתיב של הקובץ הבינארי.
listener	‫ITestInvocationListener: מאזין שאליו מדווחים את התוצאות.
description	‫TestDescription: הבדיקה שמתבצעת.

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException
IOException

setAbi

public final void setAbi (IAbi abi)

פרמטרים
abi	IAbi

setCollectTestsOnly

public final void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

הוספת ה-IConfiguration שנמצא בשימוש.

פרמטרים
configuration	IConfiguration

shouldAbortRun

public FailureDescription shouldAbortRun (TestDescription description)

בודקים אם צריך לסיים את ה-testRun מוקדם.

פרמטרים
description	‫TestDescription: הבדיקה שמתבצעת.

החזרות
FailureDescription	‫FailureDescription אם צריך להפסיק את לולאת ההפעלה.

פיצול

public final Collection<IRemoteTest> split (int shardHint)

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

פרמטרים
shardHint	‫int: מספר הרסיסים שהמערכת ניסתה ליצור.

החזרות
Collection<IRemoteTest>	אוסף של בדיקות משנה שצריך להריץ בנפרד או null אם אי אפשר לפצל את הבדיקה כרגע

שיטות מוגנות

doesRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

החזרות
boolean

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

החזרות
boolean

getAllTestCommands

protected Map<String, String> getAllTestCommands ()

כדי לשמור על עקביות, צריך להמיר את mBinaryPaths ל-mTestCommands.

החזרות
Map<String, String>	‫MapLinkedHashMap<string, string=""> של testCommands. </string,>

getConfiguration

protected IConfiguration getConfiguration ()

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

החזרות
IConfiguration	‫IConfiguration

getFilterDescriptions

protected TestDescription[] getFilterDescriptions (Map<String, String> testCommands)

פרמטרים
testCommands	Map

החזרות
TestDescription[]

getModuleId

protected String getModuleId (IInvocationContext context)

פרמטרים
context	IInvocationContext

החזרות
String

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

החזרות
long	הזמן הקצוב לתפוגה שחל על כל קובץ בינארי לצורך ההרצה שלו.

isTestFailed

protected boolean isTestFailed (String testName)

פרמטרים
testName	String

חזרה לרצף השגרה
boolean