自 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 信息收集日志记录并收集每次测试的日志的收集器。收集器将为测试运行配置并启用 snoop 日志记录，并在测试运行结束后恢复设置。

摘要

常量
`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

常量值： “persist.bluetooth.btsnooplogmode”

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`