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 的直接子级。 |
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 | 如果设备变得无响应 |
获取额外的文件过滤器
publicgetAdditionalFileFilters ()
获取额外构建工件的过滤器。
一些闪光灯需要某些构建工件,这些工件不在默认使用的工件中。这样的刷写器应该覆盖这个方法,所以刷写工具的每个用户都不需要知道这些文件并提供命令行选项。
请注意,此方法是在 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 |