IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

已知間接子類別 CdmaDeviceFlasher、FastbootDeviceFlasher、OtaUpdateDeviceFlasher、SystemUpdaterDeviceFlasher CdmaDeviceFlasher 透過 CDMA 無線電在實體 Android 裝置上刷新圖片的類別。  FastbootDeviceFlasher 這個類別會使用 Fastboot 在實體 Android 硬體上刷新映像檔。  OtaUpdateDeviceFlasher 裝置刷新器，可使用完整或增量 OTA 套件觸發 system/update_engine/scripts/update_device.py 指令碼，以便更新裝置映像檔。  SystemUpdaterDeviceFlasher IDeviceFlasher 會依賴系統更新器，安裝 OTA 更新套件中隨附的系統映像檔。

---

在裝置上刷新裝置映像檔。

摘要

公用方法
abstract void	flash(ITestDevice device, IDeviceBuildInfo deviceBuild) 閃爍的版本。
default	getAdditionalFileFilters() 取得其他建構構件的篩選器。
abstract CommandStatus	getSystemFlashingStatus() 擷取主要系統分區閃燈作業的指令執行狀態。
abstract IDeviceFlasher.UserDataFlashOption	getUserDataFlashOption() 取得是否應閃過、清除或保留使用者資料映像檔的權限
abstract void	overrideDeviceOptions(ITestDevice device) 覆寫裝置的選項。
default void	postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild) 所有必須在實際閃爍關鍵區塊後執行的清理作業和檢查作業。
default void	preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild) 所有必須在實際閃燈關鍵區塊前執行的設定作業和檢查。
abstract void	setDataWipeSkipList( dataWipeSkipList) 設定 /data 下的路徑清單，以免在使用 ITestsZipInstaller 時清除 請注意，略過清單的精細程度是 /data 的直接子項。
abstract void	setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever) 設定 Flasher 可擷取資源檔案進行刷新的機制。
abstract void	setForceSystemFlash(boolean forceSystemFlash) 設定是否應一律閃爍系統，即使正在執行目前版本也一樣
default void	setRamdiskPartition(String ramdiskPartition) 設定 RAMDISK 分割區
default void	setShouldFlashRamdisk(boolean shouldFlashRamdisk) 設定透過映像檔 ZIP 更新裝置後，是否要為其他 ramdisk 刷新
abstract void	setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption) 切換是否要刷新、抹除或保留使用者資料圖片
abstract void	setWipeTimeout(long timeout) 設定資料清除的逾時時間。
default boolean	shouldFlashRamdisk() 透過映像檔 ZIP 檔案更新裝置後，檢查 Flasher 是否設為需使用額外的 ramdisk
default boolean	supportsFlashingInFastbootD() 實作閃燈程式的裝置是否可以在快速系統啟動模式下閃燈。

公用方法

Flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

在裝置上刷新版本。

刷新完成後立即傳回。呼叫端應等待裝置連上網路且可供使用後，再繼續測試。

參數
device	ITestDevice：要閃爍的 ITestDevice
deviceBuild	IDeviceBuildInfo：要刷新的 IDeviceBuildInfo

擲回
TargetSetupError	如果無法刷新建構作業
DeviceNotAvailableException	如果裝置沒有回應

取得其他檔案篩選器

public  getAdditionalFileFilters ()

取得其他建構構件的篩選器。

部分閃爍程式需要特定的建構構件，而這些構件並非使用中的預設構件。這類閃燈應覆寫此方法，因此每位閃燈工具使用者都不需要瞭解這些檔案，也不需要提供指令列選項。

請注意，這個方法會在 IDeviceFlasher 的暫時例項上叫用，因此請勿依賴預設建構函式提供的狀態以外的狀態。

系統會將集合中的字串解讀為檔案模式，並擷取符合該模式的所有檔案。

根據預設，這個方法會傳回空的 Set。

傳回

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

擷取主要系統分區閃燈指令的執行狀態。

請注意，如果系統分區未刷新 (系統已有要刷新的版本)，指令狀態可能會是 null

傳回
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

取得是否應刷新、清除或保留使用者資料圖片

傳回
IDeviceFlasher.UserDataFlashOption	是否應刷新、清除或保留使用者資料圖片

覆寫裝置選項

public abstract void overrideDeviceOptions (ITestDevice device)

覆寫裝置的選項。如果特定裝置不支援預設值，則可用來覆寫預設選項值。

PostFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

所有必須在實際閃爍關鍵區塊後執行的清除作業和檢查作業。這些作業都不會納入並行控制的關鍵區塊。

參數
device	ITestDevice：要刷新的 ITestDevice
deviceBuild	IDeviceBuildInfo：要閃爍的 IDeviceBuildInfo

擲回
TargetSetupError	如果設定失敗
DeviceNotAvailableException	如果裝置沒有回應

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

所有必須在實際閃爍關鍵區塊前執行的設定作業和檢查作業。這些作業都不會納入並行控制的關鍵區塊。

參數
device	ITestDevice：要閃爍的 ITestDevice
deviceBuild	IDeviceBuildInfo：要刷新的 IDeviceBuildInfo

擲回
TargetSetupError	如果設定失敗
DeviceNotAvailableException	如果裝置沒有回應

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

設定 /data 下的路徑清單，以免在使用 ITestsZipInstaller 時清除

請注意，略過清單的精細程度是 /data 的直接子項。

參數
dataWipeSkipList

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

設定 Flasher 可擷取資源檔案進行刷新的機制。

參數
retriever	IFlashingResourcesRetriever：要使用的 IFlashingResourcesRetriever

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

設定是否應一律刷新系統 (即使在執行目前版本時)

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

設定 ramdisk 分區

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

設定是否要透過映像檔 ZIP 更新裝置後，是否應刷新其他 ramdisk

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

切換使用者資料映像檔應否閃過、清除或保留

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

設定清除資料的逾時時間。

參數
timeout	long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

檢查是否已設定刷新器，以便在透過圖像 ZIP 檔案更新裝置後，刷新額外的 RAMDISK

傳回
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

實作閃燈程式的裝置是否可以在快速啟動模式下閃燈。

傳回
boolean