การเรียกใช้การดำเนินการ
public class InvocationExecution
extends Object
implements IInvocationExecution
java.lang.Object | |
↳ | com.android.tradefed.invoker.InvocationExecution |
คลาสที่อธิบายขั้นตอนการเรียกใช้ทั้งหมด: ดาวน์โหลด build, target_prep, รันการทดสอบ, ล้างข้อมูล สามารถขยายเพื่อแทนที่พฤติกรรมเริ่มต้นของบางขั้นตอน ลำดับของขั้นตอนขับเคลื่อนโดย TestInvocation
สรุป
เขตข้อมูล | |
---|---|
public static final String | ADB_VERSION_KEY |
public static final String | JAVA_CLASSPATH_KEY |
public static final String | JAVA_VERSION_KEY
|
ผู้สร้างสาธารณะ | |
---|---|
InvocationExecution () |
วิธีการสาธารณะ | |
---|---|
void | cleanUpBuilds ( IInvocationContext context, IConfiguration config) ดำเนินการขั้นตอนการล้าง build_provider |
void | doCleanUp ( IInvocationContext context, IConfiguration config, Throwable exception) ดำเนินการขั้นตอนการล้างข้อมูล target_preparer และ multi_target_preparer |
void | doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener) ดำเนินการตามขั้นตอนการตั้งค่า target_preparer และ multi_target_preparer |
void | doTeardown ( TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) ดำเนินการขั้นตอนการแยกส่วน target_preparer และ multi_target_preparer |
boolean | fetchBuild ( TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener) ดำเนินการตามขั้นตอน build_provider ของการร้องขอ |
void | reportLogs ( ITestDevice device, ITestLogger listener, TestInvocation.Stage stage) รายงานบันทึกอุปกรณ์บางอย่างในขั้นตอนต่างๆ ของการเรียกใช้ |
void | runDevicePostInvocationTearDown ( IInvocationContext context, IConfiguration config, Throwable exception) เรียกใช้ |
void | runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger) เรียกใช้ |
void | runTests ( TestInformation info, IConfiguration config, ITestInvocationListener listener) เรียกใช้การทดสอบ |
boolean | shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger) พยายามแบ่งส่วนกำหนดค่าเป็นการกำหนดค่าย่อย เพื่อจัดกำหนดการใหม่ให้ทำงานบนทรัพยากรหลายรายการพร้อมกัน |
วิธีการป้องกัน | |
---|---|
void | collectAutoInfo ( IConfiguration config, TestInformation info) รวบรวมข้อมูลบางอย่างโดยอัตโนมัติบนอุปกรณ์หลักที่อยู่ระหว่างการทดสอบ |
IShardHelper | createShardHelper () สร้างการส่งคืน |
void | customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context) ให้โอกาสในการปรับแต่งอุปกรณ์บางอย่างก่อน preInvocationSetup |
String | getAdbVersion () ส่งคืนเวอร์ชัน adb ที่ใช้สำหรับการเรียกใช้ |
getLabPreparersToRun ( IConfiguration config, String deviceName) เรียกดูรายชื่อผู้เตรียมห้องปฏิบัติการเพื่อเรียกใช้บนอุปกรณ์นี้ | |
getTargetPreparersToRun ( IConfiguration config, String deviceName) เรียกรายชื่อผู้จัดเตรียมเป้าหมายเพื่อเรียกใช้บนอุปกรณ์นี้ | |
void | logHostAdb ( IConfiguration config, ITestLogger logger) รวบรวมบันทึกจาก $TMPDIR/adb.$UID.log |
Throwable | runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) |
void | setTestTag ( IBuildInfo info, IConfiguration config) จัดการตั้งค่าแท็กทดสอบบนข้อมูลการสร้าง |
เขตข้อมูล
ADB_VERSION_KEY
public static final String ADB_VERSION_KEY
JAVA_CLASSPATH_KEY
public static final String JAVA_CLASSPATH_KEY
JAVA_VERSION_KEY
public static final String JAVA_VERSION_KEY
ผู้สร้างสาธารณะ
การเรียกใช้การดำเนินการ
public InvocationExecution ()
วิธีการสาธารณะ
cleanUpBuilds
public void cleanUpBuilds (IInvocationContext context, IConfiguration config)
ดำเนินการขั้นตอนการล้าง build_provider เชื่อมโยงกับการดึงข้อมูลบิลด์
พารามิเตอร์ | |
---|---|
context | IInvocationContext : IInvocationContext ของการเรียกใช้ |
config | IConfiguration : IConfiguration ของการเรียกใช้การทดสอบนี้ |
โดคลีนอัพ
public void doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception)
ดำเนินการขั้นตอนการล้างข้อมูล target_preparer และ multi_target_preparer ทำความสะอาดอุปกรณ์หรือไม่
พารามิเตอร์ | |
---|---|
context | IInvocationContext : IInvocationContext ของการเรียกใช้ |
config | IConfiguration : IConfiguration ของการเรียกใช้การทดสอบนี้ |
exception | Throwable : ข้อยกเว้นเดิมที่เกิดขึ้นจากการทดสอบที่กำลังทำงานอยู่ |
ทำการตั้งค่า
public void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
ดำเนินการตามขั้นตอนการตั้งค่า target_preparer และ multi_target_preparer จำเป็นต้องตั้งค่าอุปกรณ์ทั้งหมดเพื่อให้การทดสอบทำงานหรือไม่
พารามิเตอร์ | |
---|---|
testInfo | TestInformation : TestInformation ของการร้องขอ |
config | IConfiguration : IConfiguration ของการเรียกใช้การทดสอบนี้ |
listener | ITestLogger : ITestLogger เพื่อรายงานบันทึกความล้มเหลวในการตั้งค่า |
พ่น | |
---|---|
BuildError | |
DeviceNotAvailableException | |
TargetSetupError |
ทำTeardown
public void doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)
ดำเนินการขั้นตอนการแยกส่วน target_preparer และ multi_target_preparer อุปกรณ์ฉีกขาดที่เกี่ยวข้องกับการตั้งค่าหรือไม่
พารามิเตอร์ | |
---|---|
testInfo | TestInformation : TestInformation ของการร้องขอ |
config | IConfiguration : IConfiguration ของการเรียกใช้การทดสอบนี้ |
logger | ITestLogger : ITestLogger เพื่อรายงานบันทึก |
exception | Throwable : ข้อยกเว้นเดิมที่เกิดขึ้นจากการทดสอบที่กำลังทำงานอยู่ |
ดึงข้อมูลสร้าง
public boolean fetchBuild (TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)
ดำเนินการตามขั้นตอน build_provider ของการร้องขอ
พารามิเตอร์ | |
---|---|
testInfo | TestInformation : TestInformation ของการร้องขอ |
config | IConfiguration : IConfiguration ของการเรียกใช้การทดสอบนี้ |
rescheduler | IRescheduler : IRescheduler สำหรับการกำหนดเวลาใหม่ในส่วนของการร้องขอสำหรับการดำเนินการกับทรัพยากรอื่น |
listener | ITestInvocationListener : ITestInvocation เพื่อรายงานความล้มเหลวในการดาวน์โหลดบิลด์ |
ส่งคืน | |
---|---|
boolean | เป็นจริงหากเราดาวน์โหลดบิลด์สำเร็จ มิฉะนั้นจะเป็นเท็จ |
พ่น | |
---|---|
BuildRetrievalError | |
DeviceNotAvailableException |
บันทึกรายงาน
public void reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
รายงานบันทึกอุปกรณ์บางอย่างในขั้นตอนต่างๆ ของการเรียกใช้ ตัวอย่างเช่น: logcat
พารามิเตอร์ | |
---|---|
device | ITestDevice : อุปกรณ์ที่จะรายงานบันทึกจาก |
listener | ITestLogger : ตัวบันทึกสำหรับบันทึก |
stage | TestInvocation.Stage : ขั้นตอนของการร้องขอที่เราอยู่ |
runDevicePostInvocationTearDown
public void runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception)
เรียกใช้ ITestDevice#postInvocationTearDown(Throwable)
สำหรับแต่ละส่วนอุปกรณ์ของการเรียกใช้
พารามิเตอร์ | |
---|---|
context | IInvocationContext : IInvocationContext ของการเรียกใช้ |
config | IConfiguration : IConfiguration ของการเรียกใช้การทดสอบนี้ |
exception | Throwable : ข้อยกเว้นดั้งเดิมที่เกิดจากการทดสอบที่รันอยู่ ถ้ามี |
runDevicePreInvocationSetup
public void runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger)
เรียกใช้ ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo))
สำหรับอุปกรณ์แต่ละส่วนของการเรียกใช้
พารามิเตอร์ | |
---|---|
context | IInvocationContext : IInvocationContext ของการเรียกใช้ |
config | IConfiguration : IConfiguration ของการเรียกใช้การทดสอบนี้ |
logger | ITestLogger : ITestLogger เพื่อรายงานบันทึก |
พ่น | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
เรียกใช้การทดสอบ
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
เรียกใช้การทดสอบ
พารามิเตอร์ | |
---|---|
info | TestInformation : TestInformation เพื่อเรียกใช้การทดสอบด้วย |
config | IConfiguration : IConfiguration ที่จะเรียกใช้ |
listener | ITestInvocationListener : ITestInvocationListener ของผลการทดสอบ |
shardConfig
public boolean shardConfig (IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
พยายามแบ่งส่วนกำหนดค่าเป็นการกำหนดค่าย่อย เพื่อจัดกำหนดการใหม่ให้ทำงานบนทรัพยากรหลายรายการพร้อมกัน
หากจำนวนเศษมีค่ามากกว่า 1 ก็จะสร้างการกำหนดค่าสำหรับแต่ละเศษโดยการตั้งค่าดัชนีเศษและกำหนดเวลาใหม่ หากไม่ได้ตั้งค่าการนับเศษ ระบบจะย้อนกลับไปยัง IShardHelper#shardConfig
พารามิเตอร์ | |
---|---|
config | IConfiguration : IConfiguration ปัจจุบัน |
testInfo | TestInformation : TestInformation เก็บข้อมูลของการทดสอบ |
rescheduler | IRescheduler : IRescheduler |
logger | ITestLogger : ITestLogger ใช้เพื่อบันทึกไฟล์ระหว่างการแบ่งส่วนข้อมูล |
ส่งคืน | |
---|---|
boolean | จริงถ้าการทดสอบถูกแบ่งย่อย มิฉะนั้นกลับ false |
วิธีการป้องกัน
รวบรวมข้อมูลอัตโนมัติ
protected void collectAutoInfo (IConfiguration config, TestInformation info)
รวบรวมข้อมูลบางอย่างโดยอัตโนมัติบนอุปกรณ์หลักที่อยู่ระหว่างการทดสอบ
พารามิเตอร์ | |
---|---|
config | IConfiguration |
info | TestInformation |
พ่น | |
---|---|
DeviceNotAvailableException |
สร้าง ShardHelper
protected IShardHelper createShardHelper ()
สร้างการส่งคืน IShardHelper
ที่จะใช้
ส่งคืน | |
---|---|
IShardHelper |
ปรับแต่ง DevicePreInvocation
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
ให้โอกาสในการปรับแต่งอุปกรณ์บางอย่างก่อน preInvocationSetup
พารามิเตอร์ | |
---|---|
config | IConfiguration : การกำหนดค่าของการเรียกใช้ |
context | IInvocationContext : บริบทการร้องขอปัจจุบัน |
getAdbVersion
protected String getAdbVersion ()
ส่งคืนเวอร์ชัน adb ที่ใช้สำหรับการเรียกใช้
ส่งคืน | |
---|---|
String |
getLabPreparersToRun
protectedgetLabPreparersToRun (IConfiguration config, String deviceName)
เรียกดูรายชื่อผู้เตรียมห้องปฏิบัติการเพื่อเรียกใช้บนอุปกรณ์นี้
ถูกแทนที่ในคลาสแซนด์บ็อกซ์เพื่อจำกัดไม่ให้ผู้เตรียมห้องปฏิบัติการเรียกใช้ภายในแซนด์บ็อกซ์ชายน์
พารามิเตอร์ | |
---|---|
config | IConfiguration |
deviceName | String |
ส่งคืน | |
---|---|
getTargetPreparersToRun
protectedgetTargetPreparersToRun (IConfiguration config, String deviceName)
เรียกรายชื่อผู้จัดเตรียมเป้าหมายเพื่อเรียกใช้บนอุปกรณ์นี้
ถูกแทนที่ในคลาสแซนด์บ็อกซ์เพื่อจำกัดไม่ให้ผู้เตรียมห้องปฏิบัติการเรียกใช้ภายในแซนด์บ็อกซ์ชายน์
พารามิเตอร์ | |
---|---|
config | IConfiguration |
deviceName | String |
ส่งคืน | |
---|---|
logHostAdb
protected void logHostAdb (IConfiguration config, ITestLogger logger)
รวบรวมบันทึกจาก $TMPDIR/adb.$UID.log
พารามิเตอร์ | |
---|---|
config | IConfiguration |
logger | ITestLogger |
runPreparersTearDown
protected Throwable runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception,preparersToRun, trackPreparersMap)
พารามิเตอร์ | |
---|---|
testInfo | TestInformation |
device | ITestDevice |
deviceName | String |
deviceIndex | int |
logger | ITestLogger |
exception | Throwable |
preparersToRun | |
trackPreparersMap |
ส่งคืน | |
---|---|
Throwable |
setTestTag
protected void setTestTag (IBuildInfo info, IConfiguration config)
จัดการตั้งค่าแท็กทดสอบบนข้อมูลการสร้าง
พารามิเตอร์ | |
---|---|
info | IBuildInfo |
config | IConfiguration |