# BluetoothAssistant

**Repository Path**: hadss/hmbluetooth-assistant

## Basic Information

- **Project Name**: BluetoothAssistant
- **Description**: HarmonyOS蓝牙调试助手
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-10-24
- **Last Updated**: 2024-12-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BluetoothAssistant

#### 介绍
HarmonyOS蓝牙调试助手是一款免费开源的蓝牙调试工具，帮助开发者更简便高效的开发蓝牙应用，辅助解决在鸿蒙应用蓝牙相关功能开发过程中遇到的一些问题。其主要功能如下：


- 1、附近蓝牙设备扫描。
- 2、蓝牙设备连接
- 3、读写特征值
- 4、蓝牙操作日志查看
- 5、常用数据包添加和保存


#### 软件架构

支持 HarmonyOS NEXT，基于 OpenHarmony API 12

软件架构说明：

```
|---- hmbluetooth-assistant
|     |---- AppScope  #示例代码文件夹
|     |---- entry  #示例代码文件夹
|     |---- |---- build  #打包后的文件
|           |---- src  #模块代码
|                |---- main  #模块代码
|                     |---- ets  #蓝牙调试助手核心代码
|                          |---- ble  #蓝牙调试助手核心代码
|                          |---- entryability  #入口ability
|                          |---- entrybackupability  #backupability
|                          |---- page  #蓝牙调试助手UI页面
|                     |---- resource   #蓝牙调试助手资源文件
|           |---- hivgorfile.ts  #hvigor打包工具
|           |---- *.json5  #配置文件       
|     |---- README.md     # 开发导读
```



#### 安装教程

1.  下载本项目代码，导入到DevEco Studio中，编译打包后，点击运行即可。
2.  从华为应用市场安装（待定）。

#### 使用说明

1.  安装蓝牙调试助手后，在桌面上点击图标，启动app。
2.  首页面上刷新扫描附近蓝牙设备，可通过搜索功能快速查找到目标设备，点击设备进行连接。
3.  连接成功后，自动进入service列表，选择对应特征值服务，点击进入characteristic数据读取页，选择对应的功能按钮即可进行特征值读写。
4.  点击右上角日志图标，即可查看当前设备的蓝牙操作日志


#### 贡献代码
使用过程中发现任何问题都可以提交Issue，当然，也非常欢迎提交PR 。

#### 开源协议
本项目遵循 MIT License。