自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 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`