แซนด์บ็อกซ์ที่เทรด

public class TradefedSandbox
extends Object implements ISandbox

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

---

คอนเทนเนอร์แซนด์บ็อกซ์ที่สามารถเรียกใช้การเรียกใช้สหพันธ์การค้าได้ สิ่งที่ต้องทำ: อนุญาตให้ส่งตัวเลือกไปยัง แซนด์บ็อกซ์

สรุป

ช่อง
public static final 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) โหมดพิเศษถูกตัดการเชื่อมต่อจากการเรียกใช้หลัก: เมื่อดูเหมือนว่าการกำหนดค่าไม่มีอยู่ใน กับระดับบน เราจะสลับใช้ Launcher แบบ Thin ที่เราพยายามตั้งค่าแซนด์บ็อกซ์ด้วย ข้อมูลที่รู้จักและเติมไดเรกทอรีการทำงานเพื่อสร้างการกำหนดค่าโดยสมบูรณ์ใน ไดเรกทอรีที่มีเวอร์ชัน
File	getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
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

ช่อง

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

ช่างก่อสร้างสาธารณะ

แซนด์บ็อกซ์ที่เทรด

public TradefedSandbox ()

วิธีการสาธารณะ

createClasspath

public String createClasspath (File workingDir)

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

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

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

การขว้าง
ConfigurationException

createThinLauncherConfig

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

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

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

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

สภาพแวดล้อม getTradefedSandbox

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

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

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

เตรียมสภาพแวดล้อม

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 พร้อมสถานะการเรียกใช้แซนด์บ็อกซ์และบันทึก

ฉีกขาด

public void tearDown ()

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

วิธีการป้องกัน

DumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

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

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

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

การขว้าง
ConfigurationException

GetJava

protected String getJava ()

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

เตรียมการกำหนดค่า

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

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

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

คิกรีเทิร์น
Exception	ข้อยกเว้นหากมีข้อผิดพลาด หากไม่มีข้อผิดพลาด

เตรียมบริบท

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

จัดเตรียมและเรียงลำดับ IInvocationContext

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

คิกรีเทิร์น
File	IInvocationContext ที่ต่อเนื่อง

การขว้าง
	ข้อยกเว้น IO