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)

設定 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 裝置沒有回應時

取得其他檔案篩選器

public  getAdditionalFileFilters ()

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

某些 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