TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

java.lang.Object
   ↳ com.android.tradefed.sandbox.TradefedSandbox

คอนเทนเนอร์แซนด์บ็อกซ์ที่เรียกใช้ Trade Federation ได้ TODO: Allow Options to be passed to the sandbox.

สรุป

ค่าคงที่

String EXTRA_TARGET_LAB

String GENERAL_TESTS_ZIP

String SANDBOX_ENABLED

เครื่องมือสร้างสาธารณะ

TradefedSandbox()

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

String createClasspath(File workingDir)

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

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

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

File getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
static matchSandboxExtraBuildTargetByConfigName(String configName)

เมื่อระบุชื่อการกำหนดค่าการทดสอบแล้ว ให้จับคู่เป้าหมายการสร้างเพิ่มเติมจากเป้าหมายการสร้างเพิ่มเติมของ Sandbox

Exception prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)

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

CommandResult run(TestInformation info, IConfiguration config, ITestLogger logger)

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

void tearDown()

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

วิธีการที่ได้รับการป้องกัน

File dumpGlobalConfig(IConfiguration config, exclusionPatterns)

ส่งออกการกำหนดค่าส่วนกลางที่กรองจากออบเจ็กต์บางรายการ

String getJava()
Exception prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)

เตรียม IConfiguration ที่จะส่งไปยังกระบวนการย่อยและจะขับเคลื่อนการดำเนินการคอนเทนเนอร์

File prepareContext(IInvocationContext context, IConfiguration config)

เตรียมและทำให้ IInvocationContext เป็นอนุกรม

ค่าคงที่

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

ค่าคงที่: "lab"

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

ค่าคงที่: "general-tests.zip"

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

ค่าคงที่: "SANDBOX_ENABLED"

เครื่องมือสร้างสาธารณะ

TradefedSandbox

public TradefedSandbox ()

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

createClasspath

public String createClasspath (File workingDir)

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

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

createThinLauncherConfig

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

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

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

getTradefedSandboxEnvironment

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

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

nonVersionedConfig IConfiguration

logger ITestLogger

args String

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

matchSandboxExtraBuildTargetByConfigName

public static  matchSandboxExtraBuildTargetByConfigName (String configName)

เมื่อระบุชื่อการกำหนดค่าการทดสอบแล้ว ให้จับคู่เป้าหมายการสร้างเพิ่มเติมจากเป้าหมายการสร้างเพิ่มเติมของ Sandbox

พารามิเตอร์
configName String

คิกรีเทิร์น

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

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

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

โฮมรัน

public CommandResult run (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

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

พารามิเตอร์
info TestInformation: TestInformationที่อธิบายการเรียกใช้
config IConfiguration: IConfiguration สำหรับคำสั่งที่จะเรียกใช้
logger ITestLogger: ITestLoggerที่เราสามารถบันทึกไฟล์ได้
คิกรีเทิร์น
CommandResult CommandResult พร้อมสถานะการเรียกใช้แซนด์บ็อกซ์และบันทึก

tearDown

public void tearDown ()

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

วิธีการที่ได้รับการป้องกัน

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

ส่งออกการกำหนดค่าส่วนกลางที่กรองจากออบเจ็กต์บางรายการ

พารามิเตอร์
config IConfiguration

exclusionPatterns

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

การขว้าง
ConfigurationException

getJava

protected String getJava ()

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

prepareConfiguration

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

เตรียม IConfiguration ที่จะส่งไปยังกระบวนการย่อยและจะขับเคลื่อนการดำเนินการคอนเทนเนอร์

พารามิเตอร์
context IInvocationContext: IInvocationContext ปัจจุบัน
config IConfiguration: IConfiguration ที่ต้องเตรียม
listener ITestInvocationListener: การเรียกใช้ปัจจุบัน ITestInvocationListener
คิกรีเทิร์น
Exception Exception หากเกิดข้อผิดพลาด หรือ null ในกรณีอื่นๆ

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

เตรียมและทำให้ IInvocationContext เป็นอนุกรม

พารามิเตอร์
context IInvocationContext: IInvocationContext ที่ต้องเตรียม
config IConfiguration: IConfiguration ของแซนด์บ็อกซ์
คิกรีเทิร์น
File IInvocationContext
การขว้าง
IOException