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

UiAutomatorTest

public class UiAutomatorTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

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

סיכום

שדות
`protected Collection<ITestLifeCycleReceiver>`	`mListeners`

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

‫methods ציבוריים
`void`	`addAllExcludeFilters(Set<String> filters)` הוספת `Set` של מסננים של בדיקות להחרגה.
`void`	`addAllIncludeFilters(Set<String> filters)` הוספה של `Set` של פילטרים של בדיקות שרוצים לכלול.
`void`	`addClassName(String className)` מוסיפים שם של מחלקת בדיקה להפעלה.
`void`	`addClassNames(Collection<String> classNames)` מוסיפים אוסף של שמות כיתות לבדיקה להרצה.
`void`	`addExcludeFilter(String filter)` הוספת מסנן להחרגת בדיקות מסוימות.
`void`	`addIncludeFilter(String filter)` הוספת מסנן של הבדיקות שרוצים לכלול.
`void`	`addRunArg(String key, String value)` הוספת ארגומנט לאספקה כשמריצים את הבדיקות של UI Automator
`void`	`clearExcludeFilters()` מחיקה של כל מסנני ההחרגה שנמצאים כרגע במעקב.
`void`	`clearIncludeFilters()` מחיקה של כל מסנני ההכללה שנמצאים כרגע במעקב.
`List<String>`	`getClassNames()` מקבל את רשימת השמות של מחלקות הבדיקה שהמערכת מוגדרת להריץ
`ITestDevice`	`getDevice()` משיגים את המכשיר שנבדק.
`Set<String>`	`getExcludeFilters()` הפונקציה מחזירה את הערך הנוכחי `Set` של מסנני החרגה.
`Set<String>`	`getIncludeFilters()` הפונקציה מחזירה את `Set` הנוכחי של מסנני הכללה.
`long`	`getSyncTime()`
`List<String>`	`getTestJarPaths()`
`Map<String, String>`	`getTestRunArgMap()`
`IRemoteAndroidTestRunner`	`getTestRunner()`
`boolean`	`isInstrumentationTest()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` מריץ את הבדיקות ומדווח על התוצאה למאזין.
`void`	`setCaptureLogs(boolean captureLogs)` השיטה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-`setLoggingOption(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(List<String> jarPaths)`
`void`	`setTestRunArgMap(Map<String, String> 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 Collection<ITestLifeCycleReceiver> mListeners

‫constructors ציבוריים

UiAutomatorTest

public UiAutomatorTest ()

‫methods ציבוריים

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

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

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

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

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

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

addClassName

public void addClassName (String className)

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

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

addClassNames

public void addClassNames (Collection<String> classNames)

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

פרמטרים
`classNames`	`Collection`

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 List<String> getClassNames ()

מקבל את רשימת השמות של מחלקות הבדיקה שהמערכת מוגדרת להריץ

החזרות
`List<String>`	רשימה של שמות כיתות לבדיקה

getDevice

public ITestDevice getDevice ()

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

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

getExcludeFilters

public Set<String> getExcludeFilters ()

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

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

getIncludeFilters

public Set<String> getIncludeFilters ()

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

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

getSyncTime

public long getSyncTime ()

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

getTestJarPaths

public List<String> getTestJarPaths ()

החזרות
`List<String>`	נתיב ה-jar של הבדיקה.

getTestRunArgMap

public Map<String, String> getTestRunArgMap ()

החזרות
`Map<String, String>`	מיפוי הארגומנטים להעברה אל UiAutomatorRunner.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

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

isInstrumentationTest

public boolean isInstrumentationTest ()

החזרות
`boolean`

ראן

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

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

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-setLoggingOption(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 (List<String> jarPaths)

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

setTestRunArgMap

public void setTestRunArgMap (Map<String, String> runArgMap)

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

שיטות מוגנות

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

החזרות
`IRemoteAndroidTestRunner`

הקפצת הודעות שגיאה (throw)
`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 קיימים במכשיר

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`