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