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

此页面由 Cloud Translation API 翻译。

BaseTargetPreparer

public abstract class BaseTargetPreparer
extends Object implements ITargetPreparer

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

已知的直接子类

AdbStopServerPreparer、AllTestAppsInstallSetup、AoaTargetPreparer、AppSetup、ArtChrootPreparer、BaseEmulatorPreparer、BuildInfoRecorder、CompanionAllocator、CompanionAwarePreparer、CompileBootImageWithSpeedTargetPreparer、CpuThrottlingWaiter、CreateAvdPreparer、CreateUserPreparer、DeviceActionTargetPreparer、DeviceBuildInfoBootStrapper 和其他 57 个。

AdbStopServerPreparer	目标准备程序，用于在运行 adb 测试之前和之后停止主机上的 adb 服务器。
AllTestAppsInstallSetup	用于将 `IDeviceBuildInfo.getTestsDir()` 文件夹中的所有应用安装到设备上的 `ITargetPreparer`。
AoaTargetPreparer	`ITargetPreparer`，用于使用 Android Open Accessory (AOAv2) 协议执行一系列操作（例如点击和滑动）。
AppSetup	用于安装 apk 及其测试的 `ITargetPreparer`。
ArtChrootPreparer	为 ART 测试创建 chroot 目录。
BaseEmulatorPreparer	用于启动本地模拟器的常用准备程序。
BuildInfoRecorder	用于将 build 信息元数据写入指定文件的 `ITargetPreparer`。
CompanionAllocator	负责分配和释放配套设备的基类应实现 `getCompanionDeviceSelectionOptions()`，以描述分配配套设备所需的条件
CompanionAwarePreparer	用于封装获取已分配配套设备的逻辑的 `ITargetPreparer`。
CompileBootImageWithSpeedTargetPreparer	使用编译器过滤器“speed”重新编译启动类路径和系统服务器。
CpuThrottlingWaiter	一个 `ITargetPreparer`，用于等待所有核心的最大频率恢复到可用的最高级别
CreateAvdPreparer
CreateUserPreparer	用于创建用户并在最后进行清理工作的目标准备器。
DeviceActionTargetPreparer	`ITargetPreparer`，用于执行设备操作。
DeviceBuildInfoBootStrapper	一个 `ITargetPreparer`，用于将 build 信息字段替换为从设备读取的属性这对于使用从外部来源（例如
DeviceBuildInfoInjector	用于将 `DeviceBuildDescriptor` 元数据插入 `IBuildInfo` 的 `ITargetPreparer`。
DeviceCleaner	在测试后执行重新启动或格式化作为清理操作，并可选择关闭屏幕
DeviceFlashPreparer	用于在实体 Android 硬件上刷写映像的 `ITargetPreparer`。
DeviceOwnerTargetPreparer	用于设置设备所有者组件的 `ITargetPreparer`。
DeviceSetup	`ITargetPreparer`，用于根据提供的 `Option` 配置设备以进行测试。
DeviceStorageFiller	目标准备器会填满存储空间，以便提供一定量的可用空间。
DeviceStringPusher	用于将字符串写入文件的目标准备器。
DeviceWiper	用于擦除 userdata 的 `ITargetPreparer`
DisableSELinuxTargetPreparer	目标准备程序，用于停用 SELinux（如果已启用）。
DynamicSystemPreparer	一个 `ITargetPreparer`，用于在具有动态系统更新的设备 build 之上设置系统映像。
EraseUserDataPreparer	用于擦除设备上用户数据的 `ITargetPreparer`。
FastbootCommandPreparer	用于触发 fastboot 并发送 fastboot 命令的目标准备器。
FeatureFlagTargetPreparer	更新 DeviceConfig（由远程服务调整的功能标志）。
FoldableModePreparer	可切换设备可折叠状态的目标准备器。
FolderSaver	用于从设备中拉取目录、对其进行压缩并将其保存到日志记录后端的 `ITargetPreparer`。
GkiDeviceFlashPreparer	使用 Android 通用内核通用映像刷写设备的目标准备器。
GsiDeviceFlashPreparer	使用 Android 通用系统映像刷写设备的目标准备器。
InstallAllTestZipAppsSetup	用于安装测试 zip 文件中的所有应用的 `ITargetPreparer`。
InstallApkSetup	用于安装文件系统中一个或多个 apk 的 `ITargetPreparer`。
InstallBuildEnvApkSetup	用于从 Android 平台 build 环境安装一个或多个测试 APK 的 `ITargetPreparer`。
InstallKernelModulePreparer	用于安装内核模块的目标准备器。
InstrumentationPreparer	运行插桩的 `ITargetPreparer`
KillExistingEmulatorPreparer	用于关闭正在运行的模拟器的 `ITargetPreparer`。
KnownFailurePreparer	目标准备程序会跳过重试已知失败的情况。
MixKernelTargetPreparer	允许将内核映像与设备映像混合的 `ITargetPreparer`。
NativeLeakCollector	运行“dumpsys meminfo --unreachable -a”的 `ITargetPreparer`，用于确定每个进程当前占用的不可访问原生内存。
NoApkTestSkipper	一种特殊的准备程序，如果没有要测试的 APK，则允许完全跳过调用（准备和测试）。
PerfettoPreparer	Perfetto 准备程序会将配置文件推送到 Perfetto 有权访问的标准位置。
ProfileTargetPreparer	用于为任何配置文件用户 `android.os.usertype.profile.XXX` 设置目标准备程序的基准类。
PushFilePreparer	一个 `ITargetPreparer`，用于尝试将任意数量的文件从任意主机路径推送到任意设备路径。
PythonVirtualenvPreparer	在宿主机上设置 Python virtualenv 并安装软件包。
RebootTargetPreparer	用于重新启动设备的目标准备程序。
RecoveryLogPreparer	目标准备程序，用于在恢复之前收集日志。
RemoveSystemAppPreparer	用于在测试运行之前从系统分区中移除 apk 的 `ITargetPreparer`。
RestartSystemServerTargetPreparer	在不重新启动设备的情况下重启系统服务器的目标准备程序。
RootTargetPreparer	根据“force-root”选项执行“adb root”或“adb unroot”的目标准备程序。
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	目标准备器，用于在运行测试之前和之后运行任意主机命令。
RunHostScriptTargetPreparer	在运行测试之前执行脚本的目标准备器。
RunOnSdkSandboxTargetPreparer	`ITargetPreparer`，用于标记测试应在 SDK 沙盒中运行。
RunOnSecondaryUserTargetPreparer	一个 `ITargetPreparer`，用于确保测试以次要用户身份运行。
RunOnSystemUserTargetPreparer	一个 `ITargetPreparer`，用于标记应在用户（而非当前用户）上运行测试。
SemaphoreTokenTargetPreparer	这是一个准备程序，用于使用令牌在 tradefed 主机中序列化测试执行。
StopServicesSetup	用于停止设备上服务的 `ITargetPreparer`。
StubTargetPreparer	`ITargetPreparer` 的占位符空实现。
SwitchUserTargetPreparer	在 setUp 中切换到指定用户类型的 `ITargetPreparer`。
TearDownPassThroughPreparer	允许对配置中作为对象包含的准备程序运行 tearDown。
TemperatureThrottlingWaiter	一个 `ITargetPreparer`，用于等待设备温度降至目标温度
TestAppInstallSetup	用于将一个或多个应用从 `IDeviceBuildInfo.getTestsDir()` 文件夹安装到设备上的 `ITargetPreparer`。
TestFilePushSetup	用于将一个或多个文件/目录从 `IDeviceBuildInfo.getTestsDir()` 文件夹推送到设备上的 `ITargetPreparer`。
TestSystemAppInstallSetup	用于将一个或多个应用从 `IDeviceBuildInfo.getTestsDir()` 文件夹安装到设备上的 /system 分区中的 `ITargetPreparer`。
TimeWaster	简单的目标准备器会浪费时间，并且可能会重启设备。
UserCleaner	一个 `ITargetPreparer`，用于在拆解时移除次要用户。
VisibleBackgroundUserPreparer	用于在后台可见状态下启动的用户中运行测试的目标准备器。
WaitForDeviceDatetimePreparer	用于等待在设备上设置日期时间的 `ITargetPreparer` （可选）如果未在超时期限内设置日期时间，此准备程序可以强制使用 `TargetSetupError`。
WifiPreparer	一个 `ITargetPreparer`，用于根据需要在设备上配置 Wi-Fi。

已知的间接子类

CheckPairingPreparer、CompanionRunCommandTargetPreparer、CompanionTestAppInstallSetup、DeviceImageZipFlashingTargetPreparer、DeviceUpdateTargetPreparer、FastbootUpdateBootstrapPreparer、InstallApexModuleTargetPreparer、LocalEmulatorLaunch、LocalEmulatorSnapshot、ModuleOemTargetPreparer、PushFileInvoker、RunOnCloneProfileTargetPreparer、RunOnPrivateProfileTargetPreparer、RunOnWorkProfileTargetPreparer、SideloadOtaTargetPreparer、SuiteApkInstaller

CheckPairingPreparer	用于验证主设备和配套设备之间的 BT 配对的 `CompanionAwarePreparer`
CompanionRunCommandTargetPreparer	在分配的配套设备上运行指定命令的 `ITargetPreparer`
CompanionTestAppInstallSetup	用于将 `IDeviceBuildInfo.getTestsDir()` 文件夹中的一个或多个应用安装到分配的配套设备上的 `ITargetPreparer`。
DeviceImageZipFlashingTargetPreparer	一种目标准备器，用于使用通过特定格式提供的设备映像刷写设备。
DeviceUpdateTargetPreparer	一个抽象 `ITargetPreparer`，用于处理使用外部来源（而非 build 服务）的设备映像文件更新设备的常见步骤。
FastbootUpdateBootstrapPreparer	`ITargetPreparer`，用于将指定文件（引导加载程序、无线装置、设备映像 ZIP 文件）分阶段导入 `IDeviceBuildInfo`，以便使用 `FastbootDeviceFlasher` 刷写设备，然后将启动后设备属性注入 build 信息，以便报告结果。
InstallApexModuleTargetPreparer
LocalEmulatorLaunch	用于从 Android build 环境在本地启动模拟器的 TargetPreparer。
LocalEmulatorSnapshot	TargetPreparer，用于从 Android build/开发环境生成干净的模拟器快照
ModuleOemTargetPreparer
PushFileInvoker	此类已废弃。改用 `PushFilePreparer`
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnWorkProfileTargetPreparer	一个 `ITargetPreparer`，用于在设置中创建工作资料，并标记应在该用户中运行测试。
SideloadOtaTargetPreparer	目标准备程序，用于对指定的 OTA 软件包执行旁加载、应用该软件包、等待设备启动，并注入设备 build 属性以用作 build 信息此目标准备器假定设备在启动时将处于常规 adb 模式，并会确保设备在应用较新 build 后以相同模式退出。
SuiteApkInstaller	为套件配置安装指定的 APK：从 $ANDROID_TARGET_OUT_TESTCASES 变量或 build 信息中的 ROOT_DIR 安装。

ITargetPreparer 的基准实现类，用于控制对象是否已停用。

摘要

公共构造函数
`BaseTargetPreparer()`

公共方法
`final boolean`	`isDisabled()` 如果整个对象已停用（同时跳过设置和拆解），则返回 true。
`final boolean`	`isTearDownDisabled()` 如果应仅跳过拆解，则返回 True。
`final void`	`setDisable(boolean isDisabled)` 设置是否应停用对象。
`final void`	`setDisableTearDown(boolean isDisabled)` 设置是否应跳过对象中的拆解步骤。

公共构造函数

BaseTargetPreparer

public BaseTargetPreparer ()

公共方法

isDisabled

public final boolean isDisabled ()

如果整个对象已停用（同时跳过设置和拆解），则返回 true。否则为 false。

返回
`boolean`

isTearDownDisabled

public final boolean isTearDownDisabled ()

如果应仅跳过拆解，则返回 True。否则为 false。

返回
`boolean`

setDisable

public final void setDisable (boolean isDisabled)

设置是否应停用对象。停用表示应跳过设置和拆解步骤。可用于在默认构造函数中默认停用对象。

参数
`isDisabled`	`boolean`：对象应处于的状态。

setDisableTearDown

public final void setDisableTearDown (boolean isDisabled)

设置是否应跳过对象中的拆解步骤。设置步骤仍在进行中。

参数
`isDisabled`	`boolean`：对象应处于的状态。