# 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**: 1
- **Forks**: 1
- **Created**: 2026-07-14
- **Last Updated**: 2026-10-08

## 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">

**A collection of Android test sample code for JieLi Bluetooth products, making it easy for customers to test Bluetooth functionality.**

[中文](./README.md) · [English](./README_en.md)· [Documentation Center](https://doc.zh-jieli.com/vue/#/home) · [Version History](#7-version-history) · [Report Issues](https://github.com/Jieli-Tech/android-bt-demo/issues)

</div>

---

## 📋 Table of Contents

- [1. Overview](#1-overview)
- [2. Supported Platforms & Devices](#2-supported-platforms--devices)
- [3. Quick Start](#3-quick-start)
- [4. Project Structure](#4-project-structure)
- [5. Sample Selection Guide](#5-sample-selection-guide)
- [6. Community & Support](#6-community--support)
- [7. Version History](7-version-history)
- [8. License](#8-license)

---

## 1. Overview

`Android-BT-Demo` is a collection of Android test sample code provided by Zhuhai JieLi Technology Co., Ltd. for its Bluetooth products.

This repository includes the following use cases:

*  ATT device (GATT over BR/EDR) connection sample, demonstrating how to communicate with JieLi Bluetooth products via the GATT protocol on Android.

---

## 2. Supported Platforms & Devices

### 2.1 Android System Requirements

| Item | Description |
|------|------|
| **Minimum Version** | Android 5.0 (API 21) |
| **Target Version** | Android 16+ (API 36+) |
| **Development Language** | Kotlin / Java |

### 2.2 Supported Bluetooth Protocols

| Protocol | Description | Status |
|------|------|------|
| GATT over BR/EDR (ATT) | GATT communication over Classic Bluetooth, higher throughput | ✅ Supported |
| GATT over BLE | GATT communication over Bluetooth Low Energy | ✅ Supported |

> **Note**: Android support for ATT (GATT over BR/EDR) may have compatibility issues. Thorough testing on target devices is recommended.

---

## 3. Quick Start

### 3.1 Clone the Repository

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

### 3.2 Choose the Right Sample

Select the sample project based on your product needs:

```
android-bt-demo/
├── ATTConnect/       # ATT device (GATT over BR/EDR) connection sample
└── .../              # More samples coming soon
```

### 3.3 Import and Run

1. Open **Android Studio**
2. Click **File → Open** and select the sample directory (e.g., `ATTConnect/`)
3. Wait for Gradle sync to complete
4. Connect an Android phone and click **Run → Run 'app'**
5. Open the app on your phone and test Bluetooth functionality

---

## 4. Project Structure

```
android-bt-demo/
├── ATTConnect/                          # 📌 ATT device connection sample
├── LICENSE                              # Apache 2.0 License
└── README.md
```

* [ATTConnect](https://gitee.com/JieLi-Tech/android-bt-demo/tree/master/ATTConnect) --- ATT device (GATT over BR/EDR) connection sample

---

## 5. Sample Selection Guide

### 5.1 ATT Connection Sample (`ATTConnect/`)

| Item | Description |
|------|------|
| **Use Case** | Dual-mode Bluetooth devices (Classic Bluetooth + BLE) requiring high-speed data communication via the GATT protocol |
| **Key Features** | ATT device scanning, connect/disconnect management, data transfer, GATT service discovery |
| **Core Classes** | `BtScanner` (Bluetooth scanning), `BleManager` (BLE device management) |
| **Reference Docs** | [ATTConnect Detailed Guide](ATTConnect/README.md) |

---

## 6. Community & Support

### Technical Discussion

| Platform | Group/Link | Status |
|------|-----------|------|
| **Gitee** | [JieLi-Tech](https://gitee.com/JieLi-Tech) | ✅ Active |
| **Issue Tracker** | [Submit an Issue](https://github.com/Jieli-Tech/android-bt-demo/issues) | ✅ Open |

### Resource Links

| Resource | Link |
|------|------|
| 📖 **Online Documentation Center** | [https://doc.zh-jieli.com/vue](https://doc.zh-jieli.com/vue/#/home) |
| 🐛 **Issue Tracker** | [Gitee Issues](https://github.com/Jieli-Tech/android-bt-demo/issues) |

---

## 7. Version History

| Version | Date       | Changes              |
| ------- | ---------- | -------------------- |
| 1.0.0   | 2025/03/31 | 1. Added ATT connection sample |

## 8. License

This project is licensed under the [Apache License 2.0](./LICENSE).

```
Copyright 2024 Zhuhai JieLi Technology Co., Ltd.

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 Zhuhai JieLi Technology Co., Ltd. | Licensed under Apache License 2.0**

</div>