ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

คลาสย่อยโดยอ้อมที่ทราบ

TradefedSandbox

TradefedSandbox คอนเทนเนอร์แซนด์บ็อกซ์ที่เรียกใช้ Trade Federation ได้

อินเทอร์เฟซที่กําหนดแซนด์บ็อกซ์ที่ใช้เรียกใช้ได้

สรุป

เมธอดสาธารณะ
`abstract String`	`createClasspath(File workingDir)` สร้าง classpath ตามสภาพแวดล้อมและไดเรกทอรีการทำงานที่ `getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])` แสดงผล
`abstract IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` โหมดพิเศษตัดการเชื่อมต่อจากการเรียกใช้หลัก: เมื่อไม่มีการกำหนดค่าในไดเรกทอรีหลัก เราจะเปลี่ยนไปใช้ Thin Launcher ซึ่งจะพยายามตั้งค่าแซนด์บ็อกซ์ด้วยข้อมูลที่ทราบในปัจจุบัน และป้อนข้อมูลในไดเรกทอรีการทำงานเพื่อสร้างการกำหนดค่าอย่างสมบูรณ์ในไดเรกทอรีเวอร์ชัน
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration)` ขั้นตอนย่อยของ `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` ซึ่งจะค้นหาการทดสอบว่า `SandboxOptions.shouldUseTestDiscovery()` เปิดใช้อยู่หรือไม่
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` ขั้นตอนย่อยของ `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` ซึ่งดึงข้อมูลไฟล์เพิ่มเติมที่จําเป็นสําหรับแซนด์บ็อกซ์
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` แสดงผล TF ของสภาพแวดล้อมเสมือนจริงที่จะใช้ตามอาร์กิวเมนต์บรรทัดคำสั่ง
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`abstract Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` เตรียมสภาพแวดล้อมให้แซนด์บ็อกซ์ทํางานได้อย่างถูกต้อง
`abstract CommandResult`	`run(TestInformation info, IConfiguration configuration, ITestLogger logger)` เรียกใช้แซนด์บ็อกซ์ด้วยสภาพแวดล้อมที่ตั้งไว้
`abstract void`	`tearDown()` ล้างสถานะ ไฟล์ หรือสภาพแวดล้อมที่อาจมีการเปลี่ยนแปลง

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

createClasspath

public abstract String createClasspath (File workingDir)

สร้าง classpath ตามสภาพแวดล้อมและไดเรกทอรีการทำงานที่ getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) แสดงผล

พารามิเตอร์
`workingDir`	`File`: ไดเรกทอรีที่ใช้งานอยู่ในปัจจุบันสำหรับแซนด์บ็อกซ์

คิกรีเทิร์น
`String`	เส้นทางคลาสที่จะใช้

การโยน
`ConfigurationException`

createThinLauncherConfig

public abstract IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

โหมดพิเศษตัดการเชื่อมต่อจากการเรียกใช้หลัก: เมื่อไม่มีการกำหนดค่าในไดเรกทอรีหลัก เราจะเปลี่ยนไปใช้ Thin Launcher ซึ่งจะพยายามตั้งค่าแซนด์บ็อกซ์ด้วยข้อมูลที่ทราบในปัจจุบัน และป้อนข้อมูลในไดเรกทอรีการทำงานเพื่อสร้างการกำหนดค่าอย่างสมบูรณ์ในไดเรกทอรีเวอร์ชัน

พารามิเตอร์
`args`	`String`: อาร์กิวเมนต์บรรทัดคำสั่งเดิม
`keyStoreClient`	`IKeyStoreClient`: ไคลเอ็นต์คีย์สโตร์ปัจจุบันที่จะใช้สร้างการกำหนดค่า
`runUtil`	`IRunUtil`: `IRunUtil` ที่ใช้อยู่ในปัจจุบันเพื่อเรียกใช้คำสั่งของโฮสต์
`globalConfig`	`File`: การกําหนดค่าส่วนกลางที่จะใช้เรียกใช้กระบวนการย่อยของ TF

คิกรีเทิร์น
`IConfiguration`	ไฟล์ที่ชี้ไปยัง XML การกําหนดค่าของ TF สําหรับออบเจ็กต์ NON_VERSIONED แสดงผล Null หากสร้างการกำหนดค่าตัวเปิดใช้งานแบบ Thin ไม่ได้

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

ขั้นตอนย่อยของ prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) ซึ่งจะค้นหาการทดสอบว่า SandboxOptions.shouldUseTestDiscovery() เปิดใช้อยู่หรือไม่

พารามิเตอร์
`context`	`IInvocationContext`: การเรียกใช้ปัจจุบัน `IInvocationContext`
`configuration`	`IConfiguration`: `IConfiguration` เพื่อให้คำสั่งทำงาน

คิกรีเทิร์น
	แผนที่ของการทดสอบที่ค้นพบ หรือเป็นค่าว่างหากระบบไม่รองรับหรือทดสอบไม่สำเร็จ

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

พารามิเตอร์
`context`	`IInvocationContext`
`configuration`	`IConfiguration`
`logger`	`ITestLogger`

คิกรีเทิร์น

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

ขั้นตอนย่อยของ prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) ซึ่งดึงข้อมูลไฟล์เพิ่มเติมที่จําเป็นสําหรับแซนด์บ็อกซ์

พารามิเตอร์
`context`	`IInvocationContext`: การเรียกใช้ปัจจุบัน `IInvocationContext`
`configuration`	`IConfiguration`: `IConfiguration` เพื่อให้คำสั่งทำงาน
`args`	`String`: อาร์กิวเมนต์บรรทัดคำสั่ง

คิกรีเทิร์น
`IFolderBuildInfo`	บิลด์ที่ดึงข้อมูลสำหรับไฟล์ที่อยู่ในแซนด์บ็อกซ์เพิ่มเติม

การโยน
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	IOException
`BuildRetrievalError`
`ConfigurationException`

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

แสดงผล TF ของสภาพแวดล้อมเสมือนจริงที่จะใช้ตามอาร์กิวเมนต์บรรทัดคำสั่ง

พารามิเตอร์
`context`	`IInvocationContext`: `IInvocationContext` ของผู้ปกครอง
`nonVersionedConfig`	`IConfiguration`: `IConfiguration` ที่แสดงถึงออบเจ็กต์ที่ไม่มีเวอร์ชัน
`args`	`String`: อาร์กิวเมนต์บรรทัดคำสั่ง

คิกรีเทิร์น
`File`	ไดเรกทอรี `ERROR(/File)` ที่มี Jar สภาพแวดล้อมแซนด์บ็อกซ์ TF

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

พารามิเตอร์
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

คิกรีเทิร์น
`File`

prepareEnvironment

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

เตรียมสภาพแวดล้อมให้แซนด์บ็อกซ์ทํางานได้อย่างถูกต้อง

พารามิเตอร์
`context`	`IInvocationContext`: การเรียกใช้ปัจจุบัน `IInvocationContext`
`configuration`	`IConfiguration`: `IConfiguration` เพื่อให้คำสั่งทำงาน
`listener`	`ITestInvocationListener`: การเรียกใช้ปัจจุบัน `ITestInvocationListener` ที่ควรส่งผ่านผลลัพธ์สุดท้าย

คิกรีเทิร์น
`Exception`	`Exception` ที่มีข้อมูลการดําเนินการที่ไม่สําเร็จ หรือ Null หากสําเร็จ

โฮมรัน

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

เรียกใช้แซนด์บ็อกซ์ด้วยสภาพแวดล้อมที่ตั้งไว้

พารามิเตอร์
`info`	`TestInformation`: `TestInformation` ที่อธิบายการเรียกใช้
`configuration`	`IConfiguration`: `IConfiguration` เพื่อให้คำสั่งทำงาน
`logger`	`ITestLogger`: `ITestLogger` ที่เราบันทึกไฟล์ได้

คิกรีเทิร์น
`CommandResult`	`CommandResult` พร้อมสถานะของการเรียกใช้แซนด์บ็อกซ์และบันทึก

tearDown

public abstract void tearDown ()

ล้างสถานะ ไฟล์ หรือสภาพแวดล้อมที่อาจมีการเปลี่ยนแปลง