Walk

一个专注于隐私与数据自主权的 Android 健康数据同步应用。通过 Android Health Connect API 提取本地健康指标，并同步至私有云端。

核心功能

• 步数读取：实时获取 Health Connect 中的每日步数（Steps）。
• 距离统计：读取每日移动距离（Distance）。
• 心率与运动强度：获取心率数据（Heart Rate）及计算运动积分。
• 数据自托管：脱离封闭生态，将数据主动同步至私有后端。

技术栈

• 语言：Kotlin (JVM 21 Target)
• 最低支持系统：Android 8.0 (API 26)
• 核心依赖：androidx.health.connect:connect-client
• 构建工具：Gradle Wrapper (8.4)

项目结构

walk/
├── app/
│   ├── src/main/
│   │   ├── java/guomengyao/walk/
│   │   │   └── MainActivity.kt
│   │   ├── res/
│   │   │   ├── layout/activity_main.xml
│   │   │   └── values/
│   │   │       ├── colors.xml
│   │   │       └── styles.xml
│   │   └── AndroidManifest.xml
│   └── build.gradle
├── gradle/
│   └── wrapper/
│       └── gradle-wrapper.properties
├── build.gradle
├── settings.gradle
└── gradlew.bat

构建与运行

环境变量准备

确保系统已配置 ANDROID_HOME 或在终端中临时指定：

$env:ANDROID_HOME="C:\Android\sdk"

编译 Debug APK

.\gradlew.bat assembleDebug

产物路径：app/build/outputs/apk/debug/app-debug.apk

安装到设备

adb install app/build/outputs/apk/debug/app-debug.apk

注意事项

测试设备（或模拟器）需安装 Health Connect (健康连接) 应用，并在应用首次运行时授予步数、距离及心率的读取权限。