ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

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

สรุป

เมธอดสาธารณะ

abstract String createClasspath(File workingDir)

สร้างคลาสพาธตามสภาพแวดล้อมและไดเรกทอรีการทำงานที่ getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]) แสดง

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

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

default Map<String, List<String>> discoverTests(IInvocationContext context, IConfiguration configuration)

ขั้นตอนย่อยของ prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) ซึ่งจะค้นหาการทดสอบหากเปิดใช้ SandboxOptions.shouldUseTestDiscovery()

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

ขั้นตอนย่อยของ prepareEnvironment(IInvocationContext,IConfiguration,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(IInvocationContext,IConfiguration,String[]) แสดง

พารามิเตอร์
workingDir File: ไดเรกทอรีการทำงานปัจจุบันของแซนด์บ็อกซ์
การคืนสินค้า
String คลาสพาธที่จะใช้
ส่ง
ConfigurationException

createThinLauncherConfig

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

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

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

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration)

ขั้นตอนย่อยของ prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) ซึ่งจะค้นหาการทดสอบหากเปิดใช้ SandboxOptions.shouldUseTestDiscovery()

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

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

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

configuration IConfiguration

logger ITestLogger

การคืนสินค้า
Map<String, List<String>>

fetchSandboxExtraArtifacts

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

ขั้นตอนย่อยของ prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) ซึ่งดึงข้อมูลไฟล์เพิ่มเติมที่จำเป็นสำหรับแซนด์บ็อกซ์

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

getTradefedSandboxEnvironment

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

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

พารามิเตอร์
context IInvocationContext: IInvocationContext ของผู้ปกครอง
nonVersionedConfig IConfiguration: IConfiguration ที่แสดงออบเจ็กต์ที่ไม่มีการควบคุมเวอร์ชัน
args String: อาร์กิวเมนต์บรรทัดคำสั่ง
การคืนสินค้า
File File ไดเรกทอรีที่มีไฟล์ JAR ของสภาพแวดล้อมแซนด์บ็อกซ์ TF
ส่ง
Exception

getTradefedSandboxEnvironment

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

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

nonVersionedConfig IConfiguration

logger ITestLogger

args String

การคืนสินค้า
File

ส่ง
Exception

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

tearDown

public abstract void tearDown ()

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