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

UiAutomatorTest

public class UiAutomatorTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

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

סיכום

שדות
`protected`	`mListeners`

Constructors ציבוריים
`UiAutomatorTest()`

‫methods ציבוריים
`void`	`addAllExcludeFilters( filters)` הוספה של `ERROR(/Set)` של מסננים של בדיקות להחרגה.
`void`	`addAllIncludeFilters( filters)` הוספה של `ERROR(/Set)` של פילטרים של בדיקות שרוצים לכלול.
`void`	`addClassName(String className)` מוסיפים שם של מחלקת בדיקה להרצה.
`void`	`addClassNames( classNames)` מוסיפים אוסף של שמות כיתות לבדיקה להפעלה.
`void`	`addExcludeFilter(String filter)` הוספת מסנן להחרגת בדיקות מסוימות.
`void`	`addIncludeFilter(String filter)` הוספת מסנן של הבדיקות שרוצים לכלול.
`void`	`addRunArg(String key, String value)` הוספת ארגומנט לאספקה בזמן הפעלת הבדיקות של UI Automator
`void`	`clearExcludeFilters()` מחיקה של כל מסנני ההחרגה שנמצאים כרגע במעקב.
`void`	`clearIncludeFilters()` מחיקה של כל מסנני ההכללה שנמצאים כרגע במעקב.
	`getClassNames()` מקבל את רשימת השמות של מחלקות הבדיקה שהוגדרו להרצה ב-harness
`ITestDevice`	`getDevice()` משיגים את המכשיר שנבדק.
	`getExcludeFilters()` הפונקציה מחזירה את `ERROR(/Set)` הנוכחי של מסנני החרגה.
	`getIncludeFilters()` מחזירה את `ERROR(/Set)` הנוכחי של מסנני הכללה.
`long`	`getSyncTime()`
	`getTestJarPaths()`
	`getTestRunArgMap()`
`IRemoteAndroidTestRunner`	`getTestRunner()`
`boolean`	`isInstrumentationTest()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` מריץ את הבדיקות ומדווח על התוצאה למאזין.
`void`	`setCaptureLogs(boolean captureLogs)` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-`setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption)`. נשמר לצורך תאימות ל-cts-tradefed
`void`	`setDevice(ITestDevice device)` מזריקים את המכשיר שנבדק.
`void`	`setLoggingOption(UiAutomatorTest.LoggingOption loggingOption)`
`void`	`setRunName(String runName)`
`void`	`setRunnerName(String runnerName)`
`void`	`setSyncTime(long syncTime)`
`void`	`setTestJarPaths( jarPaths)`
`void`	`setTestRunArgMap( runArgMap)`

שיטות מוגנות
`IRemoteAndroidTestRunner`	`createTestRunner()`
`IRunUtil`	`getRunUtil()`
`void`	`onScreenshotAndBugreport(ITestDevice device, ITestInvocationListener listener, String prefix, UiAutomatorTest.TestFailureAction overrideAction)`
`void`	`onScreenshotAndBugreport(ITestDevice device, ITestInvocationListener listener, String prefix)`
`void`	`preTestSetup()` בדיקה אם רכיבי UI Automator קיימים במכשיר

שדות

mListeners

protected  mListeners

Constructors ציבוריים

UiAutomatorTest

public UiAutomatorTest ()

‫methods ציבוריים

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

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

פרמטרים
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

פרמטרים
`filters`

addClassName

public void addClassName (String className)

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

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

addClassNames

public void addClassNames ( classNames)

מוסיפים אוסף של שמות כיתות לבדיקה להפעלה.

פרמטרים
`classNames`

addExcludeFilter

public void addExcludeFilter (String filter)

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

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

addIncludeFilter

public void addIncludeFilter (String filter)

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

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

addRunArg

public void addRunArg (String key, 
                String value)

הוספת ארגומנט לאספקה בזמן הפעלת הבדיקות של UI Automator

פרמטרים
`key`	`String`: שם הארגומנט
`value`	‫`String`: ערך הארגומנט

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

getClassNames

public  getClassNames ()

מקבל את רשימת השמות של מחלקות הבדיקה שהוגדרו להרצה ב-harness

החזרות
	רשימה של שמות כיתות לבדיקה

getDevice

public ITestDevice getDevice ()

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

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

getExcludeFilters

public  getExcludeFilters ()

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

החזרות

getIncludeFilters

public  getIncludeFilters ()

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

החזרות

getSyncTime

public long getSyncTime ()

החזרות
`long`	הזמן שהוקצה לסנכרון הבדיקות.

getTestJarPaths

public  getTestJarPaths ()

החזרות
	נתיב ה-JAR של הבדיקה.

getTestRunArgMap

public  getTestRunArgMap ()

החזרות
	מיפוי הארגומנטים להעברה אל UiAutomatorRunner.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

החזרות
`IRemoteAndroidTestRunner`	הכלי להרצת בדיקות.

isInstrumentationTest

public boolean isInstrumentationTest ()

החזרות
`boolean`

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

זריקות
`DeviceNotAvailableException`

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption).

נשמר לצורך תאימות ל-cts-tradefed

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

setDevice

public void setDevice (ITestDevice device)

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

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

setLoggingOption

public void setLoggingOption (UiAutomatorTest.LoggingOption loggingOption)

פרמטרים
`loggingOption`	`UiAutomatorTest.LoggingOption`

setRunName

public void setRunName (String runName)

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

setRunnerName

public void setRunnerName (String runnerName)

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

setSyncTime

public void setSyncTime (long syncTime)

פרמטרים
`syncTime`	‫`long`: הזמן שיידרש לסנכרון של קובצי הבדיקה.

setTestJarPaths

public void setTestJarPaths ( jarPaths)

פרמטרים
`jarPaths`	‫: המיקומים של קובצי ה-JAR של הבדיקה.

setTestRunArgMap

public void setTestRunArgMap ( runArgMap)

פרמטרים
`runArgMap`	‫: הארגומנטים להעברה אל UiAutomatorRunner.

שיטות מוגנות

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

החזרות
`IRemoteAndroidTestRunner`

זריקות
`DeviceNotAvailableException`

getRunUtil

protected IRunUtil getRunUtil ()

החזרות
`IRunUtil`

onScreenshotAndBugreport

protected void onScreenshotAndBugreport (ITestDevice device, 
                ITestInvocationListener listener, 
                String prefix, 
                UiAutomatorTest.TestFailureAction overrideAction)

פרמטרים
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`
`overrideAction`	`UiAutomatorTest.TestFailureAction`

onScreenshotAndBugreport

protected void onScreenshotAndBugreport (ITestDevice device, 
                ITestInvocationListener listener, 
                String prefix)

פרמטרים
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`

preTestSetup

protected void preTestSetup ()

בדיקה אם רכיבי UI Automator קיימים במכשיר

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`