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

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

DeviceTestCase

public class DeviceTestCase
extends MetricTestCase implements IDeviceTest, IRemoteTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	com.android.tradefed.testtype.MetricTestCase
			↳	com.android.tradefed.testtype.DeviceTestCase

מקרה בדיקה מסוג JUnit שמספק את השירותים IRemoteTest ו-IDeviceTest.

זה שימושי אם רוצים להטמיע בדיקות שפועלות לפי התבנית של JUnit להגדרת בדיקות, ועדיין לקבל תמיכה מלאה בתכונות אחרות של Tradefed כמו Options

סיכום

שדות
`protected Set<String>`	`mExcludeAnnotation` החרגת ההערות של הבדיקה להפעלה
`protected Set<String>`	`mExcludeFilters` מסנני ההחרגה של שם הבדיקה להפעלה
`protected Set<String>`	`mIncludeAnnotation` הערות שכלולות בבדיקה להפעלה
`protected Set<String>`	`mIncludeFilters` מסנני הכללה של שם הבדיקה להפעלה

‫constructors ציבוריים
`DeviceTestCase()`
`DeviceTestCase(String name)`

‫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()` מחיקה של כל מסנני ההכללה שנמצאים כרגע במעקב.
`int`	`countTestCases()`
`ITestDevice`	`getDevice()` משיגים את המכשיר שנבדק.
`Set<String>`	`getExcludeAnnotations()` הפונקציה מחזירה את `Set` הנוכחי של ההערות שצריך להחריג.
`Set<String>`	`getExcludeFilters()` הפונקציה מחזירה את הערך הנוכחי `Set` של מסנני החרגה.
`Set<String>`	`getIncludeAnnotations()` הפונקציה מחזירה את `Set` הנוכחי של ההערות שרוצים לכלול.
`Set<String>`	`getIncludeFilters()` הפונקציה מחזירה את `Set` הנוכחי של מסנני הכללה.
`void`	`run(TestResult result)` מחליפים את שיטת האב כדי להריץ את כל שיטות הבדיקה אם שיטת הבדיקה להרצה היא null.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` מריץ את הבדיקות ומדווח על התוצאה למאזין.
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` המתג מפעיל או משבית את מצב איסוף הבדיקות
`void`	`setDevice(ITestDevice device)` מזריקים את המכשיר שנבדק.

שדות

mExcludeAnnotation

protected Set<String> mExcludeAnnotation

החרגת ההערות של הבדיקה להפעלה

mExcludeFilters

protected Set<String> mExcludeFilters

מסנני ההחרגה של שם הבדיקה להפעלה

mIncludeAnnotation

protected Set<String> mIncludeAnnotation

הערות שכלולות בבדיקה להפעלה

mIncludeFilters

protected Set<String> mIncludeFilters

מסנני הכללה של שם הבדיקה להפעלה

‫constructors ציבוריים

DeviceTestCase

public DeviceTestCase ()

DeviceTestCase

public DeviceTestCase (String name)

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

‫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 ()

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

countTestCases

public int countTestCases ()

החזרות
`int`

getDevice

public ITestDevice getDevice ()

משיגים את המכשיר שנבדק.

החזרות
`ITestDevice`	‫`ITestDevice`

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 (TestResult result)

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

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

פרמטרים
`result`	`TestResult`

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

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

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setDevice

public void setDevice (ITestDevice device)

מזריקים את המכשיר שנבדק.

פרמטרים
`device`	‫`ITestDevice`: `ITestDevice` שבו רוצים להשתמש