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

OtaUpdateDeviceFlasher

public class OtaUpdateDeviceFlasher
extends Object implements IDeviceFlasher

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

裝置刷新器會使用完整或增量 OTA 套件觸發 system/update_engine/scripts/update_device.py 指令碼，以便更新裝置映像檔。為正確使用這個刷新器，裝置的建構資訊必須包含名為「update-device-script」的檔案項目，並指向上述的劇本。

摘要

欄位
`protected static final String`	`IN_ZIP_SCRIPT_PATH`
`protected static final String`	`OTA_DOWNGRADE_PROP`
`protected static final String`	`UPDATE_DEVICE_SCRIPT`
`protected static final String`	`UPDATE_SUCCESS_OUTPUT`

公用建構函式
`OtaUpdateDeviceFlasher()`

公用方法
`void`	`flash(ITestDevice device, IDeviceBuildInfo deviceBuild)` 在裝置上刷新版本。
`CommandStatus`	`getSystemFlashingStatus()` 擷取主要系統分區閃燈作業的指令執行狀態。
`IDeviceFlasher.UserDataFlashOption`	`getUserDataFlashOption()` 取得是否應閃過、清除或保留使用者資料映像檔的權限
`void`	`overrideDeviceOptions(ITestDevice device)` 覆寫裝置的選項。
`void`	`preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)` 所有必須在實際閃燈關鍵區塊前執行的設定作業和檢查作業。
`void`	`setDataWipeSkipList( dataWipeSkipList)` 設定 `/data` 下的路徑清單，以免在使用 `ITestsZipInstaller` 時遭到清除。請注意，略過清單的精細程度是 `/data` 的直接子項。
`void`	`setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)` 設定裝置可透過哪種機制擷取資源檔案來進行閃燈。
`void`	`setForceSystemFlash(boolean forceSystemFlash)` 設定是否應一律閃爍系統，即使正在執行目前版本也一樣
`void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` 切換使用者資料映像檔應否刷新、清除或保留
`void`	`setWipeTimeout(long timeout)` 設定資料清除的逾時時間。

受保護的方法
`IRunUtil`	`getRunUtil()`

欄位

IN_ZIP_SCRIPT_PATH

protected static final String IN_ZIP_SCRIPT_PATH

OTA_DOWNGRADE_PROP

protected static final String OTA_DOWNGRADE_PROP

UPDATE_DEVICE_SCRIPT

protected static final String UPDATE_DEVICE_SCRIPT

UPDATE_SUCCESS_OUTPUT

protected static final String UPDATE_SUCCESS_OUTPUT

公用建構函式

OtaUpdateDeviceFlasher

public OtaUpdateDeviceFlasher ()

公用方法

Flash

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

在裝置上刷新版本。

閃燈完成後立即傳回。呼叫端應等待裝置上線並可供使用，再繼續進行測試。

參數
`device`	`ITestDevice`：要閃爍的 `ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`：要閃爍的 `IDeviceBuildInfo`

擲回
`DeviceNotAvailableException`
`TargetSetupError`

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

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

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

傳回
`CommandStatus`

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

傳回
`IDeviceFlasher.UserDataFlashOption`	是否應閃過、清除或保留使用者資料映像檔

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

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

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

所有必須在實際閃爍關鍵區塊之前執行的設定作業和檢查作業。這些作業都不會納入並行控制的關鍵區塊。

參數
`device`	`ITestDevice`：要閃爍的 `ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`：要閃爍的 `IDeviceBuildInfo`

擲回
`DeviceNotAvailableException`
`TargetSetupError`

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)

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

setWipeTimeout

public void setWipeTimeout (long timeout)

設定資料清除的逾時值。

參數
`timeout`	`long`

受保護的方法

getRunUtil

protected IRunUtil getRunUtil ()

傳回
`IRunUtil`