

基于 uni-app + Vue 3 的跨平台蓝牙调试工具

DotNet技术匠

2025-12-12

导读：一款专业的蓝牙调试工具。

前言

物联网和智能硬件快速发展，蓝牙通信已成为设备间交互的重要方式对于开发者而言，调试蓝牙设备往往是一件繁琐且平台依赖性强的工作。不同操作系统对蓝牙的支持方式各异，开发和测试过程常常需要在多个环境间切换。

本文推荐一款真正跨平台、功能完整、使用便捷的蓝牙调试工具。

项目介绍

BLE Toolkit+ 是一款专业的蓝牙调试工具，基于 uni-app + Vue 3 开发，支持多平台部署,同时支持微信小程序、iOS 原生应用和 Android 原生应用。

工具主要用于蓝牙设备的调试和开发，支持设备扫描、服务发现、特征值读写等功能。不管是嵌入式开发调试 ESP32 模块，还是移动端验证蓝牙通信逻辑，都能通过该工具高效完成工作。

项目功能

1、支持蓝牙设备的扫描与发现，实时列出附近可连接设备

2、可查看设备详细信息，包括名称、信号强度、广播数据等

3、提供服务与特征值的完整解析，支持读取、写入及启用通知

4、支持自定义蓝牙广播，可在 iOS 和 Android 上模拟 BLE 外设

5、数据写入支持 UTF-8 文本与 HEX 格式，满足不同协议需求

6、集成 ESP32 开发板支持，提供配套固件与通信示例

项目技术

技术栈

前端框架：Vue 3
UI 框架：@dcloudio/uni-ui
原生插件：BLE-Module（自定义蓝牙广播插件）

平台支持

微信小程序：使用微信小程序原生API
iOS原生：基于CoreBluetooth框架
Android原生：支持Android 5.0及以上版本

开发环境

开发板：ESP32
开发环境：Arduino IDE
依赖库：BLE库（ESP32内置）

功能特性

支持 BLE 服务广播
支持特征值读写
支持通知功能
支持多种数据格式（UTF-8、HEX）

服务说明

服务1（UUID: 4fafc201-1fb5-459e-8fcc-c5c9c331914b）

写特征值：支持文本和 HEX 格式数据写入
通知特征值：支持数据通知功能

服务2（UUID: 4fafc201-1fb5-459e-8fcc-c5c9c331914c）

只读特征值：设备信息
只写特征值：控制命令
通知特征值：状态更新

数据格式

文本格式：UTF-8 编码
HEX 格式：支持标准 HEX 字符串（例如：FF01）

编译说明（ESP32 固件）

1、安装 Arduino IDE

2、安装 ESP32 开发板支持包

3、安装必要的库文件（如内置 BLE 库）

4、编译并上传代码到 ESP32 开发板

项目使用

安装依赖

cd BLEToolkit
npm install

运行项目

# H5 版本
npm run dev:h5

# 微信小程序
npm run dev:mp-weixin

# App（iOS / Android）
npm run dev:app

使用示例（uni-app 蓝牙 API）

// 初始化蓝牙模块
uni.openBluetoothAdapter({
success: () => {
    console.log('蓝牙初始化成功');
    // 开始搜索设备
    uni.startBluetoothDevicesDiscovery({
      success: () => {
        console.log('开始搜索设备');
      }
    });
  }
});

// 监听设备发现事件
uni.onBluetoothDeviceFound((devices) => {
console.log('发现新设备:', devices);
});

// 连接设备
function connectDevice(deviceId) {
  uni.createBLEConnection({
    deviceId: deviceId,
    success: () => {
      console.log('连接成功');
      // 获取设备服务
      uni.getBLEDeviceServices({
        deviceId: deviceId,
        success: (res) => {
          console.log('设备服务列表:', res.services);
        }
      });
    }
  });
}