החל מ-27 במרץ 2025, מומלץ להשתמש ב-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

כלי איסוף להפעלת רישום Snoop עבור HCI של Bluetooth ב-DUT ולאיסוף היומן לכל בדיקה. הכלי לאיסוף נתונים יגדיר ויפעיל את רישום הנתונים של snoop לצורך הבדיקה, ויחזיר את ההגדרות למצב הקודם אחרי הבדיקה.

סיכום

ערכים קבועים
`String`	`SNOOP_LOG_MODE_PROPERTY`

Constructors ציבוריים
`BluetoothHciSnoopLogCollector()`

‫methods ציבוריים
`String`	`getReportingDir()` אחזור הספרייה שאליה ידווחו יומני ה-Snoop של HCI.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` קריאה חוזרת כשמקרה בדיקה מסתיים.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` פונקציית Callback כשמסתיימת הרצת בדיקה.
`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

ערך קבוע: "persist.bluetooth.btsnooplogmode"

Constructors ציבוריים

BluetoothHciSnoopLogCollector

public BluetoothHciSnoopLogCollector ()

‫methods ציבוריים

getReportingDir

public String getReportingDir ()

אחזור הספרייה שאליה ידווחו יומני ה-Snoop של HCI.

החזרות
`String`

onTestEnd

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`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

פונקציית Callback כשמסתיימת הרצת בדיקה. זה הזמן לנקות את הנתונים.

פרמטרים
`runData`	‫`DeviceMetricData`: `DeviceMetricData` שמכיל את הנתונים של ההרצה. יהיה אותו אובייקט כמו במהלך `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	‫: המפה הנוכחית של המדדים שמועברים אל `ERROR(/#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`: הערך `ERROR(/File)` שנמשך מהמכשיר שתואם למפתח האפשרות.
`runData`	‫`DeviceMetricData`: `DeviceMetricData` שבו אפשר לאחסן מדדים.

processMetricFile

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

ההטמעה של השיטה צריכה לאפשר רישום של הקובץ, ניתוח שלו כדי להפיק מדדים שיוצבו ב-DeviceMetricData.

פרמטרים
`key`	‫`String`: מקש האפשרויות שמשויך לקובץ שנמשך.
`metricFile`	‫`File`: הערך `ERROR(/File)` שנמשך מהמכשיר שתואם למפתח האפשרות.
`runData`	‫`DeviceMetricData`: `DeviceMetricData` שבו אפשר לאחסן מדדים.

שיטות מוגנות

executeShellCommand

protected void executeShellCommand (ITestDevice device, 
                String command)

מריצים פקודת shell במכשיר. אם ההרצה נכשלה (קוד יציאה שאינו אפס), מוצגת השגיאה DeviceRuntimeException.

פרמטרים
`device`	`ITestDevice`
`command`	`String`

זריקות
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`