ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

คลาสย่อยโดยอ้อมที่ทราบ

DelegatedInvocationExecution, InvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution` ซึ่งมอบสิทธิ์การดําเนินการให้กับไบนารี Tradefed อื่น
InvocationExecution	คลาสที่อธิบายขั้นตอนเรียกใช้ทั้งหมด ได้แก่ การดาวน์โหลดบิลด์, target_prep, การเรียกใช้การทดสอบ, การเก็บล้าง
ParentSandboxInvocationExecution	เวอร์ชันของ `InvocationExecution` สําหรับการดําเนินการพิเศษของคําเรียกใช้หลักเมื่อเรียกใช้แซนด์บ็อกซ์
RemoteInvocationExecution	การใช้งาน `InvocationExecution` ที่ขับเคลื่อนการดำเนินการจากระยะไกล
SandboxedInvocationExecution	การดำเนินการแบบพิเศษในแซนด์บ็อกซ์ของการเรียกใช้: นี่คือ InvocationExection สำหรับเมื่อเราอยู่ภายในแซนด์บ็อกซ์ที่เรียกใช้คำสั่ง

อินเทอร์เฟซที่อธิบายการดำเนินการที่จะทำเป็นส่วนหนึ่งของการเรียกใช้ การเรียกใช้ TestInvocation เองจะดูแลลำดับการเรียกใช้

สรุป

เมธอดสาธารณะ
`default void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` เรียกใช้ขั้นตอนการล้างข้อมูล build_provider
`default void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` เรียกใช้ขั้นตอน cleanUp ของ target_preparer และ multi_target_preparer
`default void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger)` เรียกใช้ขั้นตอน target_preparer และ multi_target_preparersetUp
`default void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` เรียกใช้ขั้นตอนการเลิกใช้งาน target_preparer และ multi_target_preparer
`default boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` เรียกใช้ขั้นตอน build_provider ของการเรียกใช้
`abstract void`	`reportLogs(ITestDevice device, ITestLogger logger, TestInvocation.Stage stage)` รายงานบันทึกของอุปกรณ์บางรายการในระยะต่างๆ ของการเรียกใช้
`default void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` เรียกใช้ `ITestDevice.postInvocationTearDown(Throwable)` สำหรับอุปกรณ์แต่ละเครื่องที่เป็นส่วนหนึ่งของการเรียกใช้
`default 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))` สำหรับอุปกรณ์แต่ละเครื่องที่เป็นส่วนหนึ่งของการเรียกใช้
`default void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` ทำการทดสอบ
`default boolean`	`shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` พยายามแบ่งการกำหนดค่าออกเป็นการกำหนดค่าย่อยเพื่อกำหนดเวลาใหม่ให้ทำงานในหลายทรัพยากรพร้อมกัน

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

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

เรียกใช้ขั้นตอน target_preparer และ multi_target_preparersetUp อุปกรณ์ทั้งหมดต้องได้รับการตั้งค่าหรือไม่เพื่อให้การทดสอบทำงานได้

พารามิเตอร์
`testInfo`	`TestInformation`: `TestInformation` ของการเรียกใช้
`config`	`IConfiguration`: `IConfiguration` ของการทดสอบนี้
`logger`	`ITestLogger`: `ITestLogger` เพื่อรายงานบันทึกการตั้งค่าที่ไม่สำเร็จ

การโยน
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.device.DeviceNotAvailableException
`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`	จริงหากเราดาวน์โหลดบิลด์สำเร็จ หรือเป็นเท็จหากไม่สำเร็จ

การโยน
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.device.DeviceNotAvailableException
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

public abstract void reportLogs (ITestDevice device, 
                ITestLogger logger, 
                TestInvocation.Stage stage)

รายงานบันทึกของอุปกรณ์บางรายการในระยะต่างๆ ของการเรียกใช้ เช่น logcat

พารามิเตอร์
`device`	`ITestDevice`: อุปกรณ์ที่จะรายงานบันทึก
`logger`	`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` เพื่อรายงานบันทึก

การโยน
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
`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)

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

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

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

คิกรีเทิร์น
`boolean`	จริงหากมีการแบ่งกลุ่มการทดสอบ ไม่เช่นนั้น ให้แสดงผล `false`