Android健身App实战：状态管理、离线同步与真机适配-开发者社区

简介：本资源是一套完整的Android平台健身计划App毕业设计源码，面向计算机相关专业本科生及移动开发初学者，解决健身类应用开发中用户管理、视频内容分发与个性化训练方案设计等核心问题。压缩包共663个文件，含186个Java业务逻辑代码、236个XML界面布局与215个PNG图标资源，辅以Gradle构建脚本、JAR依赖库及文档说明，整体大小为65.76MB，结构清晰、模块划分明确，便于理解MVC架构实践与Android组件协同机制。已有429人学习下载，源码完整实现用户注册登录（含邮箱验证）、三级视频分类导航（小白必看/进阶真经/成神之路）、关键词搜索功能，以及有氧/力量双路径健身计划——如跑步场景集成安全提示弹窗与卡路里动态计算公式，具备较强的教学示范性与工程参考价值。

1. 项目概述：一个真实可用的健身计划App，不是Demo，也不是PPT原型

“毕业设计-基于Android的健身计划app源码下载”——这个标题在高校计算机/软件工程专业学生的搜索记录里高频出现，几乎每年春秋季都能看到成百上千次。它背后不是一句轻飘飘的“做个App交作业”，而是一群大四学生站在技术落地与学术规范夹缝中的真实困境：既要满足教务系统对“独立开发、功能完整、有数据库、有UI交互、有业务逻辑”的硬性要求，又要避开那些被往届学长反复提交、老师一眼就能认出的“仿知乎首页+登录注册+空列表”式模板项目。我带过六届毕业设计指导，也帮三十多位同学调试过他们的健身类App，最常听到的抱怨是：“代码跑起来了，但点开就崩”“SQLite存了数据，重启App就没了”“RecyclerView滑动卡顿，导出APK后连图标都不显示”。这说明问题不在“会不会写Hello World”，而在于对Android开发中状态管理、生命周期协调、本地持久化、UI线程安全、资源路径适配这些隐性门槛缺乏系统性认知。

这个项目的核心价值，恰恰就藏在“健身计划”四个字里——它天然具备**结构化数据建模需求（训练动作、周期计划、用户档案）、时序性交互逻辑（每日打卡、进度追踪、提醒触发）、离线优先使用场景（健身房没WiFi、跑步时锁屏操作）**三大特征。它不像天气App只需调API，也不像记账App只做CRUD，而是逼着开发者直面Android平台最典型的工程挑战：如何让一个看似简单的“计划表”，在不同机型、不同Android版本、不同内存压力下稳定运行。所以，当你下载到一份标着“健身计划App源码”的压缩包，真正该关注的不是它有没有Material Design风格的FloatingActionButton，而是它用什么机制保证用户设置的“每周三胸肌训练”不会在手机休眠10分钟后自动清空；它的“完成打卡”按钮点击后，是直接更新UI，还是先写入Room数据库再通知Adapter刷新；它的Banner轮播图，是用ViewPager2+Fragment懒加载，还是简单粗暴地用ImageView定时切换——后者在低端机上极易引发OOM崩溃。

我见过太多同学花三周时间雕琢一个炫酷的3D转场动画，结果在真机测试阶段发现：华为Mate 40 Pro上动画丝滑如德芙，但红米Note 9上直接ANR（Application Not Responding）。这种落差，根源不在技术能力，而在对Android生态碎片化的敬畏不足。这份源码的价值，不在于它多“高级”，而在于它是否用可验证的、经得起真机压测的方案，解决了健身场景下的典型痛点：比如用WorkManager实现后台打卡同步，避免JobIntentService在Android 8.0+被系统强杀；用DataStore替代SharedPreferences存储用户偏好，规避多线程读写冲突；用ConstraintLayout构建自适应训练动作卡片，确保在21:9全面屏和4:3老平板上都保持合理间距。它不是教科书里的理想模型，而是从实验室走向健身房更衣室的真实产物。

2. 整体架构设计与技术选型逻辑：为什么不用Flutter，也不用纯Kotlin协程？

2.1 架构分层：MVC还是MVVM？这里选了第三条路

很多初学者一上来就纠结“该用MVC还是MVVM”，仿佛选错架构就像选错人生伴侣。但现实是：毕业设计评审老师根本不管你是用LiveData还是StateFlow，他们只关心“功能是否跑通”“代码是否看得懂”“有没有明显硬编码”。所以这份源码采用了一种务实的混合架构：UI层（Activity/Fragment） + 业务逻辑层（UseCase类） + 数据层（Repository + DAO），刻意回避了Jetpack Compose或Clean Architecture的复杂分包。为什么？

降低理解成本：一个刚学完《Android移动应用开发》课程的学生，对Activity生命周期烂熟于心，但对ViewModelScope和lifecycleScope的区别可能还在查文档。把网络请求、数据库操作、数据转换全部塞进Activity里固然简单，但会导致类膨胀到800行以上，评审时老师翻两页就皱眉。而引入UseCase层，只是把“获取本周训练计划”这个动作封装成一个独立函数，参数是用户ID，返回是List ，既保持逻辑清晰，又无需引入Dagger/Hilt等依赖注入框架——后者在毕业设计中属于“过度设计”，反而增加答辩时被问倒的风险。
规避LiveData陷阱：网上教程千篇一律教“用LiveData观察数据”，但没人告诉你：如果在Fragment里observe()一个在Activity里创建的LiveData，当Fragment因配置变更重建时，新的Observer会收到旧的value，导致重复执行打卡逻辑。这份源码改用EventBus（GreenRobot版）实现页面间通信，虽然被部分人诟病“不够现代”，但它有一条不可替代的优势：事件只被消费一次，且明确区分粘性事件（Sticky）和普通事件（Post）。比如用户点击“开始今日训练”，发送一个StartTrainingEvent，主界面收到后跳转到训练页，同时清除该事件；即使训练页因横竖屏切换重建，也不会再次收到这个事件——这比LiveData的observeForever()加removeObserver()组合要可靠得多，尤其适合毕业设计这种时间紧、容错率低的场景。
数据库选型：Room不是必须，SQLiteOpenHelper更接地气：很多开源项目强行用Room，理由是“Google官方推荐”。但实际调试中，Room的编译时注解处理（@Entity/@Dao）会让Gradle构建时间增加15秒以上，对于配置只有8GB内存的笔记本电脑，这直接拖慢迭代节奏。这份源码选择原生SQLiteOpenHelper，配合手写的DAO类（Data Access Object），好处是：所有SQL语句明明白白写在Java文件里，老师抽查代码时能一眼看出“用户表建表语句是否包含NOT NULL约束”；增删改查方法名直白如insertUser()、queryTodayPlan()，不需要额外学习Room的@Query注解语法；更重要的是，它强制开发者理解“事务（Transaction）”概念——比如打卡操作必须同时更新plan表的status字段和record表的completion_time字段，用db.beginTransaction()...db.setTransactionSuccessful()...db.endTransaction()包裹，比Room的@Transaction注解更能培养底层思维。

2.2 关键技术点取舍：为什么放弃WebView集成百度地图，而用高德SDK精简版？

健身App必然涉及“附近健身房”功能，这是学生最容易踩坑的模块。常见错误方案是：用WebView加载百度地图网页版，通过JavaScriptInterface传坐标。表面看省事，实则埋雷：

权限链断裂：Android 10+要求ACCESS_FINE_LOCATION必须动态申请，而WebView里的JS无法触发系统权限弹窗，导致地图白屏；
路径协议冲突：你看到的热搜词里有content://com.baidu.searchbox.fileprovider/...，这正是百度搜索App的私有ContentProvider路径，第三方App无权访问，强行调用会抛SecurityException；
离线能力缺失：网页地图完全依赖网络，健身房地下室信号弱时，用户打开App看到的是一片灰色。

正确解法是接入高德地图Lite SDK（v9.0.0精简版），理由如下：

体积可控：完整版高德SDK约15MB，而Lite版仅2.3MB，打包进APK后增量不到3MB，符合毕业设计对安装包大小（通常要求<50MB）的隐性要求；
权限解耦：Lite版SDK自带位置权限检测工具类AMapLocationClient，调用checkPermissions()可主动判断GPS/WiFi定位是否开启，比自己写PackageManager.checkSelfPermission()更鲁棒；
离线缓存支持：通过AMapNaviParams.setOfflineMapMode(true)，允许用户提前下载城市离线地图包，解决健身房无网场景；
合规性保障：高德提供《地图服务使用合规指南》，明确列出“高校教学用途可免费使用”，避免答辩时被问及“是否获得商业授权”。

实操中，我们只启用三个核心功能：定位当前位置、逆地理编码（将经纬度转为“朝阳区建国路8号”）、周边搜索（radius=1000m内健身场所）。其他如路线规划、3D建筑渲染等全关闭——不是技术做不到，而是毕业设计需要体现“需求驱动开发”，而非“技术堆砌”。

2.3 UI组件策略：Banner轮播不用ViewPager2，而用RecyclerView+Handler

看到热搜词里有android中协调布局+banner，就知道这是个高频痛点。ViewPager2虽是官方推荐，但在健身App场景下存在致命缺陷：预加载机制导致内存浪费。ViewPager2默认预加载左右各1页，如果Banner图是5MB的高清JPEG，3页就是15MB内存，低端机直接OOM。而健身App的Banner通常用于推广合作健身房或新品器械，图片数量固定为3-5张，完全没必要用ViewPager2的复杂生命周期管理。

本源码采用RecyclerView + LinearLayoutManager + Handler延时滚动方案，具体实现：

创建HorizontalLinearLayoutManager，禁用Recycle（setRecycleChildrenOnDetach(false)），确保ItemView不被回收；
每个Banner ItemView包含ImageView+TextView，图片用Glide加载并指定size（override(1080, 600)），避免加载全图；
启动Handler.postDelayed()循环任务，间隔3秒滚动到下一位置；
滚动时调用smoothScrollBy(-width, 0)，而非scrollToPosition()，保证动画流畅；
用户手指滑动时，移除Handler回调，松手后重新启动——这比ViewPager2的isUserInputEnabled更轻量。

这个方案代码量不到100行，却解决了90%的Banner崩溃问题。我曾帮一位同学将ViewPager2方案替换为此方案，其App在红米Note 7（2GB RAM）上的内存占用从180MB降至65MB，ANR率从12%降至0.3%。技术选型的本质，从来不是“新不新”，而是“稳不稳”。

3. 核心功能模块拆解：从“计划生成”到“数据持久化”的全链路实现

3.1 健身计划动态生成引擎：不是静态JSON，而是规则驱动的DSL

多数毕业设计的“健身计划”功能，本质是预置几套JSON数据（如{"day":"Monday","exercises":["卧推","引体向上"]...}），运行时读取并展示。这看似简单，实则违背健身科学原理——真实计划需根据用户目标（增肌/减脂/塑形）、体能水平（新手/中级/高级）、可用器械（哑铃/杠铃/自重）动态生成。本源码实现了一个轻量级规则引擎（Rule Engine），用Java枚举定义DSL（Domain Specific Language）：

public enum TrainingRule { // 规则ID，对应数据库rule表的_id BEGINNER_CHEST_DAY(1, "新手胸肌日", "if user.level == 'BEGINNER' && day == 'MONDAY' then [BENCH_PRESS, PUSH_UP]"), INTERMEDIATE_BACK_DAY(2, "中级背肌日", "if user.level == 'INTERMEDIATE' && day == 'WEDNESDAY' then [BARBELL_ROW, PULL_UP]"); private final int id; private final String name; private final String dslExpression; // 简化版规则表达式 TrainingRule(int id, String name, String dslExpression) { this.id = id; this.name = name; this.dslExpression = dslExpression; } }

计划生成流程：

用户填写问卷（目标、水平、器械），保存至UserConfig表；
调用PlanGenerator.generateWeekPlan(userId)；
查询所有匹配规则（如user.level='BEGINNER' AND day IN ('MONDAY','WEDNESDAY')）；
解析dslExpression，提取动作数组；
将动作ID插入PlanItem表，并关联到PlanHeader表的week_id。

关键细节：规则表达式不通过ScriptEngine.eval()执行（存在安全风险），而是用正则预编译。例如解析[BENCH_PRESS, PUSH_UP]时，用Pattern.compile("\[(.*?)\]")提取括号内内容，再split(",")得到动作名数组。这样既避免反射调用开销，又杜绝恶意代码注入——毕竟毕业设计代码可能被上传到GitHub公开仓库。

3.2 打卡状态同步机制：Room+WorkManager的离线优先实践

健身App最常被忽视的环节是“打卡”。用户在跑步机上点击“完成”，网络可能中断，此时若直接Toast“打卡失败”，体验极差。本方案采用Room数据库本地暂存 + WorkManager后台同步双保险：

本地写入：点击打卡按钮时，先执行Room DAO的insertCompletion()，将completion_time、plan_item_id、device_id写入local_completion表；
后台同步：触发OneTimeWorkRequest，Worker中检查网络状态（ConnectivityManager），有网则调用Retrofit上传数据，成功后delete local record；无网则等待下次网络恢复（通过NetworkType.CONNECTED监听）；
状态回显：UI层用LiveData观察local_completion表变化，一旦插入即更新Button文字为“已打卡”，避免用户重复点击。

WorkManager配置要点：

// 设置重试策略：首次失败后1分钟重试，最多3次 Constraints constraints = new Constraints.Builder() .setRequiredNetworkType(NetworkType.CONNECTED) .build(); WorkRequest syncWork = new OneTimeWorkRequest.Builder(SyncCompletionWorker.class) .setConstraints(constraints) .setBackoffCriteria(BackoffPolicy.LINEAR, 1, TimeUnit.MINUTES) .build();

这个方案的价值在于：它让“离线可用”不再是口号。我测试过，在地铁隧道（持续3分钟无网）中连续打卡5次，出站后所有记录自动同步，且UI状态始终准确。而对比方案——用BroadcastReceiver监听CONNECTIVITY_ACTION——在Android 7.0+已被限制，且无法保证广播接收时机。

3.3 训练动作库管理：SQLite全文检索（FTS5）提升搜索体验

健身App的动作库通常含200+动作（深蹲、硬拉、俯卧撑等），用户搜索“squat”时，传统LIKE查询效率低下。本源码启用SQLite的FTS5（Full-Text Search）虚拟表，步骤如下：

创建FTS5表：

CREATE VIRTUAL TABLE exercise_fts USING fts5( name UNINDEXED, description, category, content='exercise' );

同步主表数据：

INSERT INTO exercise_fts(exercise_fts, rowid, name, description, category) SELECT 'sync', _id, name, description, category FROM exercise;

搜索查询：

SELECT e._id, e.name, e.category FROM exercise e JOIN exercise_fts f ON e._id = f.rowid WHERE f MATCH 'squat*' ORDER BY rank;

FTS5优势：

支持前缀搜索（'squat*' 匹配 squat, squats, squatting）；
自带rank排序，相关度高的结果排前；
比LIKE查询快8倍（实测10万条数据下，LIKE平均耗时120ms，FTS5仅15ms）。

注意：FTS5需Android 9.0+（API 28），但毕业设计可声明minSdkVersion=21，运行时判断Build.VERSION.SDK_INT >= Build.VERSION_CODES.P再启用FTS5，否则降级为LIKE查询——这才是工程化思维。

3.4 权限与存储适配：绕过Android 11+分区存储的务实方案

热搜词中大量出现file:///storage/emulated/0/android/data/com.xxx/...路径，暴露了学生对Android存储变更的恐慌。Android 11（API 30）起强制启用分区存储（Scoped Storage），应用私有目录（/data/data/com.xxx/）外的文件访问受限。但健身App需保存用户训练视频、导出PDF报告，必须解决此问题。

本源码采用MediaStore API + 应用专属目录双轨制：

媒体文件（视频/照片）：通过MediaStore.Video.Media.insert()获取Uri，用ContentResolver.openOutputStream()写入，系统自动归类到DCIM/Camera目录，用户可直接在相册查看；
文档文件（PDF/Excel）：创建应用专属目录getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS)，此路径无需权限即可读写，且卸载App时自动清理；
兼容旧版本：在Android 10及以下，仍使用Environment.getExternalStorageDirectory()，但添加android:requestLegacyExternalStorage="true"到AndroidManifest.xml。

关键代码：

// Android 11+ 写入视频 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) { ContentValues values = new ContentValues(); values.put(MediaStore.Video.Media.DISPLAY_NAME, "training_" + System.currentTimeMillis() + ".mp4"); values.put(MediaStore.Video.Media.MIME_TYPE, "video/mp4"); Uri uri = getContentResolver().insert(MediaStore.Video.Media.EXTERNAL_CONTENT_URI, values); try (OutputStream os = getContentResolver().openOutputStream(uri)) { // 写入视频数据 } } else { // 旧版逻辑 }

这个方案不追求“完美适配”，而是用最少代码覆盖最大用户群。据统计，国内Android 11+设备占比约65%，但仍有35%用户在用旧系统，一刀切放弃旧版支持不现实。

4. 实操部署与真机调试全流程：从Android Studio安装到APK签名

4.1 开发环境搭建避坑指南：为什么必须用Android Studio Giraffe Patch 3？

网上教程普遍推荐“最新版Android Studio”，但毕业设计最怕环境不稳定。Android Studio Hedgehog（2023.1）存在严重Bug：Gradle 8.0+与Kotlin 1.9.0配合时，Build Analyzer会误报“未使用依赖”，导致clean build失败。而本源码基于Android Studio Giraffe Patch 3（2023.2.1） + Gradle 7.4 + Kotlin 1.8.0组合，这是经过30台不同配置电脑验证的黄金搭配。

安装步骤强调三点：

JDK版本锁定为17：Android Studio Giraffe默认捆绑JDK17，若系统已装JDK21，需在File > Project Structure > SDK Location中手动指定JDK17路径，否则Gradle Sync报错“Unsupported class file major version 65”；
SDK Platform选择API 33（Android 12.1）：非必须最新，但API 33包含对WorkManager 2.8.0的完整支持，且兼容性优于API 34（Android 14）的Beta特性；
NDK版本禁用25.x：NDK 25.x在Windows平台编译OpenCV时偶发linker crash，改用NDK 23.2.9858540（随Studio Giraffe自带）可100%规避。

提示：安装完成后，务必执行“File > Sync Project with Gradle Files”，而非直接Run App。我见过太多同学跳过此步，结果在build.gradle中修改compileSdkVersion后，IDE仍用旧版本编译，导致Material3组件报错。

4.2 模拟器配置实战：Pixel_4_API_33为何比Pixel_5_API_34更适合作为测试主力？

选择模拟器不是看“名字新”，而是看系统镜像稳定性。Pixel_5_API_34（Android 14 Beta）存在两个致命问题：

WorkManager的PeriodicWorkRequest在后台被系统强制停止，导致打卡同步失效；
ConstraintLayout 2.2.0的chainPacked属性渲染异常，卡片间距错乱。

而Pixel_4_API_33（Android 12.1）镜像经过数月打磨，无此类问题。配置要点：

分辨率设为1080x1920（模拟主流手机）；
内存分配2GB（低于2GB易触发OOM）；
启用“Enable Device Frame”便于截图；
预装Google Play Services（勾选“Install Google APIs”）。

真机测试建议顺序：先用Pixel_4_API_33验证核心逻辑，再用小米13（MIUI 14）、华为Mate 50（HarmonyOS 3.0）测试厂商定制系统兼容性。特别注意华为机型需关闭“纯净模式”，否则APK安装被拦截。

4.3 APK打包与签名：debug.keystore的隐患与release签名最佳实践

毕业设计常犯错误：直接用Android Studio自动生成的debug.keystore签名APK。问题在于：

debug.keystore有效期仅30年，且密钥密码为android，安全性为零；
若多人协作，各自debug.keystore不同，导致APK包名相同但签名不同，无法覆盖安装；
评审老师用jarsigner -verify检查时，会看到“Warning: This jar contains entries whose signer certificate will expire within six months”。

正确做法：

生成专用release keystore：

keytool -genkeypair -v -storetype PKCS12 -keystore my-release-key.jks -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000

在app/build.gradle中配置signingConfigs：

android { signingConfigs { release { storeFile file("my-release-key.jks") storePassword "your_store_password" keyAlias "my-key-alias" keyPassword "your_key_password" } } buildTypes { release { signingConfig signingConfigs.release minifyEnabled true proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } } }

ProGuard规则精简：保留Room实体类、Gson序列化类、EventBus订阅者，其余混淆。例如：

-keep class com.example.fitness.entity.** { *; } -keep class com.google.gson.** { *; } -keepclassmembers class ** { @org.greenrobot.eventbus.Subscribe <methods>; }

最终生成的APK，用apksigner verify app-release.apk验证签名有效性，确保“Verified using v1 scheme (JAR signing): true”和“Verified using v2 scheme (APK Signature Scheme v2): true”均显示为true。

4.4 真机调试高频问题排查：ADB连接失败的七种可能与对应解法

连接手机调试时，90%的问题源于ADB配置。按优先级列出解决方案：

现象	可能原因	解决方案
`adb devices`显示`??????????`	USB调试模式未开启或驱动异常	进入手机开发者选项，关闭再开启USB调试；Windows下更新ADB驱动（官网下载）
设备列表为空	USB连接模式为“仅充电”	下拉通知栏，点击USB连接方式，选择“文件传输（MTP）”
`adb install`报错`INSTALL_FAILED_UPDATE_INCOMPATIBLE`	已安装同包名未签名APK	先`adb uninstall com.example.fitness`再安装
Logcat无输出	IDE未正确识别设备	File > Invalidate Caches and Restart，重启AS
点击Run按钮无反应	Gradle Daemon卡死	终端执行`./gradlew --stop`，重启AS
安装后图标不显示	AndroidManifest.xml中Launcher Activity缺少intent-filter	检查`<activity android:name=".MainActivity">`是否包含`<intent-filter><action android:name="android.intent.action.MAIN"/><category android:name="android.intent.category.LAUNCHER"/></intent-filter>`
真机运行闪退	native crash（如OpenCV库不匹配）	查看Logcat过滤`Fatal signal 11 (SIGSEGV)`，确认.so库ABI匹配（arm64-v8a/armeabi-v7a）

注意：华为/荣耀手机需在“设置 > 系统和更新 > 开发人员选项”中开启“USB调试（安全设置）”，否则ADB无法通信。此选项默认隐藏，需连续点击“版本号”7次激活开发者选项。

5. 常见问题速查与独家避坑经验：来自32个真实项目的血泪总结

5.1 数据库崩溃：Room迁移失败的三种修复路径

现象：升级App后首次启动，App崩溃并报错Migration didn't properly handle...。

原因分析：Room Migration未覆盖所有表变更。例如从v1升级到v2，新增了plan_status字段，但Migration代码只写了database.execSQL("ALTER TABLE plan ADD COLUMN status INTEGER DEFAULT 0")，却未处理v1版本中已存在的plan记录的status值。

修复方案：

方案A（推荐）：使用addColumn()替代execSQL()

static final Migration MIGRATION_1_2 = new Migration(1, 2) { @Override public void migrate(@NonNull SupportSQLiteDatabase database) { // Room自动处理DEFAULT值，无需手动UPDATE database.addColumn("plan", "status", "INTEGER DEFAULT 0"); } };

方案B：分步迁移，先添加字段再填充数据

database.execSQL("ALTER TABLE plan ADD COLUMN status INTEGER"); database.execSQL("UPDATE plan SET status = 0 WHERE status IS NULL"); // 确保NULL转0

方案C（紧急）：清除旧数据重装
在onCreate()中调用fallbackToDestructiveMigration()，适用于毕业设计演示阶段，但会丢失用户数据，仅作最后手段。

5.2 UI卡顿：RecyclerView滑动掉帧的精准定位法

现象：训练计划列表滑动时明显卡顿，Profile显示Frame Time > 16ms。

排查步骤：

在AS Profiler中开启CPU Recording，滑动列表，捕获10秒数据；
过滤RecyclerView相关方法，重点关注onBindViewHolder()耗时；
发现Glide.with(context).load(imageUrl).into(imageView)占80%时间——原因：imageUrl是网络路径，Glide每次都要解析URL并发起HTTP请求；
解决：将图片URL转为本地资源ID（如R.drawable.squat），或使用Glide预加载（Glide.with(context).load(url).preload()）。

实操心得：不要迷信“优化算法”，先用Profiler定位瓶颈。我帮一位同学优化前帧率12fps，优化后达58fps，改动仅一行代码：将holder.imageView.setImageResource(getDrawableId(actionName))替代网络加载。

5.3 权限拒绝：用户点“拒绝”后如何优雅引导？

现象：首次请求定位权限，用户点“不再询问”，后续无法获取位置。

标准解法是跳转到系统设置页，但startActivity(new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS))在Android 8.0+需额外权限。本源码采用Intent.resolveActivity()双重校验：

Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS); Uri uri = Uri.fromParts("package", getPackageName(), null); intent.setData(uri); if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } else { Toast.makeText(this, "无法打开设置页，请手动开启定位权限", Toast.LENGTH_LONG).show(); }

更进一步，添加“权限说明Dialog”：在请求权限前，先弹窗解释“为什么需要定位？——为了查找附近健身房，提升训练便利性”，用户接受率提升40%。

5.4 网络请求失败：Retrofit超时设置的黄金比例

现象：弱网环境下，Retrofit请求长时间无响应，UI卡死。

错误做法：全局设置connectTimeout=30秒，认为“越长越好”。

正确比例：连接超时 : 读取超时 : 写入超时 = 1 : 3 : 1。例如：

OkHttpClient client = new OkHttpClient.Builder() .connectTimeout(5, TimeUnit.SECONDS) // 建立TCP连接 .readTimeout(15, TimeUnit.SECONDS) // 服务器返回数据 .writeTimeout(5, TimeUnit.SECONDS) // 客户端发送数据 .build();

理由：连接超时应最短（5秒内判定网络不可达），读取超时最长（服务器处理可能耗时），写入超时居中（上传训练视频需一定时间）。实测此配置下，4G弱网（50kbps）请求成功率从62%提升至94%。

5.5 毕业设计答辩加分项：三个让老师眼前一亮的细节设计

深色模式适配：在res/values-night/colors.xml中定义深色主题色，Activity中调用AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_FOLLOW_SYSTEM)，并在设置页提供手动切换开关。老师会注意到“你考虑了无障碍设计”。
离线提示增强：网络断开时，不仅Toast“网络不可用”，还在Toolbar右侧添加NetworkStatusView（自定义View），实时显示WiFi/4G图标及信号强度，点击后弹出“重试”按钮。这体现“用户体验闭环”。
代码注释规范：每个DAO方法添加JavaDoc，注明“@param userId 用户唯一标识 @return List 按日期排序的计划项”，而非“// 获取计划”。老师抽查代码时，会认为“这孩子有工程素养”。

最后分享一个真实案例：去年一位同学的健身App在答辩时，老师问“如果用户连续7天未打卡，系统如何干预？”，他展示了在PlanGenerator中加入的streakThreshold = 7规则，触发后自动推送Notification：“您已坚持6天，再打卡1次即可解锁‘自律达人’勋章！”，并附上勋章SVG图标。老师当场给了最高分——因为这不是技术炫技，而是对“健身行为心理学”的真实理解。技术永远服务于人，这点，比任何源码都重要。

本文还有配套的精品资源，点击获取