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

AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CheckPairingPreparer, CompanionAllocator, CompanionAwarePreparer, CompanionRunCommandTargetPreparer, CompanionTestAppInstallSetup, CompileBootImageWithSpeedTargetPreparer, CpuThrottlingWaiter, dan 76 lainnya.

AdbStopServerPreparer	Persiapan target untuk menghentikan server adb di host sebelum dan sesudah menjalankan pengujian adb.
AllTestAppsInstallSetup	`ITargetPreparer` yang menginstal semua aplikasi dari folder `IDeviceBuildInfo.getTestsDir()` ke perangkat.
AoaTargetPreparer	`ITargetPreparer` yang menjalankan serangkaian tindakan (misalnya, klik dan geser) menggunakan protokol Android Open Accessory (AOAv2).
AppSetup	`ITargetPreparer` yang menginstal apk dan pengujiannya.
ArtChrootPreparer	Membuat direktori chroot untuk pengujian ART.
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.
CheckPairingPreparer	`CompanionAwarePreparer` yang memverifikasi pengikatan BT antara perangkat utama dan pendamping
CompanionAllocator	Class dasar yang menangani alokasi dan pembebasan perangkat pendamping `getCompanionDeviceSelectionOptions()` harus diterapkan untuk mendeskripsikan kriteria yang diperlukan untuk mengalokasikan perangkat pendamping
CompanionAwarePreparer	`ITargetPreparer` yang mengenkapsulasi logika untuk mendapatkan perangkat pendamping yang telah dialokasikan.
CompanionRunCommandTargetPreparer	`ITargetPreparer` yang menjalankan perintah yang ditentukan di perangkat pendamping yang dialokasikan
CompanionTestAppInstallSetup	`ITargetPreparer` yang menginstal satu atau beberapa aplikasi dari folder `IDeviceBuildInfo.getTestsDir()` ke perangkat pendamping yang dialokasikan.
CompileBootImageWithSpeedTargetPreparer	Mengompilasi ulang classpath booting dan server sistem dengan filter compiler 'speed'.
CpuThrottlingWaiter	`ITargetPreparer` yang menunggu hingga frekuensi maksimum di semua core dipulihkan ke tingkat tertinggi yang tersedia
CreateAvdPreparer
CreateUserPreparer	Persiapan target untuk membuat pengguna dan membersihkannya di akhir.
DeviceActionTargetPreparer	`ITargetPreparer` untuk melakukan tindakan perangkat.
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.
DeviceOwnerTargetPreparer	`ITargetPreparer` yang menyiapkan komponen pemilik perangkat.
DeviceSetup	`ITargetPreparer` yang mengonfigurasi perangkat untuk pengujian berdasarkan `Option` yang disediakan.
DeviceStorageFiller	Target penyiapan untuk mengisi penyimpanan sehingga tersedia sejumlah ruang kosong.
DeviceStringPusher	Persiapan target untuk menulis string ke file.
DeviceUpdateTargetPreparer	`ITargetPreparer` abstrak yang menangani langkah-langkah umum seputar update perangkat dengan file image perangkat dari sumber eksternal (bukan layanan build).
DeviceWiper	`ITargetPreparer` yang menghapus total data pengguna
DisableSELinuxTargetPreparer	Peracik target yang menonaktifkan SELinux jika diaktifkan.
DynamicSystemPreparer	`ITargetPreparer` yang menyiapkan image sistem di atas build perangkat dengan Dynamic System Update.
EraseUserDataPreparer	`ITargetPreparer` yang menghapus total data pengguna di perangkat.
FastbootCommandPreparer	Peracik target yang memicu fastboot dan mengirim perintah fastboot.
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.
FeatureFlagTargetPreparer	Memperbarui DeviceConfig (flag fitur yang disesuaikan oleh layanan jarak jauh).
FoldableModePreparer	Penyedia target yang dapat mengubah status perangkat foldable.
FolderSaver	`ITargetPreparer` yang menarik direktori dari perangkat, mengompresi, dan menyimpannya ke backend logging.
GkiDeviceFlashPreparer	Pengatur target yang mem-flash perangkat dengan image generik kernel umum Android.
GsiDeviceFlashPreparer	Pengatur target yang mem-flash perangkat dengan image sistem umum Android.
ILabPreparer	Antarmuka penanda untuk pembuat lab Lihat `ITargetPreparer` untuk mengetahui deskripsi tujuan antarmuka ini.
ITargetCleaner	Antarmuka ini tidak digunakan lagi. tearDown telah dipindahkan ke antarmuka ITargetPreparer dasar.
InstallAllTestZipAppsSetup	`ITargetPreparer` yang menginstal semua aplikasi dalam zip pengujian.
InstallApexModuleTargetPreparer
InstallApkSetup	`ITargetPreparer` yang menginstal satu atau beberapa apk yang terletak di sistem file.
InstallBuildEnvApkSetup	`ITargetPreparer` yang menginstal satu atau beberapa apk pengujian dari lingkungan build platform Android.
InstallKernelModulePreparer	Penyedia target yang menginstal modul kernel.
InstrumentationPreparer	`ITargetPreparer` yang menjalankan instrumentasi
KillExistingEmulatorPreparer	`ITargetPreparer` yang menonaktifkan emulator yang sedang berjalan.
KnownFailurePreparer	Target penyiapan untuk melewati percobaan ulang kegagalan yang diketahui.
LocalEmulatorLaunch	TargetPreparer yang meluncurkan emulator secara lokal dari lingkungan build Android.
LocalEmulatorSnapshot	TargetPreparer yang dimaksudkan untuk membuat snapshot emulator yang bersih dari lingkungan build/pengembangan Android
MixKernelTargetPreparer	`ITargetPreparer` yang memungkinkan untuk menggabungkan image kernel dengan image perangkat.
ModuleOemTargetPreparer
NativeLeakCollector	`ITargetPreparer` yang menjalankan 'dumpsys meminfo --unreachable -a' untuk mengidentifikasi memori native yang tidak dapat dijangkau yang saat ini disimpan oleh setiap proses.
NoApkTestSkipper	Penyiapan khusus yang memungkinkan untuk melewati pemanggilan sepenuhnya (persiapan dan pengujian) jika tidak ada apk untuk diuji.
PerfettoPreparer	Peracik Perfetto mengirimkan file konfigurasi ke perangkat di lokasi standar yang dapat diakses oleh Perfetto.
ProfileTargetPreparer	Class dasar untuk menyiapkan peracik target bagi pengguna profil `android.os.usertype.profile.XXX`.
PushFileInvoker	Class ini tidak digunakan lagi. Gunakan `PushFilePreparer` sebagai gantinya
PushFilePreparer	`ITargetPreparer` yang mencoba mendorong sejumlah file dari jalur host mana pun ke jalur perangkat mana pun.
PythonVirtualenvPreparer	Menyiapkan virtualenv Python di host dan menginstal paket.
RebootTargetPreparer	Persiapan target yang memulai ulang perangkat.
RecoveryLogPreparer	Pengatur target yang digunakan untuk mengumpulkan log sebelum pemulihan.
RemoveSystemAppPreparer	`ITargetPreparer` untuk menghapus apk dari partisi sistem sebelum pengujian dijalankan.
RestartSystemServerTargetPreparer	Peracik target yang memulai ulang server sistem tanpa memulai ulang perangkat.
RootTargetPreparer	Peracik target yang menjalankan "adb root" atau "adb unroot" berdasarkan opsi "force-root".
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Persiapan target untuk menjalankan perintah host arbitrer sebelum dan sesudah menjalankan pengujian.
RunHostScriptTargetPreparer	Persiapan target yang mengeksekusi skrip sebelum menjalankan pengujian.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	`ITargetPreparer` untuk menandai bahwa pengujian harus berjalan di sandbox sdk.
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` untuk memastikan pengujian berjalan sebagai pengguna sekunder.
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.
SemaphoreTokenTargetPreparer	Ini adalah penyiapan yang digunakan untuk menggunakan token guna melakukan serialisasi eksekusi pengujian di host tradefed.
SideloadOtaTargetPreparer	Pengatur target yang melakukan sideload paket OTA yang ditentukan, menerapkan paket, menunggu perangkat melakukan booting, dan memasukkan properti build perangkat untuk digunakan sebagai info build Penyedia target ini mengasumsikan bahwa perangkat akan berada dalam mode adb reguler saat dimulai, dan akan memastikan bahwa perangkat keluar dalam mode yang sama, tetapi dengan build yang lebih baru diterapkan.
StopServicesSetup	`ITargetPreparer` yang menghentikan layanan di perangkat.
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.
SwitchUserTargetPreparer	`ITargetPreparer` yang beralih ke jenis pengguna yang ditentukan di setUp.
TearDownPassThroughPreparer	Memungkinkan untuk menjalankan tearDown pada penyiapan yang disertakan dalam konfigurasi sebagai objek.
TemperatureThrottlingWaiter	`ITargetPreparer` yang menunggu hingga suhu perangkat turun ke target
TestAppInstallSetup	`ITargetPreparer` yang menginstal satu atau beberapa aplikasi dari folder `IDeviceBuildInfo.getTestsDir()` ke perangkat.
TestFilePushSetup	`ITargetPreparer` yang mendorong satu atau beberapa file/direktori dari folder `IDeviceBuildInfo.getTestsDir()` ke perangkat.
TestSystemAppInstallSetup	`ITargetPreparer` yang menginstal satu atau beberapa aplikasi dari folder `IDeviceBuildInfo.getTestsDir()` ke partisi /system di perangkat.
TimeWaster	Penyedia target sederhana untuk membuang waktu dan berpotensi memulai ulang perangkat.
UserCleaner	`ITargetPreparer` yang menghapus pengguna sekunder saat penghapusan.
VisibleBackgroundUserPreparer	Persiapan target untuk menjalankan pengujian di pengguna yang dimulai di latar belakang yang terlihat.
WaitForDeviceDatetimePreparer	`ITargetPreparer` yang menunggu tanggal waktu ditetapkan di perangkat Secara opsional, penyiapan ini dapat memaksa `TargetSetupError` jika tanggal waktu tidak ditetapkan dalam waktu tunggu.
WifiPreparer	`ITargetPreparer` yang mengonfigurasi Wi-Fi di perangkat jika diperlukan.

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