当前位置：首页 > news >正文

FastBle单元测试终极指南：Mockito在Android蓝牙BLE开发中的7个实战技巧

news 2026/8/9 16:51:55

FastBle单元测试终极指南：Mockito在Android蓝牙BLE开发中的7个实战技巧

【免费下载链接】FastBleAndroid Bluetooth Low Energy (BLE) Fast Development Framework. It uses simple ways to filter, scan, connect, read ,write, notify, readRssi, setMTU, and multiConnection.项目地址: https://gitcode.com/gh_mirrors/fa/FastBle

想要在Android蓝牙BLE开发中编写可靠的单元测试吗？FastBle作为Android蓝牙低功耗快速开发框架，提供了简单高效的方式来过滤、扫描、连接、读写、通知等BLE操作。本文将通过7个实战技巧，教你如何使用Mockito为FastBle项目编写专业的单元测试，确保你的蓝牙应用稳定可靠。

📱 FastBle框架核心架构解析

FastBle框架采用分层设计，核心模块包括蓝牙管理、回调处理、扫描配置和数据传输。了解这些模块是编写有效单元测试的基础：

BleManager：核心管理类，位于FastBleLib/src/main/java/com/clj/fastble/BleManager.java
回调模块：包含各种回调接口，如BleScanCallback.java和BleWriteCallback.java
扫描配置：BleScanRuleConfig.java提供灵活的扫描规则配置

FastBle应用界面展示BLE设备扫描方式选择

🛠️ 技巧1：Mock Android蓝牙API依赖

在单元测试中，你需要模拟Android的BluetoothAdapter和BluetoothGatt等系统API。使用Mockito的@Mock和@InjectMocks注解可以轻松实现：

@RunWith(MockitoJUnitRunner.class) public class BleManagerTest { @Mock private BluetoothAdapter mockBluetoothAdapter; @Mock private BluetoothGatt mockBluetoothGatt; @InjectMocks private BleManager bleManager; @Test public void testBluetoothEnableCheck() { // 模拟蓝牙已启用 when(mockBluetoothAdapter.isEnabled()).thenReturn(true); assertTrue(bleManager.isBluetoothEnabled()); } }

🔍 技巧2：模拟BLE设备扫描过程

FastBle的扫描功能可以通过Mockito模拟回调结果进行测试。测试扫描回调的正确处理：

@Test public void testScanCallbackSuccess() { // 创建模拟的BLE设备 BleDevice mockDevice = new BleDevice("TEST-123", "AA:BB:CC:DD:EE:FF", -60); // 模拟扫描回调 ArgumentCaptor<BleScanCallback> callbackCaptor = ArgumentCaptor.forClass(BleScanCallback.class); verify(mockBleScanner).startScan(callbackCaptor.capture()); // 触发回调 callbackCaptor.getValue().onScanStarted(true); callbackCaptor.getValue().onScanning(mockDevice); // 验证设备列表更新 assertEquals(1, deviceList.size()); }

FastBle扫描结果展示已发现的BLE设备列表

🔗 技巧3：测试连接状态管理

连接状态管理是BLE开发的关键。使用Mockito验证连接状态转换：

@Test public void testConnectionStateTransitions() { // 模拟连接成功 when(mockBluetoothGatt.connect()).thenReturn(true); bleManager.connect(mockDevice); // 验证连接状态变化 verify(mockCallback).onConnectionChanged( eq(BleConnectStateParameter.CONNECTED)); // 模拟连接断开 bleManager.disconnect(); verify(mockCallback).onConnectionChanged( eq(BleConnectStateParameter.DISCONNECTED)); }

📊 技巧4：模拟GATT服务发现

GATT服务发现是BLE通信的基础。测试服务发现流程：

@Test public void testServiceDiscovery() { // 模拟GATT服务列表 List<BluetoothGattService> mockServices = createMockGattServices(); when(mockBluetoothGatt.discoverServices()).thenReturn(true); when(mockBluetoothGatt.getServices()).thenReturn(mockServices); // 触发服务发现 bleManager.discoverServices(); // 验证回调 verify(mockCallback).onServicesDiscovered( eq(BluetoothGatt.GATT_SUCCESS), anyList()); }

FastBle展示已连接设备的GATT服务列表

✍️ 技巧5：验证数据读写操作

数据读写是BLE应用的核心功能。测试特征读写操作：

@Test public void testCharacteristicWrite() { // 创建模拟特征 BluetoothGattCharacteristic mockCharacteristic = createMockCharacteristic(); // 模拟写入数据 byte[] testData = {0x01, 0x02, 0x03}; // 执行写入操作 bleManager.writeCharacteristic( mockDevice, mockCharacteristic, testData); // 验证写入回调 verify(mockWriteCallback).onWriteSuccess( eq(mockCharacteristic), eq(testData)); }

FastBle展示服务的特征列表，支持读写操作

🔔 技巧6：测试通知和指示功能

通知功能测试需要模拟特征值变化：

@Test public void testNotificationCallback() { // 启用通知 bleManager.enableNotify(mockDevice, mockCharacteristic, true); // 模拟特征值变化 byte[] notificationData = {0x0A, 0x0B, 0x0C}; when(mockCharacteristic.getValue()).thenReturn(notificationData); // 触发通知回调 mockGattCallback.onCharacteristicChanged( mockBluetoothGatt, mockCharacteristic); // 验证数据接收 verify(mockNotifyCallback).onNotifySuccess( eq(mockCharacteristic), eq(notificationData)); }

FastBle操作控制台展示实时数据通信效果

🧪 技巧7：集成测试与覆盖率优化

结合JUnit和Mockito创建完整的测试套件：

创建测试基类：在app/src/androidTest/java/com/clj/blesample/目录下建立测试基类
配置测试依赖：在build.gradle中添加Mockito和JUnit依赖
编写测试用例：覆盖所有核心功能点
生成测试报告：使用Jacoco生成代码覆盖率报告

@RunWith(AndroidJUnit4.class) public class FastBleIntegrationTest { @Rule public ActivityTestRule<MainActivity> activityRule = new ActivityTestRule<>(MainActivity.class); @Test public void testCompleteBleWorkflow() { // 测试完整的BLE工作流程 // 1. 扫描设备 // 2. 连接设备 // 3. 发现服务 // 4. 读写特征 // 5. 断开连接 } }