TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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


คอนเทนเนอร์แซนด์บ็อกซ์ที่เรียกใช้ Trade Federation ได้ TODO: อนุญาตให้ส่งตัวเลือกไปยังแซนด์บ็อกซ์

สรุป

ช่อง

public static final String EXTRA_TARGET_LAB

public static final String GENERAL_TESTS_ZIP

public static final String SANDBOX_ENABLED

ตัวสร้างแบบสาธารณะ

TradefedSandbox()

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

String createClasspath(File workingDir)

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

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

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

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

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

ตัวสร้างแบบสาธารณะ

TradefedSandbox

public TradefedSandbox ()

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

createClasspath

public String createClasspath (File workingDir)

สร้าง classpath ตามสภาพแวดล้อมและไดเรกทอรีการทำงานที่ 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)

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

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

keyStoreClient IKeyStoreClient: ไคลเอ็นต์คีย์สโตร์ปัจจุบันที่จะใช้สร้างการกำหนดค่า

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

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

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

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 ข้อยกเว้นหากเกิดข้อผิดพลาดขึ้น หรือเป็นค่าว่างหากไม่เกิดข้อผิดพลาด

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

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

พารามิเตอร์
context IInvocationContext: IInvocationContext ที่จะเตรียม

config IConfiguration: IConfiguration ของแซนด์บ็อกซ์

คิกรีเทิร์น
File IInvocationContext ที่แปลงเป็นอนุกรม

โยน
IOException