החל משנת 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.

AndroidJUnitTest

public class AndroidJUnitTest
extends InstrumentationTest implements IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestFileFilterReceiver, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.InstrumentationTest
	↳	com.android.tradefed.testtype.AndroidJUnitTest

בדיקה שמריצה חבילת בדיקות אינסטרומנטציה במכשיר נתון באמצעות android.support.test.runner.AndroidJUnitRunner.

סיכום

ערכים קבועים
`String`	`EXCLUDE_COLLECTOR_FILTER_KEY`
`String`	`INCLUDE_COLLECTOR_FILTER_KEY` אפשרויות מספריית העזר בצד המאסף.
`String`	`NEW_RUN_LISTENER_ORDER_KEY` ארגומנט של כלי להרצת בדיקות אינסטרומנטציה שמשמש להפעלת הסדר החדש `RunListener` בצד המכשיר.
`String`	`USE_TEST_STORAGE_SERVICE`

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

‫methods ציבוריים
`void`	`addAllExcludeAnnotation(Set<String> excludeAnnotations)` מוסיף `Set` של הערות להחרגה אם בדיקה מסומנת בהן.
`void`	`addAllExcludeFilters(Set<String> filters)` הוספת `Set` של מסננים של בדיקות להחרגה.
`void`	`addAllIncludeAnnotation(Set<String> annotations)` מוסיף `Set` של הערות שייכללו אם הבדיקה מסומנת בהן.
`void`	`addAllIncludeFilters(Set<String> filters)` הוספה של `Set` של פילטרים של בדיקות שרוצים לכלול.
`void`	`addExcludeAnnotation(String excludeAnnotation)` הוספת הערה להחרגה אם בדיקה מסומנת בה.
`void`	`addExcludeFilter(String filter)` הוספת מסנן להחרגת בדיקות מסוימות.
`void`	`addIncludeAnnotation(String annotation)` מוסיף הערה שתצורף אם הבדיקה תסומן בה.
`void`	`addIncludeFilter(String filter)` הוספת מסנן של הבדיקות שרוצים לכלול.
`void`	`clearExcludeAnnotations()` מחיקה של כל הערות ההחרגה שנמצאות כרגע במעקב.
`void`	`clearExcludeFilters()` מחיקה של כל מסנני ההחרגה שנמצאים כרגע במעקב.
`void`	`clearIncludeAnnotations()` מחיקה של כל ההערות מסוג include שנמצאות כרגע במעקב.
`void`	`clearIncludeFilters()` מחיקה של כל מסנני ההכללה שנמצאים כרגע במעקב.
`Set<String>`	`getExcludeAnnotations()` הפונקציה מחזירה את `Set` הנוכחי של ההערות שצריך להחריג.
`Set<String>`	`getExcludeFilters()` הפונקציה מחזירה את הערך הנוכחי `Set` של מסנני החרגה.
`File`	`getExcludeTestFile()` הפונקציה מחזירה את הקובץ שמכיל את הבדיקות שלא נכללו.
`Set<String>`	`getIncludeAnnotations()` הפונקציה מחזירה את `Set` הנוכחי של ההערות שרוצים לכלול.
`Set<String>`	`getIncludeFilters()` הפונקציה מחזירה את `Set` הנוכחי של מסנני הכללה.
`File`	`getIncludeTestFile()` מחזירה את הקובץ שמכיל את הבדיקות הכלולות.
`long`	`getRuntimeHint()` הפונקציה מחזירה את זמן הריצה הצפוי של הבדיקה באלפיות השנייה.
`boolean`	`isClassOrMethod(String filter)` הפונקציה מחזירה תשובה אם מחרוזת היא שם של מחלקה או שיטה.
`boolean`	`isParameterizedTest(String filter)` הפונקציה מחזירה אם מחרוזת היא בדיקה עם פרמטרים.
`boolean`	`isRegex(String filter)` הפונקציה מחזירה ערך אם מחרוזת היא ביטוי רגולרי לסינון.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` מריץ את הבדיקות ומדווח על התוצאה למאזין.
`void`	`setExcludeTestFile(File testFile)` הגדרת קובץ הבדיקה של החרגות.
`void`	`setIncludeTestFile(File testFile)` מגדיר את קובץ הבדיקה של כולל.
`Collection<IRemoteTest>`	`split(int shardCount)` גרסה חלופית של `split()` שמספקת גם את shardCount שמנסים להפעיל.

שיטות מוגנות
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

ערכים קבועים

EXCLUDE_COLLECTOR_FILTER_KEY

public static final String EXCLUDE_COLLECTOR_FILTER_KEY

ערך קבוע: "exclude-filter-group"

INCLUDE_COLLECTOR_FILTER_KEY

public static final String INCLUDE_COLLECTOR_FILTER_KEY

אפשרויות מספריית העזר בצד המאסף.

ערך קבוע: "include-filter-group"

NEW_RUN_LISTENER_ORDER_KEY

public static final String NEW_RUN_LISTENER_ORDER_KEY

ארגומנט של כלי להרצת בדיקות אינסטרומנטציה שמשמש להפעלת הסדר החדש של RunListener בצד המכשיר.

ערך קבוע: "newRunListenerMode"

USE_TEST_STORAGE_SERVICE

public static final String USE_TEST_STORAGE_SERVICE

ערך קבוע: "useTestStorageService"

‫constructors ציבוריים

AndroidJUnitTest

public AndroidJUnitTest ()

‫methods ציבוריים

addAllExcludeAnnotation

public void addAllExcludeAnnotation (Set<String> excludeAnnotations)

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

פרמטרים
`excludeAnnotations`	`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 excludeAnnotation)

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

פרמטרים
`excludeAnnotation`	`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 ()

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

getExcludeAnnotations

public Set<String> getExcludeAnnotations ()

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

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

getExcludeFilters

public Set<String> getExcludeFilters ()

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

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

getExcludeTestFile

public File getExcludeTestFile ()

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

החזרות
`File`

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

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

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

getIncludeFilters

public Set<String> getIncludeFilters ()

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

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

getIncludeTestFile

public File getIncludeTestFile ()

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

החזרות
`File`

getRuntimeHint

public long getRuntimeHint ()

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

החזרות
`long`

isClassOrMethod

public boolean isClassOrMethod (String filter)

הפונקציה מחזירה תשובה אם מחרוזת היא שם של מחלקה או שיטה.

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

החזרות
`boolean`

isParameterizedTest

public boolean isParameterizedTest (String filter)

הפונקציה מחזירה אם מחרוזת היא בדיקה עם פרמטרים.

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

החזרות
`boolean`

isRegex

public boolean isRegex (String filter)

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

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

החזרות
`boolean`

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

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

setExcludeTestFile

public void setExcludeTestFile (File testFile)

הגדרת קובץ הבדיקה של החרגות. הפונקציה לא מוודאת ש-testFile קיים או שהוא קובץ.

פרמטרים
`testFile`	`File`

setIncludeTestFile

public void setIncludeTestFile (File testFile)

מגדיר את קובץ הבדיקה של כולל. הפונקציה לא מוודאת ש-testFile קיים או שהוא קובץ.

פרמטרים
`testFile`	`File`

פיצול

public Collection<IRemoteTest> split (int shardCount)

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

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

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

שיטות מוגנות

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

פרמטרים
`runner`	`IRemoteAndroidTestRunner`