DeviceFlashPreparer

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver, ITestLoggerReceiver

java.lang.Object
   ↳ com.android.tradefed.targetprep.BaseTargetPreparer
     ↳ com.android.tradefed.targetprep.DeviceFlashPreparer

在實體 Android 硬體上刷新映像檔的 ITargetPreparer。

摘要

公用建構函式

DeviceFlashPreparer()

公用方法

void addAllowedBranchForTransitionInIncremental(String branch)
void addBranchTransitionInIncremental(String origin, String destination)
IBuildInfo getBuild(TestInformation testInfo)

包裝 getBuildInfo，以便在特定情況下變更覆寫。

ITestLogger getTestLogger()
boolean isIncrementalFlashingEnabled()
boolean isIncrementalFlashingForceDisabled()
void setAllowCrossReleaseFlashing(boolean allowCrossReleaseFlashing)
void setAllowUnzipBaseline(boolean allowUnzipBaseline)
void setApplySnapshot(boolean applySnapshot)
void setConfiguration(IConfiguration configuration)

插入正在使用的 IConfiguration。

void setIgnoreHostOptions(boolean ignoreHostOptions)
void setTestLogger(ITestLogger testLogger)

插入 ITestLogger 例項

void setUp(TestInformation testInfo)

void setUpdateBootloaderFromUserspace(boolean updateBootloaderFromUserspace)
void setUseIncrementalNewFlow(boolean useIncrementalNewFlow)
void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

設定 userdata-flash 選項

void setWipeAfterApplySnapshot(boolean wipeAfterApplySnapshot)
void tearDown(TestInformation testInfo, Throwable e)
void useMerkleTreeComparison(boolean enableMerkleTreeComparison)

受保護的方法

void checkDeviceProductType(ITestDevice device, IDeviceBuildInfo deviceBuild)

在刷新前進行檢查，確保裝置與版本資訊相符。

abstract IDeviceFlasher createFlasher(ITestDevice device)

建立要使用的 IDeviceFlasher。

long getDeviceBootWaitTime()

取得裝置啟動等待時間

IHostOptions getHostOptions()

取得要使用的 IHostOptions 例項。
void reportFlashMetrics(String branch, String buildFlavor, String buildId, String serial, long queueTime, long flashingTime, CommandStatus flashingStatus)

將裝置閃爍時間資料回報至指標後端

void setSkipPostFlashBuildIdCheck(boolean skipPostFlashBuildIdCheck)
void setUseIncrementalFlashing(boolean incrementalFlashing)

公用建構函式

DeviceFlashPreparer

public DeviceFlashPreparer ()

公用方法

addAllowedBranchForTransitionInIncremental

public void addAllowedBranchForTransitionInIncremental (String branch)

參數
branch String

addBranchTransitionInIncremental

public void addBranchTransitionInIncremental (String origin, 
                String destination)

參數
origin String

destination String

getBuild

public IBuildInfo getBuild (TestInformation testInfo)

包裝 getBuildInfo，以便在特定情況下變更覆寫。

參數
testInfo TestInformation

傳回
IBuildInfo

getTestLogger

public ITestLogger getTestLogger ()

傳回
ITestLogger

isIncrementalFlashingEnabled

public boolean isIncrementalFlashingEnabled ()

傳回
boolean

isIncrementalFlashingForceDisabled

public boolean isIncrementalFlashingForceDisabled ()

傳回
boolean

setAllowCrossReleaseFlashing

public void setAllowCrossReleaseFlashing (boolean allowCrossReleaseFlashing)

參數
allowCrossReleaseFlashing boolean

setAllowUnzipBaseline

public void setAllowUnzipBaseline (boolean allowUnzipBaseline)

參數
allowUnzipBaseline boolean

setApplySnapshot

public void setApplySnapshot (boolean applySnapshot)

參數
applySnapshot boolean

setConfiguration

public void setConfiguration (IConfiguration configuration)

插入正在使用的 IConfiguration。

參數
configuration IConfiguration

setIgnoreHostOptions

public void setIgnoreHostOptions (boolean ignoreHostOptions)

參數
ignoreHostOptions boolean

setTestLogger

public void setTestLogger (ITestLogger testLogger)

插入 ITestLogger 例項

參數
testLogger ITestLogger

setUp

public void setUp (TestInformation testInfo)

參數
testInfo TestInformation

擲回
BuildError
DeviceNotAvailableException
TargetSetupError

setUpdateBootloaderFromUserspace

public void setUpdateBootloaderFromUserspace (boolean updateBootloaderFromUserspace)

參數
updateBootloaderFromUserspace boolean

setUseIncrementalNewFlow

public void setUseIncrementalNewFlow (boolean useIncrementalNewFlow)

參數
useIncrementalNewFlow boolean

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

設定 userdata-flash 選項

setWipeAfterApplySnapshot

public void setWipeAfterApplySnapshot (boolean wipeAfterApplySnapshot)

參數
wipeAfterApplySnapshot boolean

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

參數
testInfo TestInformation

e Throwable

擲回
DeviceNotAvailableException

useMerkleTreeComparison

public void useMerkleTreeComparison (boolean enableMerkleTreeComparison)

參數
enableMerkleTreeComparison boolean

受保護的方法

checkDeviceProductType

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

可能會在刷新前進行檢查，確保裝置與版本資訊相符。

參數
device ITestDevice：要閃爍的 ITestDevice。
deviceBuild IDeviceBuildInfo：用於閃爍的 IDeviceBuildInfo。
擲回
com.android.tradefed.targetprep.BuildError
com.android.tradefed.device.DeviceNotAvailableException
BuildError
DeviceNotAvailableException

createFlasher

protected abstract IDeviceFlasher createFlasher (ITestDevice device)

建立要使用的 IDeviceFlasher。子類別可覆寫

參數
device ITestDevice

傳回
IDeviceFlasher

擲回
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getDeviceBootWaitTime

protected long getDeviceBootWaitTime ()

取得裝置啟動等待時間

傳回
long

getHostOptions

protected IHostOptions getHostOptions ()

取得要使用的 IHostOptions 例項。

公開供單元測試使用

傳回
IHostOptions

reportFlashMetrics

protected void reportFlashMetrics (String branch, 
                String buildFlavor, 
                String buildId, 
                String serial, 
                long queueTime, 
                long flashingTime, 
                CommandStatus flashingStatus)

將裝置閃爍時間資料回報至指標後端

參數
branch String：裝置版本的來源分支
buildFlavor String：裝置版本的建構變種
buildId String：裝置版本的版本號碼
serial String：裝置的序號
queueTime long：等待閃爍限制可用的時間
flashingTime long：裝置圖像 ZIP 檔案閃燈作業所需的時間
flashingStatus CommandStatus：閃燈指令的執行狀態

setSkipPostFlashBuildIdCheck

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

參數
skipPostFlashBuildIdCheck boolean

setUseIncrementalFlashing

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

參數
incrementalFlashing boolean