IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

在设备上刷写设备映像。

摘要

嵌套类

enum IDeviceFlasher.UserDataFlashOption

用于处理 userdata 映像的选项枚举  

公共方法

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

在设备上刷写 build。

abstract CommandStatus getSystemFlashingStatus()

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

abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

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

abstract void overrideDeviceOptions(ITestDevice device)

设备的替换选项。

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()

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

default boolean supportsFlashingInFastbootD()

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

公共方法

Flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

在设备上刷写 build。

刷写完成后立即返回。调用方应等待设备上线并可用，然后再继续测试。

参数
device ITestDevice：要刷写的 ITestDevice
deviceBuild IDeviceBuildInfo：要刷写的 IDeviceBuildInfo
抛出
TargetSetupError if failed to flash build
DeviceNotAvailableException 如果设备无响应

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

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

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

返回
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

返回
IDeviceFlasher.UserDataFlashOption 是否应刷写、擦除或保留用户数据映像

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

设备的替换选项。用于在特定设备不支持默认值时替换默认选项值。

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 ()

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

返回
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

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

返回
boolean