ตั้งแต่ปี 2026 เป็นต้นไป เราจะเผยแพร่ซอร์สโค้ดไปยัง AOSP ในไตรมาสที่ 2 และ 4 เพื่อให้สอดคล้องกับโมเดลการพัฒนาแบบ Trunk Stable และรับประกันความเสถียรของแพลตฟอร์มสำหรับระบบนิเวศ หากต้องการสร้างและมีส่วนร่วมใน 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.

HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IDiscoverTestClasses, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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

คลาสย่อยโดยตรงที่ทราบ

JarHostTest

JarHostTest โปรแกรมเรียกใช้การทดสอบสำหรับการทดสอบ JUnit ฝั่งโฮสต์

โปรแกรมเรียกใช้การทดสอบสำหรับการทดสอบที่อิงตามโฮสต์ JUnit หากการทดสอบที่จะเรียกใช้ใช้ IDeviceTest ตัวเรียกใช้นี้จะส่งต่อการอ้างอิงไปยังอุปกรณ์

สรุป

ค่าคงที่
`String`	`SET_OPTION_DESC`
`String`	`SET_OPTION_NAME`

เครื่องมือสร้างสาธารณะ
`HostTest()`

เมธอดสาธารณะ
`void`	`addAllExcludeAnnotation(Set<String> notAnnotations)` เพิ่ม `Set` ของคำอธิบายประกอบเพื่อยกเว้นหากมีการทดสอบและทำเครื่องหมายด้วยคำอธิบายประกอบนั้น
`void`	`addAllExcludeFilters(Set<String> filters)` เพิ่ม `Set` ของตัวกรองที่ต้องการยกเว้นการทดสอบ
`void`	`addAllIncludeAnnotation(Set<String> annotations)` เพิ่ม`Set`คำอธิบายประกอบที่จะรวมไว้หากมีการทดสอบที่ทำเครื่องหมายด้วยคำอธิบายประกอบนั้น
`void`	`addAllIncludeFilters(Set<String> filters)` เพิ่ม `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()` แสดงผลจำนวนกรณีทดสอบในทุกคลาสที่เป็นส่วนหนึ่งของการทดสอบ
`IAbi`	`getAbi()`
`Set<String>`	`getClassNames()`
`ITestDevice`	`getDevice()` เตรียมอุปกรณ์ภายใต้การทดสอบ
`Set<String>`	`getExcludeAnnotations()` แสดงผล `Set` ปัจจุบันของคำอธิบายประกอบที่จะยกเว้น
`Set<String>`	`getExcludeFilters()` แสดงผล`Set`ปัจจุบันของตัวกรองยกเว้น
`Set<String>`	`getIncludeAnnotations()` แสดงผล`Set`ปัจจุบันของคำอธิบายประกอบที่จะรวมไว้
`Set<String>`	`getIncludeFilters()` แสดงผล `Set` ปัจจุบันของตัวกรองรวม
`long`	`getRuntimeHint()` แสดงระยะเวลาการทำงานที่คาดไว้ของการทดสอบในหน่วยมิลลิวินาที
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` เรียกใช้การทดสอบและรายงานผลลัพธ์ไปยังผู้ฟัง
`void`	`setAbi(IAbi abi)`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` เปิดหรือปิดใช้โหมดการรวบรวมการทดสอบ
`void`	`setConfiguration(IConfiguration configuration)` แทรก `IConfiguration` ที่ใช้งานอยู่
`void`	`setDevice(ITestDevice device)` แทรกอุปกรณ์ภายใต้การทดสอบ
`static void`	`setOptionToLoadedObject(Object testObj, List<String> keyValueOptions)` Helper สำหรับ Device Runner เพื่อใช้ตั้งค่าตัวเลือกในลักษณะเดียวกับ HostTest จาก set-option
`void`	`setTestInformation(TestInformation testInfo)`
`Collection<IRemoteTest>`	`split(Integer shardCount, TestInformation testInfo)` เราจะแบ่งตามบุคคลโดยใช้คลาสหรือวิธีการทดสอบ

วิธีการที่ได้รับการป้องกัน
`HostTest`	`createHostTest(Class<?> classObj)` Helper เพื่อสร้างอินสแตนซ์ HostTest เมื่อทำการ Sharding
`IBuildInfo`	`getBuild()` รับข้อมูลบิลด์ที่ HostTest ได้รับ
`ClassLoader`	`getClassLoader()` แสดงผล ClassLoader เริ่มต้น
`final List<Class<?>>`	`getClasses()`
`File`	`getJarFile(String jarName, TestInformation testInfo)` ตรวจสอบตำแหน่งหลายแห่งที่มักมีอาร์ติแฟกต์สำหรับกรณีการใช้งานต่างๆ เพื่อค้นหาไฟล์ JAR
`boolean`	`hasJUnit4Annotation(Class<?> classObj)` Helper to determine if we are dealing with a Test class with Junit4 annotations.
`Object`	`loadObject(Class<?> classObj)` โหลดออบเจ็กต์คลาสและตั้งค่าข้อมูลการทดสอบ (อุปกรณ์, บิลด์)
`void`	`setClassName(String className)` ล้างแล้วตั้งชื่อชั้นเรียนที่จะเรียกใช้
`void`	`setMethodName(String methodName)` ตั้งชื่อเมธอดที่จะเรียกใช้
`boolean`	`shouldTestRun(AnnotatedElement annotatedElement)` ตรวจสอบว่าองค์ประกอบที่มีคำอธิบายประกอบผ่านตัวกรองหรือไม่

ค่าคงที่

SET_OPTION_DESC

public static final String SET_OPTION_DESC

ค่าคงที่: "ตัวเลือกที่จะส่งไปยังคลาสภายใต้การทดสอบ ควรคั่นคีย์และค่าด้วยโคลอน ":" เช่น หากคลาสภายใต้การทดสอบรองรับ "--iteration 1" จากบรรทัดคำสั่ง ควรส่งเป็น "--set-option iteration:1" หรือ "--set-option iteration:key=value" เพื่อส่งตัวเลือกไปยังแมป ค่าที่มี ":" หรือ "=" สามารถกำหนดเป็นอักขระหลีกด้วยแบ็กสแลชได้ คุณกำหนดเป้าหมายชั้นเรียนที่เฉพาะเจาะจงได้โดยการระบุชั้นเรียนนั้น " --set-option :

SET_OPTION_NAME

public static final String SET_OPTION_NAME

ค่าคงที่: "set-option"

เครื่องมือสร้างสาธารณะ

HostTest

public HostTest ()

เมธอดสาธารณะ

addAllExcludeAnnotation

public void addAllExcludeAnnotation (Set<String> notAnnotations)

เพิ่ม Set ของคำอธิบายประกอบเพื่อยกเว้นหากมีการทดสอบและทำเครื่องหมายด้วยคำอธิบายประกอบนั้น

พารามิเตอร์
`notAnnotations`	`Set`

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

เพิ่ม Set ของตัวกรองที่ต้องการยกเว้นการทดสอบ

พารามิเตอร์
`filters`	`Set`

addAllIncludeAnnotation

public void addAllIncludeAnnotation (Set<String> annotations)

เพิ่มSetคำอธิบายประกอบที่จะรวมไว้หากมีการทดสอบที่ทำเครื่องหมายด้วยคำอธิบายประกอบนั้น

พารามิเตอร์
`annotations`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

เพิ่ม Set ของตัวกรองที่ระบุการทดสอบที่จะรวม

พารามิเตอร์
`filters`	`Set`

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`

getAbi

public IAbi getAbi ()

การคืนสินค้า
`IAbi`

getClassNames

public Set<String> getClassNames ()

การคืนสินค้า
`Set<String>`

getDevice

public ITestDevice getDevice ()

เตรียมอุปกรณ์ภายใต้การทดสอบ

การคืนสินค้า
`ITestDevice`	`ITestDevice`

getExcludeAnnotations

public Set<String> getExcludeAnnotations ()

แสดงผล Set ปัจจุบันของคำอธิบายประกอบที่จะยกเว้น

การคืนสินค้า
`Set<String>`

getExcludeFilters

public Set<String> getExcludeFilters ()

แสดงผลSetปัจจุบันของตัวกรองยกเว้น

การคืนสินค้า
`Set<String>`

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

แสดงผลSetปัจจุบันของคำอธิบายประกอบที่จะรวมไว้

การคืนสินค้า
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

แสดงผล Set ปัจจุบันของตัวกรองรวม

การคืนสินค้า
`Set<String>`

getRuntimeHint

public long getRuntimeHint ()

แสดงระยะเวลาการทำงานที่คาดไว้ของการทดสอบในหน่วยมิลลิวินาที ระบบจะใช้เวลาในการจัดสรรภาระงานการดำเนินการที่แยกส่วน

การคืนสินค้า
`long`

โฮมรัน

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

เรียกใช้การทดสอบและรายงานผลลัพธ์ไปยังผู้ฟัง

พารามิเตอร์
`testInfo`	`TestInformation`: ออบเจ็กต์ `TestInformation` ที่มีข้อมูลที่เป็นประโยชน์ในการเรียกใช้การทดสอบ
`listener`	`ITestInvocationListener`: `ITestInvocationListener` ของผลการทดสอบ

ส่ง
`DeviceNotAvailableException`

setAbi

public void setAbi (IAbi abi)

พารามิเตอร์
`abi`	`IAbi`

setBuild

public void setBuild (IBuildInfo buildInfo)

พารามิเตอร์
`buildInfo`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

เปิดหรือปิดใช้โหมดการรวบรวมการทดสอบ

setConfiguration

public void setConfiguration (IConfiguration configuration)

แทรก IConfiguration ที่ใช้งานอยู่

พารามิเตอร์
`configuration`	`IConfiguration`

setDevice

public void setDevice (ITestDevice device)

แทรกอุปกรณ์ภายใต้การทดสอบ

พารามิเตอร์
`device`	`ITestDevice`: `ITestDevice` ที่จะใช้

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                List<String> keyValueOptions)

Helper สำหรับ Device Runner เพื่อใช้ตั้งค่าตัวเลือกในลักษณะเดียวกับ HostTest จาก set-option

พารามิเตอร์
`testObj`	`Object`: ออบเจ็กต์ที่จะรับตัวเลือก
`keyValueOptions`	`List`: รายการตัวเลือกที่จัดรูปแบบตามที่ HostTest set-option ต้องการ

setTestInformation

public void setTestInformation (TestInformation testInfo)

พารามิเตอร์
`testInfo`	`TestInformation`

แยก

public Collection<IRemoteTest> split (Integer shardCount, 
                TestInformation testInfo)

เราจะแบ่งตามบุคคลโดยใช้คลาสหรือวิธีการทดสอบ

พารามิเตอร์
`shardCount`	`Integer`: จำนวนชาร์ดที่พยายาม
`testInfo`	`TestInformation`: ผู้ปกครอง `TestInformation`

การคืนสินค้า
`Collection<IRemoteTest>`	ชุดการทดสอบย่อยที่จะดำเนินการแยกกันหรือ `null` หากการทดสอบ ยังไม่สามารถแยกส่วนได้ในขณะนี้

วิธีการที่ได้รับการป้องกัน

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Helper เพื่อสร้างอินสแตนซ์ HostTest เมื่อทำการ Sharding ลบล้างเพื่อส่งคืนรายการย่อยจาก HostTest

พารามิเตอร์
`classObj`	`Class`

การคืนสินค้า
`HostTest`

getBuild

protected IBuildInfo getBuild ()

รับข้อมูลบิลด์ที่ HostTest ได้รับ

การคืนสินค้า
`IBuildInfo`	`IBuildInfo`

getClassLoader

protected ClassLoader getClassLoader ()

แสดงผล ClassLoader เริ่มต้น

การคืนสินค้า
`ClassLoader`

getClasses

protected final List<Class<?>> getClasses ()

การคืนสินค้า
`List<Class<?>>`

ส่ง
`IllegalArgumentException`

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

ตรวจสอบตำแหน่งหลายแห่งที่มักมีอาร์ติแฟกต์สำหรับกรณีการใช้งานต่างๆ เพื่อค้นหาไฟล์ JAR

พารามิเตอร์
`jarName`	`String`
`testInfo`	`TestInformation`

การคืนสินค้า
`File`

ส่ง
`FileNotFoundException`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Helper to determine if we are dealing with a Test class with Junit4 annotations.

พารามิเตอร์
`classObj`	`Class`

การคืนสินค้า
`boolean`

loadObject

protected Object loadObject (Class<?> classObj)

โหลดออบเจ็กต์คลาสและตั้งค่าข้อมูลการทดสอบ (อุปกรณ์, บิลด์)

พารามิเตอร์
`classObj`	`Class`

การคืนสินค้า
`Object`

setClassName

protected void setClassName (String className)

ล้างแล้วตั้งชื่อชั้นเรียนที่จะเรียกใช้

พารามิเตอร์
`className`	`String`

setMethodName

protected void setMethodName (String methodName)

ตั้งชื่อเมธอดที่จะเรียกใช้

ใช้เพื่อเรียกใช้เมธอดการทดสอบที่เฉพาะเจาะจงจากคลาสการทดสอบ

พารามิเตอร์
`methodName`	`String`

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

ตรวจสอบว่าองค์ประกอบที่มีคำอธิบายประกอบผ่านตัวกรองหรือไม่ แสดงสำหรับการทดสอบ Unit Test

การคืนสินค้า
`boolean`	false หากไม่ควรเรียกใช้การทดสอบ