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.

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Subclass tidak langsung yang umum

BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CreateAvdPreparer, CreateUserPreparer, DeviceBuildInfoBootStrapper, DeviceBuildInfoInjector, DeviceCleaner, DeviceFlashPreparer, DeviceImageZipFlashingTargetPreparer, DeviceSetup, DeviceUpdateTargetPreparer, FastbootUpdateBootstrapPreparer, FoldableModePreparer, GkiDeviceFlashPreparer, dan 15 lainnya.

BaseEmulatorPreparer	Persiapan umum untuk meluncurkan emulator lokal.
BaseTargetPreparer	Class implementasi dasar untuk `ITargetPreparer` yang memungkinkan untuk mengontrol apakah objek dinonaktifkan atau tidak.
BuildInfoRecorder	`ITargetPreparer` yang menulis metadata info build ke file yang ditentukan.
CreateAvdPreparer
CreateUserPreparer	Persiapan target untuk membuat pengguna dan membersihkannya di akhir.
DeviceBuildInfoBootStrapper	`ITargetPreparer` yang mengganti kolom info build dengan atribut yang dibaca dari perangkat Hal ini berguna untuk menguji perangkat dengan build yang dihasilkan dari sumber eksternal (misalnya,
DeviceBuildInfoInjector	`ITargetPreparer` yang menyisipkan metadata `DeviceBuildDescriptor` ke dalam `IBuildInfo`.
DeviceCleaner	Melakukan mulai ulang atau memformat sebagai tindakan pembersihan setelah pengujian, dan secara opsional menonaktifkan layar
DeviceFlashPreparer	`ITargetPreparer` yang mem-flash image pada hardware Android fisik.
DeviceImageZipFlashingTargetPreparer	Penyedia target yang mem-flash perangkat dengan image perangkat yang disediakan melalui format tertentu.
DeviceSetup	`ITargetPreparer` yang mengonfigurasi perangkat untuk pengujian berdasarkan `Option` yang disediakan.
DeviceUpdateTargetPreparer	`ITargetPreparer` abstrak yang menangani langkah-langkah umum seputar update perangkat dengan file image perangkat dari sumber eksternal (bukan layanan build).
FastbootUpdateBootstrapPreparer	`ITargetPreparer` yang melakukan staging file yang ditentukan (bootloader, radio, zip image perangkat) ke `IDeviceBuildInfo` untuk mem-flash perangkat dengan `FastbootDeviceFlasher`, lalu memasukkan atribut perangkat pasca-booting ke info build untuk tujuan pelaporan hasil.
FoldableModePreparer	Penyedia target yang dapat mengubah status perangkat foldable.
GkiDeviceFlashPreparer	Pengatur target yang mem-flash perangkat dengan image generik kernel umum Android.
GsiDeviceFlashPreparer	Penyedia target yang mem-flash perangkat dengan image sistem umum Android.
ITargetCleaner	Antarmuka ini tidak digunakan lagi. tearDown telah dipindahkan ke antarmuka ITargetPreparer dasar.
InstallApexModuleTargetPreparer
KillExistingEmulatorPreparer	`ITargetPreparer` yang menonaktifkan emulator yang sedang berjalan.
LocalEmulatorLaunch	TargetPreparer yang meluncurkan emulator secara lokal dari lingkungan build Android.
LocalEmulatorSnapshot	TargetPreparer yang ditujukan untuk membuat snapshot emulator bersih dari lingkungan build/pengembangan Android
ModuleOemTargetPreparer
RecoveryLogPreparer	Pengatur target yang digunakan untuk mengumpulkan log sebelum pemulihan.
RunCommandTargetPreparer
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` yang membuat pengguna sekunder dalam penyiapan, dan menandai bahwa pengujian harus dijalankan di pengguna tersebut.
RunOnSystemUserTargetPreparer	`ITargetPreparer` yang menandai bahwa pengujian harus dijalankan pada pengguna (bukan pengguna saat ini).
RunOnWorkProfileTargetPreparer	`ITargetPreparer` yang membuat profil kerja dalam penyiapan, dan menandai bahwa pengujian harus dijalankan di pengguna tersebut.
StubTargetPreparer	Implementasi kosong placeholder `ITargetPreparer`.
SuiteApkInstaller	Menginstal APK yang ditentukan untuk konfigurasi Suite: dari variabel $ANDROID_TARGET_OUT_TESTCASES atau ROOT_DIR dalam info build.
TestAppInstallSetup	`ITargetPreparer` yang menginstal satu atau beberapa aplikasi dari folder `IDeviceBuildInfo.getTestsDir()` ke perangkat.

Menyiapkan lingkungan pengujian untuk pengujian yang dijalankan.

Misalnya, menginstal software, menyesuaikan setelan lingkungan untuk pengujian, meluncurkan target, dll.

Perhatikan bahwa beberapa ITargetPreparer dapat ditentukan dalam konfigurasi. Sebaiknya setiap ITargetPreparer mendokumentasikan pra-penyiapan dan pasca-penyiapan lingkungan yang diharapkan dengan jelas. Misalnya, ITargetPreparer yang mengonfigurasi perangkat untuk pengujian harus dijalankan setelah ITargetPreparer yang menginstal software.

Ringkasan

Metode publik
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Metode ini tidak digunakan lagi. Sebagai gantinya, gunakan `setUp(com.android.tradefed.invoker.TestInformation)`
`default void`	`setUp(TestInformation testInformation)` Lakukan penyiapan target untuk pengujian.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` Lakukan pembersihan/pembongkaran target setelah pengujian.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` Metode ini tidak digunakan lagi. Sebagai gantinya, gunakan `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)`

Metode publik

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Metode ini tidak digunakan lagi.
Gunakan setUp(com.android.tradefed.invoker.TestInformation) sebagai gantinya

Lakukan penyiapan target untuk pengujian.

Parameter
`device`	`ITestDevice`: `ITestDevice` yang akan disiapkan.
`buildInfo`	`IBuildInfo`: data tentang build yang sedang diuji.

Menampilkan
`TargetSetupError`	jika terjadi error fatal saat menyiapkan lingkungan
`BuildError`	Jika terjadi error yang terkait dengan BuildInfo
`DeviceNotAvailableException`	jika perangkat tidak merespons

setUp

public void setUp (TestInformation testInformation)

Lakukan penyiapan target untuk pengujian.

Parameter
`testInformation`	`TestInformation`: `TestInformation` pemanggilan.

Menampilkan
`TargetSetupError`	jika terjadi error fatal saat menyiapkan lingkungan
`BuildError`	Jika terjadi error karena build sedang disiapkan
`DeviceNotAvailableException`	jika perangkat tidak merespons

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Lakukan pembersihan/pembongkaran target setelah pengujian.

Parameter
`testInformation`	`TestInformation`: `TestInformation` pemanggilan.
`e`	`Throwable`: jika pemanggilan berakhir dengan pengecualian, ini akan menjadi pengecualian yang tertangkap di tingkat Pemanggilan. Jika tidak, nilainya akan menjadi `null`.

Menampilkan
`DeviceNotAvailableException`	jika perangkat tidak merespons

tearDown

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

Metode ini tidak digunakan lagi.
Gunakan tearDown(com.android.tradefed.invoker.TestInformation, Throwable) sebagai gantinya

Lakukan pembersihan/pembongkaran target setelah pengujian.

Parameter
`device`	`ITestDevice`: `ITestDevice` yang akan disiapkan.
`buildInfo`	`IBuildInfo`: data tentang build yang sedang diuji.
`e`	`Throwable`: jika pemanggilan berakhir dengan pengecualian, ini akan menjadi pengecualian yang tertangkap di tingkat Pemanggilan. Jika tidak, nilainya akan menjadi `null`.

Menampilkan
`DeviceNotAvailableException`	jika perangkat tidak merespons