OtaUpdateDeviceFlasher

public class OtaUpdateDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Object
   ↳ com.android.tradefed.targetprep.OtaUpdateDeviceFlasher


设备刷写器,用于使用完整或增量 OTA 软件包触发 system/update_engine/scripts/update_device.py 脚本以更新设备映像。如需正确使用此刷写器,设备 build 信息必须包含一个名为“update-device-script”的文件条目,该条目指向上述脚本。

摘要

字段

protected static final String IN_ZIP_SCRIPT_PATH

protected static final String OTA_DOWNGRADE_PROP

protected static final String UPDATE_DEVICE_SCRIPT

protected static final String UPDATE_SUCCESS_OUTPUT

公共构造函数

OtaUpdateDeviceFlasher()

公共方法

void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

在设备上刷写 build。

CommandStatus getSystemFlashingStatus()

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

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

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

void overrideDeviceOptions(ITestDevice device)

设备的替换选项。

void preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

在实际刷写关键部分之前必须执行的所有设置操作和检查。

void setDataWipeSkipList( dataWipeSkipList)

设置 /data 下的路径列表,以避免在使用 ITestsZipInstaller 时清除这些路径

请注意,跳过列表的精细程度为 /data 的直接子项。

void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

设置用于让刷写器检索资源文件以进行刷写的机制。

void setForceSystemFlash(boolean forceSystemFlash)

设置系统是否应始终刷写,即使运行的是当前 build 也是如此

void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

切换用户数据映像应刷写、清除还是保留的操作

void setWipeTimeout(long timeout)

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

受保护的方法

IRunUtil getRunUtil()

字段

IN_ZIP_SCRIPT_PATH

protected static final String IN_ZIP_SCRIPT_PATH

OTA_DOWNGRADE_PROP

protected static final String OTA_DOWNGRADE_PROP

UPDATE_DEVICE_SCRIPT

protected static final String UPDATE_DEVICE_SCRIPT

UPDATE_SUCCESS_OUTPUT

protected static final String UPDATE_SUCCESS_OUTPUT

公共构造函数

OtaUpdateDeviceFlasher

public OtaUpdateDeviceFlasher ()

公共方法

Flash

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

在设备上刷写 build。

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

参数
device ITestDevice:要刷写的 ITestDevice

deviceBuild IDeviceBuildInfo:要刷写的 IDeviceBuildInfo

抛出
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

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

请注意,如果未刷写系统分区(系统已具有要刷写的 build),命令状态可能是 null

返回
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

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

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

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

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

在实际刷写关键部分之前必须执行的所有设置操作和检查。这些操作都不会包含在并发控制的关键部分中。

参数
device ITestDevice:要刷写的 ITestDevice

deviceBuild IDeviceBuildInfo:要刷写的 IDeviceBuildInfo

抛出
DeviceNotAvailableException
TargetSetupError

setDataWipeSkipList

public void setDataWipeSkipList ( dataWipeSkipList)

设置 /data 下的路径列表,以避免在使用 ITestsZipInstaller 时清除这些路径

请注意,跳过列表的精细程度为 /data 的直接子项。

参数
dataWipeSkipList

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

设置用于让刷写器检索资源文件以进行刷写的机制。

参数
retriever IFlashingResourcesRetriever:要使用的 IFlashingResourcesRetriever

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

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

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

切换用户数据映像应刷写、清除还是保留

setWipeTimeout

public void setWipeTimeout (long timeout)

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

参数
timeout long

受保护的方法

getRunUtil

protected IRunUtil getRunUtil ()

返回
IRunUtil