自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度将源代码发布到 AOSP。对于构建 AOSP 和向 AOSP 贡献代码，我们建议使用 android-latest-release 而不是 aosp-main。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

IDisableable

public interface IDisableable

com.android.tradefed.util.IDisableable

已知的间接子类

AdbStopServerPreparer、AggregatePostProcessor、AllTestAppsInstallSetup、AoaTargetPreparer、AppSetup、ArtChrootPreparer、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BaseEmulatorPreparer、BaseMultiTargetPreparer、BasePostProcessor、BaseTargetPreparer、BluetoothConnectionLatencyCollector 以及其他 141 个。

AdbStopServerPreparer	目标准备器，用于在运行 adb 测试之前和之后停止主机上的 adb 服务器。
AggregatePostProcessor	一种指标聚合器，用于提供多次迭代测试运行期间收集的数值指标的最小值、最大值、平均值、方差、标准差、总和、数量，以及可选的百分位数（将这些指标视为双精度浮点数）。
AllTestAppsInstallSetup	一种 `ITargetPreparer`，可将 `IDeviceBuildInfo.getTestsDir()` 文件夹中的所有应用安装到设备上。
AoaTargetPreparer	`ITargetPreparer`，它使用 Android 开放配件 (AOAv2) 协议执行一系列操作（例如点击和滑动）。
AppSetup	用于安装 APK 及其测试的 `ITargetPreparer`。
ArtChrootPreparer	为 ART 测试创建 chroot 目录。
AtraceCollector	一种在测试期间运行 atrace 并收集结果和日志，然后将它们记录到调用中的 `IMetricCollector`。
AtraceRunMetricCollector	从测试设备收集给定目录下的所有测试目录中的轨迹，记录测试目录，对测试目录下的轨迹文件进行后处理并汇总指标。
AveragePostProcessor	实现后处理器，用于计算指标列表的平均值。
BaseDeviceMetricCollector	`IMetricCollector` 的基本实现，允许在 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 和 `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` 上开始和停止收集。
BaseEmulatorPreparer	用于启动本地模拟器的通用准备器。
BaseMultiTargetPreparer	`IMultiTargetPreparer` 的基本实现，允许停用对象。
BasePostProcessor	每个实现都应扩展的基本 `IPostProcessor`。
BaseTargetPreparer	`ITargetPreparer` 的基本实现类，用于控制对象是否处于停用状态。
BluetoothConnectionLatencyCollector	收集器会将预定义的 statsd 时长指标配置推送到设备，并收集每个配置文件的蓝牙连接时长。
BluetoothConnectionStateCollector	此收集器将收集 BluetoothConnectionStateChanged 指标，并记录每个配置的连接状态编号。
BluetoothConnectionSuccessRatePostProcessor	实现用于计算蓝牙配置文件成功率的后处理器使用“metric-key-match”指定包含蓝牙连接状态（以数字数组表示）的指标，例如 [0, 1, 2, 3, 0, 1, 2, 3]。
BluetoothHciSnoopLogCollector	用于在 DUT 上启用蓝牙 HCI 信息收集日志记录并收集每次测试的日志的收集器。
BugreportzOnFailureCollector	在测试用例失败时收集 bugreportz。
BugreportzOnTestCaseFailureCollector	在运行中的测试用例失败时收集 bugreportz。
BuildInfoRecorder	一种将 build 信息元数据写入指定文件的 `ITargetPreparer`。
CheckPairingPreparer	一种用于验证主设备和配套设备之间的蓝牙配对的 `CompanionAwarePreparer`
ClangCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备拉取 Clang 覆盖率测量结果并将其记录为测试制品。
CodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备中提取 Java 和原生覆盖率测量结果，并将其记录为测试制品。
CollectingTestListener	用于收集所有测试结果的 `ITestInvocationListener`。
CompanionAllocator	负责分配和释放配套设备的基类应实现 `getCompanionDeviceSelectionOptions()` 以描述分配配套设备所需满足的条件
CompanionAwarePreparer	一个 `ITargetPreparer`，用于封装获取已分配的配套设备的逻辑。
CompanionRunCommandTargetPreparer	一种 `ITargetPreparer`，可在分配的配套设备上运行指定命令
CompanionTestAppInstallSetup	一种 `ITargetPreparer`，用于将 `IDeviceBuildInfo.getTestsDir()` 文件夹中的一个或多个应用安装到已分配的配套设备上。
CompileBootImageWithSpeedTargetPreparer	使用编译器过滤器“speed”重新编译启动类路径和系统服务器。
CountTestCasesCollector	统计并报告给定 `IRemoteTest` 的测试用例数量。
CpuThrottlingWaiter	一种 `ITargetPreparer`，用于等待所有核心上的最大频率恢复到最高可用级别
CreateAvdPreparer
CreateUserPreparer	用于创建用户并在最后清理用户的目标准备器。
DebugHostLogOnFailureCollector	一种收集器，用于在测试用例失败时收集并记录主机端日志。
DeviceActionTargetPreparer	用于执行设备操作的 `ITargetPreparer`。
DeviceBuildInfoBootStrapper	一种 `ITargetPreparer`，用于将 build 信息字段替换为从设备读取的属性这对于测试具有从外部来源生成的 build 的设备非常有用（例如
DeviceBuildInfoInjector	一种将 `DeviceBuildDescriptor` 元数据插入到 `IBuildInfo` 中的 `ITargetPreparer`。
DeviceCleaner	在测试后执行重新启动或格式化操作作为清理操作，并可选择关闭屏幕
DeviceFlashPreparer	一个 `ITargetPreparer`，用于在实体 Android 硬件上刷写映像。
DeviceImageZipFlashingTargetPreparer	一种目标准备器，用于将设备映像（以特定格式提供）刷写到设备上。
DeviceOwnerTargetPreparer	用于设置设备所有者组件的 `ITargetPreparer`。
DeviceSetup	一种 `ITargetPreparer`，可根据提供的 `Option` 配置设备以进行测试。
DeviceStorageFiller	目标准备器，用于填满存储空间，以便提供一定量的可用空间。
DeviceStringPusher	用于将字符串写入文件的目标准备器。
DeviceTraceCollector	在测试运行开始时启动 perfetto 轨迹并在结束时记录轨迹文件的收集器。
DeviceUpdateTargetPreparer	一个抽象的 `ITargetPreparer`，用于处理通过来自外部来源（而非 build 服务）的设备映像文件更新设备的相关常见步骤。
DeviceWiper	一种会擦除用户数据的 `ITargetPreparer`
DisableSELinuxTargetPreparer	如果已启用 SELinux，则停用 SELinux 的目标准备器。
DynamicSystemPreparer	一种 `ITargetPreparer`，用于在搭载动态系统更新的设备 build 上设置系统映像。
EraseUserDataPreparer	一种会擦除设备上用户数据的 `ITargetPreparer`。
FastbootCommandPreparer	触发 fastboot 并发送 fastboot 命令的目标准备器。
FastbootUpdateBootstrapPreparer	一个 `ITargetPreparer`，用于将指定文件（引导加载程序、无线装置、设备映像 zip）暂存到 `IDeviceBuildInfo` 中，以使设备刷写 `FastbootDeviceFlasher`，然后将启动后设备属性注入到 build 信息中，以用于结果报告。
FeatureFlagTargetPreparer	更新 DeviceConfig（由远程服务调整的功能标志）。
FilePullerDeviceMetricCollector	一个 `BaseDeviceMetricCollector`，用于监听来自设备的指标密钥，并以文件形式从设备拉取这些密钥。
FilePullerLogCollector	设备端报告的文件的记录器。
FoldableModePreparer	一种可以切换设备的可折叠状态的目标准备器。
FolderSaver	一种 `ITargetPreparer`，用于从设备中提取目录，对其进行压缩并将其保存到日志记录后端。
FormattedGeneratorReporter	允许以特定格式生成报告的报告器。
FutilityCommandPreparer	用于执行无用命令的 Preparer。
GcovCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备中提取 gcov 覆盖率测量结果，并将其记录为测试制品。
GcovKernelCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从 debugfs 和设备中提取 gcov 内核覆盖率测量结果，然后最终将其记录为测试制品。
GkiDeviceFlashPreparer	一种目标准备器，用于使用 Android 通用内核通用映像刷写设备。
GoogleAccountPreparer	支持配置 Google 账号的 `ITargetPreparer`。
GsiDeviceFlashPreparer	一种将 Android 通用系统映像刷写到设备上的目标准备器。
HelloWorldMultiTargetPreparer	`IMultiTargetPreparer` 的实现示例。
HostStatsdMetricCollector	一种 `IMetricCollector`，用于使用 statsd 实用程序命令从主机端收集 statsd 指标。
ILabPreparer	面向实验准备人员的标记界面如需了解这些接口的用途，请参阅 `ITargetPreparer`。
IMetricCollector	在报告测试结果时，此接口将作为装饰器添加，以便收集匹配的指标。
IMultiTargetPreparer	同时为多部设备准备测试环境。
IPostProcessor	后处理器是一种 Trade Federation 对象，旨在允许在测试结束后和报告结果之前处理指标和日志。
ITargetCleaner	此接口已弃用。 tearDown 已移至基本 ITargetPreparer 接口。
ITargetPreparer	为测试运行准备测试环境。
InstallAllTestZipAppsSetup	一种 `ITargetPreparer`，用于安装测试 zip 中的所有应用。
InstallApexModuleTargetPreparer
InstallApkSetup	一种 `ITargetPreparer`，用于安装文件系统上的一个或多个 APK。
InstallBuildEnvApkSetup	一种 `ITargetPreparer`，用于从 Android 平台 build 环境安装一个或多个测试 APK。
InstallKernelModulePreparer	一种用于安装内核模块的目标准备器。
InstrumentationPreparer	运行插桩的 `ITargetPreparer`
JavaCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备拉取 Java 覆盖率测量结果并将其记录为测试制品。
JsonHttpTestResultReporter	一种结果报告程序，可将测试指标结果和分支、设备信息编码为 JSON 并 POST 到 HTTP 服务端点
KillExistingEmulatorPreparer	用于关闭正在运行的模拟器的 `ITargetPreparer`。
KnownFailurePreparer	目标准备器，用于跳过重试已知失败。
LUCIResultReporter	一种结果报告程序，可将 ResultDB 和 LUCI 所需的测试结果保存为 JSON 格式 (go/result-sink)，并在控制台中记录文件位置。
LocalEmulatorLaunch	一种 TargetPreparer，用于从 Android build 环境在本地启动模拟器。
LocalEmulatorSnapshot	一种旨在从 Android build/开发环境生成干净的模拟器快照的 TargetPreparer
LogcatOnFailureCollector	在测试用例失败时捕获并记录 logcat 的收集器。
LogcatTimingMetricCollector	一种指标收集器，通过使用给定的正则表达式模式从 logcat 行解析事件的开始和结束信号，在一次或多次重复测试期间从 logcat 收集时间信息（例如用户切换时间）。
MergeMultiBuildTargetPreparer	一种 `IMultiTargetPreparer`，可通过命名信息和要复制到其他 build 的文件密钥，将信息从一个 build 传递到另一个 build。
MetricFilePostProcessor	用于上传在测试和运行级别收集的指标日志文件。
MetricsXMLResultReporter	在测试的 invocationEnded 阶段，MetricsXMLResultReporter 会将测试指标和运行指标写入 metrics-folder 参数指定的文件夹中的 XML 文件。
MixImageZipPreparer	一种 `IMultiTargetPreparer`，可在设备 build 中混合使用系统 build 的映像。
MixKernelTargetPreparer	一种允许将内核映像与设备映像混合的 `ITargetPreparer`。
MixRadioTargetPreparer	一种允许将无线装置映像与设备映像混合的 `ITargetPreparer`。
ModuleListener	附加到每个模块的每个 `IRemoteTest` 的监听器，用于收集结果列表。
ModuleLogcatCollector	logcat 收集器的版本（但适用于模块）。
ModuleOemTargetPreparer
NativeLeakCollector	一个 `ITargetPreparer`，用于运行“dumpsys meminfo --unreachable -a”，以识别每个进程当前持有的无法访问的原生内存。
NoApkTestSkipper	一种特殊准备器，如果没有任何要测试的 APK，则允许完全跳过调用（准备和测试）。
PairingMultiTargetPreparer	多目标准备器有助于在两台设备之间进行蓝牙配对（和连接）。
PerfettoFilePullerCollector	一种收集器，用于从设备拉取 Perfetto 轨迹文件，可选择性地压缩这些文件，并将其添加到测试日志中。
PerfettoGenericPostProcessor	一种后处理器，用于通过递归展开具有字符串值的 proto 消息和字段，直到遇到具有数值的字段，从而将文本/二进制指标 perfetto proto 文件处理为键值对。
PerfettoPreparer	Perfetto preparer 将配置文件推送到设备上 Perfetto 可以访问的标准位置。
PerfettoPullerMetricCollector	此类已弃用。请改用 `PerfettoFilePullerCollector` 和 `ERROR(/PerfettoTracePostProcessor)`。
PerfettoTracePostProcessor	一种后处理器，用于从测试日志中检索 Perfetto 轨迹文件，并在这些文件上运行轨迹处理器以生成 Perfetto 指标 proto。
ProfileTargetPreparer	用于为任何配置文件用户 `android.os.usertype.profile.XXX` 设置目标准备器的基类。
PushFileInvoker	此类已弃用。请改用 `PushFilePreparer`
PushFilePreparer	一个 `ITargetPreparer`，用于尝试将任意数量的文件从任意主机路径推送到任意设备路径。
PythonVirtualenvPreparer	在主机上设置 Python virtualenv 并安装软件包。
RebootReasonCollector	收集器，用于收集测试运行期间的设备重启情况，并按原因和次数报告。
RebootTargetPreparer	重新启动设备的目标准备器。
RecoveryLogPreparer	一种用于在恢复之前收集日志的目标准备器。
RemoveSystemAppPreparer	用于在测试运行之前从系统分区中移除 APK 的 `ITargetPreparer`。
ReportPassedTests	报告了文件中的可能过滤条件，以排除通过的测试。
RestartSystemServerTargetPreparer	在不重启设备的情况下重启系统服务器的目标准备器。
ResultAggregator	一种特殊的转发器，可根据所采取的重试策略在需要时汇总结果。
RootTargetPreparer	根据“force-root”选项执行“adb root”或“adb unroot”的目标准备器。
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	用于在运行测试之前和之后运行任意主机命令的目标准备器。
RunHostScriptTargetPreparer	在运行测试之前执行脚本的目标准备器。
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	一个 `ITargetPreparer`，用于标记测试应在 SDK 沙盒中运行。
RunOnSecondaryUserTargetPreparer	一个 `ITargetPreparer`，用于确保测试以次要用户身份运行。
RunOnSystemUserTargetPreparer	一种 `ITargetPreparer`，用于标记应在用户（而非当前用户）上运行测试。
RunOnWorkProfileTargetPreparer	一个 `ITargetPreparer`，用于在设置中创建工作资料，并标记测试应在该用户中运行。
RuntimeRestartCollector	用于收集测试运行期间运行时重启（系统服务器崩溃）的时间戳（如有）。
ScreenshotOnFailureCollector	在测试用例失败时捕获并记录屏幕截图的收集器。
SemaphoreTokenTargetPreparer	此准备器用于使用令牌在 tradefed 主机中序列化测试执行。
ShardListener	一种 `ITestInvocationListener`，用于从调用分片（即拆分后的调用，可在多个资源上并行运行）收集结果，并将结果转发给另一个监听器。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本实现，允许从设备拉取 showmap 文件并从中收集指标。
SideloadOtaTargetPreparer	一种目标准备器，用于执行指定 OTA 软件包的旁加载、应用该软件包、等待设备启动，并注入设备 build 属性以用作 build 信息此目标准备器假定设备在启动时将处于常规 adb 模式，并确保设备在退出时处于相同模式，但应用了较新的 build。
SkipManager	根据各种条件，跳过管理器可帮助确定应在不同级别（调用、模块和测试）跳过的内容。
StatsdBeforeAfterGaugeMetricPostProcessor	一种后处理器，用于处理以“前后”方式（即
StatsdEventMetricPostProcessor	一种后处理器，用于使用处理器上指定的格式化程序将 statsd 报告中的事件指标处理为键值对。
StatsdGenericPostProcessor	一种后处理器，用于通过将二进制 proto statsd 报告扩展为树结构，将其处理为键值对。
StopServicesSetup	一种会停止设备上服务的 `ITargetPreparer`。
StubMultiTargetPreparer	`IMultiTargetPreparer` 的占位空实现。
StubTargetPreparer	`ITargetPreparer` 的占位空实现。
SuiteApkInstaller	安装指定 APK 以进行 Suite 配置：从 $ANDROID_TARGET_OUT_TESTCASES 变量或 build 信息中的 ROOT_DIR 安装。
SuiteResultReporter	收集整个套件调用的测试结果，并输出最终结果。
SwitchUserTargetPreparer	一种 `ITargetPreparer`，可在设置中切换到指定的用户类型。
TearDownPassThroughPreparer	允许对配置中作为对象包含的准备器运行 tearDown。
TemperatureThrottlingWaiter	一种 `ITargetPreparer`，用于等待设备温度降至目标温度
TestAppInstallSetup	一种从 `IDeviceBuildInfo.getTestsDir()` 文件夹向设备安装一个或多个应用的 `ITargetPreparer`。
TestFilePushSetup	一种 `ITargetPreparer`，用于将 `IDeviceBuildInfo.getTestsDir()` 文件夹中的一个或多个文件/目录推送到设备上。
TestSystemAppInstallSetup	一种 `ITargetPreparer`，用于将 `IDeviceBuildInfo.getTestsDir()` 文件夹中的一个或多个应用安装到设备的 /system 分区中。
TimeWaster	一个简单的目标准备器，用于浪费时间并可能重启设备。
TraceCmdCollector	一个 `IMetricCollector`，用于在测试期间使用 trace-cmd 收集轨迹，并将轨迹记录到调用中。
UserCleaner	一种在拆解时移除次要用户的 `ITargetPreparer`。
VisibleBackgroundUserPreparer	用于在后台可见的用户中运行测试的目标准备器。
WaitForDeviceDatetimePreparer	一种等待在设备上设置日期时间的 `ITargetPreparer` （可选）如果未在超时时间内设置日期时间，此准备器可以强制执行 `TargetSetupError`。
WifiPreparer	一个 `ITargetPreparer`，用于在必要时配置设备上的 Wi-Fi。
XmlFormattedGeneratorReporter	`FormattedGeneratorReporter` 的实现，用于以 XML 格式设置测试套件结果的格式。
XmlResultReporter	以与 Ant 的 XMLJUnitResultFormatter 一致的格式将 JUnit 结果写入 XML 文件。

描述可停用的 Tradefed 对象的接口。系统会跳过已停用的对象，并且根本不会调用该对象。

摘要

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

公共方法

isDisabled

public boolean isDisabled ()

如果整个对象都被停用（跳过设置和拆解），则返回 True。否则输出 false。

返回
`boolean`

isTearDownDisabled

public boolean isTearDownDisabled ()

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

返回
`boolean`

setDisable

public void setDisable (boolean isDisabled)

设置是否应停用对象。如果值为“已停用”，则表示应跳过设置和拆解步骤。可用于在默认构造函数中使对象默认处于停用状态。

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

setDisableTearDown

public void setDisableTearDown (boolean isDisabled)

设置是否应跳过对象中的拆解步骤。设置步骤仍处于完成状态。

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