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

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


อินเทอร์เฟซกำหนดแซนด์บ็อกซ์ที่สามารถใช้เพื่อเรียกใช้การร้องขอ

สรุป

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

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)

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

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

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

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

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

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

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

abstract void tearDown ()

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

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

createClasspath

public abstract String createClasspath (File workingDir)

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

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

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

ขว้าง
ConfigurationException

createThinLauncherConfig

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

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

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

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

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

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

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

getTradefedSandboxEnvironment

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

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

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

nonVersionedConfig IConfiguration : IConfiguration ที่แสดงถึงอ็อบเจ็กต์ที่ไม่มีเวอร์ชัน

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

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

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

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

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

พารามิเตอร์
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 พร้อมสถานะของการรันแซนด์บ็อกซ์และบันทึก

การถอดออก

public abstract void tearDown ()

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