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

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)

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

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

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

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

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

abstract CommandResult run ( 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 คลาสพาธที่จะใช้

ขว้าง
ConfigurationException

createThinLauncherConfig

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 ส่งคืนค่าว่างหากไม่สามารถสร้างการกำหนดค่าตัวเรียกใช้งานแบบบางได้

getTradefedSandboxEnvironment

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

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

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

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

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

การส่งคืน
File ไดเร็กทอรี ERROR(/File) ที่มี Jars สภาพแวดล้อมแซนด์บ็อกซ์ 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 (IConfiguration configuration, 
                ITestLogger logger)

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

พารามิเตอร์
configuration IConfiguration : IConfiguration สำหรับคำสั่งที่จะรัน

logger ITestLogger : ITestLogger ที่เราสามารถบันทึกไฟล์ได้

การส่งคืน
CommandResult CommandResult พร้อมสถานะการรันแซนด์บ็อกซ์และบันทึก

การถอดออก

public abstract void tearDown ()

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