本頁面由 Cloud Translation API 翻譯而成。

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_ZIP` 和 `IDeviceFlasher.UserDataFlashOption#RETAIN` 做為有效選項
`void`	`setWipeTimeout(long timeout)` 設定資料清除的逾時時間。

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`

public CommandStatus getSystemFlashingStatus ()

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

請注意，如果系統分區未刷新 (系統已有要刷新的版本)，指令狀態可能會是 null

傳回
`CommandStatus`

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

取得是否應刷新、清除或保留使用者資料圖片

傳回
`IDeviceFlasher.UserDataFlashOption`	是否應刷新、清除或保留使用者資料圖片

public void overrideDeviceOptions (ITestDevice device)

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

public void setDataWipeSkipList ( dataWipeSkipList)

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

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

參數
`dataWipeSkipList`

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

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

參數
`retriever`	`IFlashingResourcesRetriever`：要使用的 `IFlashingResourcesRetriever`

public void setForceSystemFlash (boolean forceSystemFlash)

設定是否應一律刷新系統 (即使在執行目前版本時)

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

public void setWipeTimeout (long timeout)

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

參數
`timeout`	`long`