# Steps-App

**Repository Path**: popokaikai/Steps-App

## Basic Information

- **Project Name**: Steps-App
- **Description**: Android 计步器 / 本地健康助手（开源）｜步数·轨迹·统计·饮食·心情·番茄钟·音乐歌词·NFC·桌面小部件，数据只存本机，无广告无统计 SDK
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://gitee.com/popokaikai/Steps-App/releases/latest
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-10-17
- **Last Updated**: 2026-10-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="store/icon_512.png" width="132" alt="Steps">
</p>

<h1 align="center">Steps · 纯本地多功能生活助手</h1>

<p align="center">
  计步 · 运动 · 地图轨迹 · 饮食身体 · 心情习惯 · 番茄钟 · 音乐伴侣 · NFC · 桌面小部件
</p>

<p align="center">
  <b>数据只留在你的手机里 —— 无广告、无统计 SDK、不上传任何数据</b>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/license-MIT-green" alt="license">
  <img src="https://img.shields.io/badge/Android-9.0%2B-brightgreen" alt="android">
  <img src="https://img.shields.io/badge/Java-17-orange" alt="java">
  <img src="https://img.shields.io/badge/i18n-12%20languages-blue" alt="languages">
  <img src="https://img.shields.io/badge/APK-13.4MB-lightgrey" alt="size">
  <img src="https://img.shields.io/badge/dependencies-0%20tracking%20SDK-success" alt="no%20sdk">
</p>

<p align="center">
  <a href="https://gitee.com/popokaikai/Steps-App/releases/download/v26.10.18.2/Steps-26.10.18.2-release.apk">
    <img src="https://img.shields.io/badge/%E2%AC%87%20%E4%B8%8B%E8%BD%BD%20APK-13.4MB-2ea44f?style=for-the-badge" alt="download">
  </a>
  <a href="https://gitee.com/popokaikai/Steps-App/releases">
    <img src="https://img.shields.io/badge/%E5%85%A8%E9%83%A8%E7%89%88%E6%9C%AC-Releases-1f6feb?style=for-the-badge" alt="releases">
  </a>
</p>

---

## 为什么是 Steps

- **纯本地**：16 张表全在手机 SQLite 里，没有账号、没有云端、没有埋点。断网也能完整使用（只有地图瓦片、在线歌词、检查更新会联网）。
- **一口吃掉 11 个场景**：计步、运动热量、地图轨迹、统计图表、饮食身体、心情习惯与 16 枚勋章、番茄钟、纪念日提醒、音乐歌词伴侣、NFC 读写、5 种尺寸桌面小部件。
- **小而干净**：67 个 Java 文件，依赖只有 AndroidX + Material，APK 13.4 MB，零第三方统计 / 广告 / 推送 SDK。
- **一直在更新**：打开就在后台查新版本，发现更新时弹窗里可直接下载安装（显示体积、速度、剩余时间与百分比），也可以去 Releases 手动下。

## 界面预览

<p align="center">
  <img src="store/screenshots/01-home.jpg" width="212" alt="健康首页">
  &nbsp;
  <img src="store/screenshots/03-stats.jpg" width="212" alt="统计">
  &nbsp;
  <img src="store/screenshots/02-map.jpg" width="212" alt="地图轨迹">
</p>

<p align="center">
  <sub>健康首页 · 统计图表 · 地图轨迹</sub>
</p>

## 功能

| 模块 | 说明 |
|---|---|
| 健康首页 | 环形步数、7 天柱状、体重/BMI 折线、睡眠、饮水、自然语言记录；一键把今日步数分享给微信 / QQ |
| 运动 | 6 类运动按 MET 估算热量，单次运动记录与今日汇总 |
| 统计 | 周/月/达标分析、14 天与 8 周图表、明细列表、16 枚勋章进度 |
| 饮食身体 | 三餐热量、体重 / 血压 / 血糖 / 心率 |
| 心情习惯 | 心情 5 档、自定义习惯连续天数，连续记录解锁勋章 |
| 专注 | 25 / 45 / 60 分钟番茄钟（通知 + 震动 + 语音） |
| 生活 | 纪念日倒数、提醒、闹钟（全屏响铃 + 常驻通知）、屏幕时间 |
| 地图 | 大陆用**高德 Web JS API**、海外用 **Google 瓦片**；GPS 轨迹 + 三层漂移过滤 + **WGS-84 → GCJ-02 坐标纠偏**（消除 100~600 米系统性偏移） |
| 音乐 | 媒体会话读取歌名歌手；歌词国内 **QQ → 网易云 → 酷狗 → LRCLIB** 逐级回退、海外 LRCLIB，内存 + 磁盘两级缓存，切歌秒出词 |
| NFC | ReaderMode 读写 NDEF（未格式化卡自动 format） |
| 小部件 | 1×2 / 2×1 / 2×2 / 2×4 / 4×8 五种尺寸，随 App 内数据同步刷新 |
| 外观 | 「经典」与「液态玻璃」双风格；环形 / 柱状 / 折线图均带入场动画；导航栏支持长按拖动切页 |
| 引导 | 首启 4 步权限向导 + App 内图文教程 + 可关闭的开机动画 |
| 设置 | 单位 / 目标 / 语音 / 久坐 / 悬浮球 / 数据导入导出 / 12 语言 / 法律信息 / 检查更新 / 赞赏支持 |

## 技术栈

- 包名 `pk.steps`；**minSdk 28（Android 9.0）** / targetSdk 37 / compileSdk 36 / Java 17
- 构建：AGP 8.13.0 + Gradle 9.0.0，开启 `viewBinding`
- 依赖仅四项：`androidx.core` / `androidx.appcompat` / `androidx.constraintlayout` / `material`
- 界面全部用代码搭（无 XML 布局），`Ui` 构件库统一卡片 / 胶囊 / 弹窗与双主题配色
- 自绘控件：环形进度 `RingView`、柱状 `BarChartView`、折线 `LineChartView`（无图表库，均带动画）
- i18n：`values` / `values-zh-rCN` / `values-zh-rTW` 各 591 条文案，另有 ja / ko / es / pt / fr / de / it / ru / ar 框架

## 下载与安装

- **最新版 v26.10.18.2（13.4 MB）**：[直接下载 APK](https://gitee.com/popokaikai/Steps-App/releases/download/v26.10.18.2/Steps-26.10.18.2-release.apk) · [版本页](https://gitee.com/popokaikai/Steps-App/releases/tag/v26.10.18.2)
- 安装时请允许「安装未知应用」；之后升级可在 App 内直接完成。
- 若之前装过 debug 版，因签名不同请先卸载旧版，再装正式包。
- 旧版本见 [Releases](https://gitee.com/popokaikai/Steps-App/releases)，每版改动见 [CHANGELOG.md](CHANGELOG.md)。

## 常见问题

**为什么需要「身体活动」权限？**
只有这个权限能读到硬件计步器；拒绝也能用 App，但步数不会自动累加。

**数据存在哪？会被上传吗？**
全部在手机本地。地图瓦片、在线歌词、检查更新这几个请求里不含任何用户标识，也没有账号体系。

**换手机怎么迁移？**
设置 → 数据管理 → 导出 JSON（或 CSV），在新机导入即可。

**地图上的点为什么不飘？**
GPS 原始坐标是 WGS-84，国内底图用 GCJ-02，两者差 100~600 米。App 内部统一做了坐标转换，数据库里仍存原始值。

**歌词为什么有时没有？**
歌词来自公开接口（QQ / 网易云 / 酷狗 / LRCLIB），冷门歌曲可能四个源都没有；已取到的会缓存到本地。

## 隐私

所有数据存本机 SQLite；只有地图瓦片、在线歌词、系统翻译、检查更新会联网，且请求中不含任何用户标识。
应用内可随时阅读完整的《隐私政策》《用户协议》《第三方声明》。

## 许可

<p align="center">
  <img src="https://img.shields.io/badge/license-MIT-2ea44f?style=flat-square" alt="MIT">
  <img src="https://img.shields.io/badge/%E5%95%86%E7%94%A8-%E5%85%81%E8%AE%B8-1f6feb?style=flat-square" alt="commercial use">
  <img src="https://img.shields.io/badge/%E4%BA%8C%E6%AC%A1%E5%BC%80%E5%8F%91-%E6%AC%A2%E8%BF%8E-6f42c1?style=flat-square" alt="fork">
</p>

源码采用 [MIT License](LICENSE)：**可以自由使用、修改、商用、再发布**，只需保留原始的版权声明与许可声明。

| 范围 | 说明 |
|---|---|
| 代码 | MIT，随便用，包括闭源商用 |
| 名称与图标 | 「Steps」名称与图标版权归作者，二次分发请换名换图，避免用户混淆 |
| 第三方服务 | 地图瓦片（高德 / Google）、在线歌词源均遵循各自服务条款，**发布前请自行申请 Key**，不要复用仓库里的示例配置 |
| 你的数据 | 全部在你手机里，作者既看不到也无法恢复；卸载前请自行导出备份 |

> 本项目按「现状」提供，不附带任何担保。因使用本软件造成的步数误差、数据丢失或设备问题，作者不承担连带责任。

<p align="center">
  <sub>如果 Steps 对你有用，点个 ⭐ Star 是最大的支持；发现问题欢迎提 Issue。</sub>
</p>