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”的文件条目，该条目指向上述脚本。
摘要
常量 | |
|---|---|
String |
OTA_DOWNGRADE_PROP
|
String |
UPDATE_DEVICE_SCRIPT
|
String |
UPDATE_SUCCESS_OUTPUT
|
字段 | |
|---|---|
protected
static
final
String |
IN_ZIP_SCRIPT_PATH
|
公共构造函数 | |
|---|---|
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(Collection<String> dataWipeSkipList)
设置
请注意，跳过列表的粒度是 |
void
|
setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)
设置刷写工具检索用于刷写的资源文件的机制。 |
void
|
setForceSystemFlash(boolean forceSystemFlash)
设置是否应始终刷写系统，即使运行当前 build 也是如此 |
void
|
setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)
切换是否应刷写、擦除或保留用户数据映像 |
void
|
setWipeTimeout(long timeout)
设置擦除数据的超时时间。 |
受保护的方法 | |
|---|---|
IRunUtil
|
getRunUtil()
|
常量
OTA_DOWNGRADE_PROP
protected static final String OTA_DOWNGRADE_PROP
常量值： "ro.ota.allow_downgrade"
UPDATE_DEVICE_SCRIPT
protected static final String UPDATE_DEVICE_SCRIPT
常量值： "update-device-script"
UPDATE_SUCCESS_OUTPUT
protected static final String UPDATE_SUCCESS_OUTPUT
常量值： "onPayloadApplicationComplete(ErrorCode::kSuccess (0)"
字段
IN_ZIP_SCRIPT_PATH
protected static final String IN_ZIP_SCRIPT_PATH
公共构造函数
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 (Collection<String> dataWipeSkipList)
设置 /data 下的路径列表，以避免在使用
ITestsZipInstaller
时清除这些路径
请注意，跳过列表的粒度是 /data 的直接子项。
| 参数 | |
|---|---|
dataWipeSkipList |
Collection |
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 |