设备闪光器

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


在设备上闪烁设备图像。

概括

公共方法

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