和 Miku 一起学习、听歌，记录每一天的专注时间。
基于 shshouse/StudyWithMiku 的非官方原生 Android 移植，使用 Kotlin、Jetpack Compose、Media3 和 Material 3 Expressive。保留原项目的网络播放器、推荐歌单、账号同步与聊天室，同时提供离线计时、内置音乐和本地计划。网络功能沿用原站服务。
当前正式版为 1.2.9，可直接下载 StudyWithMiku-Android-1.2.9-release.apk。仓库、源码及已发布的 Release 均公开，下载无需仓库权限。
当前源码版本为 1.2.11，新增网络歌单音频缓存与离线播放，保留 1.2.10 的同步修复。新版已通过回归验证，并保存为固定签名 Release 草稿，公开下载入口以已发布版本为准。
| 项目 | 信息 |
|---|---|
| 系统要求 | Android 8.0（API 26）及以上 |
| 包名 | io.github.chorusfruit233.studywithmiku |
| 正式签名 | 固定 StudyWithMiku 证书，关闭调试 |
| 安装包大小 | 1.2.9 约 129 MB，包含全部离线音乐与场景视频 |
Release 附带 SHA256SUMS.txt、SIGNING-CERTIFICATE.txt 和检查报告，可用于核对文件与签名。
正式版升级需保持同包名、同签名及更高的 versionCode。此前的 Debug APK 使用临时签名，首次切换不能覆盖安装；先保存需要的资料，卸载会删除本机资料。旧包名应用可与当前应用共存，本机资料不会自动迁移。
| 页面 | 功能 |
|---|---|
| 专注 | 番茄钟、倒计时、正计时、短休息与长休息、三段 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 35 和 Build Tools 35.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 无需正式签名密钥。
正式发行见 Release 构建与发布指南。Android app 工作流负责 Debug 构建和 Android 模拟器回归；Android signed release 负责固定签名的 Release 构建。工作流先保存 Release 草稿，维护者点击 Publish release 后才向公众展示。历史 Debug 草稿仍仅供有仓库写入权限的维护者查看。
1.2.11 已通过 99 项 Release 单元测试与 Release Lint；相同应用源码的 Debug 构建通过 99 项单元测试及 31 项 Android 35 回归，包括断网播放、缓存重建、断点续传及真实下载服务。设备测试使用合成音频和本地服务，不作为签名包真机或真实账号验收。具体范围见 验证记录。
安装包体积主要来自 11 首音乐（约 65 MB）与 3 段视频（约 44 MB）。1.2.7 尚未启用 R8 代码裁剪及资源裁剪，音视频沿用原始编码。
报告问题时，请说明应用版本、手机与 Android 版本、复现步骤，以及预期和实际结果。
原项目由 SHSHOUSE 创作：StudyWithMiku。Android 移植保留原作署名，遵循 GNU GPL v3。
场景、音乐、完成语音、贴图、表情与推荐歌单沿用原项目。音乐来源包括和未来一起喝茶、Alice In Cradle 与 Snail’s House；资源与角色权利归各自权利人。依赖与资源说明见 工程文档。