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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IsolatedHostTest

public class IsolatedHostTest
extends Object implements IBuildReceiver, IConfigurationReceiver, IRemoteTest, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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

הטמעה של רכיב TradeFed runner שמשתמש בתהליך משנה כדי להריץ את הבדיקות בסביבה עם תלות נמוכה, במקום להריץ אותן בתהליך הראשי.

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

סיכום

‫constructors ציבוריים
`IsolatedHostTest()`

‫methods ציבוריים
`void`	`addAllExcludeAnnotation(Set<String> notAnnotations)` מוסיף `Set` של הערות להחרגה אם בדיקה מסומנת בהן.
`void`	`addAllExcludeFilters(Set<String> filters)` הוספת `Set` של מסננים של בדיקות להחרגה.
`void`	`addAllIncludeAnnotation(Set<String> annotations)` מוסיף `Set` של הערות שייכללו אם הבדיקה מסומנת בהן.
`void`	`addAllIncludeFilters(Set<String> filters)` הוספה של `Set` של פילטרים של בדיקות שרוצים לכלול.
`void`	`addExcludeAnnotation(String notAnnotation)` הוספת הערה להחרגה אם בדיקה מסומנת בה.
`void`	`addExcludeFilter(String filter)` הוספת מסנן להחרגת בדיקות מסוימות.
`void`	`addIncludeAnnotation(String annotation)` מוסיף הערה שתצורף אם הבדיקה תסומן בה.
`void`	`addIncludeFilter(String filter)` הוספת מסנן של הבדיקות שרוצים לכלול.
`void`	`clearExcludeAnnotations()` מחיקה של כל הערות ההחרגה שנמצאות כרגע במעקב.
`void`	`clearExcludeFilters()` מחיקה של כל מסנני ההחרגה שנמצאים כרגע במעקב.
`void`	`clearIncludeAnnotations()` מחיקה של כל ההערות מסוג include שנמצאות כרגע במעקב.
`void`	`clearIncludeFilters()` מחיקה של כל מסנני ההכללה שנמצאים כרגע במעקב.
`String`	`compileClassPath()` יוצר נתיב מחלקות לתהליך המשנה שכולל את קובצי ה-JAR הדרושים להרצת הבדיקות
`List<String>`	`compileCommandArgs(String classpath, File artifactsDir)` מרכיב את ארגומנטי הפקודה כדי להפעיל את רכיב ההפעלה של תהליך המשנה.
`void`	`deleteTempFiles()`
`File`	`getCoverageExecFile()`
`Set<String>`	`getExcludeAnnotations()` הפונקציה מחזירה את `Set` הנוכחי של ההערות שצריך להחריג.
`Set<String>`	`getExcludeFilters()` הפונקציה מחזירה את הערך הנוכחי `Set` של מסנני החרגה.
`Set<String>`	`getIncludeAnnotations()` הפונקציה מחזירה את `Set` הנוכחי של ההערות שרוצים לכלול.
`Set<String>`	`getIncludeFilters()` הפונקציה מחזירה את `Set` הנוכחי של מסנני הכללה.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` מריץ את הבדיקות ומדווח על התוצאה למאזין.
`void`	`setBuild(IBuildInfo build)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` המתג מפעיל או משבית את מצב איסוף הבדיקות
`void`	`setConfiguration(IConfiguration configuration)` הוספת ה-`IConfiguration` שנמצא בשימוש.
`void`	`setDebug(boolean debug)`
`Collection<IRemoteTest>`	`split(int shardCount)` גרסה חלופית של `split()` שמספקת גם את shardCount שמנסים להפעיל.
`void`	`uploadTestArtifacts(File logDir, ITestInvocationListener listener)`
`boolean`	`useRavenwoodResources()`
`boolean`	`useRobolectricResources()`

שיטות מוגנות
`String`	`compileLdLibraryPathInner(String androidHostOut)` אנחנו קוראים לגרסה הזו מבדיקת היחידה ומעבירים ישירות את ANDROID_HOST_OUT.
`File`	`getJarFile(String jarName, TestInformation testInfo)` הועתק מ-HostTest כדי לחקות את מסגרת הבדיקה שלו.
`void`	`setServer(ServerSocket server)`

‫constructors ציבוריים

IsolatedHostTest

public IsolatedHostTest ()

‫methods ציבוריים

addAllExcludeAnnotation

public void addAllExcludeAnnotation (Set<String> notAnnotations)

מוסיף Set של הערות להחרגה אם בדיקה מסומנת בהן.

פרמטרים
`notAnnotations`	`Set`

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

הוספת Set של מסננים של בדיקות להחרגה.

פרמטרים
`filters`	`Set`

addAllIncludeAnnotation

public void addAllIncludeAnnotation (Set<String> annotations)

מוסיף Set של הערות שייכללו אם הבדיקה מסומנת בהן.

פרמטרים
`annotations`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

הוספה של Set של פילטרים של בדיקות שרוצים לכלול.

פרמטרים
`filters`	`Set`

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

הוספת הערה להחרגה אם בדיקה מסומנת בה.

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

addExcludeFilter

public void addExcludeFilter (String filter)

הוספת מסנן להחרגת בדיקות מסוימות.

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

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

מוסיף הערה שתצורף אם הבדיקה תסומן בה.

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

addIncludeFilter

public void addIncludeFilter (String filter)

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

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

clearExcludeAnnotations

public void clearExcludeAnnotations ()

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

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeAnnotations

public void clearIncludeAnnotations ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

compileClassPath

public String compileClassPath ()

יוצר נתיב מחלקה לתהליך המשנה שכולל את קובצי ה-JAR הדרושים להרצת הבדיקות

החזרות
`String`	מחרוזת שמציינת את נתיב המחלקות (classpath) עם הפרדה באמצעות נקודתיים.

compileCommandArgs

public List<String> compileCommandArgs (String classpath, 
                File artifactsDir)

מרכיב את ארגומנטי הפקודה כדי להפעיל את רכיב ההפעלה של תהליך המשנה.

פרמטרים
`classpath`	`String`
`artifactsDir`	`File`

החזרות
`List<String>`

deleteTempFiles

public void deleteTempFiles ()

getCoverageExecFile

public File getCoverageExecFile ()

החזרות
`File`

getExcludeAnnotations

public Set<String> getExcludeAnnotations ()

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

החזרות
`Set<String>`

getExcludeFilters

public Set<String> getExcludeFilters ()

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

החזרות
`Set<String>`

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

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

החזרות
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

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

החזרות
`Set<String>`

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

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

setBuild

public void setBuild (IBuildInfo build)

פרמטרים
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

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

פרמטרים
`configuration`	`IConfiguration`

setDebug

public void setDebug (boolean debug)

פרמטרים
`debug`	`boolean`

פיצול

public Collection<IRemoteTest> split (int shardCount)

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

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

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

uploadTestArtifacts

public void uploadTestArtifacts (File logDir, 
                ITestInvocationListener listener)

פרמטרים
`logDir`	`File`
`listener`	`ITestInvocationListener`

useRavenwoodResources

public boolean useRavenwoodResources ()

החזרות
`boolean`

useRobolectricResources

public boolean useRobolectricResources ()

החזרות
`boolean`

שיטות מוגנות

compileLdLibraryPathInner

protected String compileLdLibraryPathInner (String androidHostOut)

אנחנו קוראים לגרסה הזו מבדיקת היחידה ומעבירים ישירות את ANDROID_HOST_OUT. אנחנו צריכים את זה כי ל-Java אין API להגדרת משתני סביבה.

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

החזרות
`String`

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

הועתק מ-HostTest כדי לחקות את מסגרת הבדיקה שלו.

כדי למצוא את קובץ ה-JAR, צריך לבדוק כמה מיקומים שבהם בדרך כלל נמצאים הארטיפקטים בתרחישי שימוש שונים.

פרמטרים
`jarName`	`String`
`testInfo`	`TestInformation`

החזרות
`File`

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

setServer

protected void setServer (ServerSocket server)

פרמטרים
`server`	`ServerSocket`