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 79 lainnya.

AdbStopServerPreparer	Penyiap target untuk menghentikan server adb di host sebelum dan setelah 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	Buat direktori chroot untuk pengujian ART.
BaseEmulatorPreparer	Penyiapan 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 dalam file tertentu.
CheckPairingPreparer	`CompanionAwarePreparer` yang memverifikasi pengaitan BT antara perangkat utama dan pendamping
CompanionAllocator	Class dasar yang menangani alokasi dan pelepasan perangkat pendamping `getCompanionDeviceSelectionOptions()` harus diterapkan untuk menjelaskan kriteria yang diperlukan untuk mengalokasikan perangkat pendamping
CompanionAwarePreparer	`ITargetPreparer` yang merangkum logika untuk mendapatkan perangkat pendamping yang sudah dialokasikan.
CompanionRunCommandTargetPreparer	`ITargetPreparer` yang menjalankan perintah tertentu 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 boot dan server sistem dengan filter compiler 'speed'.
CpuThrottlingWaiter	`ITargetPreparer` yang menunggu hingga frekuensi maksimum pada semua core dipulihkan ke level tertinggi yang tersedia
CreateAvdPreparer
CreateUserPreparer	Penyiapan target untuk membuat pengguna dan membersihkannya di akhir.
DeviceActionTargetPreparer	`ITargetPreparer` untuk melakukan tindakan perangkat.
DeviceBuildInfoBootStrapper	`ITargetPreparer` yang menggantikan 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 format sebagai tindakan pembersihan setelah pengujian, dan secara opsional mematikan layar
DeviceFlashPreparer	`ITargetPreparer` yang mem-flash image pada hardware Android fisik.
DeviceImageZipFlashingTargetPreparer	Penyiapan 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 diberikan.
DeviceStorageFiller	Penyiapan target untuk mengisi penyimpanan sehingga tersedia ruang kosong dalam jumlah tertentu.
DeviceStringPusher	Penyiapan target untuk menulis string ke file.
DeviceUpdateTargetPreparer	`ITargetPreparer` abstrak yang menangani langkah-langkah umum seputar mengupdate perangkat dengan file image perangkat dari sumber eksternal (berbeda dengan layanan build).
DeviceWiper	`ITargetPreparer` yang menghapus data pengguna
DisableSELinuxTargetPreparer	Penyiap 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	Penyiap target yang memicu fastboot dan mengirim perintah fastboot.
FastbootUpdateBootstrapPreparer	`ITargetPreparer` yang melakukan penyiapan file tertentu (bootloader, radio, ZIP image perangkat) ke dalam `IDeviceBuildInfo` untuk mem-flash perangkat dengan `FastbootDeviceFlasher`, lalu menyuntikkan atribut perangkat setelah booting ke dalam info build untuk tujuan pelaporan hasil.
FeatureFlagTargetPreparer	Memperbarui DeviceConfig (tanda fitur yang disesuaikan oleh layanan jarak jauh).
FoldableModePreparer	Penyiap target yang dapat mengubah status perangkat foldable.
FolderSaver	`ITargetPreparer` yang menarik direktori dari perangkat, mengompresi, dan menyimpannya ke backend logging.
FutilityCommandPreparer	Persiapan untuk menjalankan perintah sia-sia.
GkiDeviceFlashPreparer	Penyiapan target yang mem-flash perangkat dengan image generik kernel umum Android.
GoogleAccountPreparer	`ITargetPreparer` yang mendukung konfigurasi akun Google.
GsiDeviceFlashPreparer	Penyiapan target yang mem-flash perangkat dengan image sistem generik Android.
ILabPreparer	Antarmuka penanda untuk penyiap 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 ada di sistem file.
InstallBuildEnvApkSetup	`ITargetPreparer` yang menginstal satu atau beberapa APK pengujian dari lingkungan build platform Android.
InstallKernelModulePreparer	Penyiapan target yang menginstal modul kernel.
InstrumentationPreparer	`ITargetPreparer` yang menjalankan instrumentasi
KillExistingEmulatorPreparer	`ITargetPreparer` yang menonaktifkan emulator yang sedang berjalan.
KnownFailurePreparer	Penyiap target untuk melewati percobaan ulang kegagalan yang diketahui.
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
MixKernelTargetPreparer	`ITargetPreparer` yang memungkinkan untuk menggabungkan image kernel dengan image perangkat.
MixRadioTargetPreparer	`ITargetPreparer` yang memungkinkan untuk mencampur gambar radio dengan gambar perangkat.
ModuleOemTargetPreparer
NativeLeakCollector	`ITargetPreparer` yang menjalankan 'dumpsys meminfo --unreachable -a' untuk mengidentifikasi memori native yang tidak dapat dijangkau yang saat ini ditahan oleh setiap proses.
NoApkTestSkipper	Penyiap khusus yang memungkinkan untuk melewati pemanggilan sepenuhnya (persiapan dan pengujian) jika tidak ada APK yang akan diuji.
PerfettoPreparer	Penyiap Perfetto mengirimkan file konfigurasi ke perangkat di lokasi standar yang dapat diakses oleh Perfetto.
ProfileTargetPreparer	Class dasar untuk menyiapkan penyiapan target bagi pengguna profil `android.os.usertype.profile.XXX`.
PushFileInvoker	Class ini tidak digunakan lagi. Gunakan `PushFilePreparer` sebagai gantinya
PushFilePreparer	`ITargetPreparer` yang mencoba mengirim sejumlah file dari jalur host mana pun ke jalur perangkat mana pun.
PythonVirtualenvPreparer	Menyiapkan virtualenv Python di host dan menginstal paket.
RebootTargetPreparer	Penyiap target yang memulai ulang perangkat.
RecoveryLogPreparer	Penyiap target yang digunakan untuk mengumpulkan log sebelum pemulihan.
RemoveSystemAppPreparer	`ITargetPreparer` untuk menghapus APK dari partisi sistem sebelum menjalankan pengujian.
RestartSystemServerTargetPreparer	Penyiap target yang memulai ulang server sistem tanpa melakukan reboot perangkat.
RootTargetPreparer	Menargetkan pembuat yang melakukan "adb root" atau "adb unroot" berdasarkan opsi "force-root".
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Penyiap target untuk menjalankan perintah host arbitrer sebelum dan setelah menjalankan pengujian.
RunHostScriptTargetPreparer	Penyiap target yang menjalankan skrip sebelum menjalankan pengujian.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	`ITargetPreparer` untuk menandai bahwa pengujian harus dijalankan di sandbox SDK.
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` untuk memastikan bahwa 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 preparer yang digunakan untuk menggunakan token guna melakukan serialisasi eksekusi pengujian di host tradefed.
SideloadOtaTargetPreparer	Penyiap target yang melakukan sideload paket OTA tertentu, menerapkan paket, menunggu perangkat melakukan booting, dan menyuntikkan properti build perangkat untuk digunakan sebagai info build Penyiap 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: baik 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 menjalankan tearDown pada preparer 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 mengirim 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	Penyiap target sederhana untuk membuang-buang waktu dan berpotensi memulai ulang perangkat.
UserCleaner	`ITargetPreparer` yang menghapus pengguna sekunder saat penguraian.
VisibleBackgroundUserPreparer	Penyiapan target untuk menjalankan pengujian di pengguna yang dimulai di latar belakang yang terlihat.
WaitForDeviceDatetimePreparer	`ITargetPreparer` yang menunggu hingga tanggal dan waktu disetel di perangkat Secara opsional, preparer ini dapat memaksakan `TargetSetupError` jika datetime tidak ditetapkan dalam waktu tunggu.
WifiPreparer	`ITargetPreparer` yang mengonfigurasi Wi-Fi di perangkat jika perlu.

Menyiapkan lingkungan pengujian untuk menjalankan pengujian.

Misalnya, menginstal software, mengubah setelan env untuk pengujian, meluncurkan target, dll.

Perhatikan bahwa beberapa ITargetPreparer dapat ditentukan dalam satu konfigurasi. Setiap ITargetPreparer sebaiknya mendokumentasikan dengan jelas penyiapan awal dan pasca-penyiapan lingkungan yang diharapkan. 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. Gunakan `setUp(com.android.tradefed.invoker.TestInformation)` sebagai gantinya
`default void`	`setUp(TestInformation testInformation)` Lakukan penyiapan target untuk pengujian.
`default void`	`tearDown(TestInformation testInformation, Throwable e)` Lakukan pembersihan/penonaktifan target setelah pengujian.
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` Metode ini tidak digunakan lagi. Gunakan `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)` sebagai gantinya

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 terkait BuildInfo
`DeviceNotAvailableException`	jika perangkat tidak responsif

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 menjadi tidak responsif

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Lakukan pembersihan/penonaktifan 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 adalah `null`.

Menampilkan
`DeviceNotAvailableException`	jika perangkat tidak responsif

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/penonaktifan 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 adalah `null`.

Menampilkan
`DeviceNotAvailableException`	jika perangkat menjadi tidak responsif