BluetoothUtils

public class BluetoothUtils
extends Object

java.lang.Object
   ↳ com.android.tradefed.util.BluetoothUtils

用于在设备上调用 BluetoothInstrumentation 的实用函数

设备端 BluetoothInstrumentation 代码位于 AOSP 中的以下位置：frameworks/base/core/tests/bluetoothtests

摘要

字段

public static final String BTSNOOP_API

public static final String BTSNOOP_CMD

public static final String BTSNOOP_DISABLE_CMD

public static final String BTSNOOP_ENABLE_CMD

public static final String GOLD_BTSNOOP_LOG_PATH

public static final String O_BUILD

公共构造函数

BluetoothUtils()

公共方法

static void cleanLogFile(ITestDevice device)

从设备中删除 Snoop 日志文件

static boolean disable(ITestDevice device)

在给定设备上停用蓝牙

static boolean disableBtsnoopLogging(ITestDevice device, File sl4aApkFile)

通过 sl4a 调用停用 btsnoop 日志记录

static boolean disableBtsnoopLogging(ITestDevice device)

通过 sl4a 调用停用 btsnoop 日志记录

static boolean enable(ITestDevice device)

在指定设备上启用蓝牙

static boolean enableBtsnoopLogging(ITestDevice device, File sl4aApkFile)

通过 sl4a 调用启用 btsnoop 日志记录

static boolean enableBtsnoopLogging(ITestDevice device)

通过 sl4a 调用启用 btsnoop 日志记录

static String getBluetoothMac(ITestDevice device)

检索给定设备的 BT MAC

static getBondedDevices(ITestDevice device)

返回给定设备已绑定的设备的蓝牙 MAC 地址

static String getBtSnoopLogFilePath(ITestDevice device)

从 bt_stack.config 文件获取 bt 嗅探日志文件路径

static String runBluetoothInstrumentation(ITestDevice device, String command)

用于执行 BT 插桩命令并返回输出的便捷方法

static boolean runBluetoothInstrumentationWithRetry(ITestDevice device, String command)
static boolean toggleBtsnoopLogging(Sl4aClient client, boolean onOff)
static boolean unpairWithRetry(ITestDevice device)

使用线性退避算法重试清除蓝牙配对

static void uploadLogFiles(ITestInvocationListener listener, ITestDevice device, String type, int iteration)

上传测试结果的 Snoop 日志文件

字段

BTSNOOP_API

public static final String BTSNOOP_API

BTSNOOP_CMD

public static final String BTSNOOP_CMD

BTSNOOP_DISABLE_CMD

public static final String BTSNOOP_DISABLE_CMD

BTSNOOP_ENABLE_CMD

public static final String BTSNOOP_ENABLE_CMD

GOLD_BTSNOOP_LOG_PATH

public static final String GOLD_BTSNOOP_LOG_PATH

O_BUILD

public static final String O_BUILD

公共构造函数

BluetoothUtils

public BluetoothUtils ()

公共方法

cleanLogFile

public static void cleanLogFile (ITestDevice device)

从设备中删除 Snoop 日志文件

参数
device ITestDevice

抛出
DeviceNotAvailableException

停用

public static boolean disable (ITestDevice device)

在给定设备上停用蓝牙

返回
boolean 如果停用成功，则为 true；否则为 false
抛出
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableBtsnoopLogging

public static boolean disableBtsnoopLogging (ITestDevice device, 
                File sl4aApkFile)

通过 sl4a 调用停用 btsnoop 日志记录

参数
sl4aApkFile File：sl4a.apk 文件位置，如果已安装，则为 null
返回
boolean 是否成功
抛出
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableBtsnoopLogging

public static boolean disableBtsnoopLogging (ITestDevice device)

通过 sl4a 调用停用 btsnoop 日志记录

返回
boolean 是否成功
抛出
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

启用

public static boolean enable (ITestDevice device)

在指定设备上启用蓝牙

返回
boolean 如果启用成功，则为 true，否则为 false
抛出
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableBtsnoopLogging

public static boolean enableBtsnoopLogging (ITestDevice device, 
                File sl4aApkFile)

通过 sl4a 调用启用 btsnoop 日志记录

参数
sl4aApkFile File：sl4a.apk 文件位置，如果已安装，则为 null
返回
boolean 是否成功
抛出
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableBtsnoopLogging

public static boolean enableBtsnoopLogging (ITestDevice device)

通过 sl4a 调用启用 btsnoop 日志记录

返回
boolean 是否成功
抛出
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBluetoothMac

public static String getBluetoothMac (ITestDevice device)

检索给定设备的 BT MAC

返回
String BT MAC 或 null（如果未找到）
抛出
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBondedDevices

public static  getBondedDevices (ITestDevice device)

返回给定设备已配对的设备的蓝牙 MAC 地址

返回
蓝牙 MAC 地址
抛出
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBtSnoopLogFilePath

public static String getBtSnoopLogFilePath (ITestDevice device)

从 bt_stack.config 文件获取 bt snoop 日志文件路径

返回
String bt_snoop_log 的文件名，如果未找到，则为 null
抛出
DeviceNotAvailableException

runBluetoothInstrumentation

public static String runBluetoothInstrumentation (ITestDevice device, 
                String command)

用于执行 BT 插桩命令并返回输出的便捷方法

参数
command String：发送到 BT 插桩的命令字符串，目前支持：enable、disable、unpairAll、getName、getAddress、getBondedDevices；如需了解详情，请参阅 AOSP 源代码
返回
String BluetoothInstrumentation 的输出
抛出
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

runBluetoothInstrumentationWithRetry

public static boolean runBluetoothInstrumentationWithRetry (ITestDevice device, 
                String command)

参数
device ITestDevice

command String

返回
boolean

抛出
DeviceNotAvailableException

toggleBtsnoopLogging

public static boolean toggleBtsnoopLogging (Sl4aClient client, 
                boolean onOff)

参数
client Sl4aClient

onOff boolean

返回
boolean

抛出
DeviceNotAvailableException

unpairWithRetry

public static boolean unpairWithRetry (ITestDevice device)

使用线性退避算法重试清除蓝牙配对

返回
boolean

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

uploadLogFiles

public static void uploadLogFiles (ITestInvocationListener listener, 
                ITestDevice device, 
                String type, 
                int iteration)

上传测试结果的 Snoop 日志文件

参数
listener ITestInvocationListener

device ITestDevice

type String

iteration int

抛出
DeviceNotAvailableException