此页面由 Cloud Translation API 翻译。

IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

已知的间接子类

CdmaDeviceFlasher , FastbootDeviceFlasher , SystemUpdaterDeviceFlasher

CdmaDeviceFlasher	在具有 CDMA 收音机的物理 Android 设备上闪烁图像的类。
FastbootDeviceFlasher	依赖 fastboot 在物理 Android 硬件上刷新图像的类。
SystemUpdaterDeviceFlasher	`IDeviceFlasher`依赖系统更新程序来安装捆绑在 OTA 更新包中的系统映像。

在设备上闪烁设备图像。

概括

公共方法
`abstract void`	`flash ( ITestDevice device, IDeviceBuildInfo deviceBuild)` Flash 在设备上构建。
`default`	`getAdditionalFileFilters ()` 获取额外构建工件的过滤器。
`abstract CommandStatus`	`getSystemFlashingStatus ()` 检索闪存主系统分区的命令执行状态。
`abstract IDeviceFlasher.UserDataFlashOption`	`getUserDataFlashOption ()` 获取用户数据映像是否应闪烁、擦除或保留
`abstract void`	`overrideDeviceOptions ( ITestDevice device)` 覆盖设备的选项。
`default void`	`postFlashOperations ( ITestDevice device, IDeviceBuildInfo deviceBuild)` 所有清理操作和检查都必须在实际闪烁临界区之后进行。
`default void`	`preFlashOperations ( ITestDevice device, IDeviceBuildInfo deviceBuild)` 必须在实际闪烁临界区之前发生的所有设置操作和检查。
`abstract void`	`setDataWipeSkipList ( dataWipeSkipList)` `setDataWipeSkipList ( dataWipeSkipList)` 在`/data`下设置路径列表以避免在使用`ITestsZipInstaller`时被清除请注意，跳过列表的粒度是`/data`的直接子级。
`abstract void`	`setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)` 设置闪烁器可以检索资源文件以进行闪烁的机制。
`abstract void`	`setForceSystemFlash (boolean forceSystemFlash)` 设置系统是否应该始终闪烁，即使运行当前构建
`default void`	`setRamdiskPartition (String ramdiskPartition)` 设置 ramdisk 分区
`default void`	`setShouldFlashRamdisk (boolean shouldFlashRamdisk)` 设置在通过图像 zip 更新设备后是否应刷新额外的 ramdisk
`abstract void`	`setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)` 切换是否应闪烁、擦除或保留用户数据映像
`abstract void`	`setWipeTimeout (long timeout)` 设置擦除数据的超时时间。
`default boolean`	`shouldFlashRamdisk ()` 检查闪存是否设置为有一个额外的 ramdisk 应该在通过图像 zip 更新设备后闪存
`default boolean`	`supportsFlashingInFastbootD ()` 实现刷机的设备是否可以在fastbootd模式下刷机。

公共方法

闪光

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash 在设备上构建。

刷机完成后立即返回。来电者应等待设备在线并可用，然后再继续进行测试。

参数
`device`	`ITestDevice` ：要闪存的`ITestDevice`
`deviceBuild`	`IDeviceBuildInfo` ：要刷新的`IDeviceBuildInfo`

投掷
`TargetSetupError`	如果无法快速构建
`DeviceNotAvailableException`	如果设备变得无响应

获取额外的文件过滤器

public  getAdditionalFileFilters ()

获取额外构建工件的过滤器。

一些闪光灯需要某些构建工件，这些工件不在默认使用的工件中。这样的刷写器应该覆盖这个方法，所以刷写工具的每个用户都不需要知道这些文件并提供命令行选项。

请注意，此方法是在 IDeviceFlasher 的临时实例上调用的，因此不应依赖默认构造函数中提供的状态之外的任何状态。

Set 中的字符串被解释为文件模式，并且将检索与该模式匹配的所有文件。

默认情况下，此方法返回一个空集。

退货

获取系统闪烁状态

public abstract CommandStatus getSystemFlashingStatus ()

检索闪存主系统分区的命令执行状态。

请注意，如果系统分区未刷新（系统已经有要刷新的构建），则命令状态可能为null

退货
`CommandStatus`

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

获取用户数据映像是否应闪烁、擦除或保留

退货
`IDeviceFlasher.UserDataFlashOption`	用户数据映像是否应闪现、擦除或保留

覆盖设备选项

public abstract void overrideDeviceOptions (ITestDevice device)

覆盖设备的选项。如果特定设备不支持默认值，则用于覆盖默认选项值。

闪后操作

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

所有清理操作和检查都必须在实际闪烁临界区之后进行。这些操作都不会包含在并发控制的临界区中。

参数
`device`	`ITestDevice` ：要闪存的`ITestDevice`
`deviceBuild`	`IDeviceBuildInfo` ：要刷新的`IDeviceBuildInfo`

投掷
`TargetSetupError`	如果任何设置失败
`DeviceNotAvailableException`	如果设备变得无响应

预闪操作

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

必须在实际闪烁临界区之前发生的所有设置操作和检查。这些操作都不会包含在并发控制的临界区中。

参数
`device`	`ITestDevice` ：要闪存的`ITestDevice`
`deviceBuild`	`IDeviceBuildInfo` ：要刷新的`IDeviceBuildInfo`

投掷
`TargetSetupError`	如果任何设置失败
`DeviceNotAvailableException`	如果设备变得无响应

setDataWipeSkipList

public abstract void setDataWipeSkipList ( dataWipeSkipList)

在/data下设置路径列表以避免在使用ITestsZipInstaller时被清除

请注意，跳过列表的粒度是/data的直接子级。

参数
`dataWipeSkipList`

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

设置闪烁器可以检索资源文件以进行闪烁的机制。

参数
`retriever`	`IFlashingResourcesRetriever` ：要使用的`IFlashingResourcesRetriever`

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

设置系统是否应该始终闪烁，即使运行当前构建

设置Ramdisk分区

public void setRamdiskPartition (String ramdiskPartition)

设置 ramdisk 分区

设置ShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

设置在通过图像 zip 更新设备后是否应刷新额外的 ramdisk

设置用户数据闪存选项

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

切换是否应闪烁、擦除或保留用户数据映像

设置擦除超时

public abstract void setWipeTimeout (long timeout)

设置擦除数据的超时时间。

参数
`timeout`	`long`

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

检查闪存是否设置为有一个额外的 ramdisk 应该在通过图像 zip 更新设备后闪存

退货
`boolean`

支持FlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

实现刷机的设备是否可以在fastbootd模式下刷机。

退货
`boolean`