此页面由 Cloud Translation API 翻译。

设备闪光器

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

已知的间接子类

CdmaDeviceFlasher 、 FastbootDeviceFlasher 、 SystemUpdaterDeviceFlasher

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

在设备上闪烁设备图像。

概括

公共方法
`abstract void`	`flash ( ITestDevice device, IDeviceBuildInfo deviceBuild)` 闪存是在设备上构建的。
`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)` 设置虚拟磁盘分区
`default void`	`setShouldFlashRamdisk (boolean shouldFlashRamdisk)` 设置通过映像 zip 更新设备后是否应刷新附加 ramdisk
`abstract void`	`setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)` 切换是否应刷新、擦除或保留用户数据映像
`abstract void`	`setWipeTimeout (long timeout)` 设置擦除数据的超时时间。
`default boolean`	`shouldFlashRamdisk ()` 检查刷新器是否设置为在通过映像 zip 更新设备后应刷新额外的 ramdisk
`default boolean`	`supportsFlashingInFastbootD ()` 实现 flasher 的设备是否可以在 fastbootd 模式下进行刷新。

公共方法

闪光

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

闪存是在设备上构建的。

闪烁完成后立即返回。呼叫者应等待设备上线并可用，然后再继续测试。

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

投掷
`TargetSetupError`	如果闪存构建失败
`DeviceNotAvailableException`	如果设备变得无响应

获取附加文件过滤器

public  getAdditionalFileFilters ()

获取其他构建工件的过滤器。

一些 flashers 需要某些构建工件，而这些工件不属于默认使用的工件。此类闪存程序应重写此方法，因此闪存工具的每个用户都不需要了解这些文件并提供命令行选项。

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

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

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

退货

获取系统闪烁状态

public abstract CommandStatus getSystemFlashingStatus ()

检索刷新主系统分区的命令执行状态。

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

退货
`CommandStatus`

获取用户数据闪存选项

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`	如果设备变得无响应

设置数据擦除跳过列表

public abstract void setDataWipeSkipList ( dataWipeSkipList)

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

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

参数
`dataWipeSkipList`

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

设置刷新器检索资源文件以进行刷新的机制。

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

设置强制系统闪存

public abstract void setForceSystemFlash (boolean forceSystemFlash)

设置系统是否应该始终刷新，即使运行当前版本

设置虚拟磁盘分区

public void setRamdiskPartition (String ramdiskPartition)

设置虚拟磁盘分区

设置ShouldFlash Ramdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

设置通过映像 zip 更新设备后是否应刷新附加 ramdisk

设置用户数据闪存选项

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

设置擦除超时

public abstract void setWipeTimeout (long timeout)

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

参数
`timeout`	`long`

应该Flash Ramdisk

public boolean shouldFlashRamdisk ()

检查刷新器是否设置为在通过映像 zip 更新设备后应刷新额外的 ramdisk

退货
`boolean`

支持FlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

实现 flasher 的设备是否可以在 fastbootd 模式下进行刷新。

退货
`boolean`