Tradefedแซนด์บ็อกซ์

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)

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

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

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

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

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

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

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

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

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

void tearDown ()

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

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

File dumpGlobalConfig ( IConfiguration config, exclusionPatterns) 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

ผู้สร้างสาธารณะ

Tradefedแซนด์บ็อกซ์

public TradefedSandbox ()

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

สร้างคลาสพาธ

public String createClasspath (File workingDir)

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

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

ส่งคืน
String classpath ที่จะใช้

พ่น
ConfigurationException

สร้าง ThinLauncherConfig

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

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

พารามิเตอร์
args String : args บรรทัดคำสั่งเดิม

keyStoreClient IKeyStoreClient : ไคลเอนต์ที่เก็บคีย์ปัจจุบันเพื่อใช้สร้างคอนฟิกูเรชัน

runUtil IRunUtil : IRunUtil ปัจจุบันเพื่อเรียกใช้คำสั่งโฮสต์

globalConfig File : การกำหนดค่าส่วนกลางเพื่อใช้ในการเรียกใช้กระบวนการย่อยของ TF

ส่งคืน
IConfiguration ไฟล์ที่ชี้ไปที่การกำหนดค่า XML ของ TF สำหรับวัตถุ NON_VERSIONED คืนค่า null หากไม่สามารถสร้างการกำหนดค่าตัวเรียกใช้งานแบบบางได้

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

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

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

พารามิเตอร์
context IInvocationContext : IInvocationContext ของพาเรนต์

nonVersionedConfig IConfiguration : IConfiguration ที่เป็นตัวแทนของออบเจกต์ที่ไม่ใช่เวอร์ชัน

args String : อาร์กิวเมนต์บรรทัดคำสั่ง

ส่งคืน
File ไดเร็กทอรี ERROR(/File) ที่มี jar สภาพแวดล้อมแบบ TF sandbox

เตรียมสิ่งแวดล้อม

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

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

พารามิเตอร์
context IInvocationContext : การเรียกปัจจุบัน IInvocationContext

config IConfiguration : IConfiguration สำหรับคำสั่งที่จะรัน

listener ITestInvocationListener : การร้องขอ ITestInvocationListener ปัจจุบันที่ควรส่งผลลัพธ์สุดท้าย

ส่งคืน
Exception ERROR(/Exception) ที่มีความล้มเหลว หรือ Null หากสำเร็จ

วิ่ง

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

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

พารามิเตอร์
info TestInformation : TestInformation ที่อธิบายการร้องขอ

config IConfiguration : IConfiguration สำหรับคำสั่งที่จะรัน

logger ITestLogger : ITestLogger ที่เราสามารถล็อกไฟล์ได้

ส่งคืน
CommandResult CommandResult พร้อมสถานะของการรัน Sandbox และบันทึก

การถอดออก

public void tearDown ()

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

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

ดัมพ์ GlobalConfig

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ข้อยกเว้น