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

此页面由 Cloud Translation API 翻译。

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

已知的间接子类

BaseEmulatorPreparer、BaseTargetPreparer、BuildInfoRecorder、CreateAvdPreparer、CreateUserPreparer、DeviceBuildInfoBootStrapper、DeviceBuildInfoInjector、DeviceCleaner、DeviceFlashPreparer、DeviceImageZipFlashingTargetPreparer、DeviceSetup、DeviceUpdateTargetPreparer、FastbootUpdateBootstrapPreparer、FoldableModePreparer、GkiDeviceFlashPreparer 和其他 15 个。

BaseEmulatorPreparer	用于启动本地模拟器的常用准备程序。
BaseTargetPreparer	`ITargetPreparer` 的基准实现类，用于控制对象是否已停用。
BuildInfoRecorder	用于将 build 信息元数据写入指定文件的 `ITargetPreparer`。
CreateAvdPreparer
CreateUserPreparer	用于创建用户并在最后进行清理工作的目标准备器。
DeviceBuildInfoBootStrapper	一个 `ITargetPreparer`，用于将 build 信息字段替换为从设备读取的属性这对于使用从外部来源（例如
DeviceBuildInfoInjector	用于将 `DeviceBuildDescriptor` 元数据插入 `IBuildInfo` 的 `ITargetPreparer`。
DeviceCleaner	在测试后执行重新启动或格式化作为清理操作，并可选择关闭屏幕
DeviceFlashPreparer	用于在实体 Android 硬件上刷写映像的 `ITargetPreparer`。
DeviceImageZipFlashingTargetPreparer	一种目标准备器，用于使用通过特定格式提供的设备映像刷写设备。
DeviceSetup	`ITargetPreparer`，用于根据提供的 `Option` 配置设备以进行测试。
DeviceUpdateTargetPreparer	一个抽象 `ITargetPreparer`，用于处理使用外部来源（而非 build 服务）的设备映像文件更新设备的常见步骤。
FastbootUpdateBootstrapPreparer	`ITargetPreparer`，用于将指定文件（引导加载程序、无线装置、设备映像 ZIP 文件）分阶段导入 `IDeviceBuildInfo`，以便使用 `FastbootDeviceFlasher` 刷写设备，然后将启动后设备属性注入 build 信息，以便报告结果。
FoldableModePreparer	可切换设备可折叠状态的目标准备器。
GkiDeviceFlashPreparer	使用 Android 通用内核通用映像刷写设备的目标准备器。
GsiDeviceFlashPreparer	用于使用 Android 通用系统映像刷写设备的目标准备器。
ITargetCleaner	此接口已废弃。 tearDown 已移至基本 ITargetPreparer 接口。
InstallApexModuleTargetPreparer
KillExistingEmulatorPreparer	用于关闭正在运行的模拟器的 `ITargetPreparer`。
LocalEmulatorLaunch	从 Android build 环境在本地启动模拟器的 TargetPreparer。
LocalEmulatorSnapshot	用于从 Android build/开发环境生成干净模拟器快照的 TargetPreparer
ModuleOemTargetPreparer
RecoveryLogPreparer	用于在恢复之前收集日志的目标准备程序。
RunCommandTargetPreparer
RunOnSecondaryUserTargetPreparer	一个 `ITargetPreparer`，用于在设置中创建次要用户，并标记应在该用户中运行测试。
RunOnSystemUserTargetPreparer	一个 `ITargetPreparer`，用于标记应在用户（而非当前用户）上运行测试。
RunOnWorkProfileTargetPreparer	一个 `ITargetPreparer`，用于在设置中创建工作资料，并标记应在该用户中运行测试。
StubTargetPreparer	`ITargetPreparer` 的占位符空实现。
SuiteApkInstaller	为套件配置安装指定的 APK：从 $ANDROID_TARGET_OUT_TESTCASES 变量或 build 信息中的 ROOT_DIR 安装。
TestAppInstallSetup	用于将一个或多个应用从 `IDeviceBuildInfo.getTestsDir()` 文件夹安装到设备上的 `ITargetPreparer`。

为测试运行准备测试环境。

例如，安装软件、调整环境设置以进行测试、启动目标等。

请注意，您可以在一个配置中指定多个 ITargetPreparer。建议每个 ITargetPreparer 都明确记录其预设置和设置后的预期环境。例如，用于配置设备以进行测试的 ITargetPreparer 必须在安装软件的 ITargetPreparer 之后运行。

摘要

公共方法
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` 此方法已废弃。改用 `setUp(com.android.tradefed.invoker.TestInformation)`
`default void`	`setUp(TestInformation testInformation)` 执行目标设置以进行测试。
`default void`	`tearDown(TestInformation testInformation, Throwable e)` 在测试后执行目标清理/拆解。
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` 此方法已废弃。改用 `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)`

公共方法

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

此方法已废弃。
改用 setUp(com.android.tradefed.invoker.TestInformation)

执行目标设置以进行测试。

参数
`device`	`ITestDevice`：要准备的 `ITestDevice`。
`buildInfo`	`IBuildInfo`：与受测 build 相关的数据。

抛出
`TargetSetupError`	如果在设置环境时发生严重错误
`BuildError`	如果发生与 BuildInfo 相关的错误
`DeviceNotAvailableException`	如果设备无响应

setUp

public void setUp (TestInformation testInformation)

执行目标设置以进行测试。

参数
`testInformation`	`TestInformation`：调用的 `TestInformation`。

抛出
`TargetSetupError`	如果在设置环境时发生严重错误
`BuildError`	如果由于准备构建而发生错误
`DeviceNotAvailableException`	如果设备无响应

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

在测试后执行目标清理/拆解。

参数
`testInformation`	`TestInformation`：调用的 `TestInformation`。
`e`	`Throwable`：如果调用以异常结束，则这是在调用级别捕获的异常。否则，将为 `null`。

抛出
`DeviceNotAvailableException`	如果设备无响应

tearDown

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

此方法已废弃。
改用 tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

在测试后执行目标清理/拆解。

参数
`device`	`ITestDevice`：要准备的 `ITestDevice`。
`buildInfo`	`IBuildInfo`：与受测 build 相关的数据。
`e`	`Throwable`：如果调用以异常结束，则这是在调用级别捕获的异常。否则，将为 `null`。

抛出
`DeviceNotAvailableException`	如果设备无响应