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

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 เวอร์ชัน .

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

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

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

runUtil IRunUtil : IRunUtil ปัจจุบันเพื่อรันคำสั่งโฮสต์

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

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

ค้นพบการทดสอบ

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 สำหรับคำสั่งที่จะรัน

การส่งคืน
แผนที่ของการทดสอบที่ค้นพบหรือเป็นโมฆะหากไม่รองรับหรือล้มเหลว

ค้นพบการทดสอบ

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

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

configuration IConfiguration

logger ITestLogger

การส่งคืน

ดึง SandboxExtraArtifacts

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

getTradefedSandboxEnvironment

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

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

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

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

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

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

getTradefedSandboxEnvironment

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

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