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

取得是否應閃過、清除或保留使用者資料映像檔的權限

void overrideDeviceOptions(ITestDevice device)

覆寫裝置的選項。

void setDataWipeSkipList( dataWipeSkipList)

設定 /data 下的路徑清單,以免在使用 ITestsZipInstaller 時遭到清除。

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

void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

設定裝置可透過哪種機制擷取資源檔案來進行閃燈。

void setForceSystemFlash(boolean forceSystemFlash)

設定是否應一律閃爍系統,即使正在執行目前版本也一樣

void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

切換使用者資料映像檔應否閃過、清除或保留

此實作僅支援 IDeviceFlasher.UserDataFlashOption.TESTS_ZIPIDeviceFlasher.UserDataFlashOption.RETAIN 做為有效選項

void setWipeTimeout(long timeout)

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

公用建構函式

SystemUpdaterDeviceFlasher

public SystemUpdaterDeviceFlasher ()

公用方法

Flash

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

設定 /data 下的路徑清單,以免在使用 ITestsZipInstaller 時遭到清除。

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

參數
dataWipeSkipList

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

設定刷新器可用來擷取資源檔案的機制,以便刷新。

參數
retriever IFlashingResourcesRetriever:要使用的 IFlashingResourcesRetriever

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

設定是否應一律閃爍系統,即使正在執行目前版本也一樣

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

切換使用者資料映像檔應否閃過、清除或保留

此實作僅支援 IDeviceFlasher.UserDataFlashOption.TESTS_ZIPIDeviceFlasher.UserDataFlashOption.RETAIN 做為有效選項

setWipeTimeout

public void setWipeTimeout (long timeout)

設定資料清除的逾時值。

參數
timeout long