IDeviceFlasher
public
interface
IDeviceFlasher
com.android.tradefed.targetprep.IDeviceFlasher |
在裝置上刷新裝置映像檔。
摘要
公用方法 | |
---|---|
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(
設定
請注意,略過清單的精細程度是 |
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()
檢查 Flasher 是否設定為在更新後需傳送額外的 ramdisk 透過圖片 ZIP 檔案 |
default
boolean
|
supportsFlashingInFastbootD()
設定實作 Flasher 的裝置是否可在 Fastbootd 模式中刷新。 |
公用方法
Flash
public abstract void flash (ITestDevice device, IDeviceBuildInfo deviceBuild)
裝置會刷新。
刷新完成後立即傳回。來電者應等待裝置 並在繼續測試前使用。
參數 | |
---|---|
device |
ITestDevice :要刷新的 ITestDevice |
deviceBuild |
IDeviceBuildInfo :要刷新的 IDeviceBuildInfo |
擲回 | |
---|---|
TargetSetupError |
如果無法刷新版本 |
DeviceNotAvailableException |
裝置沒有回應時 |
取得其他檔案篩選器
publicgetAdditionalFileFilters ()
取得其他建構構件的篩選器。
某些 Flasher 需要某些版本構件,但這些構件並非預設使用中的構件。這些 Flasher 應覆寫此方法,因此,刷新工具的使用者不需要 瞭解這些檔案並提供指令列選項
請注意,此方法是在 IDeviceFlasher 的臨時例項上叫用,因此 除預設建構函式中提供的狀態外,也應依賴該狀態。
組合中的字串會解讀為檔案模式,且所有符合該模式的檔案 。
在預設情況下,這個方法會傳回空的集合。
傳回 | |
---|---|
|
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 分區
setSetFlashRamdisk
public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)
設定是否在透過映像檔 ZIP 更新裝置後,應刷新其他 ramdisk
setUserDataFlashOption
public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)
切換是否要刷新、抹除或保留使用者資料圖片
設定抹除逾時
public abstract void setWipeTimeout (long timeout)
設定清除資料的逾時時間。
參數 | |
---|---|
timeout |
long |
應該使用 FlashRamdisk
public boolean shouldFlashRamdisk ()
檢查 Flasher 是否設定為在更新後需傳送額外的 ramdisk 透過圖片 ZIP 檔案
傳回 | |
---|---|
boolean |
支援 FlashingInFastbootD
public boolean supportsFlashingInFastbootD ()
設定實作 Flasher 的裝置是否可在 Fastbootd 模式中刷新。
傳回 | |
---|---|
boolean |