ISandbox

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 ซึ่งจะพยายามตั้งค่าแซนด์บ็อกซ์ด้วยข้อมูลที่ทราบในปัจจุบัน และป้อนข้อมูลในไดเรกทอรีการทำงานเพื่อสร้างการกำหนดค่าอย่างสมบูรณ์ในไดเรกทอรีเวอร์ชัน

default discoverTests(IInvocationContext context, IConfiguration configuration)

ขั้นตอนย่อยของ prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) ซึ่งจะค้นหาการทดสอบว่า SandboxOptions.shouldUseTestDiscovery() เปิดใช้อยู่หรือไม่

default discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)

ขั้นตอนย่อยของ prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) ซึ่งดึงข้อมูลไฟล์เพิ่มเติมที่จําเป็นสําหรับแซนด์บ็อกซ์

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

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

default File getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
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 เส้นทางคลาสที่จะใช้
การโยน
ConfigurationException

createThinLauncherConfig

public abstract 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 ไม่ได้

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

ขั้นตอนย่อยของ prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) ซึ่งจะค้นหาการทดสอบว่า SandboxOptions.shouldUseTestDiscovery() เปิดใช้อยู่หรือไม่

พารามิเตอร์
context IInvocationContext: การเรียกใช้ปัจจุบัน IInvocationContext
configuration IConfiguration: IConfiguration เพื่อให้คำสั่งทำงาน
คิกรีเทิร์น
แผนที่ของการทดสอบที่ค้นพบ หรือเป็นค่าว่างหากระบบไม่รองรับหรือทดสอบไม่สำเร็จ

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

พารามิเตอร์
context IInvocationContext

configuration IConfiguration

logger ITestLogger

คิกรีเทิร์น

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

ขั้นตอนย่อยของ prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) ซึ่งดึงข้อมูลไฟล์เพิ่มเติมที่จําเป็นสําหรับแซนด์บ็อกซ์

พารามิเตอร์
context IInvocationContext: การเรียกใช้ปัจจุบัน IInvocationContext
configuration IConfiguration: IConfiguration เพื่อให้คำสั่งทำงาน
args String: อาร์กิวเมนต์บรรทัดคำสั่ง
คิกรีเทิร์น
IFolderBuildInfo บิลด์ที่ดึงข้อมูลสำหรับไฟล์ที่อยู่ในแซนด์บ็อกซ์เพิ่มเติม
การโยน
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
IOException
BuildRetrievalError
ConfigurationException

getTradefedSandboxEnvironment

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

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

พารามิเตอร์
context IInvocationContext: IInvocationContext ของผู้ปกครอง
nonVersionedConfig IConfiguration: IConfiguration ที่แสดงถึงออบเจ็กต์ที่ไม่มีเวอร์ชัน
args String: อาร์กิวเมนต์บรรทัดคำสั่ง
คิกรีเทิร์น
File ไดเรกทอรี ERROR(/File) ที่มี Jar สภาพแวดล้อมแซนด์บ็อกซ์ TF

getTradefedSandboxEnvironment

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

พารามิเตอร์
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

คิกรีเทิร์น
File

prepareEnvironment

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

tearDown

public abstract void tearDown ()

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