اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

مجمِّع لتفعيل تسجيل التطفل على واجهة تحكّم المضيف في البلوتوث على الجهاز الخاضع للاختبار وجمع السجلّ لكل اختبار. سيضبط المجمِّع إعدادات تسجيل التطفل ويفعّلها لتشغيل الاختبار، ثم سيعيد ضبط الإعدادات بعد تشغيل الاختبار.

ملخّص

الثوابت
`String`	`SNOOP_LOG_MODE_PROPERTY`

طُرق وضع التصميم العامة
`BluetoothHciSnoopLogCollector()`

الإجراءات العامة
`String`	`getReportingDir()` استرداد الدليل الذي سيتم إرسال سجلّات التطفل على واجهة تحكّم المضيف إليه
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` طلب ردّ عند انتهاء حالة اختبار
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> 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 على الجهاز

الثوابت

SNOOP_LOG_MODE_PROPERTY

public static final String SNOOP_LOG_MODE_PROPERTY

Constant Value: "persist.bluetooth.btsnooplogmode"

طُرق وضع التصميم العامة

BluetoothHciSnoopLogCollector

public BluetoothHciSnoopLogCollector ()

الإجراءات العامة

getReportingDir

public String getReportingDir ()

استرداد الدليل الذي سيتم إرسال سجلّات التطفل على واجهة تحكّم المضيف إليه

المرتجعات
`String`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

طلب ردّ عند انتهاء حالة اختبار يجب أن يكون هذا هو وقت التنظيف.

المعلَمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات حالة الاختبار سيكون هو الكائن نفسه الذي تم استخدامه أثناء `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: الخريطة الحالية للمقاييس التي تم تمريرها إلى `testEnded(TestDescription,Map)`.
`test`	`TestDescription`: `TestDescription` لحالة الاختبار قيد التقدّم

عمليات الطرح
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

طلب ردّ عند انتهاء تشغيل اختبار يجب أن يكون هذا هو وقت التنظيف.

المعلَمات
`runData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات تشغيل الاختبار سيكون هو الكائن نفسه الذي تم استخدامه أثناء `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	`Map`: الخريطة الحالية للمقاييس التي تم تمريرها إلى `testRunEnded(long,Map)`

عمليات الطرح
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

طلب ردّ عند بدء تشغيل اختبار

المعلَمات
`runData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات تشغيل الاختبار

عمليات الطرح
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

طلب ردّ عند بدء حالة اختبار

المعلَمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات حالة الاختبار

عمليات الطرح
`DeviceNotAvailableException`

processMetricDirectory

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

يجب أن يسمح تنفيذ الطريقة بتسجيل الدليل وتحليله بحثًا عن المقاييس التي سيتم وضعها في DeviceMetricData.

المعلَمات
`key`	`String`: مفتاح الخيار المرتبط بالدليل الذي تم سحبه
`metricDirectory`	`File`: `File` الذي تم سحبه من الجهاز والذي يطابق مفتاح الخيار
`runData`	`DeviceMetricData`: `DeviceMetricData` الذي يمكن تخزين المقاييس فيه

processMetricFile

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

يجب أن يسمح تنفيذ الطريقة بتسجيل الملف وتحليله بحثًا عن المقاييس التي سيتم وضعها في DeviceMetricData.

المعلَمات
`key`	`String`: مفتاح الخيار المرتبط بالملف الذي تم سحبه
`metricFile`	`File`: `File` الذي تم سحبه من الجهاز والذي يطابق مفتاح الخيار
`runData`	`DeviceMetricData`: `DeviceMetricData` الذي يمكن تخزين المقاييس فيه

الإجراءات المحمية

executeShellCommand

protected void executeShellCommand (ITestDevice device, 
                String command)

تنفيذ أمر shell على الجهاز إذا تعذّر التنفيذ (رمز الخروج غير صفري)، يتم طرح DeviceRuntimeException.

المعلَمات
`device`	`ITestDevice`
`command`	`String`

عمليات الطرح
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`