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( dataWipeSkipList)

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

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

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

public  getAdditionalFileFilters ()

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

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

請注意，這個方法會在 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 ()

閃爍器實作項目最後一次清理自身的機會