自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

SystemUpdaterDeviceFlasher

public class SystemUpdaterDeviceFlasher
extends Object implements IDeviceFlasher

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

依赖于系统更新程序来安装 OTA 更新软件包中捆绑的系统映像的 IDeviceFlasher。具体而言，此实现不依赖于 fastboot。

摘要

公共构造函数
`SystemUpdaterDeviceFlasher()`

公共方法
`void`	`flash(ITestDevice device, IDeviceBuildInfo deviceBuild)` 在设备上刷写 build。此实现假定 `IDeviceBuildInfo.getDeviceImageFile()` 返回的设备映像文件是 OTA 更新 ZIP 文件。
`CommandStatus`	`getSystemFlashingStatus()` 检索刷写主要系统分区的命令执行状态。
`IDeviceFlasher.UserDataFlashOption`	`getUserDataFlashOption()` 获取是否应刷写、擦除或保留用户数据映像
`void`	`overrideDeviceOptions(ITestDevice device)` 设备的替换选项。
`void`	`setDataWipeSkipList( dataWipeSkipList)` 设置 `/data` 下的路径列表，以避免在使用 `ITestsZipInstaller` 时清除这些路径请注意，跳过列表的精细程度为 `/data` 的直接子项。
`void`	`setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)` 设置用于让刷写器检索资源文件以进行刷写的机制。
`void`	`setForceSystemFlash(boolean forceSystemFlash)` 设置系统是否应始终刷写，即使运行的是当前 build 也是如此
`void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` 切换用户数据映像应刷写、清除还是保留的操作此实现仅支持 `IDeviceFlasher.UserDataFlashOption.TESTS_ZIP` 和 `IDeviceFlasher.UserDataFlashOption.RETAIN` 作为有效选项
`void`	`setWipeTimeout(long timeout)` 设置清除数据的超时时间。

public SystemUpdaterDeviceFlasher ()

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

在设备上刷写 build。

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

此实现假定 IDeviceBuildInfo.getDeviceImageFile() 返回的设备映像文件是 OTA 更新 ZIP 文件。在这种解释不成立的上下文中使用此更新程序是不安全的。

参数
`device`	`ITestDevice`：要刷写的 `ITestDevice`
`deviceBuild`	`IDeviceBuildInfo`：要刷写的 `IDeviceBuildInfo`

抛出
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`

public CommandStatus getSystemFlashingStatus ()

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

请注意，如果未刷写系统分区（系统已包含要刷写的 build），命令状态可能是 null

返回
`CommandStatus`

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

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

public void overrideDeviceOptions (ITestDevice device)

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

public void setDataWipeSkipList ( dataWipeSkipList)

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

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

参数
`dataWipeSkipList`

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

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

参数
`retriever`	`IFlashingResourcesRetriever`：要使用的 `IFlashingResourcesRetriever`

public void setForceSystemFlash (boolean forceSystemFlash)

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

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

public void setWipeTimeout (long timeout)

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

参数
`timeout`	`long`