החל משנת 2026, כדי להתאים את התהליך למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור תוספים ל-AOSP ולתרום לו, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main. ענף המניפסט android-latest-release תמיד יפנה לגרסה העדכנית ביותר שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

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( filters)` הוספה של `ERROR(/Set)` של מסננים של בדיקות להחרגה.
`void`	`addAllIncludeFilters( filters)` הוספה של `ERROR(/Set)` של פילטרים של בדיקות שרוצים לכלול.
`void`	`addExcludeFilter(String filter)` הוספת מסנן להחרגת בדיקות מסוימות.
`void`	`addIncludeFilter(String filter)` הוספת מסנן של הבדיקות שרוצים לכלול.
`void`	`clearExcludeFilters()` מחיקה של כל מסנני ההחרגה שנמצאים כרגע במעקב.
`void`	`clearIncludeFilters()` מחיקה של כל מסנני ההכללה שנמצאים כרגע במעקב.
`abstract String`	`findBinary(String binary)` מחפשים את הקובץ הבינארי כדי להריץ אותו.
`IAbi`	`getAbi()`
`boolean`	`getCollectTestsOnly()`
	`getExcludeFilters()` הפונקציה מחזירה את `ERROR(/Set)` הנוכחי של מסנני החרגה.
	`getIncludeFilters()` מחזירה את `ERROR(/Set)` הנוכחי של מסנני הכללה.
`final long`	`getRuntimeHint()` הפונקציה מחזירה את זמן הריצה הצפוי של הבדיקה באלפיות השנייה.
	`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`	`split(int shardHint)` גרסה חלופית של `split()` שמספקת גם את shardCount שהניסיון להפעיל אותו מתבצע.

שיטות מוגנות
`boolean`	`doesRunBinaryGenerateTestResults()`
`boolean`	`doesRunBinaryGenerateTestRuns()`
	`getAllTestCommands()` כדי לשמור על עקביות, צריך להמיר את mBinaryPaths ל-mTestCommands.
`IConfiguration`	`getConfiguration()` מחזירה את ההגדרה לבדיקה.
`TestDescription[]`	`getFilterDescriptions( 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 ( 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`

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

findBinary

public abstract String findBinary (String binary)

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

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

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

זריקות
`DeviceNotAvailableException`

getAbi

public IAbi getAbi ()

החזרות
`IAbi`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

החזרות
`boolean`

getExcludeFilters

public  getExcludeFilters ()

הפונקציה מחזירה את ERROR(/Set) הנוכחי של מסנני החרגה.

החזרות

getIncludeFilters

public  getIncludeFilters ()

מחזירה את ERROR(/Set) הנוכחי של מסנני הכללה.

החזרות

getRuntimeHint

public final long getRuntimeHint ()

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

החזרות
`long`

reportDependencies

public  reportDependencies ()

החזרות

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

זריקות
`DeviceNotAvailableException`

runBinary

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

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

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

זריקות
`DeviceNotAvailableException`

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  split (int shardHint)

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

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

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

שיטות מוגנות

doesRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

החזרות
`boolean`

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

החזרות
`boolean`

getAllTestCommands

protected  getAllTestCommands ()

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

החזרות
	‫Map`ERROR(/LinkedHashMap)`<string, string=""> של testCommands. </string,>

getConfiguration

protected IConfiguration getConfiguration ()

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

החזרות
`IConfiguration`	‫IConfiguration

getFilterDescriptions

protected TestDescription[] getFilterDescriptions ( testCommands)

פרמטרים
`testCommands`

החזרות
`TestDescription[]`

getModuleId

protected String getModuleId (IInvocationContext context)

פרמטרים
`context`	`IInvocationContext`

החזרות
`String`

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

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

isTestFailed

protected boolean isTestFailed (String testName)

פרמטרים
`testName`	`String`

החזרות
`boolean`