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

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


ส่วนต่อประสานที่กำหนด sandbox ที่สามารถใช้ในการเรียกใช้การร้องขอ

สรุป

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

abstract String createClasspath (File workingDir)

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

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

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

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

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

abstract Exception prepareEnvironment ( IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)

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

abstract CommandResult run ( TestInformation info, IConfiguration configuration, ITestLogger logger)

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

abstract void tearDown ()

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

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

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

public abstract String createClasspath (File workingDir)

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

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

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

พ่น
ConfigurationException

สร้าง ThinLauncherConfig

public abstract 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 abstract File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

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

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

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

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

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

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

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

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

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

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

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

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

วิ่ง

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

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

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

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

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

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

การถอดออก

public abstract void tearDown ()

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