ตั้งแต่วันที่ 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`	: ตำแหน่งของไฟล์ 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`