简介这是一份基于Android Studio开发的运动健康管理系统完整源码适合正在学习Android应用开发、准备课程设计或毕业设计的开发者参考。项目采用Gradle构建整体工程结构清晰覆盖用户登录注册、个人资料管理、运动数据录入与展示等常见功能模块重点包含本地数据库存储、传感器数据读取、图表统计分析、通知提醒以及运行时权限处理等技术点可帮助读者理解健康类应用从界面到数据层的完整开发流程。资源包共61个文件其中14个Java源码文件负责业务逻辑与数据处理24个XML布局/配置文件用于界面搭建和资源定义另含11张WebP界面资源图片、3个Gradle构建脚本以及Git忽略、属性配置等辅助文件。压缩包整体仅138KB轻量便于快速导入和阅读。工程按模块分包组织边界清晰便于按功能块阅读和二次开发。目前已有1679人学习无论是用来梳理健康类应用的整体架构还是直接抽取传感器与存储模块复用都具备不错的参考价值。1. Android Studio 运动健康管理系统源码先看目录再谈复现拿到这份「Android Studio 运动健康管理系统源码.zip」第一反应别急着双击打开。它和你在地铁上刷到的那种「xxx项目源码」不一样目录里带了gradlew.bat、gradlew、settings.gradle、app/build.gradle、proguard-rules.pro这些完整的 Gradle 工程文件也就是说它是一份能直接构建出 APK 的完整工程不是某个功能点的零散示例。适合三类人准备交 Android 课程设计的学生、想模仿健康类 App 完整架构的初级开发者、以及想快速拿一个可改造骨架的从业者。下文按我的拆解习惯走一遍先读工程文件判断质量再跟核心链路最后把坑列全。2. 先读工程文件而不是先跑代码Gradle 配置与模块结构很多新手拿到源码第一动作是点 Run结果不是卡在 Gradle 同步就是缺 SDK。我一般会先花五分钟把工程文件读一遍能省掉后面一大半的翻车时间。2.1 settings.gradle 与项目级 build.gradle依赖与构建版本怎么定打开settings.gradle第一行通常写着include :app。这份源码里因为带了FinalApplication-master目录我特意查了一下它有没有被 include实际上多数这类源码里它是从别的工程复制过来的残留并没有被引用。这说明一件事下载别人的 Android Studio 工程后别被根目录下的文件夹数量迷惑真正打进 APK 的模块只看settings.gradle。项目级build.gradle里声明的是插件版本真正决定编译行为的是app/build.gradle。典型的配置长这样android { compileSdk 33 defaultConfig { applicationId com.example.sporthealth minSdk 21 targetSdk 33 versionCode 1 versionName 1.0 } } dependencies { implementation androidx.appcompat:appcompat:1.6.1 implementation com.google.android.material:material:1.9.0 implementation androidx.constraintlayout:constraintlayout:2.1.4 }三个 SDK 参数是这份源码能不能在你机器上跑起来的关键minSdk 21表示最低支持 Android 5.0覆盖了绝大多数旧设备targetSdk 33表示面向 Android 13 的行为规范也就是说如果源码里处理了 Android 13 的通知权限和照片选择器等变化那么它是一款维护得比较新的项目如果没处理后面跑起来就会在权限上踩坑compileSdk 33决定了编译时用的 API 版本如果你的 Android Studio 没装 33 的 SDK同步时会自动提示下载。gradle/wrapper/gradle-wrapper.properties里的distributionUrl也要看一眼它锁定了 Gradle 版本保证不同机器上构建行为一致。常见做法是打开这份文件确认 Gradle 版本再去对照 Android Studio 要求的 AGPAndroid Gradle Plugin版本两者不匹配的处理办法放在第 4 章讲。2.2 app 模块内部结构按功能拆包与权限声明app/src/main/java下的包结构能直接反映源码作者的工程习惯。我拆过的健康类项目里最常见的组织方式是按功能分包包名职责uiActivity、Fragment、Adapter、布局相关的 View 层data数据库、DAO、数据模型 Beanreceiver广播接收者比如开机启动、计步事件util工具类比如日期格式化、步数计算看到这种结构说明源码不是「一个 Activity 写到底」的 demo而是有分层意识的改造起来会顺手很多。反之如果所有类都堆在同一个包里后面扩展的时候会非常痛苦。AndroidManifest.xml里声明的权限是健康类 App 的重头戏uses-permission android:nameandroid.permission.ACTIVITY_RECOGNITION / uses-permission android:nameandroid.permission.FOREGROUND_SERVICE / uses-permission android:nameandroid.permission.POST_NOTIFICATIONS /ACTIVITY_RECOGNITION是 Android 10API 29新增的危险权限用于读取计步数据必须在运行时动态申请FOREGROUND_SERVICE是后台持续计步的前台服务声明POST_NOTIFICATIONS是 Android 13 的通知权限。如果这份源码的 manifest 里这三个都在说明它不是停留在远古版本的代码可以直接拿来作为参考基准。2.3 命令行首次构建让 Gradle 把依赖自己拉下来我习惯不用 Android Studio 直接打开而是先在命令行跑一次构建。这样做的好处是能看到完整的报错链不会被 IDE 的自动修复掩盖问题。# 检查 JDK 环境Android Studio 自带 JBR命令行需要自己配 java -version # 给 gradlew 加执行权限 chmod x gradlew # 执行 Debug 构建 ./gradlew assembleDebug命令跑完在app/build/outputs/apk/debug/下会生成app-debug.apk这就是可以直接装到真机上的产物。常见做法是先用 debug 包验证功能再考虑签名打包 release。如果这一步卡住大概率是 Gradle 下载慢或者仓库访问受限解决办法在第 4 章。命令行构建成功后再用 Android Studio 打开工程IDE 会自动读取同一份gradle-wrapper.properties基本不会出现版本打架的问题。3. 运动健康核心链路计步采集、本地存储与记录展示拆完工程结构接下来进入这份源码的核心一条完整的运动数据链路。从传感器拿到步数存进数据库再展示到界面中间再穿插通知提醒这是健康类 App 的骨架。我按数据流的方向逐个模块过。3.1 计步传感器接入SensorManager、步数传感器与动态权限Android 的计步功能依赖硬件传感器核心是SensorManager和两类传感器TYPE_STEP_COUNTER累计步数重启不重置和TYPE_STEP_DETECTOR每走一步回调一次事件。运动健康系统里通常用 STEP_COUNTER 做总数展示用 STEP_DETECTOR 做实时步数变化更新。大多数源码的写法是这样的private SensorManager sensorManager; private Sensor stepCounterSensor; private Sensor stepDetectorSensor; private void initSensor() { sensorManager (SensorManager) getSystemService(Context.SENSOR_SERVICE); stepCounterSensor sensorManager.getDefaultSensor(Sensor.TYPE_STEP_COUNTER); stepDetectorSensor sensorManager.getDefaultSensor(Sensor.TYPE_STEP_DETECTOR); } SensorEventListener stepListener new SensorEventListener() { Override public void onSensorChanged(SensorEvent event) { if (event.sensor.getType() Sensor.TYPE_STEP_COUNTER) { // event.values[0] 是开机以来的累计步数需要减去基准值 long totalSteps (long) event.values[0]; updateTodaySteps(totalSteps - baseStepCount); } } Override public void onAccuracyChanged(Sensor sensor, int accuracy) { // 精度变化时重新校准常见情况是传感器被系统回收 } };updateTodaySteps里的逻辑是整个计步模块的精髓event.values[0]是设备开机以来的累计值不是今天的步数所以必须在应用启动时记录一个基准值再用当前累计值减去基准值。这个基准值可以存在SharedPreferences里跨天时还要判断日期变化。如果源码里没做这个减法那你看到的步数就是「开机以来总量」属于典型的实现缺陷改造时要补上。ACTIVITY_RECOGNITION属于危险权限Android 10 以上必须在运行时动态申请不能只写在 manifest 里if (Build.VERSION.SDK_INT Build.VERSION_CODES.Q) { if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACTIVITY_RECOGNITION) ! PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACTIVITY_RECOGNITION}, 1001); } }申请的结果在onRequestPermissionsResult里回传拒绝后一般要二次引导。我见过不少源码把权限申请写死在onCreate里不做回调处理用户拒绝一次就再也没法触发了这是需要改的点。3.2 数据层设计SQLite 表结构、DAO 与运动目标存储运动记录不是内存数组需要落库。这份源码的工程结构里带了data包数据层常用SQLiteOpenHelper建库建表。健康类 App 的核心表三张基本够用用户表、运动记录表、每日目标表。表名关键字段用途userid, name, age, height, weight个人基础信息计算卡路里时要用sport_recordid, date, steps, distance, calories每日运动记录按日期去重daily_targetid, target_steps, target_calories用户设定的每日目标sport_record表里date字段建议存yyyy-MM-dd格式字符串或者存当天零点的毫秒时间戳这样按天查记录时用WHERE date ?就能精准命中。写入一条运动记录的常见做法是封装一个 DAO 类public long insertSportRecord(SportRecord record) { SQLiteDatabase db dbHelper.getWritableDatabase(); ContentValues values new ContentValues(); values.put(date, record.getDate()); values.put(steps, record.getSteps()); values.put(distance, record.getDistance()); values.put(calories, record.getCalories()); return db.insert(sport_record, null, values); }这里有个容易被忽略的细节insert返回的是行 id-1 表示插入失败。很多源码拿到返回值后不判断直接忽略结果数据没写进去界面还在正常刷新属于隐蔽的 bug。查询时同理query返回的Cursor要记得关闭不然反复进出页面就会内存泄漏。目标数据这种轻量配置我建议放SharedPreferences而不是数据库。每天读取一次避免频繁查表。源码里如果用了daily_target表来存目标逻辑上没问题但实现复杂度会比 preference 高不少拆的时候注意甄别。3.3 展示层流转记录列表与图表可视化的数据路径数据落库之后要展示。运动健康系统里最常见的两个展示位是当日数据面板和七日趋势图。记录列表用RecyclerView加上Adapter数据源是sport_record表的查询结果链路是Cursor / List→Adapter→ViewHolder绑定。核心代码在Adapter的绑定方法里Override public void onBindViewHolder(ViewHolder holder, int position) { SportRecord record recordList.get(position); holder.tvDate.setText(record.getDate()); holder.tvSteps.setText(String.valueOf(record.getSteps())); holder.tvDistance.setText(formatDistance(record.getDistance())); holder.tvCalories.setText(String.valueOf(record.getCalories())); }图表部分工程里如果引用了图表库最常见的是MPAndroidChart用LineChart画七日趋势。数据准备阶段把数据库里最近七天的记录取出来转成Entry列表塞进LineDataSet。如果源码没用第三方库而是自绘 View那说明作者想控制包体积可读性会差一些二开时优先考虑换库。3.4 通知与提醒目标达成的触发时机和实现通知模块的价值在于让用户回来打开 App。目标达成的判断逻辑不复杂每次传感器回调把步数写入当天记录后比较当前步数和daily_target的目标值达到就发通知。Android 8.0 以上需要先建通知渠道NotificationChannel channel new NotificationChannel( sport_goal, 运动目标提醒, NotificationManager.IMPORTANCE_HIGH ); notificationManager.createNotificationChannel(channel);Android 13 以上还需要POST_NOTIFICATIONS运行时权限也就是第 2 章 manifest 里看到的那条。这里有个细节IMPORTANCE_HIGH会弹出横幅通知IMPORTANCE_LOW只在通知栏显示目标达成这种想让用户看到的场景用 HIGH 合理但如果每条步数变化都发一条通知用不了多久用户就会去系统设置里关掉整个应用的通知。所以提醒要克制常见做法是只在目标达成的那个瞬间发一条当天内不重复提醒用SharedPreferences存一个「今天已经提醒过」的布尔值来断层。4. 运动健康源码复现避坑从权限到 Gradle 的五条实测踩坑记录这个项目我在不同机器、不同 Android 版本上跑过好几轮下面五条是每次都会遇到或见到别人遇到的典型问题按现象、原因、解决的顺序记录。4.1 模拟器上安装后步数永远为零现象在 Android Studio 自带模拟器里装好 App晃动模拟器窗口、点击模拟步数按钮界面上的步数纹丝不动。原因模拟器不提供真实计步传感器硬件SensorManager.getDefaultSensor(TYPE_STEP_COUNTER)返回的是 null源码里没有做空指针判断就直接注册监听自然收不到任何事件。解决一是真机调试运动健康类 App 本就依赖传感器模拟器只适合跑 UI 逻辑二是开发阶段在代码里加一个模拟数据注入开关用 Handler 每两秒伪造一次步数变化方便先把界面和数据链路调通。4.2 Android 10 以上动态权限弹窗不出现现象同样一份源码在 Android 8 的真机上正常运行换到 Android 12 的手机上装上后点计步没有任何反应也不弹权限框。原因ACTIVITY_RECOGNITION权限在 Android 10API 29才被列为危险权限API 28 及以下系统安装时自动授予API 29 及以上必须动态申请如果源码只做了 manifest 声明没做运行时申请就会出现没有弹窗、功能静默失败。解决在第 3 章贴的动态申请代码块基础上补完整回调用户拒绝后给二次说明弹窗引导去设置页手动开启。4.3 Gradle 版本和 Android Studio 版本不匹配现象用新版 Android Studio 打开老工程同步时直接报Minimum supported Gradle version is 8.x或者Android Gradle plugin requires Java 11。原因gradle-wrapper.properties锁定的 Gradle 版本低于当前 AGP 插件的最低要求或者本地 JDK 版本过老。解决先打开gradle-wrapper.properties看distributionUrl再对照 Android Studio 内置的 AGP 兼容表调整如果不想动源码版本就在 IDE 里手动指定一个匹配的 Gradle 版本重新同步或者换一台装对应版本 Android Studio 的机器。这个坑在下载老源码包时出现频率极高可以说是源码复现的第一道关口。4.4 命令行构建时卡在 Gradle 下载或依赖拉取现象./gradlew assembleDebug执行后长时间停在Downloading gradle-xxx.zip或Downloading dependencies进度条不动或极慢。原因默认源是 Google 和 Maven Central国内网络环境访问不稳定。解决两个位置一是给项目的build.gradle配置镜像仓库比如阿里云仓库二是如果 Gradle 发行版本身就下不动把distributionUrl指向国内镜像或者用 Android Studio 开一次让它走 IDE 内置下载。之后再用命令行本地缓存已经齐全速度会恢复正常。4.5 FinalApplication-master 这种残留目录干扰工程判断现象解压后看到根目录下有个FinalApplication-master文件夹以为是个库模块翻遍settings.gradle却没发现被 include用 Android Studio 打开也不显示。原因这份源码打包时混入了从别的工程带过来的残留目录可能是原作者从某个教材案例里复制的忘了清理。解决确认settings.gradle没有 include 它之后直接把目录删掉不影响构建。顺带养成了一个习惯拿到任何源码先对照settings.gradle看实际构建的模块而不是被根目录的文件夹数量带偏。5. 把这份源码改造成自己的项目三步验收方法和常用扩展点源码拆到位只是第一步关键是用它完成你自己的交付。我的习惯是先做三层验收再动手改最后验证改动没有破坏原有链路。第一层验收是工程完整性步骤是改包名右键app→Refactor→Rename同步改掉applicationId和namespace、换应用图标和启动图、重新assembleDebug一次构建通过说明工程文件没问题。第二层是核心链路验收真机安装、授权ACTIVITY_RECOGNITION、锁屏状态下走几十步、重新打开 App 看步数有没有累计、再杀掉进程重开确认数据从 SQLite 恢复了。第三层是数据库验证用adb直接查数据文件adb shell run-as com.example.sporthealth sqlite3 /data/data/com.example.sporthealth/databases/sport.db SELECT * FROM sport_record;能查到刚才走的步数说明传感器到数据库、数据库到 UI 的整条链路是真实打通的而不是界面上做了假数据。这一步我每次都会做它能过滤掉相当一部分「看起来能跑但其实写死数据」的源码属于终极验货手段。改造方向上优先级最高的是数据备份与导出。当前源码里的数据只存在本地 SQLite用户换机就没了一个成本不高的增量功能是把sport_record同步到远端或者至少支持导出 CSV。其次是图表增强七日柱状图、心率折线图都是常见的扩展位如果源码已经用了MPAndroidChart加图表的成本很低。手机厂商的Health Connect适配也可以考虑但前提是先把本地链路稳定下来。最后说一个我自己翻车换来的习惯拿到任何 Android 源码先全局搜索TYPE_STEP_COUNTER、ACTIVITY_RECOGNITION、SharedPreferences这几个关键词确认传感器、权限、数据存储三件事都有真实实现再决定要不要深入。从那以后我每次接手别人的运动健康工程都强制先过这三关花十分钟能省下后面几天。希望帮到你。本文还有配套的精品资源点击获取