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

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

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

สรุป

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

abstract String createClasspath(File workingDir)

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

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

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

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)

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

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

พารามิเตอร์
args String: อาร์กิวเมนต์บรรทัดคำสั่งเดิม
keyStoreClient IKeyStoreClient: ไคลเอ็นต์คีย์สโตร์ปัจจุบันที่จะใช้สร้างการกำหนดค่า
runUtil IRunUtil: IRunUtil ปัจจุบันเพื่อเรียกใช้คำสั่งของโฮสต์
globalConfig File: การกำหนดค่าส่วนกลางที่จะใช้เพื่อเรียกใช้กระบวนการย่อยของ TF
คิกรีเทิร์น
IConfiguration ไฟล์ที่ชี้ไปยัง XML การกำหนดค่าของ TF สำหรับออบเจ็กต์ NON_VERSIONED คิกรีเทิร์น null หากไม่มีการสร้างการกำหนดค่า Launcher แบบ Thin

สำรวจการทดสอบ

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 ของคำสั่งที่จะเรียกใช้
คิกรีเทิร์น
แผนที่ของการทดสอบที่ค้นพบหรือ Null หากไม่รองรับหรือล้มเหลว

สำรวจการทดสอบ

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
ข้อยกเว้น IO
BuildRetrievalError
ConfigurationException

สภาพแวดล้อม getTradefedSandbox

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

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

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

สภาพแวดล้อม getTradefedSandbox

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

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

nonVersionedConfig IConfiguration

logger ITestLogger

args String

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

เตรียมสภาพแวดล้อม

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 ()

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