# BluetoothMAC

**Repository Path**: GKoSon/BluetoothMAC

## Basic Information

- **Project Name**: BluetoothMAC
- **Description**: win10笔记本安装QT6.10 开发一个安卓APP 在oppo手机测试 可以和MCU+BT24S模组 做蓝牙通信 文件传输 
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-04
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

基于 Qt 6.10.1 开发的跨平台 Android 蓝牙通信应用，专为 BT24S 蓝牙模组打造轻量化的调试工具，适配 Android 移动端交互逻辑，已在 OPPO A3x 真机测试验证通过。集成 Qt 蓝牙模块，支持周边蓝牙设备扫描（内置 UUID + 制造商双重过滤规则，仅展示 BT24S 模组），点击即可完成设备连接；连接成功后自动使能 UUID 对应服务，实现与 BT24S 模组的 TX/RX 双向数据收发，等效于移动端蓝牙串口助手。支持蓝牙文件传输功能，可通过自定义文件传输协议将预存于手机本地的 bin 固件文件发送至 MCU，实现 BT24S 模组的固件升级，简化线下调试与固件更新流程。

### 功能
- 使用 Qt 框架开发 Android 应用。
- 蓝牙设备扫描与展示。
- 获取并展示蓝牙设备的 MAC 地址。
- 蓝牙服务发现与设备连接功能。
- 通过蓝牙进行文件传输。

### 技术栈
- **语言**: C++, Qt
- **框架**: Qt 6.10.1
- **模块**: QtBluetooth
- **目标平台**: Android (arm64-v8a)

### 文件结构说明
- `BluetoothMAC.pro`: Qt 项目文件，定义编译规则。
- `.qtcreator/`: Qt Creator 的配置文件目录。
- `android/`: Android 相关资源和配置文件（如 `AndroidManifest.xml` 和图标资源）。
- `build/`: 编译输出目录，包含构建过程中生成的缓存和索引文件（由 Qt 和 Clangd 生成）。

### 开发与构建环境
- Qt 6.10.1
- Android 构建套件（arm64-v8a）
- 支持 C++17 或更高版本的编译器
- Android SDK/NDK

### 使用说明
1. 使用 Qt Creator 打开 `BluetoothMAC.pro` 文件。
2. 配置 Android 构建环境（包括 JDK、SDK、NDK 和 Qt Android 套件）。
3. 构建并部署项目到 Android 设备。
4. 运行应用程序，查看蓝牙设备列表和 MAC 地址。

### 注意事项
- 由于涉及 Android 平台蓝牙权限，需在 `AndroidManifest.xml` 中正确配置权限请求。
- 项目可能需要在实际支持蓝牙功能的 Android 设备上运行测试。
- 从零开始，请阅读文章《QT6.10小项目:如何使用我的开源项目》。

### 贡献
欢迎提交 Pull Request 或 Issue 来改进项目。