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)
設定裝置可透過哪種機制擷取資源檔案進行閃燈。 |
abstract
void
|
setForceSystemFlash(boolean forceSystemFlash)
設定是否應一律閃爍系統,即使正在執行目前版本也一樣 |
default
void
|
setRamdiskPartition(String ramdiskPartition)
設定 RAMDISK 分割區 |
default
void
|
setShouldFlashRamdisk(boolean shouldFlashRamdisk)
設定是否應在透過圖像 ZIP 檔案更新裝置後,再閃記額外的 RAM 磁碟。 |
abstract
void
|
setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)
切換使用者資料映像檔應否閃過、擦除或保留 |
abstract
void
|
setWipeTimeout(long timeout)
設定資料清除的逾時值。 |
default
boolean
|
shouldFlashRamdisk()
檢查是否已設定閃燈程式,以便在透過圖片 ZIP 檔案更新裝置後,閃燈程式應額外閃燈 ramdisk |
default
boolean
|
supportsFlashingInFastbootD()
實作閃燈程式的裝置是否可以在快速系統啟動模式下閃燈。 |
default
void
|
tearDownFlasher()
這是閃光燈實作項目最後一次清理自身的機會 |
公用方法
Flash
public abstract void flash (ITestDevice device, IDeviceBuildInfo deviceBuild)
在裝置上刷新版本。
閃燈完成後立即傳回。呼叫端應等待裝置上線並可供使用,再繼續進行測試。
參數 | |
---|---|
device |
ITestDevice :要閃爍的 ITestDevice |
deviceBuild |
IDeviceBuildInfo :要閃爍的 IDeviceBuildInfo |
擲回 | |
---|---|
TargetSetupError |
如果無法刷新建構作業 |
DeviceNotAvailableException |
如果裝置沒有回應 |
getAdditionalFileFilters
publicgetAdditionalFileFilters ()
取得其他建構構件專用的篩選器。
部分閃電器需要特定的建構構件,而這些構件並非使用中的預設構件。這類閃燈應覆寫此方法,因此每位閃燈工具使用者都不需要瞭解這些檔案,也不需要提供指令列選項。
請注意,這個方法會在 IDeviceFlasher 的暫時例項上叫用,因此請勿依賴預設建構函式提供的狀態以外的狀態。
系統會將 Set 中的字串解讀為檔案模式,並擷取符合模式的所有檔案。
根據預設,這個方法會傳回空的 Set。
傳回 | |
---|---|
|
getSystemFlashingStatus
public abstract CommandStatus getSystemFlashingStatus ()
擷取主要系統分區閃燈作業的指令執行狀態。
請注意,如果系統分區未完成刷新 (系統已具有要刷新的版本),指令狀態可能會是 null
傳回 | |
---|---|
CommandStatus |
getUserDataFlashOption
public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()
取得是否應閃過、清除或保留使用者資料映像檔
傳回 | |
---|---|
IDeviceFlasher.UserDataFlashOption |
是否應閃過、清除或保留使用者資料映像檔 |
overrideDeviceOptions
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)
設定刷新器可用來擷取資源檔案的機制,以便刷新。
參數 | |
---|---|
retriever |
IFlashingResourcesRetriever :要使用的 IFlashingResourcesRetriever |
setForceSystemFlash
public abstract void setForceSystemFlash (boolean forceSystemFlash)
設定是否應一律閃爍系統,即使執行目前版本也一樣
setRamdiskPartition
public void setRamdiskPartition (String ramdiskPartition)
設定 RAMDISK 分割區
setShouldFlashRamdisk
public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)
設定是否應在透過圖像 ZIP 檔案更新裝置後,再刷新額外的 RAM 磁碟
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 |
tearDownFlasher
public void tearDownFlasher ()
閃爍器實作項目最後一次清理自身的機會