การเรียกใช้การดำเนินการ

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)

เรียกใช้ 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 ที่ใช้สำหรับการเรียกใช้

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

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

เรียกดูรายชื่อผู้เตรียมห้องปฏิบัติการเพื่อเรียกใช้บนอุปกรณ์นี้

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

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

deviceName String

ส่งคืน

getTargetPreparersToRun

protected  getTargetPreparersToRun (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