TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

คลาสย่อยโดยตรงที่ทราบ GoogleTradefedSandbox GoogleTradefedSandbox การปรับแต่งภายในของ 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) สร้างคลาสพาธตามสภาพแวดล้อมและไดเรกทอรีการทำงานที่ getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]) แสดง
IConfiguration	createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig) โหมดพิเศษที่ไม่ได้เชื่อมต่อกับการเรียกใช้หลัก: เมื่อไม่พบการกำหนดค่าใน องค์ประกอบหลัก เราจะกลับไปใช้ตัวเรียกใช้แบบบางเพื่อพยายามตั้งค่าแซนด์บ็อกซ์ด้วยข้อมูลที่ทราบในปัจจุบัน และเติมไดเรกทอรีการทำงานเพื่อสร้างการกำหนดค่าอย่างสมบูรณ์ใน ไดเรกทอรีที่มีการควบคุมเวอร์ชัน
File	getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
static Set<String>	matchSandboxExtraBuildTargetByConfigName(String configName) เมื่อระบุชื่อการกำหนดค่าการทดสอบแล้ว ให้จับคู่เป้าหมายการสร้างเพิ่มเติมจากเป้าหมายการสร้างเพิ่มเติมของ Sandbox
Exception	prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener) เตรียมสภาพแวดล้อมเพื่อให้แซนด์บ็อกซ์ทำงานได้อย่างถูกต้อง
static String[]	removeIncompatibleFlags(String[] args)
CommandResult	run(TestInformation info, IConfiguration config, ITestLogger logger) เรียกใช้แซนด์บ็อกซ์ด้วยสภาพแวดล้อมที่ตั้งค่าไว้
void	tearDown() ล้างสถานะ ไฟล์ หรือสภาพแวดล้อมที่อาจมีการเปลี่ยนแปลง

วิธีการที่ได้รับการป้องกัน
File	dumpGlobalConfig(IConfiguration config, Set<String> 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)

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

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

การคืนสินค้า
String	คลาสพาธที่จะใช้

ส่ง
ConfigurationException

createThinLauncherConfig

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

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

พารามิเตอร์
args	String: อาร์กิวเมนต์บรรทัดคำสั่งเดิม
keyStoreClient	IKeyStoreClient: ไคลเอ็นต์ Keystore ปัจจุบันที่จะใช้สร้างการกำหนดค่า
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

ส่ง
Exception

matchSandboxExtraBuildTargetByConfigName

public static Set<String> matchSandboxExtraBuildTargetByConfigName (String configName)

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

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

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

prepareEnvironment

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

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

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

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

removeIncompatibleFlags

public static String[] removeIncompatibleFlags (String[] args)

พารามิเตอร์
args	String

การคืนสินค้า
String[]

โฮมรัน

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

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

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

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

ส่ง
Throwable

tearDown

public void tearDown ()

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

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

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                Set<String> exclusionPatterns)

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

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

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

ส่ง
ConfigurationException
IOException

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	ข้อยกเว้นหากเกิดข้อผิดพลาด หรือ null ในกรณีอื่นๆ

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

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

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

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

ส่ง
	java.io.IOException
IOException