# zlas

**Repository Path**: TaBuE/zlas

## Basic Information

- **Project Name**: zlas
- **Description**: 蓝牙&app
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-13
- **Last Updated**: 2025-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MyApplication2

MyApplication2 是一款基于蓝牙通信的健康管理应用，专注于饮水监测与设备连接功能。通过该应用，用户可以实时监控饮水量、设置饮水目标，并与蓝牙设备进行数据交互。

## 功能特性

- **蓝牙设备扫描与连接**：支持扫描并连接 BLE（蓝牙低功耗）设备，实现设备间的数据通信。
- **饮水监测**：记录每日饮水量，提供可视化图表展示饮水趋势。
- **饮水目标设置**：用户可自定义每日饮水目标，并实时查看完成进度。
- **设备管理**：支持保存已连接设备信息，并提供设备列表供快速切换。
- **提醒功能**：可设置饮水提醒间隔，帮助用户养成良好饮水习惯。
- **数据同步**：支持与蓝牙设备同步饮水数据，确保本地与设备端数据一致。

## 技术栈

- **开发语言**：Java
- **框架/库**：
  - Android Jetpack（ViewModel, LiveData）
  - Room Persistence Library（本地数据库）
  - RecyclerView（列表展示）
  - LineChart（数据可视化）
- **蓝牙通信**：使用 Android Bluetooth API 实现 BLE 设备扫描、连接与数据读写。
- **架构模式**：MVVM（Model-View-ViewModel），实现 UI 与业务逻辑分离。

## 架构概览

项目采用 **MVVM 架构**，分为以下主要模块：

- **UI 层（View）**：由 `Fragment` 和 `Activity` 组成，负责界面展示与用户交互。
- **ViewModel 层**：负责处理 UI 相关逻辑，与 Repository 通信获取数据。
- **Repository 层**：封装数据访问逻辑，包括蓝牙通信和本地数据库操作。
- **数据层（Model）**：
  - 使用 Room 数据库存储设备信息和饮水记录。
  - 通过蓝牙协议与设备进行数据交互。

## 使用说明

1. **启动应用**：打开应用后，默认进入主界面。
2. **扫描设备**：点击“扫描”按钮，进入设备扫描界面，选择目标设备进行连接。
3. **设置饮水目标**：在主界面点击“设置目标”按钮，输入每日饮水目标。
4. **查看饮水数据**：主界面显示当前饮水量、目标值及完成百分比，并提供图表展示历史数据。
5. **设备管理**：已连接设备将自动保存，可在设备列表中查看、切换或删除设备。
6. **同步数据**：点击“同步”按钮，手动从设备同步最新饮水数据。

## 权限要求

- **蓝牙权限**：应用需要访问蓝牙功能以扫描和连接设备。
- **位置权限**：部分设备需要位置权限以启用蓝牙扫描功能。
- **存储权限**：用于保存设备信息和饮水记录至本地数据库。

## 主要模块

- **蓝牙模块**：负责设备扫描、连接、数据读写。
- **饮水监测模块**：记录并展示每日饮水量，提供图表分析。
- **设备管理模块**：保存、切换和管理已连接设备。
- **提醒模块**：设置饮水提醒间隔，定时提醒用户饮水。
- **数据同步模块**：确保本地数据与蓝牙设备数据保持一致。

## 开发者指南

### 构建与运行

1. **环境准备**：
   - Android Studio（建议最新稳定版）
   - Android SDK（API 21+）
   - Gradle 插件版本匹配 Android Studio 版本

2. **构建步骤**：
   - 克隆项目到本地。
   - 打开 Android Studio，导入项目。
   - 点击 "Sync Project with Gradle Files"。
   - 点击 "Run" 按钮，选择目标设备进行调试。

### 贡献代码

欢迎贡献代码！请遵循以下步骤：

1. Fork 项目。
2. 创建新分支（`git checkout -b feature/your-feature-name`）。
3. 提交更改（`git commit -am 'Add some feature'`）。
4. 推送分支（`git push origin feature/your-feature-name`）。
5. 提交 Pull Request。

### 许可证

本项目采用 [MIT License](https://opensource.org/licenses/MIT) 开源协议。详情请参阅 [LICENSE](LICENSE) 文件。