ตั้งแต่ปี 2026 เป็นต้นไป เราจะเผยแพร่ซอร์สโค้ดไปยัง AOSP ในไตรมาสที่ 2 และ 4 เพื่อให้สอดคล้องกับโมเดลการพัฒนาที่เสถียรของ Trunk และรับประกันความเสถียรของแพลตฟอร์มสำหรับระบบนิเวศ เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main ในการสร้างและมีส่วนร่วมใน AOSP android-latest-release สาขาไฟล์ Manifest จะอ้างอิงถึงรุ่นล่าสุดที่พุชไปยัง AOSP เสมอ ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงใน AOSP

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

java.lang.Object
↳	com.android.tradefed.sandbox.TradefedSandbox

คอนเทนเนอร์แซนด์บ็อกซ์ที่เรียกใช้ Trade Federation ได้ TODO: Allow Options to be passed to the sandbox.

สรุป

ค่าคงที่
`String`	`EXTRA_TARGET_LAB`
`String`	`GENERAL_TESTS_ZIP`
`String`	`SANDBOX_ENABLED`

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

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

วิธีการที่ได้รับการป้องกัน
`File`	`dumpGlobalConfig(IConfiguration config, exclusionPatterns)` ส่งออกการกำหนดค่าส่วนกลางที่กรองจากออบเจ็กต์บางรายการ
`String`	`getJava()`
`Exception`	`prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` เตรียม `IConfiguration` ที่จะส่งไปยังกระบวนการย่อยและจะขับเคลื่อนการดำเนินการคอนเทนเนอร์
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` เตรียมและทำให้ `IInvocationContext` เป็นอนุกรม

ค่าคงที่

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

ค่าคงที่: "lab"

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

ค่าคงที่: "general-tests.zip"

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

ค่าคงที่: "SANDBOX_ENABLED"

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

TradefedSandbox

public TradefedSandbox ()

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

createClasspath

public String createClasspath (File workingDir)

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

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

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

การขว้าง
`ConfigurationException`

createThinLauncherConfig

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

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

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

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

getTradefedSandboxEnvironment

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

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

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

matchSandboxExtraBuildTargetByConfigName

public static  matchSandboxExtraBuildTargetByConfigName (String configName)

เมื่อระบุชื่อการกำหนดค่าการทดสอบแล้ว ให้จับคู่เป้าหมายการสร้างเพิ่มเติมจากเป้าหมายการสร้างเพิ่มเติมของ Sandbox

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

คิกรีเทิร์น

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

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

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

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

โฮมรัน

public CommandResult run (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

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

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

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

tearDown

public void tearDown ()

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

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

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

ส่งออกการกำหนดค่าส่วนกลางที่กรองจากออบเจ็กต์บางรายการ

พารามิเตอร์
`config`	`IConfiguration`
`exclusionPatterns`

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

การขว้าง
`ConfigurationException`

getJava

protected String getJava ()

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

prepareConfiguration

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

เตรียม IConfiguration ที่จะส่งไปยังกระบวนการย่อยและจะขับเคลื่อนการดำเนินการคอนเทนเนอร์

พารามิเตอร์
`context`	`IInvocationContext`: `IInvocationContext` ปัจจุบัน
`config`	`IConfiguration`: `IConfiguration` ที่ต้องเตรียม
`listener`	`ITestInvocationListener`: การเรียกใช้ปัจจุบัน `ITestInvocationListener`

คิกรีเทิร์น
`Exception`	Exception หากเกิดข้อผิดพลาด หรือ null ในกรณีอื่นๆ

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

เตรียมและทำให้ IInvocationContext เป็นอนุกรม

พารามิเตอร์
`context`	`IInvocationContext`: `IInvocationContext` ที่ต้องเตรียม
`config`	`IConfiguration`: `IConfiguration` ของแซนด์บ็อกซ์

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

การขว้าง
	IOException