اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

UiAutomatorTest

public class UiAutomatorTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

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

ملخّص

الحقول
`protected`	`mListeners`

وظائف الإنشاء العامة
`UiAutomatorTest()`

الطرق العامة
`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()` الحصول على قائمة بأسماء فئات الاختبار التي تم ضبط الحِزمة لتشغيلها
`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

وظائف الإنشاء العامة

UiAutomatorTest

public UiAutomatorTest ()

الطرق العامة

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

الحصول على قائمة بأسماء فئات الاختبار التي تم ضبط الحِزمة لتشغيلها

المرتجعات
	قائمة بأسماء فئات الاختبار

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`	: مواقع الجرار الاختبارية

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`