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

此页面由 Cloud Translation API 翻译。

BluetoothHciSnoopLogCollector

public class BluetoothHciSnoopLogCollector
extends FilePullerDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.FilePullerDeviceMetricCollector
		↳	com.android.tradefed.device.metric.BluetoothHciSnoopLogCollector

收集器，用于在 DUT 上启用蓝牙 HCI 信息收集日志记录，并收集每次测试的日志。收集器将为测试运行配置并启用嗅探日志记录，并在测试运行后还原设置。

摘要

字段
`public static final String`	`SNOOP_LOG_MODE_PROPERTY`

公共构造函数
`BluetoothHciSnoopLogCollector()`

公共方法
`String`	`getReportingDir()` 检索要将 HCI 信息收集日志报告到的目录。
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` 测试用例结束时的回调。
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` 测试运行结束时的回调。
`void`	`onTestRunStart(DeviceMetricData runData)` 测试运行开始时的回调。
`void`	`onTestStart(DeviceMetricData testData)` 测试用例启动时的回调。
`void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData runData)` 该方法的实现应允许记录目录，并对其进行解析，以便将指标放入 `DeviceMetricData`。
`final void`	`processMetricFile(String key, File metricFile, DeviceMetricData runData)` 该方法的实现应允许记录文件，并对其进行解析以将指标放入 `DeviceMetricData`。

受保护的方法
`void`	`executeShellCommand(ITestDevice device, String command)` 在设备上执行 shell 命令。

public static final String SNOOP_LOG_MODE_PROPERTY

public BluetoothHciSnoopLogCollector ()

public String getReportingDir ()

检索要将 HCI 信息收集日志报告到的目录。

返回
`String`

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

测试用例结束时的回调。现在应该是清理时间了。

参数
`testData`	`DeviceMetricData`：用于存储测试用例数据的 `DeviceMetricData`。将与 `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` 期间相同的对象。
`currentTestCaseMetrics`	：传递给 `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` 的当前指标映射。
`test`	`TestDescription`：正在进行的测试用例的 `TestDescription`。

抛出
`DeviceNotAvailableException`

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

测试运行结束时的回调。现在应该是清理时间了。

参数
`runData`	`DeviceMetricData`：用于存储运行数据的 `DeviceMetricData`。将与 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 期间相同的对象。
`currentRunMetrics`	：传递给 `ERROR(/#testRunEnded(long,Map))` 的当前指标映射。

抛出
`DeviceNotAvailableException`

public void onTestRunStart (DeviceMetricData runData)

测试运行开始时的回调。

参数
`runData`	`DeviceMetricData`：用于存储运行数据的 `DeviceMetricData`。

抛出
`DeviceNotAvailableException`

public void onTestStart (DeviceMetricData testData)

测试用例启动时的回调。

参数
`testData`	`DeviceMetricData`：用于存储测试用例数据的 `DeviceMetricData`。

抛出
`DeviceNotAvailableException`

public void processMetricDirectory (String key, 
                File metricDirectory, 
                DeviceMetricData runData)

该方法的实现应允许记录目录，并对其进行解析，以便将指标放入 DeviceMetricData。

参数
`key`	`String`：与拉取的目录关联的选项键。
`metricDirectory`	`File`：从与选项键匹配的设备中提取的 `ERROR(/File)`。
`runData`	`DeviceMetricData`：可存储指标的 `DeviceMetricData`。

public final void processMetricFile (String key, 
                File metricFile, 
                DeviceMetricData runData)

该方法的实现应允许记录文件，并对其进行解析，以便将指标放入 DeviceMetricData。

参数
`key`	`String`：与拉取的文件关联的选项键。
`metricFile`	`File`：从与选项键匹配的设备中提取的 `ERROR(/File)`。
`runData`	`DeviceMetricData`：可存储指标的 `DeviceMetricData`。

protected void executeShellCommand (ITestDevice device, 
                String command)

在设备上执行 shell 命令。如果执行失败（退出代码不为零），则抛出 DeviceRuntimeException。

参数
`device`	`ITestDevice`
`command`	`String`

抛出
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`