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

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

TestInvocation

public class TestInvocation
extends Object implements ITestInvocation

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

การใช้งาน ITestInvocation เริ่มต้น

โหลดออบเจ็กต์หลักตาม IConfiguration - เรียกข้อมูลบิลด์ - เตรียมเป้าหมาย - เรียกใช้การทดสอบ - รายงานผลลัพธ์

สรุป

ค่าคงที่
`long`	`AVAILABILITY_CHECK_TIMEOUT`

ช่อง
`public static final String`	`COMMAND_ARGS_KEY` คีย์ของแอตทริบิวต์ args ของบรรทัดคำสั่ง
`public static final String`	`INVOCATION_EXTERNAL_DEPENDENCIES`
`public static final String`	`TRADEFED_CONFIG_NAME`
`public static final String`	`TRADEFED_END_HOST_LOG`
`public static final String`	`TRADEFED_INVOC_COMPLETE_HOST_LOG`
`public static final String`	`TRADEFED_LOG_NAME`

ตัวสร้างแบบสาธารณะ
`TestInvocation()`

เมธอดสาธารณะ
`static IBuildInfo`	`backFillBuildInfoForReporting(String commandLine)` ตัวช่วยที่ใช้บรรทัดคำสั่งเพื่อทดแทน `IBuildInfo` สำหรับการรายงานในกรณีที่ดาวน์โหลดไม่สําเร็จ
`static FailureDescription`	`createFailureFromException(Throwable exception, TestRecordProto.FailureStatus defaultStatus)` สร้าง `FailureDescription` จากข้อยกเว้นการเรียกใช้
`IInvocationExecution`	`createInvocationExec(TestInvocation.RunMode mode)` สร้างเส้นทางการเรียกใช้ที่ควรทำตาม
`static String`	`getDeviceLogName(TestInvocation.Stage stage)`
`static String`	`getEmulatorLogName(TestInvocation.Stage stage)`
`ITestInvocation.ExitInformation`	`getExitInfo()` ข้อมูลการออกของคําเรียกที่ระบุ
`void`	`invoke(IInvocationContext context, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener... extraListeners)` เรียกใช้การทดสอบ
`static boolean`	`isSubprocess(IConfiguration config)` แสดงผลเป็น "จริง" หากการเรียกใช้อยู่ในขอบเขตของกระบวนการย่อย
`void`	`notifyInvocationForceStopped(String message, ErrorIdentifier errorId)` แจ้งให้ `TestInvocation` ทราบว่ามีการขอให้ TradeFed หยุดดำเนินการ
`void`	`notifyInvocationStopped(String message)` แจ้งให้ `TestInvocation` ทราบว่า TradeFed จะปิดตัวลงในที่สุด
`static void`	`printStageDelimiter(TestInvocation.Stage phase, boolean end)` พิมพ์ตัวคั่นสําหรับระยะที่ระบุของการเรียกใช้
`void`	`registerExecutionFiles(ExecutionFiles executionFiles)`
`void`	`setClearcutClient(ClearcutClient client)` ส่งต่อไคลเอ็นต์ Clearcut เพื่อรายงานเมตริก
`static boolean`	`shouldSkipBugreportError(Throwable t)` เมธอดตัวช่วยที่ระบุข้อผิดพลาดเมื่อควรข้ามการรายงานข้อบกพร่อง
`String`	`toString()`

วิธีการที่มีการป้องกัน
`void`	`addInvocationMetric(InvocationMetricLogger.InvocationMetricKey key, String value)`
`void`	`addInvocationMetric(InvocationMetricLogger.InvocationMetricKey key, long value)`
`void`	`applyAutomatedReporters(IConfiguration config)`
`void`	`setExitCode(CommandRunner.ExitCode code, Throwable stack)` ตัวช่วยในการตั้งค่ารหัสออก

ค่าคงที่

AVAILABILITY_CHECK_TIMEOUT

public static final long AVAILABILITY_CHECK_TIMEOUT

ค่าคงที่: 180000 (0x000000000002bf20)

ช่อง

COMMAND_ARGS_KEY

public static final String COMMAND_ARGS_KEY

คีย์ของแอตทริบิวต์ args ของบรรทัดคำสั่ง

INVOCATION_EXTERNAL_DEPENDENCIES

public static final String INVOCATION_EXTERNAL_DEPENDENCIES

TRADEFED_CONFIG_NAME

public static final String TRADEFED_CONFIG_NAME

TRADEFED_END_HOST_LOG

public static final String TRADEFED_END_HOST_LOG

TRADEFED_INVOC_COMPLETE_HOST_LOG

public static final String TRADEFED_INVOC_COMPLETE_HOST_LOG

TRADEFED_LOG_NAME

public static final String TRADEFED_LOG_NAME

ตัวสร้างแบบสาธารณะ

TestInvocation

public TestInvocation ()

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

backFillBuildInfoForReporting

public static IBuildInfo backFillBuildInfoForReporting (String commandLine)

ตัวช่วยที่ใช้บรรทัดคำสั่งเพื่อทดแทน IBuildInfo สำหรับการรายงานในกรณีที่ดาวน์โหลดไม่สําเร็จ

พารามิเตอร์
`commandLine`	`String`

คิกรีเทิร์น
`IBuildInfo`

createFailureFromException

public static FailureDescription createFailureFromException (Throwable exception, 
                TestRecordProto.FailureStatus defaultStatus)

สร้าง FailureDescription จากข้อยกเว้นการเรียกใช้

พารามิเตอร์
`exception`	`Throwable`: ข้อยกเว้นในการแปลง
`defaultStatus`	`TestRecordProto.FailureStatus`: สถานะที่จะใช้โดยค่าเริ่มต้นหากข้อยกเว้นไม่ใช่ `IHarnessException`

คิกรีเทิร์น
`FailureDescription`

createInvocationExec

public IInvocationExecution createInvocationExec (TestInvocation.RunMode mode)

สร้างเส้นทางการเรียกใช้ที่ควรทำตาม

พารามิเตอร์
`mode`	`TestInvocation.RunMode`: โหมดที่เราใช้อยู่ในปัจจุบัน

คิกรีเทิร์น
`IInvocationExecution`	`IInvocationExecution` ที่อธิบายการเรียกใช้

getDeviceLogName

public static String getDeviceLogName (TestInvocation.Stage stage)

พารามิเตอร์
`stage`	`TestInvocation.Stage`

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

getEmulatorLogName

public static String getEmulatorLogName (TestInvocation.Stage stage)

พารามิเตอร์
`stage`	`TestInvocation.Stage`

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

getExitInfo

public ITestInvocation.ExitInformation getExitInfo ()

ข้อมูลการออกของคําเรียกที่ระบุ

คิกรีเทิร์น
`ITestInvocation.ExitInformation`

เรียกใช้

public void invoke (IInvocationContext context, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener... extraListeners)

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

พารามิเตอร์
`context`	`IInvocationContext`: `IInvocationContext` ที่ใช้ทดสอบ
`config`	`IConfiguration`: `IConfiguration` ของการทดสอบนี้
`rescheduler`	`IRescheduler`: `IRescheduler` สำหรับกำหนดเวลาการเรียกใช้บางส่วนใหม่เพื่อดำเนินการในทรัพยากรอื่น
`extraListeners`	`ITestInvocationListener`: `ITestInvocationListener` ที่จะแจ้งเตือนนอกเหนือจากใน `config`

การโยน
`DeviceNotAvailableException`

isSubprocess

public static boolean isSubprocess (IConfiguration config)

แสดงผลเป็น "จริง" หากการเรียกใช้อยู่ในขอบเขตของกระบวนการย่อย

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

คิกรีเทิร์น
`boolean`

notifyInvocationForceStopped

public void notifyInvocationForceStopped (String message, 
                ErrorIdentifier errorId)

แจ้งให้ TestInvocation ทราบว่ามีการขอให้ TradeFed หยุดดำเนินการ

พารามิเตอร์
`message`	`String`: ข้อความที่เชื่อมโยงกับการหยุดการเรียกใช้
`errorId`	`ErrorIdentifier`: ตัวระบุที่เชื่อมโยงกับการหยุดทำงานแบบบังคับ

notifyInvocationStopped

public void notifyInvocationStopped (String message)

แจ้งให้ TestInvocation ทราบว่า TradeFed จะปิดตัวลงในที่สุด

พารามิเตอร์
`message`	`String`: ข้อความที่เชื่อมโยงกับการหยุดการเรียกใช้

printStageDelimiter

public static void printStageDelimiter (TestInvocation.Stage phase, 
                boolean end)

พิมพ์ตัวคั่นสําหรับระยะที่ระบุของการเรียกใช้

พารามิเตอร์
`phase`	`TestInvocation.Stage`
`end`	`boolean`

registerExecutionFiles

public void registerExecutionFiles (ExecutionFiles executionFiles)

พารามิเตอร์
`executionFiles`	`ExecutionFiles`

setClearcutClient

public void setClearcutClient (ClearcutClient client)

ส่งต่อไคลเอ็นต์ Clearcut เพื่อรายงานเมตริก

พารามิเตอร์
`client`	`ClearcutClient`

shouldSkipBugreportError

public static boolean shouldSkipBugreportError (Throwable t)

เมธอดตัวช่วยที่ระบุข้อผิดพลาดเมื่อควรข้ามการรายงานข้อบกพร่อง

พารามิเตอร์
`t`	`Throwable`

คิกรีเทิร์น
`boolean`

toString

public String toString ()

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

วิธีการที่มีการป้องกัน

addInvocationMetric

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                String value)

พารามิเตอร์
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`String`

addInvocationMetric

protected void addInvocationMetric (InvocationMetricLogger.InvocationMetricKey key, 
                long value)

พารามิเตอร์
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`long`

applyAutomatedReporters

protected void applyAutomatedReporters (IConfiguration config)

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

setExitCode

protected void setExitCode (CommandRunner.ExitCode code, 
                Throwable stack)

ตัวช่วยในการตั้งค่ารหัสออก แสดงเพื่อทดสอบ

พารามิเตอร์
`code`	`CommandRunner.ExitCode`
`stack`	`Throwable`