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

דף זה תורגם על ידי Cloud Translation API.

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 להגדרת בדיקות, ועדיין לקבל תמיכה מלאה בתכונות אחרות של קוד פתוח, כמו Options

סיכום

שדות
`protected`	`mExcludeAnnotation` ההערות להחרגה של הבדיקה שרוצים להריץ
`protected`	`mExcludeFilters` מסנני ההחרגה של שם הבדיקה שרוצים להריץ
`protected`	`mIncludeAnnotation` הערות שכוללות את הבדיקה שרוצים להריץ
`protected`	`mIncludeFilters` מסנני ההכללה של שם הבדיקה שרוצים להריץ

קונסטרוקטורים גלויים לכולם
`DeviceTestCase()`
`DeviceTestCase(String name)`

שיטות ציבוריות
`void`	`addAllExcludeAnnotation( notAnnotations)` הוספת `ERROR(/Set)` של הערות להחרגה אם בדיקה מסוימת מסומנת בה.
`void`	`addAllExcludeFilters( filters)` הוספת `ERROR(/Set)` של מסננים של בדיקות שרוצים להחריג.
`void`	`addAllIncludeAnnotation( annotations)` הוספת `ERROR(/Set)` של הערות שצריך לכלול אם בדיקה מסוימת מסומנת בהן.
`void`	`addAllIncludeFilters( filters)` הוספת `ERROR(/Set)` של מסננים של בדיקות שרוצים לכלול.
`void`	`addExcludeAnnotation(String notAnnotation)` הוספת הערה להחרגה אם בדיקה מסוימת מסומנת בה.
`void`	`addExcludeFilter(String filter)` הוספת מסנן של הבדיקות שרוצים להחריג.
`void`	`addIncludeAnnotation(String annotation)` הוספת הערה שכוללת את הבדיקה אם היא מסומנת בה.
`void`	`addIncludeFilter(String filter)` הוספת מסנן של הבדיקות שרוצים לכלול.
`void`	`clearExcludeAnnotations()` מחיקה של כל ההערות להחרגה שעליהן מתבצע מעקב כרגע.
`void`	`clearExcludeFilters()` מחיקה של כל מסנני ההחרגה שנמצאים במעקב כרגע.
`void`	`clearIncludeAnnotations()` מוחקים את כל ההערות של ההכללות שעליהן מתבצע מעקב כרגע.
`void`	`clearIncludeFilters()` מחיקה של כל מסנני ההכללה שבהם מתבצע מעקב כרגע.
`int`	`countTestCases()`
`ITestDevice`	`getDevice()` מקבלים את המכשיר לבדיקה.
	`getExcludeAnnotations()` הפונקציה מחזירה את הערך הנוכחי של `ERROR(/Set)` של ההערות להחרגה.
	`getExcludeFilters()` הפונקציה מחזירה את הערך הנוכחי של `ERROR(/Set)` של מסנני החרגה.
	`getIncludeAnnotations()` הפונקציה מחזירה את הערך הנוכחי של `ERROR(/Set)` של ההערות שרוצים לכלול.
	`getIncludeFilters()` הפונקציה מחזירה את הערך הנוכחי של `ERROR(/Set)` של מסנני ההכללה.
`void`	`run(TestResult result)` שינוי ברירת המחדל של שיטת ההורה כדי להריץ את כל שיטות הבדיקה אם שיטת הבדיקה להרצה היא null.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` מפעיל את הבדיקות ומדווח על התוצאות למאזין.
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` הפעלה או השבתה של מצב אוסף הבדיקות
`void`	`setDevice(ITestDevice device)` מזריקים את המכשיר שנבדק.

שדות

mExcludeAnnotation

protected  mExcludeAnnotation

ההערות להחרגה של הבדיקה שרוצים להריץ

mExcludeFilters

protected  mExcludeFilters

מסנני ההחרגה של שם הבדיקה שרוצים להריץ

mIncludeAnnotation

protected  mIncludeAnnotation

הערות שכוללות את הבדיקה שרוצים להריץ

mIncludeFilters

protected  mIncludeFilters

מסנני ההכללה של שם הבדיקה שרוצים להריץ

קונסטרוקטורים גלויים לכולם

DeviceTestCase

public DeviceTestCase ()

DeviceTestCase

public DeviceTestCase (String name)

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

שיטות ציבוריות

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

הוספת ERROR(/Set) של הערות להחרגה אם בדיקה מסוימת מסומנת בה.

פרמטרים
`notAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

הוספת ERROR(/Set) של מסננים של בדיקות שרוצים להחריג.

פרמטרים
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

הוספת ERROR(/Set) של הערות שצריך לכלול אם בדיקה מסוימת מסומנת בהן.

פרמטרים
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

הוספת ERROR(/Set) של מסננים של בדיקות שרוצים לכלול.

פרמטרים
`filters`

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

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

clearIncludeFilters

public void clearIncludeFilters ()

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

countTestCases

public int countTestCases ()

החזרות
`int`

getDevice

public ITestDevice getDevice ()

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

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

getExcludeAnnotations

public  getExcludeAnnotations ()

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

החזרות

getExcludeFilters

public  getExcludeFilters ()

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

החזרות

getIncludeAnnotations

public  getIncludeAnnotations ()

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

החזרות

getIncludeFilters

public  getIncludeFilters ()

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

החזרות

ראן

public void run (TestResult result)

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

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

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

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

זריקות
`DeviceNotAvailableException`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setDevice

public void setDevice (ITestDevice device)

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

פרמטרים
`device`	`ITestDevice`: ה-`ITestDevice` לשימוש