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

IDeviceActionReceiver

public interface IDeviceActionReceiver

com.android.tradefed.device.IDeviceActionReceiver

已知的间接子类

AtraceCollector、AtraceRunMetricCollector、BaseDeviceMetricCollector、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothHciSnoopLogCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector、CodeCoverageCollector、CountTestCasesCollector、DebugHostLogOnFailureCollector、DeviceTraceCollector、FilePullerDeviceMetricCollector、FilePullerLogCollector 以及其他 14 个收集器。

AtraceCollector	一种在测试期间运行 atrace 并收集结果和日志，然后将它们记录到调用中的 `IMetricCollector`。
AtraceRunMetricCollector	从测试设备收集给定目录下的所有测试目录中的轨迹，记录测试目录，对测试目录下的轨迹文件进行后处理并汇总指标。
BaseDeviceMetricCollector	`IMetricCollector` 的基本实现，允许在 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 和 `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` 上开始和停止收集。
BluetoothConnectionLatencyCollector	收集器会将预定义的 statsd 时长指标配置推送到设备，并收集每个配置文件的蓝牙连接时长。
BluetoothConnectionStateCollector	此收集器将收集 BluetoothConnectionStateChanged 指标，并记录每个配置的连接状态编号。
BluetoothHciSnoopLogCollector	用于在 DUT 上启用蓝牙 HCI 信息收集日志记录并收集每次测试的日志的收集器。
BugreportzOnFailureCollector	在测试用例失败时收集 bugreportz。
BugreportzOnTestCaseFailureCollector	在运行中的测试用例失败时收集 bugreportz。
ClangCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备拉取 Clang 覆盖率测量结果并将其记录为测试制品。
CodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备中提取 Java 和原生覆盖率测量结果，并将其记录为测试制品。
CountTestCasesCollector	统计并报告给定 `IRemoteTest` 的测试用例数量。
DebugHostLogOnFailureCollector	一种收集器，用于在测试用例失败时收集并记录主机端日志。
DeviceTraceCollector	在测试运行开始时启动 perfetto 轨迹并在结束时记录轨迹文件的收集器。
FilePullerDeviceMetricCollector	一个 `BaseDeviceMetricCollector`，用于监听来自设备的指标密钥，并以文件形式从设备拉取这些密钥。
FilePullerLogCollector	设备端报告的文件的记录器。
GcovCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备中提取 gcov 覆盖率测量结果，并将其记录为测试制品。
GcovKernelCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从 debugfs 和设备中提取 gcov 内核覆盖率测量结果，然后最终将其记录为测试制品。
HostStatsdMetricCollector	一种 `IMetricCollector`，用于使用 statsd 实用程序命令从主机端收集 statsd 指标。
JavaCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备拉取 Java 覆盖率测量结果并将其记录为测试制品。
LogcatOnFailureCollector	在测试用例失败时捕获并记录 logcat 的收集器。
LogcatTimingMetricCollector	一种指标收集器，通过使用给定的正则表达式模式从 logcat 行解析事件的开始和结束信号，在一次或多次重复测试期间从 logcat 收集时间信息（例如用户切换时间）。
ModuleLogcatCollector	logcat 收集器的版本（但适用于模块）。
PerfettoFilePullerCollector	一种收集器，用于从设备拉取 Perfetto 轨迹文件，可选择性地压缩这些文件，并将其添加到测试日志中。
PerfettoPullerMetricCollector	此类已弃用。请改用 `PerfettoFilePullerCollector` 和 `ERROR(/PerfettoTracePostProcessor)`。
RebootReasonCollector	收集器，用于收集测试运行期间的设备重启情况，并按原因和次数报告。
RuntimeRestartCollector	用于收集测试运行期间运行时重启（系统服务器崩溃）的时间戳（如有）。
ScreenshotOnFailureCollector	在测试用例失败时捕获并记录屏幕截图的收集器。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本实现，允许从设备拉取 showmap 文件并从中收集指标。
TraceCmdCollector	一个 `IMetricCollector`，用于在测试期间使用 trace-cmd 收集轨迹，并将轨迹记录到调用中。

提供用于接收设备事件的 API。

注意：目前仅支持指标收集器。

摘要

公共方法
`default boolean`	`isDisabledReceiver()` `IDeviceActionReceiver` 是否处于停用状态。
`abstract void`	`rebootEnded(ITestDevice device)` 在设备重启结束时获取通知。
`abstract void`	`rebootStarted(ITestDevice device)` 在设备中启动重启时获取通知。
`abstract void`	`setDisableReceiver(boolean isDisabled)` 设置是否应停用 `IDeviceActionReceiver`。

公共方法

isDisabledReceiver

public boolean isDisabledReceiver ()

IDeviceActionReceiver 是否处于停用状态。

返回
`boolean`	如果已停用，则返回 true；否则返回 false。

rebootEnded

public abstract void rebootEnded (ITestDevice device)

在设备重启结束时收到通知。

注意：接收器应避免在此回调期间重启。任何重启尝试都会被忽略。

参数
`device`	`ITestDevice`：重新启动结束时的 `ITestDevice`。

抛出
`DeviceNotAvailableException`

rebootStarted

public abstract void rebootStarted (ITestDevice device)

在设备中启动重新启动时获取通知。

注意：接收器应避免在此回调期间重启。任何重启尝试都会被忽略。

参数
`device`	`ITestDevice`：`ITestDevice`，重启开始的位置。

抛出
`DeviceNotAvailableException`

setDisableReceiver

public abstract void setDisableReceiver (boolean isDisabled)

设置是否应停用 IDeviceActionReceiver。如果停用，则不会注册到设备以接收设备操作事件。

参数
`isDisabled`	`boolean`