FitTrack - 健身打卡 Android App

一个现代、简约且美观的健身打卡 Android 应用。

功能特性

核心功能

• 🏠 首页 - 展示每日打卡进度、健身记录和统计数据
• ✅ 打卡页面 - 记录运动数据，支持计时器与备注
• 📊 历史数据 - 以图表形式展示运动趋势
• 👤 个人中心 - 用户信息、目标设置、主题切换

界面设计

• 清新健康的配色方案（绿色 + 蓝色渐变）
• Material Design 设计语言
• 流畅的页面切换动画
• 直观的底部导航栏
• 悬浮打卡快捷按钮

技术栈

• 开发语言: Java
• 最低 SDK: API 24 (Android 7.0)
• 目标 SDK: API 34 (Android 14)
• UI 框架: Material Components
• 架构: 单 Activity + 多视图切换

项目结构

FitnessTracker/
├── app/
│   ├── src/
│   │   └── main/
│   │       ├── java/com/fitness/tracker/
│   │       │   └── MainActivity.java
│   │       ├── res/
│   │       │   ├── layout/
│   │       │   │   ├── activity_main.xml
│   │       │   │   ├── page_home.xml
│   │       │   │   ├── page_checkin.xml
│   │       │   │   ├── page_history.xml
│   │       │   │   └── page_profile.xml
│   │       │   ├── values/
│   │       │   │   ├── colors.xml
│   │       │   │   ├── strings.xml
│   │       │   │   └── themes.xml
│   │       │   ├── drawable/
│   │       │   ├── menu/
│   │       │   └── color/
│   │       └── AndroidManifest.xml
│   └── build.gradle
├── build.gradle
├── settings.gradle
└── gradle.properties

如何构建

方法一：使用 Android Studio（推荐）

1. 安装 Android Studio
2. 打开 Android Studio
3. 选择 "Open an Existing Project"
4. 选择 FitnessTracker 文件夹
5. 等待 Gradle 同步完成
6. 点击 Run 按钮（绿色播放图标）或按 Shift+F10

方法二：使用命令行

需要先安装 Android SDK 和配置环境变量。

# 进入项目目录
cd FitnessTracker

# 构建 Debug APK
./gradlew assembleDebug

# APK 输出位置：
# app/build/outputs/apk/debug/app-debug.apk

方法三：使用在线构建服务

如果您没有本地开发环境，可以使用以下在线服务：

1. GitHub + GitHub Actions

   • 将项目上传到 GitHub
   • 配置 GitHub Actions 自动构建

2. AppCenter / Firebase

   • 上传项目到云端
   • 自动构建并生成 APK

安装到设备

开发者模式安装

1. 在 Android 设备上启用"开发者选项"
2. 启用"USB 调试"
3. 通过 USB 连接设备到电脑
4. 在 Android Studio 中直接运行即可安装

APK 安装

1. 将生成的 APK 文件传输到 Android 设备
2. 在设备上打开文件管理器
3. 找到 APK 文件并点击安装
4. 如果提示"不允许安装未知来源应用"，需要在设置中允许

运行环境要求

• Android 版本: Android 7.0 (API 24) 及以上
• 屏幕: 适配手机屏幕（推荐分辨率 1080x1920 及以上）
• 存储: 至少 50MB 可用空间

主要依赖库

• AndroidX AppCompat 1.6.1
• Material Components 1.11.0
• ConstraintLayout 2.1.4
• CoordinatorLayout 1.2.0
• CardView 1.0.0

功能说明

计时器功能

• 支持开始、暂停、重置
• 实时显示运动时长
• 格式：时:分:秒

数据统计

• 今日卡路里消耗
• 运动时长
• 步数统计
• 目标完成率

打卡记录

• 选择运动类型（跑步、力量训练、瑜伽等）
• 设置运动强度
• 添加备注
• 自动保存记录

版本信息

• 当前版本: 1.0.0
• 构建工具: Gradle 8.2.0
• Java 版本: Java 8

注意事项

1. 首次构建需要下载 Gradle 依赖，请确保网络连接正常
2. 如遇到构建错误，请检查 Android SDK 是否正确安装
3. 推荐使用最新版本的 Android Studio

后续开发计划

• 数据持久化（SQLite/Room）
• 云端同步功能
• 社交分享功能
• 更多运动类型
• 个性化主题切换
• 运动提醒通知
• 成就系统

许可证

本项目为演示项目，仅供学习参考使用。

联系方式

如有问题或建议，欢迎反馈！