此页面由 Cloud Translation API 翻译。

设备闪存准备器

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver

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

已知的直接子类

FastbootUpdateBootstrapPreparer

FastbootUpdateBootstrapPreparer ITargetPreparer将指定文件（引导加载程序、无线电、设备映像 zip）暂存到IDeviceBuildInfo中，以获取使用FastbootDeviceFlasher刷新的设备，然后将启动后设备属性注入到构建信息中以用于结果报告目的。

一个ITargetPreparer ，可在物理 Android 硬件上闪烁图像。

概括

公共构造函数
`DeviceFlashPreparer ()`

公共方法
`void`	`setConfiguration ( IConfiguration configuration)` 注入正在使用的`IConfiguration` 。
`void`	`setUp ( TestInformation testInfo)`
`void`	`setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)` 设置用户数据闪存选项
`void`	`tearDown ( TestInformation testInfo, Throwable e)`

受保护的方法
`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)`

公共构造函数

设备闪存准备器

public DeviceFlashPreparer ()

公共方法

设置配置

public void setConfiguration (IConfiguration configuration)

注入正在使用的IConfiguration 。

参数
`configuration`	`IConfiguration`

设置

public void setUp (TestInformation testInfo)

参数
`testInfo`	`TestInformation`

投掷
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

设置用户数据闪存选项

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

设置用户数据闪存选项

拆除

public void tearDown (TestInformation testInfo, 
                Throwable e)

参数
`testInfo`	`TestInformation`
`e`	`Throwable`

投掷
`DeviceNotAvailableException`

受保护的方法

检查设备产品类型

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

刷新前可能进行检查，以确保设备与构建信息相比符合预期。

参数
`device`	`ITestDevice` ：要刷新的`ITestDevice` 。
`deviceBuild`	`IDeviceBuildInfo` ：用于 flash 的`IDeviceBuildInfo` 。

投掷
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.device.DeviceNotAvailableException
`BuildError`
`DeviceNotAvailableException`

创建Flasher

protected abstract IDeviceFlasher createFlasher (ITestDevice device)

创建IDeviceFlasher来使用。子类可以重写

参数
`device`	`ITestDevice`

退货
`IDeviceFlasher`

投掷
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

获取设备启动等待时间

protected long getDeviceBootWaitTime ()

获取设备启动等待时间

退货
`long`

获取主机选项

protected IHostOptions getHostOptions ()

获取要使用的IHostOptions实例。

暴露用于单元测试

退货
`IHostOptions`

报告FlashMetrics

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`