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) 刷写设备。
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) 设置 /data 下的路径列表，以避免在使用 ITestsZipInstaller 请注意，跳过列表的粒度是 /data 的直接子项。
abstract void	setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever) 设置刷写程序检索资源文件进行刷写的机制。
abstract void	setForceSystemFlash(boolean forceSystemFlash) 设置是否应始终刷写系统（即使运行当前 build）
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 模式下刷写。

公共方法

Flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

刷写设备。

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

参数
device	ITestDevice：要刷写的 ITestDevice
deviceBuild	IDeviceBuildInfo：要刷写的 IDeviceBuildInfo

抛出
TargetSetupError	如果未能刷写 build
DeviceNotAvailableException	如果设备无响应

getAdditionalFileFilters

public  getAdditionalFileFilters ()

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

某些刷写程序需要某些不属于默认使用的 build 工件。此类 刷写程序应该覆盖此方法，因此使用刷写工具的每位用户都不需要 了解这些文件并提供命令行选项。

请注意，此方法是在 IDeviceFlasher 的临时实例上调用，因此 状态。

集合中的字符串被解释为文件格式，匹配该模式的所有文件 。

默认情况下，此方法会返回空的 Set。

返回

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

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

请注意，如果未刷写系统分区（系统已有要刷写的 build）， 命令状态可能是 null

返回
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

获取是应该刷写、擦除还是保留用户数据映像

返回
IDeviceFlasher.UserDataFlashOption	是应刷写、擦除还是保留用户数据图片

替换设备选项

public abstract void overrideDeviceOptions (ITestDevice device)

覆盖设备的选项。用于在未设置默认值时替换默认值 支持该功能。

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

所有清理操作和必须在实际刷写关键部分之后进行的检查。无 将包含在并发控制的关键部分中。

参数
device	ITestDevice：要刷写的 ITestDevice
deviceBuild	IDeviceBuildInfo：要刷写的 IDeviceBuildInfo

抛出
TargetSetupError	如果任何设置失败
DeviceNotAvailableException	如果设备无响应

preFlashOperations

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)

设置是否应始终刷写系统（即使运行当前 build）

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

设置 ramdisk 分区

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

用于切换是应该刷写、擦除还是保留用户数据图片

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

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

参数
timeout	long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

检查闪存器是否设置为在更新后刷写额外的 ramdisk 设备（通过映像 ZIP 文件）

返回
boolean

支持刷写 InFastbootD

public boolean supportsFlashingInFastbootD ()

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

返回
boolean