Mulai tahun 2026, untuk menyelaraskan dengan model pengembangan stabil trunk kami dan memastikan stabilitas platform untuk ekosistem, kami akan memublikasikan kode sumber ke AOSP pada Q2 dan Q4. Untuk membuat dan berkontribusi ke AOSP, gunakan android-latest-release. Cabang manifes android-latest-release akan selalu merujuk ke rilis terbaru yang dikirim ke AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

Subclass tidak langsung yang umum

DelegatedInvocationExecution, InvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution` yang mendelegasikan eksekusi ke biner Tradefed lain.
InvocationExecution	Class yang menjelaskan semua langkah pemanggilan: download build, target_prep, jalankan pengujian, hapus.
ParentSandboxInvocationExecution	Versi `InvocationExecution` untuk tindakan khusus pemanggilan induk saat menjalankan sandbox.
RemoteInvocationExecution	Penerapan `InvocationExecution` yang mendorong eksekusi jarak jauh.
SandboxedInvocationExecution	Eksekusi sandbox khusus dari pemanggilan: Ini adalah InvocationExection saat kita berada di dalam sandbox yang menjalankan perintah.

Antarmuka yang menjelaskan tindakan yang akan dilakukan sebagai bagian dari pemanggilan. Pemanggilan TestInvocation itu sendiri memastikan urutan panggilan.

Ringkasan

Metode publik
`default void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Jalankan langkah pembersihan build_provider.
`default void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` Jalankan langkah pembersihan target_preparer dan multi_target_preparer.
`default void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger)` Jalankan langkah penyiapan target_preparer dan multi_target_preparer.
`default void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Jalankan langkah penonaktifan target_preparer dan multi_target_preparer.
`default boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Jalankan langkah build_provider dari pemanggilan.
`abstract void`	`reportLogs(ITestDevice device, ITestLogger logger, TestInvocation.Stage stage)` Laporkan beberapa log perangkat pada tahap pemanggilan yang berbeda.
`default void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Panggil `ITestDevice.postInvocationTearDown(Throwable)` untuk setiap bagian perangkat dari pemanggilan.
`default void`	`runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)` Panggil `ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo))` untuk setiap bagian perangkat dari pemanggilan.
`default void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Menjalankan pengujian.
`default boolean`	`shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` Mencoba membagi konfigurasi menjadi sub-konfigurasi, yang akan dijadwalkan ulang untuk dijalankan di beberapa resource secara paralel.

Metode publik

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Jalankan langkah pembersihan build_provider. Terkait dengan pengambilan build.

Parameter
`context`	`IInvocationContext`: `IInvocationContext` pemanggilan.
`config`	`IConfiguration`: `IConfiguration` operasi pengujian ini.

doCleanUp

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

Jalankan langkah pembersihan target_preparer dan multi_target_preparer. Apakah perangkat membersihkan diri.

Parameter
`context`	`IInvocationContext`: `IInvocationContext` pemanggilan.
`config`	`IConfiguration`: `IConfiguration` operasi pengujian ini.
`exception`	`Throwable`: pengecualian asli yang ditampilkan oleh pengujian yang sedang berjalan.

doSetup

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger)

Jalankan langkah penyiapan target_preparer dan multi_target_preparer. Menyiapkan semua perangkat yang diperlukan agar pengujian dapat berjalan.

Parameter
`testInfo`	`TestInformation`: `TestInformation` pemanggilan.
`config`	`IConfiguration`: `IConfiguration` operasi pengujian ini.
`logger`	`ITestLogger`: `ITestLogger` untuk melaporkan log kegagalan penyiapan.

Menampilkan
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.targetprep.TargetSetupError
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

Jalankan langkah penonaktifan target_preparer dan multi_target_preparer. Menghapus perangkat yang terkait dengan penyiapan.

Parameter
`testInfo`	`TestInformation`: `TestInformation` pemanggilan.
`config`	`IConfiguration`: `IConfiguration` operasi pengujian ini.
`logger`	`ITestLogger`: `ITestLogger` untuk melaporkan log.
`exception`	`Throwable`: pengecualian asli yang ditampilkan oleh pengujian yang sedang berjalan.

Menampilkan
	java.lang.Throwable
`Throwable`

fetchBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

Jalankan langkah build_provider dari pemanggilan.

Parameter
`testInfo`	`TestInformation`: `TestInformation` pemanggilan.
`config`	`IConfiguration`: `IConfiguration` operasi pengujian ini.
`rescheduler`	`IRescheduler`: `IRescheduler`, untuk menjadwalkan ulang sebagian pemanggilan untuk dieksekusi di resource lain
`listener`	`ITestInvocationListener`: `ITestInvocation` untuk melaporkan kegagalan download build.

Hasil
`boolean`	Benar jika kita berhasil mendownload build, salah jika tidak.

Menampilkan
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.device.DeviceNotAvailableException
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

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

Laporkan beberapa log perangkat pada tahap pemanggilan yang berbeda. Misalnya: logcat.

Parameter
`device`	`ITestDevice`: Perangkat yang akan melaporkan log.
`logger`	`ITestLogger`: Logger untuk log.
`stage`	`TestInvocation.Stage`: Tahap pemanggilan saat ini.

runDevicePostInvocationTearDown

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

Panggil ITestDevice.postInvocationTearDown(Throwable) untuk setiap bagian perangkat dari pemanggilan.

Parameter
`context`	`IInvocationContext`: `IInvocationContext` pemanggilan.
`config`	`IConfiguration`: `IConfiguration` operasi pengujian ini.
`exception`	`Throwable`: pengecualian asli yang ditampilkan oleh pengujian yang sedang berjalan jika ada.

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

Panggil ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) untuk setiap bagian perangkat dari pemanggilan.

Parameter
`context`	`IInvocationContext`: `IInvocationContext` pemanggilan.
`config`	`IConfiguration`: `IConfiguration` operasi pengujian ini.
`logger`	`ITestLogger`: `ITestLogger` untuk melaporkan log.

Menampilkan
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`

runTests

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

Menjalankan pengujian.

Parameter
`info`	`TestInformation`: `TestInformation` untuk menjalankan pengujian.
`config`	`IConfiguration`: `IConfiguration` yang akan dijalankan
`listener`	`ITestInvocationListener`: `ITestInvocationListener` hasil pengujian

Menampilkan
	java.lang.Throwable
`Throwable`

shardConfig

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

Mencoba membagi konfigurasi menjadi sub-konfigurasi, yang akan dijadwalkan ulang untuk dijalankan di beberapa resource secara paralel.

Jika jumlah shard lebih besar dari 1, konfigurasi untuk setiap shard akan dibuat dengan menetapkan indeks shard dan menjadwalkannya ulang. Jika jumlah shard tidak ditetapkan,nilai defaultnya adalah IShardHelper.shardConfig.

Parameter
`config`	`IConfiguration`: `IConfiguration` saat ini.
`testInfo`	`TestInformation`: `TestInformation` yang menyimpan info pengujian.
`rescheduler`	`IRescheduler`: `IRescheduler`.
`logger`	`ITestLogger`: `ITestLogger` yang digunakan untuk mencatat file selama sharding.

Hasil
`boolean`	benar jika pengujian di-shard. Jika tidak, tampilkan `false`