ตั้งแต่ปี 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.

IsolatedHostTest

public class IsolatedHostTest
extends Object implements IBuildReceiver, IConfigurationReceiver, IRemoteTest, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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

ใช้โปรแกรมเรียกใช้ TradeFed ที่ใช้กระบวนการย่อยเพื่อเรียกใช้การทดสอบในสภาพแวดล้อมที่มีการพึ่งพาน้อย แทนที่จะเรียกใช้ในกระบวนการหลัก

โปรแกรมเรียกใช้นี้ถือว่าไฟล์ JAR ทั้งหมดที่กำหนดค่าอยู่ในไดเรกทอรีการทดสอบเดียวกัน และ เปิดใช้กระบวนการย่อยในไดเรกทอรีนั้น เนื่องจากต้องเลือกไดเรกทอรีการทำงานสำหรับกระบวนการย่อย และการทดสอบจำนวนมากได้รับประโยชน์จากการที่ไดเรกทอรีนั้นเป็นไดเรกทอรีการทดสอบ จึงถือเป็นทางออกที่ดีที่สุด

สรุป

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

เมธอดสาธารณะ
`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()` ลบตัวกรองรวมทั้งหมดที่ติดตามอยู่ในปัจจุบัน
`String`	`compileClassPath()` สร้างคลาสพาธสำหรับกระบวนการย่อยซึ่งรวมไฟล์ JAR ที่จำเป็นในการเรียกใช้การทดสอบ
`List<String>`	`compileCommandArgs(String classpath, File artifactsDir)` รวบรวมอาร์กิวเมนต์คำสั่งเพื่อเรียกใช้โปรแกรมเรียกใช้กระบวนการย่อย
`void`	`deleteTempFiles()`
`File`	`getCoverageExecFile()`
`Set<String>`	`getExcludeAnnotations()` แสดงผล `Set` ปัจจุบันของคำอธิบายประกอบที่จะยกเว้น
`Set<String>`	`getExcludeFilters()` แสดงผล`Set`ปัจจุบันของตัวกรองยกเว้น
`Set<String>`	`getIncludeAnnotations()` แสดงผล`Set`ปัจจุบันของคำอธิบายประกอบที่จะรวมไว้
`Set<String>`	`getIncludeFilters()` แสดงผล `Set` ปัจจุบันของตัวกรองรวม
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` เรียกใช้การทดสอบและรายงานผลลัพธ์ไปยังผู้ฟัง
`void`	`setBuild(IBuildInfo build)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` เปิดหรือปิดใช้โหมดการรวบรวมการทดสอบ
`void`	`setConfiguration(IConfiguration configuration)` แทรก `IConfiguration` ที่ใช้งานอยู่
`void`	`setDebug(boolean debug)`
`Collection<IRemoteTest>`	`split(int shardCount)` เวอร์ชันทางเลือกของ `split()` ซึ่งยังระบุ shardCount ที่พยายามเรียกใช้ด้วย
`void`	`uploadTestArtifacts(File logDir, ITestInvocationListener listener)`
`boolean`	`useRavenwoodResources()`
`boolean`	`useRobolectricResources()`

วิธีการที่ได้รับการป้องกัน
`String`	`compileLdLibraryPathInner(String androidHostOut)` เราเรียกใช้เวอร์ชันนี้จากการทดสอบหน่วยและส่ง ANDROID_HOST_OUT โดยตรง
`File`	`getJarFile(String jarName, TestInformation testInfo)` คัดลอกจาก HostTest เพื่อเลียนแบบการใช้ประโยชน์จากการทดสอบหน่วย
`void`	`setServer(ServerSocket server)`

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

IsolatedHostTest

public IsolatedHostTest ()

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

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

ลบตัวกรองรวมทั้งหมดที่ติดตามอยู่ในปัจจุบัน

compileClassPath

public String compileClassPath ()

สร้างคลาสพาธสำหรับกระบวนการย่อยซึ่งรวมไฟล์ JAR ที่จำเป็นในการเรียกใช้การทดสอบ

การคืนสินค้า
`String`	สตริงที่ระบุเส้นทางคลาสที่คั่นด้วยโคลอน

compileCommandArgs

public List<String> compileCommandArgs (String classpath, 
                File artifactsDir)

รวบรวมอาร์กิวเมนต์คำสั่งเพื่อเรียกใช้โปรแกรมเรียกใช้กระบวนการย่อย

พารามิเตอร์
`classpath`	`String`
`artifactsDir`	`File`

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

deleteTempFiles

public void deleteTempFiles ()

getCoverageExecFile

public File getCoverageExecFile ()

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

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>`

โฮมรัน

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

ส่ง
`DeviceNotAvailableException`

setBuild

public void setBuild (IBuildInfo build)

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

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

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

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

setDebug

public void setDebug (boolean debug)

พารามิเตอร์
`debug`	`boolean`

แยก

public Collection<IRemoteTest> split (int shardCount)

เวอร์ชันทางเลือกของ split() ซึ่งยังระบุ shardCount ที่พยายามเรียกใช้ด้วย ซึ่งจะเป็นประโยชน์สำหรับโปรแกรมเรียกใช้การทดสอบบางรายการที่บางครั้งไม่สามารถตัดสินใจได้โดยพลการ

พารามิเตอร์
`shardCount`	`int`: จำนวนชาร์ดที่พยายาม

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

uploadTestArtifacts

public void uploadTestArtifacts (File logDir, 
                ITestInvocationListener listener)

พารามิเตอร์
`logDir`	`File`
`listener`	`ITestInvocationListener`

useRavenwoodResources

public boolean useRavenwoodResources ()

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

useRobolectricResources

public boolean useRobolectricResources ()

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

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

compileLdLibraryPathInner

protected String compileLdLibraryPathInner (String androidHostOut)

เราเรียกใช้เวอร์ชันนี้จากการทดสอบหน่วยและส่ง ANDROID_HOST_OUT โดยตรง เราจำเป็นต้องใช้เพราะ Java ไม่มี API สำหรับตั้งค่าตัวแปรสภาพแวดล้อม

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

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

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

คัดลอกจาก HostTest เพื่อเลียนแบบการใช้ประโยชน์จากการทดสอบหน่วย

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

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

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

ส่ง
`FileNotFoundException`

setServer

protected void setServer (ServerSocket server)

พารามิเตอร์
`server`	`ServerSocket`