# XTSensorTool

**Repository Path**: zpflog/XTSensorTool

## Basic Information

- **Project Name**: XTSensorTool
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# XTSensorTool - 安卓传感器数据全能工具

一款面向开发者与技术爱好者的 Android 传感器数据工具，提供传感器数据的实时采集、可视化分析、记录导出等一站式功能，助力传感器相关开发与调试工作。

![XTSensorTool 封面图](copyright.jpg) 

## 🚀 核心功能

- **全量传感器支持**：适配加速度计、陀螺仪、磁力计、光线传感器、压力传感器、接近传感器等设备原生传感器，自动识别设备支持的传感器类型。
- **双模式数据展示**：
- 数值模式：实时显示三轴数据、精度、采样频率等核心参数，支持数据保留位数自定义。
- 图表模式：通过动态折线图可视化数据变化趋势，支持单轴/多轴切换、数据缩放与暂停查看。
- **数据记录与导出**：支持一键启动/停止数据记录，自动生成 CSV 格式文件（包含时间戳、传感器参数、数据值），可通过系统分享功能导出至其他应用。
- **传感器详情查询**：展示传感器名称、类型、厂商、分辨率、最大量程、功耗等硬件参数，助力设备兼容性分析。
- **灵活采样率调节**：提供 4 档采样率选项（UI 级/普通级/游戏级/最快级），适配不同场景的数据精度需求。
- **轻量无广告**：纯工具属性，无任何植入广告与冗余权限，专注传感器数据核心功能。

## 📱 截图展示

| 传感器列表页 | 实时数据页 | 图表分析页 | 传感器详情页 |
|--------------|------------|------------|--------------|
| ![传感器列表](1.jpg) | ![GPS](2.jpg) | ![指南针](3.jpg) | ![传感器详情](1.jpg) |
 

## 📥 下载与安装

### 方式 1：直接下载 APK
前往 [Releases](https://github.com/XiTu893/XTSensorTool/releases) 页面，下载最新版本的 APK 文件，安装前请开启「未知来源应用安装」权限。

### 方式 2：源码构建
```bash
# 克隆仓库
git clone https://github.com/XiTu893/XTSensorTool.git

# 进入项目目录
cd XTSensorTool

# 构建 Debug 版本
./gradlew assembleDebug

# 构建完成后，APK 位于 app/build/outputs/apk/debug/ 目录下
```

## 📖 使用指南

1. **权限申请**：首次打开应用时，需授予「传感器权限」（Android 12+ 需显式授权 `BODY_SENSORS`），否则无法获取传感器数据。
2. **选择传感器**：在首页「传感器列表」中点击目标传感器，进入实时数据页面。
3. **数据查看**：
- 数值页：默认显示三轴数据，点击「设置」可调整数据保留位数与采样率。
- 图表页：点击「切换图表」进入，长按图表可暂停刷新并查看具体数值，双指缩放可调整时间范围。
4. **数据记录**：点击底部「开始记录」按钮启动数据采集，完成后点击「停止记录」，系统自动生成 CSV 文件，可通过「导出」按钮分享。

## 🔧 技术栈

- **核心框架**：基于 Android 原生 `SensorManager` API 开发，适配 Android 8.0 (API 26) 及以上版本。
- **架构模式**：采用 MVVM 架构，分离数据层、视图层与业务逻辑，提升代码可维护性。
- **数据可视化**：集成 MPAndroidChart 实现动态折线图，支持多轴数据叠加与实时刷新。
- **文件处理**：使用 Android 存储框架管理 CSV 文件，适配 Scoped Storage 规范（Android 10+）。
- **权限管理**：基于 ActivityResultContracts 实现现代化权限请求流程，适配 Android 13+ 权限变更。

## 🤝 贡献指南

欢迎开发者参与项目优化与功能扩展，贡献流程如下：

1. Fork 本仓库到个人账号。
2. 创建特性分支：`git checkout -b feature/your-feature-name`。
3. 提交代码变更：`git commit -m "feat: 添加XX功能/修复XX问题"`（遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范）。
4. 推送分支到远程：`git push origin feature/your-feature-name`。
5. 打开 GitHub 仓库的 Pull Request，描述功能细节与测试情况。

## 📄 许可证

本项目采用 **MIT 许可证**，允许个人与商业用途的自由使用、修改与分发，详见 [LICENSE](https://github.com/XiTu893/XTSensorTool/blob/main/LICENSE) 文件。

## ❤️ 支持与捐赠

如果 XTSensorTool 对你的开发或学习有帮助，欢迎通过以下方式支持开发者：

| 微信赞赏 | ![微信赞赏码](QrReward.jpg) | 

*您的支持是项目持续优化的动力，感谢每一份认可！*

## 📞 联系与反馈

- 项目地址：[https://github.com/XiTu893/XTSensorTool](https://github.com/XiTu893/XTSensorTool)
- 问题反馈：[Issues](https://github.com/XiTu893/XTSensorTool/issues)
- 功能建议：可直接在 Issues 中提交，或通过邮件联系：28491599@qq.com