和 Miku 一起学习、听歌，记录每一天的专注时间。
基于 shshouse/StudyWithMiku 的非官方原生 Android 移植，使用 Kotlin、Jetpack Compose、Media3 和 Material 3 Expressive。保留原项目的网络播放器、推荐歌单、账号同步与聊天室，同时提供离线计时、内置音乐和本地计划。网络功能沿用原站服务。
| 页面 | 功能 |
|---|---|
| 专注 | 番茄钟、倒计时、正计时、短休息与长休息、三段 Miku 场景、静态模式、沉浸全屏和完成语音 |
| 音乐 | 网易云／QQ 网络播放、原作 10 个推荐歌单、自定义歌单链接、封面与歌词、队列与循环、手动／自动交叉淡入、11 首内置音乐、本地导入与收藏；“我的网络歌单”、整张网络歌单缓存与离线播放 |
| 计划与记录 | 待办、日期计划、倒数日、每日专注统计和月度热力日历 |
| 社区与账号 | MikuMod 官方网页登录、学习资料与日历云同步、在线人数、管理员状态、实时聊天与历史分页、头像、表情及歌曲／倒数日分享；1.2.8 新增引用回复 |
| 外观与系统集成 | Material 3 Expressive、深浅主题、壁纸取色、自适应与单色主题图标、通知栏／锁屏媒体控制 |
番茄钟、计划、记录、三段场景和内置音乐可离线使用。在音乐页选择歌单后点击“缓存当前歌单”，完整下载的音频可离线播放。进入“离线歌单”后只播放已完成缓存的曲目；支持进度查看、暂停／继续和确认清除全部缓存。未缓存歌曲、刷新歌单、账号与社区功能需要联网。
开始计时后会自动获取 CPU WakeLock，暂停或结束后释放。首次开始计时时，应用会自动打开系统的后台运行授权页面；拒绝后不会反复自动弹出，可在 设置 → 后台运行 → 获取后台运行权限 中重新申请。
按提示打开系统的应用信息，在 电池 / 后台耗电管理 中将 Study With Miku 设为 无限制（部分手机称“不限制”或“允许后台运行”）。这项设置需要在系统界面确认；电池优化豁免状态不等同于厂商的全部后台限制都已关闭。设置中的“打开应用系统设置”按钮可随时进入。
在 社区 → 账号 打开 MikuMod 官方登录页，完成认证后返回应用。登录沿用原站流程，应用不读取账号密码。
首次关联有差异的本地与云端资料时，选择“使用云端资料”“保留本地并上传”或“合并并同步”，再点击确认。合并按原作规则保留每天较大的学习值，并对待办、计划等按 ID 去重。
读取成功并保存后才关闭同步窗口；失败会保留本地资料与选择框。合并支持只在一端存在的日期及缺失计数字段，保留有效的较大值；上传失败会明确标明“学习资料”或“日历”，本地资料及待上传状态保留，可重试。已接受且没有变化的资料不会重复要求选择，云端更新与本地修改同时出现时会再次核对。切换账号时，账号与访客资料分别保存。同步范围沿用原作；本地导入音乐、收藏、播放队列与主题等 Android 扩展保存在本机。
使用 Android Studio 打开 android 目录，准备 JDK 17、Android SDK 37.0 和 Build Tools 37.0.0：
git clone https://github.com/chorusfruit-233/StudyWithMiku-Android.git
cd StudyWithMiku-Android/android
./gradlew assembleDebug testDebugUnitTest lintDebugDebug APK 输出到 android/app/build/outputs/apk/debug/app-debug.apk，构建 Debug 无需正式签名密钥。
当前使用 AGP 9.4.1、Gradle 9.6.0 与 Kotlin／Compose Compiler 2.4.21，compileSdk 和 targetSdk 均为 37，最低支持 API 26。依赖版本及 Android 17 适配说明见 构建依赖。
正式发行见 Release 构建与发布指南。Android app 工作流负责 Debug 构建和 Android 模拟器回归；Android signed release 负责固定签名的 Release 构建。两项检查通过后，Publish verified release 可将已验证的产物公开发布。历史 Debug 草稿仍仅供有仓库写入权限的维护者查看。
1.2.13 更新构建工具与依赖，并在 Android 15 与 17 分别完成设备回归。上游基线为 2026-10-16 提交，覆盖切歌交接、聊天投递、设置默认值与过期请求保护。构建、设备回归和签名结果见 验证记录，差异映射见 上游适配记录。设备测试使用合成音频和本地服务，真实账号与正式包真机验收另行确认。
安装包体积主要来自 11 首音乐（约 65 MB）与 3 段视频（约 44 MB）。当前尚未启用 R8 代码裁剪及资源裁剪，音视频沿用原始编码。
报告问题时，请说明应用版本、手机与 Android 版本、复现步骤，以及预期和实际结果。
原项目由 SHSHOUSE 创作：StudyWithMiku。Android 移植保留原作署名，遵循 GNU GPL v3。
场景、音乐、完成语音、贴图、表情与推荐歌单沿用原项目。音乐来源包括和未来一起喝茶、Alice In Cradle 与 Snail’s House；资源与角色权利归各自权利人。依赖与资源说明见 工程文档。