ตั้งแต่วันที่ 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 ของ Helper ที่ให้บริการ IRemoteTest และ IDeviceTest

ซึ่งมีประโยชน์ในกรณีที่คุณต้องการใช้การทดสอบที่เป็นไปตามรูปแบบการกําหนดการทดสอบของ JUnit และยังคงรองรับฟีเจอร์อื่นๆ ใน Tradefed อย่างเต็มรูปแบบ เช่น Option

สรุป

ช่อง
`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)` ลบล้างเมธอดหลักเพื่อเรียกใช้เมธอดทดสอบทั้งหมดหากเมธอดทดสอบที่จะเรียกใช้เป็นค่าว่าง
`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)

ลบล้างเมธอดหลักเพื่อเรียกใช้เมธอดทดสอบทั้งหมดหากเมธอดทดสอบที่จะเรียกใช้เป็นค่าว่าง

เฟรมเวิร์ก JUnit รองรับเฉพาะการเรียกใช้การทดสอบทั้งหมดใน TestCase โดยการรวมไว้ใน TestSuite แต่ข้อเสียของการใช้กลไกนี้ก็คือ ผู้เรียกใช้จะควบคุมวงจรชีวิตของเทสเคสของตนเองไม่ได้ ซึ่งทำให้ไม่สามารถทําสิ่งต่างๆ เช่น ให้เฟรมเวิร์กการกําหนดค่าที่ส่งผ่านข้อมูลแทรกตัวเลือกลงในเทสเคส

พารามิเตอร์
`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` ที่จะใช้