ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Subclass tidak langsung yang umum AdbStopServerPreparer Mempersiapkan target untuk menghentikan server adb pada 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).  Penyiapan Aplikasi ITargetPreparer yang menginstal apk dan pengujiannya.  ArtChrootPreparer Buat direktori chroot untuk pengujian ART.  BaseEmulatorPreparer Persiapan umum untuk meluncurkan emulator lokal.  BaseTargetPreparer Class implementasi dasar untuk ITargetPreparer yang memungkinkan kontrol apakah objek dinonaktifkan atau tidak.  BuildInfoRecorder ITargetPreparer yang menulis metadata info build ke dalam file tertentu.  CheckPairingPreparer CompanionAwarePreparer yang memverifikasi pengikatan BT antara perangkat utama dan pendamping  CompanionAllocator Class dasar yang menangani alokasi dan membebaskan perangkat pendamping getCompanionDeviceSelectionOptions() harus diterapkan untuk menjelaskan kriteria yang diperlukan guna mengalokasikan perangkat pendamping CompanionAwarePreparer ITargetPreparer yang mengenkapsulasi logika mendapatkan perangkat pendamping yang sudah 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'.  CpuThrottlingPelajar ITargetPreparer yang menunggu hingga frekuensi maksimum di semua core dipulihkan ke tingkat tertinggi yang tersedia  CreateAvdPreparer   CreateUserPreparer Mempersiapkan 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 (mis. DeviceBuildInfoInjector ITargetPreparer yang menyisipkan metadata DeviceBuildDescriptor ke dalam IBuildInfo.  Pembersih Perangkat Melakukan mulai ulang atau memformat sebagai tindakan pembersihan setelah pengujian, dan (opsional) menonaktifkan layar DeviceFlashPreparer ITargetPreparer yang mem-flash gambar di hardware Android fisik.  DeviceImageZipFlashingTargetPreparer Mempersiapkan 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 Mempersiapkan target untuk mengisi penyimpanan sehingga tersedia sedikit ruang kosong.  DeviceStringPusher Mempersiapkan target untuk menulis string ke file.  DeviceUpdateTargetPreparer ITargetPreparer abstrak yang menangani langkah-langkah umum seputar mengupdate perangkat dengan file image perangkat dari sumber eksternal (bukan layanan build).  Wiper Perangkat ITargetPreparer yang menghapus total data pengguna DisableSELinuxTargetPreparer Mempersiapkan target yang menonaktifkan SELinux jika diaktifkan.  DynamicSystemPreparer ITargetPreparer yang menyiapkan image sistem di atas build perangkat dengan Dynamic System Update.  MenghapusUserDataPreparer ITargetPreparer yang menghapus total data pengguna di perangkat.  FastbootCommandPreparer Peracik target yang memicu fastboot dan mengirim perintah fastboot.  FastbootUpdateBootstrapPreparer ITargetPreparer yang memperlihatkan file yang ditentukan (bootloader, radio, zip image perangkat) ke dalam IDeviceBuildInfo agar perangkat di-flash dengan FastbootDeviceFlasher, lalu memasukkan atribut perangkat pasca-booting ke dalam info build untuk tujuan pelaporan hasil.  FeatureFlagTargetPreparer Mengupdate DeviceConfig (tombol fitur yang disesuaikan oleh layanan jarak jauh).  FoldableModePreparer Pemicu target yang dapat mengubah status perangkat foldable.  FolderSaver ITargetPreparer yang mengambil direktori dari perangkat, mengompresi dan menyimpannya ke backend logging.  GkiDeviceFlashPreparer Pengatur target yang mem-flash perangkat dengan image generik kernel umum Android.  GsiDeviceFlashPreparer Mempersiapkan target yang mem-flash perangkat dengan image sistem generik Android.  ILabPreparer Antarmuka penanda untuk persiapan lab Lihat ITargetPreparer untuk mengetahui deskripsi tujuan antarmuka ini.  ITargetCleaner Antarmuka ini tidak digunakan lagi. splitdown telah dipindahkan ke antarmuka ITargetPreparer dasar.  InstallAllTestZipAppsSetup ITargetPreparer yang menginstal semua aplikasi di 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 mematikan emulator yang sedang berjalan.  KnownFailurePreparer Mempersiapkan target untuk melewati percobaan ulang kegagalan yang diketahui.  LocalEmulatorLaunch TargetPreparer yang meluncurkan emulator secara lokal dari lingkungan build Android.  LocalEmulatorSnapshot TargetPreparer dimaksudkan untuk menghasilkan snapshot emulator bersih dari lingkungan build/pengembangan Android MixKernelTargetPreparer ITargetPreparer yang memungkinkan penggabungan 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.  Persiapan Perfetto Persiapan Perfetto mendorong 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. Sebagai gantinya, gunakan PushFilePreparer PushFilePreparer ITargetPreparer yang mencoba mengirim sejumlah file dari jalur host mana pun ke jalur perangkat mana pun.  PythonVirtualenvPreparer Menyiapkan virtualenv Python pada host dan menginstal paket.  RebootTargetPreparer Mempersiapkan target yang memulai ulang perangkat.  RecoveryLogPreparer Mempersiapkan 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 Mempersiapkan 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 Mempersiapkan target yang menjalankan skrip sebelum menjalankan pengujian.  RunOnCloneProfileTargetPreparer   RunOnPrivateProfileTargetPreparer   RunOnSdkSandboxTargetPreparer ITargetPreparer untuk menandai bahwa pengujian harus berjalan 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 pada 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 dari 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 mengirim satu atau beberapa file/dir dari folder IDeviceBuildInfo.getTestsDir() ke perangkat.  TestSystemAppInstallSetup ITargetPreparer yang menginstal satu atau beberapa aplikasi dari folder IDeviceBuildInfo.getTestsDir() ke partisi /system di perangkat.  TimeWaster Mempersiapkan target sederhana untuk membuang waktu dan berpotensi memulai ulang perangkat.  Pembersih Pengguna ITargetPreparer yang menghapus pengguna sekunder saat pembongkaran.  VisibleBackgroundUserPreparer Persiapan target untuk menjalankan pengujian pada pengguna yang dimulai di latar belakang yang terlihat.  waitForDeviceDatetimePreparer ITargetPreparer yang menunggu datetime disetel di perangkat Secara opsional, preparer ini dapat memaksa TargetSetupError jika datetime tidak disetel dalam waktu tunggu.  Wi-FiPreparer ITargetPreparer yang mengonfigurasi Wi-Fi di perangkat jika diperlukan.

---

Menyiapkan lingkungan pengujian untuk pengujian.

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

Perhatikan bahwa beberapa ITargetPreparer dapat ditentukan dalam konfigurasi. Sebaiknya setiap ITargetPreparer dengan jelas mendokumentasikan pra-penyiapan 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. 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/pelepasan 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

penyiapan

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

penyiapan

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 error terjadi karena build sedang disiapkan
DeviceNotAvailableException	jika perangkat menjadi tidak responsif

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

Lakukan pembersihan/pembongkaran target setelah pengujian.

Parameter
testInformation	TestInformation: TestInformation pemanggilan.
e	Throwable: jika pemanggilan diakhiri dengan pengecualian, ini akan menjadi pengecualian yang terdeteksi di tingkat Pemanggilan. Jika tidak, akan menjadi null.

Menampilkan
DeviceNotAvailableException	jika perangkat tidak merespons

pembongkaran

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/perusakan target setelah pengujian.

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

Menampilkan
DeviceNotAvailableException	jika perangkat tidak merespons