裝置閃光器

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

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

請注意,跳過清單的粒度是/data的直接子級。

abstract void setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)

設定刷新器檢索資源文件以進行刷新的機制。

abstract void setForceSystemFlash (boolean forceSystemFlash)

設定係統是否應該始終刷新,即使運行當前版本

default void setRamdiskPartition (String ramdiskPartition)

設定虛擬磁碟分割區

default void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

設定透過映像 zip 更新裝置後是否應刷新附加 ramdisk

abstract void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

切換是否應刷新、擦除或保留使用者資料映像

abstract void setWipeTimeout (long timeout)

設定擦除資料的超時時間。

default boolean shouldFlashRamdisk ()

檢查刷新器是否設定為在透過映像 zip 更新裝置後應刷新額外的 ramdisk

default boolean supportsFlashingInFastbootD ()

實作 flasher 的裝置是否可以在 fastbootd 模式下進行刷新。

公共方法

閃光

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

閃存是在設備上建構的。

閃爍完成後立即返回。呼叫者應等待設備上線並可用,然後再繼續測試。

參數
device ITestDevice :要刷新的ITestDevice

deviceBuild IDeviceBuildInfo :要刷新的IDeviceBuildInfo

投擲
TargetSetupError如果快閃記憶體建置失敗
DeviceNotAvailableException如果設備變得無響應

取得附加文件過濾器

public  getAdditionalFileFilters ()

取得其他建置工件的過濾器。

有些 flashers 需要某些建置工件,而這些工件不屬於預設使用的工件。此類閃存程式應重寫此方法,因此快閃記憶體工具的每個使用者都不需要了解這些檔案並提供命令列選項。

請注意,此方法是在 IDeviceFlasher 的臨時實例上呼叫的,因此不應依賴預設建構函式中提供的狀態之外的任何狀態。

Set 中的字串被解釋為檔案模式,並且將檢索與該模式相符的所有檔案。

預設情況下,此方法傳回一個空 Set。

退貨

取得系統閃爍狀態

public abstract CommandStatus getSystemFlashingStatus ()

檢索刷新主系統分割區的命令執行狀態。

請注意,如果系統分割區未刷新(系統已經有要刷新的版本),則命令狀態可能為null

退貨
CommandStatus

取得用戶資料快閃記憶體選項

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

取得是否應刷新、擦除或保留使用者資料映像

退貨
IDeviceFlasher.UserDataFlashOption是否應刷新、擦除或保留使用者資料映像

覆蓋設備選項

public abstract void overrideDeviceOptions (ITestDevice device)

覆蓋設備的選項。如果特定裝置不支援預設值,則用於覆寫預設選項值。

閃後操作

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

所有清理操作和檢查必須在實際刷新關鍵部分之後進行。這些操作都不會包含在並發控制的關鍵部分。

參數
device ITestDevice :要刷新的ITestDevice

deviceBuild IDeviceBuildInfo :要刷新的IDeviceBuildInfo

投擲
TargetSetupError如果任何設定失敗
DeviceNotAvailableException如果設備變得無響應

預閃操作

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

所有設定操作和檢查必須在實際閃爍關鍵部分之前進行。這些操作都不會包含在並發控制的關鍵部分。

參數
device ITestDevice :要刷新的ITestDevice

deviceBuild IDeviceBuildInfo :要刷新的IDeviceBuildInfo

投擲
TargetSetupError如果任何設定失敗
DeviceNotAvailableException如果設備變得無響應

設定資料擦除跳過列表

public abstract void setDataWipeSkipList ( dataWipeSkipList)

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

請注意,跳過清單的粒度是/data的直接子級。

參數
dataWipeSkipList

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

設定刷新器檢索資源文件以進行刷新的機制。

參數
retriever IFlashingResourcesRetriever :要使用的IFlashingResourcesRetriever

設定強制系統快閃記憶體

public abstract void setForceSystemFlash (boolean forceSystemFlash)

設定係統是否應該始終刷新,即使運行當前版本

設定虛擬磁碟分割區

public void setRamdiskPartition (String ramdiskPartition)

設定虛擬磁碟分割區

設定ShouldFlash Ramdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

設定透過映像 zip 更新裝置後是否應刷新附加 ramdisk

設定用戶資料快閃記憶體選項

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

切換是否應刷新、擦除或保留使用者資料映像

設定擦除超時

public abstract void setWipeTimeout (long timeout)

設定擦除資料的超時時間。

參數
timeout long

應該Flash Ramdisk

public boolean shouldFlashRamdisk ()

檢查刷新器是否設定為在透過映像 zip 更新裝置後應刷新額外的 ramdisk

退貨
boolean

支援FlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

實作 flasher 的裝置是否可以在 fastbootd 模式下進行刷新。

退貨
boolean