SystemUpdaterDeviceFlasher

public class SystemUpdaterDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Object
   ↳ com.android.tradefed.targetprep.SystemUpdaterDeviceFlasher

IDeviceFlasher：依賴系統更新程式安裝 OTA 更新套件中綁定的系統映像檔。具體來說，這項實作項目不會依賴 Fastboot。

摘要

公用建構函式

SystemUpdaterDeviceFlasher()

公用方法

void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

在裝置上刷新版本。

這項實作方式假設 IDeviceBuildInfo.getDeviceImageFile() 傳回的裝置映像檔是 OTA 更新 ZIP 檔。
CommandStatus getSystemFlashingStatus()

擷取刷寫主要系統分割區的指令執行狀態。

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

Gets whether the user data image should be flashed, wiped, or retained

void overrideDeviceOptions(ITestDevice device)

裝置的覆寫選項。

void setDataWipeSkipList(Collection<String> dataWipeSkipList)

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

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

void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

設定 Flasher 可擷取資源檔案以進行刷機的機制。

void setForceSystemFlash(boolean forceSystemFlash)

設定系統是否一律要刷機，即使目前執行的版本也是如此

void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

切換是否應清除、保留或刷入使用者資料映像檔

這項實作方式僅支援 IDeviceFlasher.UserDataFlashOption.TESTS_ZIP 和 IDeviceFlasher.UserDataFlashOption.RETAIN 做為有效選項

void setWipeTimeout(long timeout)

設定清除資料的逾時時間。

公用建構函式

SystemUpdaterDeviceFlasher

public SystemUpdaterDeviceFlasher ()

公用方法

刷新

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

在裝置上刷新版本。

韌體更新完成後，系統會立即傳回結果。呼叫端應等待裝置上線並可供使用，再繼續進行測試。

這項實作會假設 IDeviceBuildInfo.getDeviceImageFile() 傳回的裝置映像檔是 OTA 更新 ZIP 檔。如果這種解讀方式不適用於特定情境，請勿使用這個更新程式。

參數
device ITestDevice：要刷新的 ITestDevice
deviceBuild IDeviceBuildInfo：要刷新的 IDeviceBuildInfo
擲回
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

擷取主要系統分割區的閃爍指令執行狀態。

請注意，如果未刷入系統分割區 (系統已具備要刷入的建構版本)，指令狀態可能會是 null

傳回
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

取得是否應清除、保留或清除使用者資料映像檔

傳回
IDeviceFlasher.UserDataFlashOption 是否要清除、保留或刷入使用者資料映像檔

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

覆寫裝置的選項。如果特定裝置不支援預設選項值，可用於覆寫預設選項值。

setDataWipeSkipList

public void setDataWipeSkipList (Collection<String> dataWipeSkipList)

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

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

參數
dataWipeSkipList Collection

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

設定 Flasher 擷取資源檔案以進行刷機的機制。

參數
retriever IFlashingResourcesRetriever：要使用的 IFlashingResourcesRetriever

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

設定是否一律要刷入系統，即使目前執行的版本相同也一樣

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

切換是否應清除、保留或刷入使用者資料映像檔

這項實作方式僅支援 IDeviceFlasher.UserDataFlashOption.TESTS_ZIP 和 IDeviceFlasher.UserDataFlashOption.RETAIN 這兩個有效選項

setWipeTimeout

public void setWipeTimeout (long timeout)

設定清除資料的逾時時間。

參數
timeout long