InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
   ↳ com.android.tradefed.invoker.InvocationExecution

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

สรุป

ค่าคงที่

String ADB_VERSION_KEY

String JAVA_CLASSPATH_KEY

String JAVA_VERSION_KEY

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

InvocationExecution()

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

void cleanUpBuilds(IInvocationContext context, IConfiguration config)

ดำเนินการตามขั้นตอนการล้างข้อมูล build_provider

void doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)

เรียกใช้ขั้นตอน cleanUp ของ 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)

เรียกใช้ ITestDevice.postInvocationTearDown(Throwable) สำหรับอุปกรณ์แต่ละเครื่องซึ่งเป็นส่วนหนึ่งของ การเรียกใช้

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)) สำหรับอุปกรณ์แต่ละเครื่องซึ่งเป็นส่วนหนึ่งของ การเรียกใช้

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

สร้างและส่งคืน IShardHelper ที่จะใช้

void customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)

ให้โอกาสในการปรับแต่งอุปกรณ์บางอย่างก่อน preInvocationSetup

String getAdbVersion()

แสดงเวอร์ชัน adb ที่ใช้สำหรับการเรียกใช้

List<ITargetPreparer> getLabPreparersToRun(IConfiguration config, String deviceName)

ดึงข้อมูลรายการผู้เตรียมห้องทดลองเพื่อเรียกใช้ในอุปกรณ์นี้

List<ITargetPreparer> getTargetPreparersToRun(IConfiguration config, String deviceName)

ดึงรายการโปรแกรมเตรียมเป้าหมายเพื่อเรียกใช้ในอุปกรณ์นี้

void linkExternalDirs(IBuildInfo info, TestInformation testInfo)
void logHostAdb(IConfiguration config, ITestLogger logger)

รวบรวมบันทึกจาก $TMPDIR/adb.$UID.log

Throwable runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, List<ITargetPreparer> preparersToRun, Map<String, Set<ITargetPreparer>> trackPreparersMap)
void setTestTag(IBuildInfo info, IConfiguration config)

จัดการการตั้งค่าแท็กทดสอบในข้อมูลการสร้าง

ค่าคงที่

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

ค่าคงที่ "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

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

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

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

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

InvocationExecution

public InvocationExecution ()

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

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

ดำเนินการตามขั้นตอนการล้างข้อมูล build_provider เชื่อมโยงกับการดึงข้อมูลบิลด์

พารามิเตอร์
context IInvocationContext: IInvocationContext ของการเรียกใช้
config IConfiguration: IConfiguration ของการทดสอบนี้

doCleanUp

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

เรียกใช้ขั้นตอน cleanUp ของ target_preparer และ multi_target_preparer อุปกรณ์จะล้างข้อมูล

พารามิเตอร์
context IInvocationContext: IInvocationContext ของการเรียกใช้
config IConfiguration: IConfiguration ของการทดสอบนี้
exception Throwable: ข้อยกเว้นเดิมที่เกิดจากการทดสอบที่กำลังทำงาน

doSetup

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

doTeardown

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: ข้อยกเว้นเดิมที่เกิดจากการทดสอบที่กำลังทำงาน
ส่ง
Throwable

fetchBuild

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

reportLogs

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

runTests

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

เรียกใช้การทดสอบ

พารามิเตอร์
info TestInformation: TestInformation ที่ใช้เรียกใช้การทดสอบ
config IConfiguration: IConfiguration ที่จะเรียกใช้
listener ITestInvocationListener: ITestInvocationListener ของผลการทดสอบ
ส่ง
Throwable

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

พยายามแบ่งการกำหนดค่าออกเป็นการกำหนดค่าย่อยเพื่อกำหนดเวลาใหม่ให้ทำงานใน ทรัพยากรหลายรายการแบบขนาน

หากจำนวน Shard มากกว่า 1 ระบบจะสร้างการกำหนดค่าสำหรับแต่ละ Shard โดยการตั้งค่าดัชนี Shard และกำหนดเวลาใหม่ หากไม่ได้ตั้งค่าจำนวน Shard ระบบจะใช้ค่าสำรองเป็น IShardHelper.shardConfig

พารามิเตอร์
config IConfiguration: IConfiguration ปัจจุบัน
testInfo TestInformation: TestInformation ที่มีข้อมูลของการทดสอบ
rescheduler IRescheduler: IRescheduler
logger ITestLogger: ITestLogger ใช้เพื่อบันทึกไฟล์ระหว่างการแบ่งข้อมูล
การคืนสินค้า
boolean จริง หากมีการแบ่งการทดสอบ ไม่เช่นนั้น ให้ส่งคืน false

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

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

รวบรวมข้อมูลบางอย่างโดยอัตโนมัติในอุปกรณ์หลักที่อยู่ระหว่างการทดสอบ

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

info TestInformation

ส่ง
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

สร้างและส่งคืน IShardHelper ที่จะใช้

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

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

ให้โอกาสในการปรับแต่งอุปกรณ์บางอย่างก่อน preInvocationSetup

พารามิเตอร์
config IConfiguration: การกำหนดค่าของการเรียกใช้
context IInvocationContext: บริบทการเรียกใช้ปัจจุบัน

getAdbVersion

protected String getAdbVersion ()

แสดงเวอร์ชัน adb ที่ใช้สำหรับการเรียกใช้

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

getLabPreparersToRun

protected List<ITargetPreparer> getLabPreparersToRun (IConfiguration config, 
                String deviceName)

ดึงข้อมูลรายการผู้เตรียมห้องทดลองเพื่อเรียกใช้ในอุปกรณ์นี้

แทนที่ในคลาสแซนด์บ็อกซ์เพื่อจำกัดไม่ให้ผู้เตรียมแล็บทำงานภายในแซนด์บ็อกซ์ ย่อย

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

deviceName String

การคืนสินค้า
List<ITargetPreparer>

getTargetPreparersToRun

protected List<ITargetPreparer> getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

ดึงรายการโปรแกรมเตรียมเป้าหมายเพื่อเรียกใช้ในอุปกรณ์นี้

แทนที่ในคลาสแซนด์บ็อกซ์เพื่อจำกัดไม่ให้ผู้เตรียมแล็บทำงานภายในแซนด์บ็อกซ์ ย่อย

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

deviceName String

การคืนสินค้า
List<ITargetPreparer>

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

พารามิเตอร์
info IBuildInfo

testInfo TestInformation

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, 
                List<ITargetPreparer> preparersToRun, 
                Map<String, Set<ITargetPreparer>> trackPreparersMap)

พารามิเตอร์
testInfo TestInformation

device ITestDevice

deviceName String

deviceIndex int

logger ITestLogger

exception Throwable

preparersToRun List

trackPreparersMap Map

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

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

จัดการการตั้งค่าแท็กทดสอบในข้อมูลการสร้าง

พารามิเตอร์
info IBuildInfo

config IConfiguration