IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


在设备上闪烁设备图像。

概括

公共方法

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