IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

Subclass tidak langsung yang umum CdmaDeviceFlasher, FastbootDeviceFlasher, OtaUpdateDeviceFlasher, SystemUpdaterDeviceFlasher CdmaDeviceFlasher Class yang menampilkan gambar di perangkat Android fisik dengan radio CDMA.  FastbootDeviceFlasher Class yang mengandalkan fastboot untuk mem-flash image pada hardware Android fisik.  OtaUpdateDeviceFlasher Flasher perangkat yang memicu skrip system/update_engine/scripts/update_device.py dengan paket OTA penuh atau inkremental untuk mengupdate image perangkat.  SystemUpdaterDeviceFlasher IDeviceFlasher yang mengandalkan pengupdate sistem untuk menginstal image sistem yang di-bundle dalam paket update OTA.

---

Mem-flash image perangkat di perangkat.

Ringkasan

Metode publik
abstract void	flash(ITestDevice device, IDeviceBuildInfo deviceBuild) Mem-flash build di perangkat.
default	getAdditionalFileFilters() Mendapatkan filter untuk artefak build tambahan.
abstract CommandStatus	getSystemFlashingStatus() Mengambil status eksekusi perintah untuk mem-flash partisi sistem utama.
abstract IDeviceFlasher.UserDataFlashOption	getUserDataFlashOption() Mendapatkan apakah gambar data pengguna harus di-flash, dihapus, atau dipertahankan
abstract void	overrideDeviceOptions(ITestDevice device) Opsi penggantian untuk perangkat.
default void	postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild) Semua operasi & pemeriksaan pembersihan yang harus dilakukan setelah bagian penting flashing yang sebenarnya.
default void	preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild) Semua operasi & pemeriksaan penyiapan yang harus dilakukan sebelum mem-flash bagian penting yang sebenarnya.
abstract void	setDataWipeSkipList( dataWipeSkipList) Menetapkan daftar jalur di /data agar tidak dihapus saat menggunakan ITestsZipInstaller Perhatikan bahwa perincian daftar lewati adalah turunan langsung dari /data.
default void	setExtraMetadata( metadata) Memungkinkan flasher menerima opsi metadata tambahan.
abstract void	setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever) Menetapkan mekanisme yang digunakan flasher untuk mengambil file resource untuk flashing.
abstract void	setForceSystemFlash(boolean forceSystemFlash) Menetapkan apakah sistem harus selalu di-flash meskipun menjalankan build saat ini
default void	setRamdiskPartition(String ramdiskPartition) Menetapkan partisi ramdisk
default void	setShouldFlashRamdisk(boolean shouldFlashRamdisk) Menetapkan apakah ramdisk tambahan harus di-flash setelah mengupdate perangkat melalui zip image
abstract void	setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption) Mengalihkan apakah image data pengguna harus di-flash, dihapus, atau dipertahankan
abstract void	setWipeTimeout(long timeout) Tetapkan waktu tunggu untuk menghapus data.
default boolean	shouldFlashRamdisk() Memeriksa apakah flasher disetel untuk memiliki ramdisk tambahan yang harus di-flash setelah mengupdate perangkat melalui zip image
default boolean	supportsFlashingInFastbootD() Apakah perangkat yang mengimplementasikan flasher dapat di-flash dalam mode fastbootd.
default void	tearDownFlasher() Peluang terakhir bagi penerapan flasher untuk membersihkan dirinya sendiri

Metode publik

flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Mem-flash build di perangkat.

Langsung kembali setelah flashing selesai. Pemanggil harus menunggu hingga perangkat online dan tersedia sebelum melanjutkan pengujian.

Parameter
device	ITestDevice: ITestDevice yang akan di-flash
deviceBuild	IDeviceBuildInfo: IDeviceBuildInfo yang akan di-flash

Menampilkan
TargetSetupError	jika gagal mem-flash build
DeviceNotAvailableException	jika perangkat tidak responsif

getAdditionalFileFilters

public  getAdditionalFileFilters ()

Mendapatkan filter untuk artefak build tambahan.

Beberapa flasher memerlukan artefak build tertentu yang tidak termasuk dalam artefak default yang digunakan. Flasher tersebut harus mengganti metode ini, sehingga setiap pengguna alat flashing tidak perlu mengetahui file ini dan memberikan opsi command line.

Perhatikan bahwa metode ini dipanggil pada instance sementara IDeviceFlasher, sehingga tidak ada status di luar yang disediakan dalam konstruktor default yang harus diandalkan.

String dalam Set ditafsirkan sebagai pola file, dan semua file yang cocok dengan pola tersebut akan diambil.

Secara default, metode ini menampilkan Set kosong.

Hasil

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

Mengambil status eksekusi perintah untuk mem-flash partisi sistem utama.

Perhatikan bahwa jika partisi sistem tidak di-flash (sistem sudah memiliki build yang akan di-flash), status perintah mungkin null

Hasil
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Mendapatkan apakah gambar data pengguna harus di-flash, dihapus, atau dipertahankan

Hasil
IDeviceFlasher.UserDataFlashOption	Apakah image data pengguna harus di-flash, dihapus, atau dipertahankan

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Opsi penggantian untuk perangkat. Digunakan untuk mengganti nilai opsi default jika nilai default tidak didukung oleh perangkat tertentu.

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Semua operasi & pemeriksaan pembersihan yang harus dilakukan setelah bagian penting flashing yang sebenarnya. Tidak ada operasi tersebut yang akan disertakan dalam bagian penting yang dikontrol serentak.

Parameter
device	ITestDevice: ITestDevice yang akan di-flash
deviceBuild	IDeviceBuildInfo: IDeviceBuildInfo yang akan di-flash

Menampilkan
TargetSetupError	jika ada penyiapan yang gagal
DeviceNotAvailableException	jika perangkat tidak responsif

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Semua operasi & pemeriksaan penyiapan yang harus dilakukan sebelum mem-flash bagian penting yang sebenarnya. Tidak ada operasi tersebut yang akan disertakan dalam bagian penting yang dikontrol serentak.

Parameter
device	ITestDevice: ITestDevice yang akan di-flash
deviceBuild	IDeviceBuildInfo: IDeviceBuildInfo yang akan di-flash

Menampilkan
TargetSetupError	jika ada penyiapan yang gagal
DeviceNotAvailableException	jika perangkat tidak responsif

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

Menetapkan daftar jalur di /data agar tidak dihapus saat menggunakan ITestsZipInstaller

Perhatikan bahwa perincian daftar lewati adalah turunan langsung dari /data.

Parameter
dataWipeSkipList

setExtraMetadata

public void setExtraMetadata ( metadata)

Memungkinkan flasher menerima opsi metadata tambahan.

Parameter
metadata

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Menetapkan mekanisme yang digunakan flasher untuk mengambil file resource untuk flashing.

Parameter
retriever	IFlashingResourcesRetriever: IFlashingResourcesRetriever yang akan digunakan

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Menetapkan apakah sistem harus selalu di-flash meskipun menjalankan build saat ini

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Menetapkan partisi ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Menetapkan apakah ramdisk tambahan harus di-flash setelah mengupdate perangkat melalui zip image

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Mengalihkan apakah image data pengguna harus di-flash, dihapus, atau dipertahankan

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

Tetapkan waktu tunggu untuk menghapus data.

Parameter
timeout	long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Memeriksa apakah flasher disetel untuk memiliki ramdisk tambahan yang harus di-flash setelah mengupdate perangkat melalui zip image

Hasil
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

Apakah perangkat yang mengimplementasikan flasher dapat di-flash dalam mode fastbootd.

Hasil
boolean

tearDownFlasher

public void tearDownFlasher ()

Peluang terakhir bagi penerapan flasher untuk membersihkan dirinya sendiri