Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

TestInvocation

public class TestInvocation
extends Object implements ITestInvocation

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

Implementasi default ITestInvocation.

Memuat objek utama berdasarkan IConfiguration - mengambil build - menyiapkan target - menjalankan pengujian - melaporkan hasil

Ringkasan

Konstanta
`long`	`AVAILABILITY_CHECK_TIMEOUT`

Kolom
`public static final String`	`COMMAND_ARGS_KEY` Kunci atribut args command line
`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`

Konstruktor publik
`TestInvocation()`

Metode publik
`static IBuildInfo`	`backFillBuildInfoForReporting(String commandLine)` Helper yang menggunakan command line untuk mengisi ulang `IBuildInfo` untuk pelaporan jika terjadi kegagalan download.
`static FailureDescription`	`createFailureFromException(Throwable exception, TestRecordProto.FailureStatus defaultStatus)` Buat `FailureDescription` dari pengecualian pemanggilan.
`IInvocationExecution`	`createInvocationExec(TestInvocation.RunMode mode)` Buat jalur pemanggilan yang harus diikuti.
`static String`	`getDeviceLogName(TestInvocation.Stage stage)`
`static String`	`getEmulatorLogName(TestInvocation.Stage stage)`
`ITestInvocation.ExitInformation`	`getExitInfo()` Informasi keluar dari pemanggilan yang diberikan.
`void`	`invoke(IInvocationContext context, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener... extraListeners)` Lakukan pemanggilan pengujian.
`static boolean`	`isSubprocess(IConfiguration config)` Menampilkan nilai benar (true) jika pemanggilan saat ini berada dalam cakupan subproses.
`void`	`notifyInvocationForceStopped(String message, ErrorIdentifier errorId)` Beri tahu `TestInvocation` bahwa TradeFed telah diminta untuk berhenti.
`void`	`notifyInvocationStopped(String message)` Beri tahu `TestInvocation` bahwa TradeFed pada akhirnya akan dinonaktifkan.
`static void`	`printStageDelimiter(TestInvocation.Stage phase, boolean end)` Mencetak pembatas untuk Tahap pemanggilan tertentu.
`void`	`registerExecutionFiles(ExecutionFiles executionFiles)`
`void`	`setClearcutClient(ClearcutClient client)` Teruskan klien clearcut untuk melaporkan metrik.
`static boolean`	`shouldSkipBugreportError(Throwable t)` Metode helper yang mengidentifikasi error saat bugreport harus dilewati
`String`	`toString()`

Metode yang dilindungi
`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)` Helper untuk menetapkan kode keluar.

Konstanta

AVAILABILITY_CHECK_TIMEOUT

public static final long AVAILABILITY_CHECK_TIMEOUT

Nilai Konstanta: 180000 (0x000000000002bf20)

Kolom

COMMAND_ARGS_KEY

public static final String COMMAND_ARGS_KEY

Kunci atribut args command line

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

Konstruktor publik

TestInvocation

public TestInvocation ()

Metode publik

backFillBuildInfoForReporting

public static IBuildInfo backFillBuildInfoForReporting (String commandLine)

Helper yang menggunakan command line untuk mengisi ulang IBuildInfo untuk pelaporan jika terjadi kegagalan download.

Parameter
`commandLine`	`String`

Hasil
`IBuildInfo`

createFailureFromException

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

Buat FailureDescription dari pengecualian pemanggilan.

Parameter
`exception`	`Throwable`: Pengecualian yang akan dikonversi
`defaultStatus`	`TestRecordProto.FailureStatus`: Status yang akan digunakan secara default jika pengecualian bukan `IHarnessException`.

Hasil
`FailureDescription`

createInvocationExec

public IInvocationExecution createInvocationExec (TestInvocation.RunMode mode)

Buat jalur pemanggilan yang harus diikuti.

Parameter
`mode`	`TestInvocation.RunMode`: Mode yang saat ini kita jalankan.

Hasil
`IInvocationExecution`	`IInvocationExecution` yang menjelaskan pemanggilan.

getDeviceLogName

public static String getDeviceLogName (TestInvocation.Stage stage)

Parameter
`stage`	`TestInvocation.Stage`

Hasil
`String`

getEmulatorLogName

public static String getEmulatorLogName (TestInvocation.Stage stage)

Parameter
`stage`	`TestInvocation.Stage`

Hasil
`String`

getExitInfo

public ITestInvocation.ExitInformation getExitInfo ()

Informasi keluar dari pemanggilan yang diberikan.

Hasil
`ITestInvocation.ExitInformation`

memanggil

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

Lakukan pemanggilan pengujian.

Parameter
`context`	`IInvocationContext`: `IInvocationContext` untuk melakukan pengujian.
`config`	`IConfiguration`: `IConfiguration` dari pengujian ini dijalankan.
`rescheduler`	`IRescheduler`: `IRescheduler`, untuk menjadwalkan ulang bagian pemanggilan untuk dieksekusi di resource lain
`extraListeners`	`ITestInvocationListener`: `ITestInvocationListener` yang akan diberi tahu, selain yang ada di `config`

Menampilkan
`DeviceNotAvailableException`

isSubprocess

public static boolean isSubprocess (IConfiguration config)

Menampilkan nilai benar (true) jika pemanggilan saat ini berada dalam cakupan subproses.

Parameter
`config`	`IConfiguration`

Hasil
`boolean`

notifyInvocationForceStopped

public void notifyInvocationForceStopped (String message, 
                ErrorIdentifier errorId)

Beri tahu TestInvocation bahwa TradeFed telah diminta untuk berhenti.

Parameter
`message`	`String`: Pesan yang terkait dengan penghentian pemanggilan
`errorId`	`ErrorIdentifier`: ID yang terkait dengan penghentian paksa

notifyInvocationStopped

public void notifyInvocationStopped (String message)

Beri tahu TestInvocation bahwa TradeFed pada akhirnya akan dinonaktifkan.

Parameter
`message`	`String`: Pesan yang terkait dengan penghentian pemanggilan

printStageDelimiter

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

Mencetak pembatas untuk Tahap pemanggilan tertentu.

Parameter
`phase`	`TestInvocation.Stage`
`end`	`boolean`

registerExecutionFiles

public void registerExecutionFiles (ExecutionFiles executionFiles)

Parameter
`executionFiles`	`ExecutionFiles`

setClearcutClient

public void setClearcutClient (ClearcutClient client)

Teruskan klien clearcut untuk melaporkan metrik.

Parameter
`client`	`ClearcutClient`

shouldSkipBugreportError

public static boolean shouldSkipBugreportError (Throwable t)

Metode helper yang mengidentifikasi error saat bugreport harus dilewati

Parameter
`t`	`Throwable`

Hasil
`boolean`

toString

public String toString ()

Hasil
`String`

Metode yang dilindungi

addInvocationMetric

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

Parameter
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`String`

addInvocationMetric

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

Parameter
`key`	`InvocationMetricLogger.InvocationMetricKey`
`value`	`long`

applyAutomatedReporters

protected void applyAutomatedReporters (IConfiguration config)

Parameter
`config`	`IConfiguration`

setExitCode

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

Helper untuk menetapkan kode keluar. Ditampilkan untuk pengujian.

Parameter
`code`	`CommandRunner.ExitCode`
`stack`	`Throwable`