ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

Subclass tidak langsung yang diketahui AdbStopServerPreparer , AllTestAppsInstallSetup , AoaTargetPreparer , AppSetup , ArtChrootPreparer , BaseEmulatorPreparer , BaseTargetPreparer , BuildInfoRecorder , CheckPairingPreparer , CompanionAllocator , CompanionAwarePreparer , CompanionRunCommandTargetPreparer , CompanionTestAppInstallSetup , CompileBootImageWithSpeedTargetPreparer , CpuThrottlingWaiter , and 68 others. AdbStopServerPreparer Targetkan pembuat untuk menghentikan server adb di host sebelum dan sesudah menjalankan pengujian adb. SemuaTestAppsInstallSetup ITargetPreparer yang menginstal semua aplikasi dari IDeviceBuildInfo#getTestsDir() ke perangkat. AoaTargetPreparer ITargetPreparer yang menjalankan serangkaian tindakan (misalnya klik dan geser) menggunakan protokol Android Open Accessory (AOAv2). Pengaturan Aplikasi ITargetPreparer yang menginstal apk dan pengujiannya. ArtCrootPreparer Buat direktori chroot untuk tes ART. BaseEmulatorPreparer Persiapan umum untuk meluncurkan emulator lokal. BaseTargetPreparer Kelas implementasi dasar untuk ITargetPreparer yang memungkinkan untuk mengontrol apakah objek dinonaktifkan atau tidak. BuildInfoRecorder ITargetPreparer yang menulis data meta info build ke file tertentu. CheckPairingPreparer CompanionAwarePreparer yang memverifikasi ikatan BT antara perangkat utama dan pendamping PendampingAlokasi Kelas dasar yang menangani pengalokasian dan pembebasan perangkat pendamping getCompanionDeviceSelectionOptions() harus diimplementasikan untuk menjelaskan kriteria yang diperlukan untuk mengalokasikan perangkat pendamping CompanionAwarePreparer ITargetPreparer yang merangkum logika mendapatkan perangkat pendamping yang sudah dialokasikan. CompanionRunCommandTargetPreparer ITargetPreparer yang menjalankan perintah tertentu pada perangkat pendamping yang dialokasikan CompanionTestAppInstallSetup ITargetPreparer yang menginstal satu atau beberapa aplikasi dari IDeviceBuildInfo#getTestsDir() ke perangkat pendamping yang dialokasikan. CompileBootImageWithSpeedTargetPreparer Mengkompilasi ulang classpath boot dan server sistem dengan 'kecepatan' filter kompilator. CpuThrottlingPelayan ITargetPreparer yang menunggu hingga frekuensi maksimum pada semua core dipulihkan ke level tertinggi yang tersedia BuatAvdPreparer BuatPenggunaPreparer Targetkan pembuat untuk membuat pengguna dan membersihkannya di akhir. DeviceBuildInfoBootStrapper ITargetPreparer yang menggantikan bidang info build dengan atribut yang dibaca dari perangkat 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 reboot atau memformat sebagai tindakan pembersihan setelah pengujian, dan secara opsional mematikan layar PerangkatFlashPreparer ITargetPreparer yang mem-flash gambar pada perangkat keras Android fisik. DeviceImageZipFlashingTargetPreparer Persiapan target yang mem-flash perangkat dengan gambar perangkat yang disediakan melalui format tertentu. DeviceOwnerTargetPreparer ITargetPreparer yang menyiapkan komponen pemilik perangkat. Pengaturan Perangkat ITargetPreparer yang mengonfigurasi perangkat untuk pengujian berdasarkan Option yang disediakan. Pengisi Penyimpanan Perangkat Targetkan pembuat untuk mengisi penyimpanan sehingga sejumlah ruang kosong tersedia. PerangkatStringPendorong Targetkan pembuat untuk menulis string ke file. DeviceUpdateTargetPreparer ITargetPreparer abstrak yang menangani langkah-langkah umum seputar memperbarui perangkat dengan file gambar perangkat dari sumber eksternal (sebagai lawan dari layanan build). Penghapus Perangkat ITargetPreparer yang menghapus data pengguna NonaktifkanSELinuxTargetPreparer Persiapan target yang menonaktifkan SELinux jika diaktifkan. DynamicSystemPreparer ITargetPreparer yang menyiapkan image sistem di atas build perangkat dengan Dynamic System Update. EraseUserDataPreparer ITargetPreparer yang menghapus data pengguna di perangkat. FastbootCommandPreparer Target preparer yang memicu fastboot dan mengirimkan perintah fastboot. FastbootUpdateBootstrapPreparer ITargetPreparer yang mementaskan file tertentu (bootloader, radio, zip gambar perangkat) ke IDeviceBuildInfo agar perangkat di-flash dengan FastbootDeviceFlasher , lalu menyuntikkan atribut perangkat pasca-boot ke dalam info build untuk tujuan pelaporan hasil. FiturFlagTargetPreparer Memperbarui DeviceConfig (tanda fitur yang disetel oleh layanan jarak jauh). LipatModePreparer Persiapan target yang dapat mengubah status perangkat yang dapat dilipat. FolderSaver ITargetPreparer yang menarik direktori dari perangkat, mengompres dan menyimpannya ke backend logging. GkiDeviceFlashPreparer Persiapan target yang mem-flash perangkat dengan gambar generik kernel umum android. GsiDeviceFlashPreparer Penyedia target yang mem-flash perangkat dengan citra sistem generik android. ILabPreparer Antarmuka penanda untuk pembuat lab Lihat ITargetPreparer untuk deskripsi tentang apa antarmuka ini dimaksudkan. Pembersih Target Antarmuka ini tidak digunakan lagi. tearDown telah dipindahkan ke antarmuka ITargetPreparer dasar. InstallAllTestZipAppsSetup ITargetPreparer yang menginstal semua aplikasi dalam zip pengujian. InstalApexModuleTargetPreparer InstalApkSetup ITargetPreparer yang menginstal satu atau lebih apk yang terletak di sistem file. InstalBuildEnvApkSetup ITargetPreparer yang menginstal satu atau lebih apk pengujian dari platform Android build env. InstrumentasiPreparer ITargetPreparer yang menjalankan instrumentasi KillExistingEmulatorPreparer ITargetPreparer yang mematikan emulator yang sedang berjalan. DikenalFailurePreparer Targetkan pembuat untuk melewati mencoba lagi kegagalan yang diketahui. Peluncuran Emulator Lokal TargetPreparer yang meluncurkan emulator secara lokal dari lingkungan build Android. LokalEmulatorSnapshot TargetPreparer yang dimaksudkan untuk menghasilkan snapshot emulator yang bersih dari lingkungan build/pengembangan Android ModulOemTargetPreparer Kolektor Kebocoran Asli ITargetPreparer yang menjalankan 'dumpsys meminfo --unreachable -a' untuk mengidentifikasi memori asli yang tidak terjangkau yang saat ini dipegang oleh setiap proses. NoApkTestSkipper Persiapan khusus yang memungkinkan untuk melewatkan permintaan sepenuhnya (persiapan dan pengujian) jika tidak ada apk untuk pengujian. PerfettoPreparer Penyedia Perfetto mendorong file konfigurasi ke perangkat di lokasi standar yang dapat diakses oleh perfetto. PushFileInvoker Kelas ini tidak digunakan lagi. Gunakan PushFilePreparer sebagai gantinya PushFilePreparer ITargetPreparer yang mencoba mendorong sejumlah file dari jalur host mana pun ke jalur perangkat apa pun. PythonVirtualenvPreparer Menyiapkan virtualenv Python di host dan menginstal paket. RebootTargetPreparer Persiapan target yang me-reboot perangkat. RecoveryLogPreparer Persiapan target yang digunakan untuk mengumpulkan log sebelum pemulihan. HapusSystemAppPreparer ITargetPreparer untuk menghapus apk dari partisi sistem sebelum uji coba. RestartSystemServerTargetPreparer Persiapan target yang memulai ulang server sistem tanpa me-reboot perangkat. RootTargetPreparer Persiapan target yang melakukan "adb root" atau "adb unroot" berdasarkan opsi "force-root". JalankanCommandTargetPreparer JalankanHostCommandTargetPreparer Targetkan pembuat untuk menjalankan perintah host arbitrer sebelum dan setelah menjalankan pengujian. JalankanHostScriptTargetPreparer Persiapan target yang mengeksekusi skrip sebelum menjalankan tes. RunOnSdkSandboxTargetPreparer ITargetPreparer untuk menandai bahwa pengujian harus dijalankan di sandbox SDK. 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. SemaphoreTokenTargetPreparer Ini adalah pembuat yang digunakan untuk menggunakan token untuk membuat serial eksekusi uji di host yang diperdagangkan. SideloadOtaTargetPreparer Persiapan target yang melakukan sideload paket OTA tertentu, menerapkan paket, menunggu perangkat untuk boot, dan menyuntikkan properti build perangkat untuk digunakan sebagai info build Persiapan 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. Pengaturan StopServices ITargetPreparer yang menghentikan layanan pada perangkat. StubTargetPreparer Implementasi kosong placeholder dari ITargetPreparer . SuiteApkInstaller Menginstal APK tertentu untuk konfigurasi Suite: baik dari variabel $ANDROID_TARGET_OUT_TESTCASES atau ROOT_DIR di info build. SwitchUserTargetPreparer ITargetPreparer yang beralih ke jenis pengguna tertentu di setUp. TearDownPassThroughPreparer Memungkinkan untuk menjalankan tearDown pada pembuat yang disertakan dalam konfigurasi sebagai objek. SuhuPelangiPelayan 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 lebih file/dir dari folder IDeviceBuildInfo.getTestsDir() ke perangkat. TestSystemAppInstallSetup ITargetPreparer yang menginstal satu atau beberapa aplikasi dari folder IDeviceBuildInfo.getTestsDir() ke partisi /system pada perangkat. Pembuang waktu Penyiapan target sederhana untuk membuang waktu dan berpotensi memulai ulang perangkat. Pembersih Pengguna ITargetPreparer yang menghapus pengguna sekunder saat pembongkaran. WaitForDeviceDatetimePreparer ITargetPreparer yang menunggu datetime disetel di perangkat Secara opsional, pembuat ini dapat memaksa TargetSetupError jika datetime tidak disetel dalam batas waktu, atau memaksa host datetime ke perangkat, WifiPreparer ITargetPreparer yang mengonfigurasi wifi di perangkat jika perlu.

---

Mempersiapkan lingkungan pengujian untuk uji coba.

Misalnya, menginstal perangkat lunak, mengubah pengaturan env untuk pengujian, meluncurkan target, dll.

Perhatikan bahwa beberapa ITargetPreparer s dapat ditentukan dalam konfigurasi. Direkomendasikan agar 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 perangkat lunak.

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 pengaturan target untuk pengujian.
default void	tearDown ( TestInformation testInformation, Throwable e) Lakukan pembersihan/teardown 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

mempersiapkan

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

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

Lakukan pengaturan target untuk pengujian.

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

Melempar
TargetSetupError	jika terjadi kesalahan fatal pengaturan lingkungan
BuildError	Jika terjadi kesalahan terkait dengan BuildInfo
DeviceNotAvailableException	jika perangkat menjadi tidak responsif

mempersiapkan

public void setUp (TestInformation testInformation)

Lakukan pengaturan target untuk pengujian.

Parameter
testInformation	TestInformation : TestInformation dari pemanggilan.

Melempar
TargetSetupError	jika terjadi kesalahan fatal pengaturan lingkungan
BuildError	Jika terjadi kesalahan karena build sedang disiapkan
DeviceNotAvailableException	jika perangkat menjadi tidak responsif

menangis

public void tearDown (TestInformation testInformation, 
                Throwable e)

Lakukan pembersihan/teardown target setelah pengujian.

Parameter
testInformation	TestInformation : TestInformation dari pemanggilan.
e	Throwable : jika pemanggilan diakhiri dengan eksepsi, ini akan menjadi eksepsi yang ditangkap pada tingkat Invokasi. Jika tidak, akan menjadi null .

Melempar
DeviceNotAvailableException	jika perangkat menjadi tidak responsif

menangis

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

Parameter
device	ITestDevice : ITestDevice yang harus disiapkan.
buildInfo	IBuildInfo : data tentang build yang sedang diuji.
e	Throwable : jika pemanggilan diakhiri dengan eksepsi, ini akan menjadi eksepsi yang ditangkap pada tingkat Invokasi. Jika tidak, akan menjadi null .

Melempar
DeviceNotAvailableException	jika perangkat menjadi tidak responsif