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) 从设备中删除信息收集日志文件
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) 上传用于测试结果的信息收集日志文件

字段

BTSNOOP_API

public static final String BTSNOOP_API

幕后花絮

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)

从设备中删除信息收集日志文件

参数
device	ITestDevice

抛出
DeviceNotAvailableException

停用

public static boolean disable (ITestDevice device)

在指定设备上停用蓝牙

返回
boolean	如果停用成功，则为 true，否则为 false

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

停用 BtsnoopLogging

public static boolean disableBtsnoopLogging (ITestDevice device, 
                File sl4aApkFile)

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

参数
sl4aApkFile	File：sl4a.apk 文件位置；如果已安装，则为 null

返回
boolean	成功与否

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

停用 BtsnoopLogging

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

获取 BluetoothMac

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 信息收集日志文件路径

返回
String	bt_snoop_log 的文件名；如果未找到，则返回 null

抛出
DeviceNotAvailableException

运行 BluetoothInstrumentation

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

运行 BluetoothInstrumentationWith 重试

public static boolean runBluetoothInstrumentationWithRetry (ITestDevice device, 
                String command)

参数
device	ITestDevice
command	String

返回
boolean

抛出
DeviceNotAvailableException

切换 BtsnoopLogging

public static boolean toggleBtsnoopLogging (Sl4aClient client, 
                boolean onOff)

参数
client	Sl4aClient
onOff	boolean

返回
boolean

抛出
DeviceNotAvailableException

取消配对并重试

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)

上传用于测试结果的信息收集日志文件

参数
listener	ITestInvocationListener
device	ITestDevice
type	String
iteration	int

抛出
DeviceNotAvailableException