Kể từ năm 2026, để phù hợp với mô hình phát triển ổn định của nhánh chính và đảm bảo tính ổn định của nền tảng cho hệ sinh thái, chúng tôi sẽ xuất bản mã nguồn lên AOSP vào quý 2 và quý 4. Để tạo và đóng góp cho AOSP, bạn nên sử dụng android-latest-release thay vì aosp-main. Nhánh tệp kê khai android-latest-release sẽ luôn tham chiếu đến bản phát hành gần đây nhất được chuyển đến AOSP. Để biết thêm thông tin, hãy xem bài viết Các thay đổi đối với AOSP.

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

Trình thu thập để bật tính năng ghi nhật ký theo dõi HCI Bluetooth trên DUT và thu thập nhật ký cho từng kiểm thử. Trình thu thập sẽ định cấu hình và bật tính năng ghi nhật ký snoop cho quá trình chạy thử nghiệm, đồng thời khôi phục các chế độ cài đặt sau khi quá trình chạy thử nghiệm kết thúc.

Tóm tắt

Hằng số
`String`	`SNOOP_LOG_MODE_PROPERTY`

Hàm khởi tạo công khai
`BluetoothHciSnoopLogCollector()`

Phương thức công khai
`String`	`getReportingDir()` Truy xuất thư mục để báo cáo nhật ký theo dõi HCI.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Lệnh gọi lại khi một trường hợp kiểm thử kết thúc.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Lệnh gọi lại khi một lần chạy thử kết thúc.
`void`	`onTestRunStart(DeviceMetricData runData)` Lệnh gọi lại khi một lần chạy thử nghiệm bắt đầu.
`void`	`onTestStart(DeviceMetricData testData)` Lệnh gọi lại khi một trường hợp kiểm thử bắt đầu.
`void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData runData)` Việc triển khai phương thức này sẽ cho phép ghi nhật ký thư mục, phân tích cú pháp thư mục để đưa các chỉ số vào `DeviceMetricData`.
`final void`	`processMetricFile(String key, File metricFile, DeviceMetricData runData)` Việc triển khai phương thức này phải cho phép ghi nhật ký tệp, phân tích cú pháp tệp để đưa các chỉ số vào `DeviceMetricData`.

Phương thức được bảo vệ
`void`	`executeShellCommand(ITestDevice device, String command)` Thực thi lệnh shell trên thiết bị.

Hằng số

SNOOP_LOG_MODE_PROPERTY

public static final String SNOOP_LOG_MODE_PROPERTY

Giá trị không đổi: "persist.bluetooth.btsnooplogmode"

Hàm khởi tạo công khai

BluetoothHciSnoopLogCollector

public BluetoothHciSnoopLogCollector ()

Phương thức công khai

getReportingDir

public String getReportingDir ()

Truy xuất thư mục để báo cáo nhật ký theo dõi HCI.

Giá trị trả về
`String`

onTestEnd

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

Lệnh gọi lại khi một trường hợp kiểm thử kết thúc. Đây là thời điểm dọn dẹp.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` chứa dữ liệu cho trường hợp kiểm thử. Sẽ là cùng một đối tượng như trong `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: bản đồ hiện tại của các chỉ số được truyền đến `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.
`test`	`TestDescription`: `TestDescription` của trường hợp kiểm thử đang diễn ra.

Gửi
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Lệnh gọi lại khi một lần chạy thử kết thúc. Đây là thời điểm dọn dẹp.

Tham số
`runData`	`DeviceMetricData`: `DeviceMetricData` chứa dữ liệu cho lần chạy. Sẽ là cùng một đối tượng như trong `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: bản đồ hiện tại của các chỉ số được truyền đến `ERROR(/#testRunEnded(long,Map))`.

Gửi
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Lệnh gọi lại khi một lần chạy thử nghiệm bắt đầu.

Tham số
`runData`	`DeviceMetricData`: `DeviceMetricData` chứa dữ liệu cho lần chạy.

Gửi
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Lệnh gọi lại khi một trường hợp kiểm thử bắt đầu.

Tham số
`testData`	`DeviceMetricData`: `DeviceMetricData` chứa dữ liệu cho trường hợp kiểm thử.

Gửi
`DeviceNotAvailableException`

processMetricDirectory

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

Việc triển khai phương thức này sẽ cho phép ghi nhật ký thư mục, phân tích cú pháp thư mục để đưa các chỉ số vào DeviceMetricData.

Tham số
`key`	`String`: khoá tuỳ chọn được liên kết với thư mục đã được kéo.
`metricDirectory`	`File`: `ERROR(/File)` được kéo từ thiết bị khớp với khoá tuỳ chọn.
`runData`	`DeviceMetricData`: `DeviceMetricData` nơi có thể lưu trữ các chỉ số.

processMetricFile

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

Việc triển khai phương thức này phải cho phép ghi nhật ký tệp, phân tích cú pháp tệp để đưa các chỉ số vào DeviceMetricData.

Tham số
`key`	`String`: khoá tuỳ chọn được liên kết với tệp đã được kéo.
`metricFile`	`File`: `ERROR(/File)` được kéo từ thiết bị khớp với khoá tuỳ chọn.
`runData`	`DeviceMetricData`: `DeviceMetricData` nơi có thể lưu trữ các chỉ số.

Phương thức được bảo vệ

executeShellCommand

protected void executeShellCommand (ITestDevice device, 
                String command)

Thực thi lệnh shell trên thiết bị. Nếu quá trình thực thi không thành công (mã thoát khác 0), hãy gửi một DeviceRuntimeException.

Tham số
`device`	`ITestDevice`
`command`	`String`

Gửi
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`