# android-bt-demo

**Repository Path**: Jieli-Tech/android-bt-demo

## Basic Information

- **Project Name**: android-bt-demo
- **Description**: No description available
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-14
- **Last Updated**: 2026-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[tag download]:https://github.com/JieLi-Tech/android-bt-demo/tags
[tag_badgen]:https://img.shields.io/badge/Tag-v1.0.0-informational?style=plastic&logo=android&labelColor=ffffff&logoColor=blue

# Android-BT-Demo  [![tag][tag_badgen]][tag download]

<div align="center">

**杰理蓝牙产品 Android 端测试示例代码集合，方便客户快速测试蓝牙功能。**

[中文](./README.md) · [English](./README_en.md) · [文档中心](https://doc.zh-jieli.com/vue/#/home) · [版本历史](#七版本历史) · [报告问题](https://github.com/Jieli-Tech/android-bt-demo/issues)

</div>

---

## 📋 目录

- [一、概述](#一概述)
- [二、支持的平台与设备](#二支持的平台与设备)
- [三、快速开始](#三快速开始)
- [四、工程结构](#四工程结构)
- [五、示例选择指南](#五示例选择指南)
- [六、社区与支持](#六社区与支持)
- [七、版本历史](七版本历史)
- [八、许可证](#八许可证)

---

## 一、概述

`Android-BT-Demo` 是珠海杰理科技股份有限公司为蓝牙产品提供的 Android 端测试示例代码集合仓库。

本仓库包含以下用例:

*  ATT 设备（GATT over BR/EDR）的连接示例，演示了如何在 Android 端通过 GATT 协议与杰理蓝牙产品进行数据通讯。

---

## 二、支持的平台与设备

### 2.1 Android 系统要求

| 项目 | 说明 |
|------|------|
| **最低版本** | Android 5.0（API 21） |
| **目标版本** | Android 16+（API 36+） |
| **开发语言** | Kotlin / Java |

### 2.2 支持的蓝牙协议

| 协议 | 说明 | 状态 |
|------|------|------|
| GATT over BR/EDR（ATT） | 基于经典蓝牙的 GATT 通讯，速率更高 | ✅ 支持 |
| GATT over BLE | 基于低功耗蓝牙的 GATT 通讯 | ✅ 支持 |

> **注意**：Android 端对 ATT（GATT over BR/EDR）功能的支持可能存在兼容性问题，建议在目标设备上进行充分测试。



---

## 三、快速开始

### 3.1 克隆仓库

```bash
git clone https://github.com/Jieli-Tech/android-bt-demo.git
cd android-bt-demo
```

### 3.2 选择合适的示例

根据你的产品需求选择示例工程：

```
android-bt-demo/
├── ATTConnect/       # ATT 设备（GATT over BR/EDR）连接示例
└── .../              # 更多示例持续更新中
```

### 3.3 导入并运行

1. 打开 **Android Studio**
2. 点击 **File → Open**，选择对应的示例目录（如 `ATTConnect/`）
3. 等待 Gradle 同步完成
4. 连接 Android 手机，点击 **Run → Run 'app'**
5. 在手机上打开 APP，测试蓝牙功能

---

## 四、工程结构

```
android-bt-demo/
├── ATTConnect/                          # 📌 ATT 设备连接示例
├── LICENSE                              # Apache 2.0 开源协议
└── README.md
```



* [ATTConnect](https://gitee.com/JieLi-Tech/android-bt-demo/tree/master/ATTConnect) --- ATT设备(Gatt over BR/EDR)的连接示例



---

## 五、示例选择指南

### 5.1 ATT 连接示例（`ATTConnect/`）

| 项目 | 说明 |
|------|------|
| **适用场景** | 双模蓝牙设备（经典蓝牙 + BLE），需要通过 GATT 协议进行高速数据通讯 |
| **关键特性** | ATT 设备扫描、连接/断开管理、数据收发、GATT 服务发现 |
| **核心类** | `BtScanner`（蓝牙扫描）、`BleManager`（BLE 设备管理） |
| **参考文档** | [ATTConnect 详细说明](ATTConnect/README.md) |





---

## 六、社区与支持

### 技术交流

| 平台 | 群号/链接 | 状态 |
|------|-----------|------|
| **Gitee** | [JieLi-Tech](https://gitee.com/JieLi-Tech) | ✅ 活跃 |
| **问题反馈** | [提交 Issue](https://github.com/Jieli-Tech/android-bt-demo/issues) | ✅ 开放 |

### 资源链接

| 资源 | 链接 |
|------|------|
| 📖 **在线文档中心** | [https://doc.zh-jieli.com/vue](https://doc.zh-jieli.com/vue/#/home) |
| 🐛 **问题反馈** | [Gitee Issues](https://github.com/Jieli-Tech/android-bt-demo/issues) |

---



## 七、版本历史

| 版本  | 日期       | 修改记录           |
| ----- | ---------- | ------------------ |
| 1.0.0 | 2025/03/31 | 1. 新增ATT连接示例 |



## 八、许可证

本项目采用 [Apache License 2.0](./LICENSE) 开源协议。

```
Copyright 2024 珠海市杰理科技股份有限公司

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```



<div align="center">


   **© 2024 珠海市杰理科技股份有限公司 | Licensed under Apache License 2.0**

</div>